Spaces:

karlexmarin
/

taf-agent

Running

karlexmarin Claude Opus 4.7 (1M context) commited on 7 days ago

Commit

6e2328e

1 Parent(s): 28ac122

v0.6.1: 5 audit-driven gap fixes (privacy, exports, a11y, tooling)

- meta tags: corrected to "8 recipes" (Help title already said 8; Profile-context retains "5" = profile chain count)
- submit-to-registry: clipboard + title-only URL replaces full-JSON-in-GET (privacy: was leaking body via GH server logs / referer headers)
- LaTeX/Markdown export: 6 new download buttons (3 share-bars × 2 formats); profileToLatex / compareToLatex / recipeToLatex serializers
- accessibility: ARIA roles on modal/tabs/lang-switcher, skip-to-main link, focus trap + Esc/Tab cycle in Help modal, aria-selected toggle on mode tabs
- new: scripts/check_lean_manifest.py — cross-checks lean_status.json against lean-taf source. Detects missing-in-source / line-drift / file-drift (errors) + new-in-source / commit-drift (info). --regenerate rewrites in-place. --strict for CI gate.
- i18n: 5 new keys × EN/ES/FR/ZH (parity 0 missing / 0 extra)
- 62/62 smoke tests passed locally

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Files changed (6) hide show

index.html +20 -17
js/i18n.js +20 -0
js/main.js +192 -22
scripts/README.md +38 -0
scripts/check_lean_manifest.py +231 -0
style.css +15 -0

index.html CHANGED Viewed

@@ -12,13 +12,13 @@
   <meta property="og:type" content="website" />
   <meta property="og:url" content="https://karlesmarin.github.io/tafagent/" />
   <meta property="og:title" content="TAF Agent — Test ANY Transformer LLM in Your Browser" />
-  <meta property="og:description" content="Free, auditable transformer LLM diagnostic. 5 recipes, 5 modes, 4 languages. Runs in your browser. No server, no auth, $0/month forever." />
   <meta property="og:site_name" content="TAF Agent" />
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image" />
   <meta name="twitter:title" content="TAF Agent — Test ANY Transformer LLM in Your Browser" />
-  <meta name="twitter:description" content="Free, auditable transformer LLM diagnostic. 5 recipes, 5 modes, 4 languages. Runs in your browser. $0 forever." />
   <!-- Theme color for browser UI -->
   <meta name="theme-color" content="#0a0e14" />
@@ -27,13 +27,14 @@
   <script src="https://cdn.jsdelivr.net/pyodide/v0.26.4/full/pyodide.js"></script>
 </head>
 <body>
   <header>
     <!-- Language switcher (top-right, round flags) -->
     <div class="lang-switcher">
-      <button class="lang-btn" data-lang="en" data-label="English" title="English">🇬🇧</button>
-      <button class="lang-btn" data-lang="es" data-label="Español" title="Español">🇪🇸</button>
-      <button class="lang-btn" data-lang="fr" data-label="Français" title="Français">🇫🇷</button>
-      <button class="lang-btn" data-lang="zh" data-label="中文" title="中文">🇨🇳</button>
     </div>
     <h1 data-i18n="hero.title">🔬 TAF Agent</h1>
@@ -61,10 +62,10 @@
   </header>
   <!-- Help modal -->
-  <div id="help-modal">
     <div class="help-content">
-      <button class="help-close" id="help-close">×</button>
-      <h2 data-i18n="help.title">📘 TAF Agent — User Manual</h2>
       <h3 data-i18n="help.what.title">What does it do?</h3>
       <p data-i18n="help.what.body">Predicts <strong>practical viability</strong> of any transformer LLM
@@ -252,14 +253,14 @@
         <strong>📋 Recipe</strong>: manual selection with full form control.
         </span></span>
       </h2>
-      <div class="mode-tabs">
-        <button class="mode-btn active" data-mode="profile" data-i18n="modes.profile">📇 Profile a model</button>
-        <button class="mode-btn" data-mode="compare" data-i18n="modes.compare">🆚 Compare models</button>
-        <button class="mode-btn" data-mode="inspector" data-i18n="modes.inspector">🔍 Inspect config</button>
-        <button class="mode-btn" data-mode="ask" data-i18n="modes.ask">💬 Ask plain English</button>
-        <button class="mode-btn" data-mode="recipe" data-i18n="modes.recipe">📋 Pick recipe</button>
-        <button class="mode-btn" data-mode="diagnose" data-i18n="modes.diagnose">🩺 Diagnose CLI</button>
-        <button class="mode-btn" data-mode="phase" data-i18n="modes.phase">📊 Phase diagram</button>
       </div>
       <p id="mode-desc" class="recipe-desc" data-i18n="modes.desc">
         <strong>Quickest start</strong>: paste any HuggingFace model id (e.g. <code>meta-llama/Meta-Llama-3-8B</code>),
@@ -591,6 +592,8 @@
       <div class="share-bar">
         <button id="share-btn" class="secondary" type="button" data-i18n="share.btn">🔗 Copy share link</button>
         <button id="recipe-download-btn" class="secondary" type="button" data-i18n="share.download">💾 Download JSON</button>
         <button id="recipe-submit-btn" class="secondary" type="button" data-i18n="share.submit">📤 Submit to registry</button>
         <span id="share-status" class="subtle"></span>
       </div>

   <meta property="og:type" content="website" />
   <meta property="og:url" content="https://karlesmarin.github.io/tafagent/" />
   <meta property="og:title" content="TAF Agent — Test ANY Transformer LLM in Your Browser" />
+  <meta property="og:description" content="Free, auditable transformer LLM diagnostic. 8 recipes, 5 modes, 4 languages. Runs in your browser. No server, no auth, $0/month forever." />
   <meta property="og:site_name" content="TAF Agent" />
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image" />
   <meta name="twitter:title" content="TAF Agent — Test ANY Transformer LLM in Your Browser" />
+  <meta name="twitter:description" content="Free, auditable transformer LLM diagnostic. 8 recipes, 5 modes, 4 languages. Runs in your browser. $0 forever." />
   <!-- Theme color for browser UI -->
   <meta name="theme-color" content="#0a0e14" />
   <script src="https://cdn.jsdelivr.net/pyodide/v0.26.4/full/pyodide.js"></script>
 </head>
 <body>
+  <a href="#mode-section" class="skip-link" data-i18n="a11y.skip">Skip to main content</a>
   <header>
     <!-- Language switcher (top-right, round flags) -->
     <div class="lang-switcher">
+      <button class="lang-btn" data-lang="en" data-label="English" title="English" aria-label="Switch language to English">🇬🇧</button>
+      <button class="lang-btn" data-lang="es" data-label="Español" title="Español" aria-label="Cambiar idioma a Español">🇪🇸</button>
+      <button class="lang-btn" data-lang="fr" data-label="Français" title="Français" aria-label="Changer la langue en Français">🇫🇷</button>
+      <button class="lang-btn" data-lang="zh" data-label="中文" title="中文" aria-label="切换语言至中文">🇨🇳</button>
     </div>
     <h1 data-i18n="hero.title">🔬 TAF Agent</h1>
   </header>
   <!-- Help modal -->
+  <div id="help-modal" role="dialog" aria-modal="true" aria-labelledby="help-modal-title" aria-hidden="true">
     <div class="help-content">
+      <button class="help-close" id="help-close" aria-label="Close help">×</button>
+      <h2 id="help-modal-title" data-i18n="help.title">📘 TAF Agent — User Manual</h2>
       <h3 data-i18n="help.what.title">What does it do?</h3>
       <p data-i18n="help.what.body">Predicts <strong>practical viability</strong> of any transformer LLM
         <strong>📋 Recipe</strong>: manual selection with full form control.
         </span></span>
       </h2>
+      <div class="mode-tabs" role="tablist" aria-label="View modes">
+        <button class="mode-btn active" data-mode="profile" role="tab" aria-selected="true" data-i18n="modes.profile">📇 Profile a model</button>
+        <button class="mode-btn" data-mode="compare" role="tab" aria-selected="false" data-i18n="modes.compare">🆚 Compare models</button>
+        <button class="mode-btn" data-mode="inspector" role="tab" aria-selected="false" data-i18n="modes.inspector">🔍 Inspect config</button>
+        <button class="mode-btn" data-mode="ask" role="tab" aria-selected="false" data-i18n="modes.ask">💬 Ask plain English</button>
+        <button class="mode-btn" data-mode="recipe" role="tab" aria-selected="false" data-i18n="modes.recipe">📋 Pick recipe</button>
+        <button class="mode-btn" data-mode="diagnose" role="tab" aria-selected="false" data-i18n="modes.diagnose">🩺 Diagnose CLI</button>
+        <button class="mode-btn" data-mode="phase" role="tab" aria-selected="false" data-i18n="modes.phase">📊 Phase diagram</button>
       </div>
       <p id="mode-desc" class="recipe-desc" data-i18n="modes.desc">
         <strong>Quickest start</strong>: paste any HuggingFace model id (e.g. <code>meta-llama/Meta-Llama-3-8B</code>),
       <div class="share-bar">
         <button id="share-btn" class="secondary" type="button" data-i18n="share.btn">🔗 Copy share link</button>
         <button id="recipe-download-btn" class="secondary" type="button" data-i18n="share.download">💾 Download JSON</button>
+        <button id="recipe-download-md-btn" class="secondary" type="button" data-i18n="share.download_md">📝 Markdown</button>
+        <button id="recipe-download-tex-btn" class="secondary" type="button" data-i18n="share.download_tex">📜 LaTeX</button>
         <button id="recipe-submit-btn" class="secondary" type="button" data-i18n="share.submit">📤 Submit to registry</button>
         <span id="share-status" class="subtle"></span>
       </div>

js/i18n.js CHANGED Viewed

@@ -78,8 +78,13 @@ export const TRANSLATIONS = {
     "share.btn":               "🔗 Copy share link",
     "share.copied":            "✅ Copied to clipboard!",
     "share.download":          "💾 Download JSON",
     "share.submit":            "📤 Submit to registry",
     "share.import_title":      "📂 Import a shared TAF result",
     "share.import_desc":       "Got a JSON file from someone else's TAF analysis? Load it here to see the verdict + chain locally. Same view as if you'd run it yourself.",
     "share.import_btn":        "📂 Load shared JSON",
     "synthesis.system":        "You are a precise transformer LLM diagnostic assistant. Given pre-computed TAF formula results, write a clear plain-English summary in 4-6 sentences. Cite the section number (§X.Y) for each number you mention. Always give a concrete recommendation. Do NOT invent numbers.",
@@ -582,8 +587,13 @@ export const TRANSLATIONS = {
     "share.btn":               "🔗 Copiar link",
     "share.copied":            "✅ ¡Copiado al portapapeles!",
     "share.download":          "💾 Descargar JSON",
     "share.submit":            "📤 Enviar al registry",
     "share.import_title":      "📂 Importar un resultado TAF compartido",
     "share.import_desc":       "¿Tienes un fichero JSON del análisis TAF de alguien? Cárgalo aquí para ver el veredicto + cadena localmente. La misma vista que si lo hubieras ejecutado tú.",
     "share.import_btn":        "📂 Cargar JSON compartido",
     "synthesis.system":        "Eres un asistente de diagnóstico preciso para LLMs transformer. Dados resultados de fórmulas TAF pre-calculados, escribe un resumen claro en español de 4-6 frases. Cita el número de sección (§X.Y) para cada número que menciones. Da siempre una recomendación concreta. NO inventes números.",
@@ -950,8 +960,13 @@ export const TRANSLATIONS = {
     "share.btn":               "🔗 Copier le lien",
     "share.copied":            "✅ Copié dans le presse-papiers!",
     "share.download":          "💾 Télécharger JSON",
     "share.submit":            "📤 Soumettre au registry",
     "share.import_title":      "📂 Importer un résultat TAF partagé",
     "share.import_desc":       "Vous avez un fichier JSON de l'analyse TAF de quelqu'un ? Chargez-le ici pour voir le verdict + la chaîne localement. La même vue que si vous l'aviez exécuté vous-même.",
     "share.import_btn":        "📂 Charger JSON partagé",
     "synthesis.system":        "Vous êtes un assistant de diagnostic précis pour LLMs transformer. Étant donné des résultats de formules TAF pré-calculés, écrivez un résumé clair en français de 4-6 phrases. Citez le numéro de section (§X.Y) pour chaque nombre mentionné. Donnez toujours une recommandation concrète. N'INVENTEZ PAS de nombres.",
@@ -1318,8 +1333,13 @@ export const TRANSLATIONS = {
     "share.btn":               "🔗 复制分享链接",
     "share.copied":            "✅ 已复制到剪贴板!",
     "share.download":          "💾 下载 JSON",
     "share.submit":            "📤 提交到 registry",
     "share.import_title":      "📂 导入共享的 TAF 结果",
     "share.import_desc":       "有他人 TAF 分析的 JSON 文件? 在这里加载以本地查看判定 + 链。与您自己运行的视图相同。",
     "share.import_btn":        "📂 加载共享的 JSON",
     "synthesis.system":        "您是 transformer LLM 的精确诊断助手。给定预先计算的 TAF 公式结果,用 4-6 句中文写出清晰的摘要。为每个提到的数字引用章节号 (§X.Y)。始终给出具体建议。不要编造数字。",

     "share.btn":               "🔗 Copy share link",
     "share.copied":            "✅ Copied to clipboard!",
     "share.download":          "💾 Download JSON",
+    "share.download_md":       "📝 Markdown",
+    "share.download_tex":      "📜 LaTeX",
     "share.submit":            "📤 Submit to registry",
+    "share.submit_clip_ok":    "↗ Opened GitHub. Body copied to clipboard — paste it into the issue body.",
+    "share.submit_clip_fail":  "↗ Opened GitHub. Clipboard blocked — body logged in browser console (F12).",
     "share.import_title":      "📂 Import a shared TAF result",
+    "a11y.skip":               "Skip to main content",
     "share.import_desc":       "Got a JSON file from someone else's TAF analysis? Load it here to see the verdict + chain locally. Same view as if you'd run it yourself.",
     "share.import_btn":        "📂 Load shared JSON",
     "synthesis.system":        "You are a precise transformer LLM diagnostic assistant. Given pre-computed TAF formula results, write a clear plain-English summary in 4-6 sentences. Cite the section number (§X.Y) for each number you mention. Always give a concrete recommendation. Do NOT invent numbers.",
     "share.btn":               "🔗 Copiar link",
     "share.copied":            "✅ ¡Copiado al portapapeles!",
     "share.download":          "💾 Descargar JSON",
+    "share.download_md":       "📝 Markdown",
+    "share.download_tex":      "📜 LaTeX",
     "share.submit":            "📤 Enviar al registry",
+    "share.submit_clip_ok":    "↗ GitHub abierto. Cuerpo copiado al portapapeles — pégalo en el cuerpo del issue.",
+    "share.submit_clip_fail":  "↗ GitHub abierto. Portapapeles bloqueado — cuerpo volcado en la consola del navegador (F12).",
     "share.import_title":      "📂 Importar un resultado TAF compartido",
+    "a11y.skip":               "Saltar al contenido principal",
     "share.import_desc":       "¿Tienes un fichero JSON del análisis TAF de alguien? Cárgalo aquí para ver el veredicto + cadena localmente. La misma vista que si lo hubieras ejecutado tú.",
     "share.import_btn":        "📂 Cargar JSON compartido",
     "synthesis.system":        "Eres un asistente de diagnóstico preciso para LLMs transformer. Dados resultados de fórmulas TAF pre-calculados, escribe un resumen claro en español de 4-6 frases. Cita el número de sección (§X.Y) para cada número que menciones. Da siempre una recomendación concreta. NO inventes números.",
     "share.btn":               "🔗 Copier le lien",
     "share.copied":            "✅ Copié dans le presse-papiers!",
     "share.download":          "💾 Télécharger JSON",
+    "share.download_md":       "📝 Markdown",
+    "share.download_tex":      "📜 LaTeX",
     "share.submit":            "📤 Soumettre au registry",
+    "share.submit_clip_ok":    "↗ GitHub ouvert. Corps copié dans le presse-papiers — collez-le dans le corps de l'issue.",
+    "share.submit_clip_fail":  "↗ GitHub ouvert. Presse-papiers bloqué — corps dans la console du navigateur (F12).",
     "share.import_title":      "📂 Importer un résultat TAF partagé",
+    "a11y.skip":               "Aller au contenu principal",
     "share.import_desc":       "Vous avez un fichier JSON de l'analyse TAF de quelqu'un ? Chargez-le ici pour voir le verdict + la chaîne localement. La même vue que si vous l'aviez exécuté vous-même.",
     "share.import_btn":        "📂 Charger JSON partagé",
     "synthesis.system":        "Vous êtes un assistant de diagnostic précis pour LLMs transformer. Étant donné des résultats de formules TAF pré-calculés, écrivez un résumé clair en français de 4-6 phrases. Citez le numéro de section (§X.Y) pour chaque nombre mentionné. Donnez toujours une recommandation concrète. N'INVENTEZ PAS de nombres.",
     "share.btn":               "🔗 复制分享链接",
     "share.copied":            "✅ 已复制到剪贴板!",
     "share.download":          "💾 下载 JSON",
+    "share.download_md":       "📝 Markdown",
+    "share.download_tex":      "📜 LaTeX",
     "share.submit":            "📤 提交到 registry",
+    "share.submit_clip_ok":    "↗ 已打开 GitHub。正文已复制到剪贴板——粘贴到 issue 正文。",
+    "share.submit_clip_fail":  "↗ 已打开 GitHub。剪贴板被阻止——正文已写入浏览器控制台 (F12)。",
     "share.import_title":      "📂 导入共享的 TAF 结果",
+    "a11y.skip":               "跳到主要内容",
     "share.import_desc":       "有他人 TAF 分析的 JSON 文件? 在这里加载以本地查看判定 + 链。与您自己运行的视图相同。",
     "share.import_btn":        "📂 加载共享的 JSON",
     "synthesis.system":        "您是 transformer LLM 的精确诊断助手。给定预先计算的 TAF 公式结果,用 4-6 句中文写出清晰的摘要。为每个提到的数字引用章节号 (§X.Y)。始终给出具体建议。不要编造数字。",

js/main.js CHANGED Viewed

@@ -142,8 +142,12 @@ function setStatus(msg) { $("status").textContent = msg; }
 // ════════════════════════════════════════════════════════════════════
 document.querySelectorAll(".mode-btn").forEach(btn => {
   btn.addEventListener("click", () => {
-    document.querySelectorAll(".mode-btn").forEach(b => b.classList.remove("active"));
     btn.classList.add("active");
     const mode = btn.dataset.mode;
     state.currentMode = mode;
     // Hide all mode sections
@@ -1227,6 +1231,8 @@ function renderProfile(p, params) {
           <div class="share-bar">
             <button class="secondary" id="profile-share-btn" data-i18n="share.btn">🔗 Copy share link</button>
             <button class="secondary" id="profile-download-btn" data-i18n="share.download">💾 Download JSON</button>
             <button class="secondary" id="profile-submit-btn" data-i18n="share.submit">📤 Submit to registry</button>
             <span id="profile-share-status" class="subtle"></span>
           </div>
@@ -1268,11 +1274,23 @@ function renderProfile(p, params) {
     $("profile-share-status").textContent = `✅ Downloaded ${filename}`;
     setTimeout(() => $("profile-share-status").textContent = "", 5000);
   });
   $("profile-submit-btn").addEventListener("click", async () => {
-    const url = await buildIssueUrl("profile", p);
-    window.open(url, "_blank");
-    $("profile-share-status").textContent = "↗ Opened GitHub registry (search hash before submitting to avoid duplicate)";
-    setTimeout(() => $("profile-share-status").textContent = "", 6000);
   });
   // v0.6: γ predicted-vs-observed panel — interactive
@@ -1487,6 +1505,8 @@ function renderCompare(cmp) {
     <div class="share-bar">
       <button class="secondary" id="compare-share-btn" data-i18n="share.btn">🔗 Copy share link</button>
       <button class="secondary" id="compare-download-btn" data-i18n="share.download">💾 Download JSON</button>
       <button class="secondary" id="compare-submit-btn" data-i18n="share.submit">📤 Submit to registry</button>
       <span id="compare-share-status" class="subtle"></span>
     </div>
@@ -1505,11 +1525,23 @@ function renderCompare(cmp) {
     $("compare-share-status").textContent = `✅ Downloaded ${filename}`;
     setTimeout(() => $("compare-share-status").textContent = "", 5000);
   });
   $("compare-submit-btn").addEventListener("click", async () => {
-    const url = await buildIssueUrl("compare", cmp);
-    window.open(url, "_blank");
-    $("compare-share-status").textContent = "↗ Opened GitHub registry";
-    setTimeout(() => $("compare-share-status").textContent = "", 6000);
   });
 }
@@ -1576,21 +1608,71 @@ $("recipe-download-btn").addEventListener("click", async () => {
   $("share-status").textContent = `✅ Downloaded ${filename}`;
   setTimeout(() => $("share-status").textContent = "", 5000);
 });
 $("recipe-submit-btn").addEventListener("click", async () => {
   if (!state.lastFullResult) return;
-  const url = await buildIssueUrl("recipe", state.lastFullResult);
-  window.open(url, "_blank");
-  $("share-status").textContent = "↗ Opened GitHub registry (search hash before submitting to avoid duplicate)";
-  setTimeout(() => $("share-status").textContent = "", 6000);
 });
 // ════════════════════════════════════════════════════════════════════
 // Help modal
 // ════════════════════════════════════════════════════════════════════
-$("help-btn").addEventListener("click", () => $("help-modal").classList.add("open"));
-$("help-close").addEventListener("click", () => $("help-modal").classList.remove("open"));
 $("help-modal").addEventListener("click", (e) => {
-  if (e.target.id === "help-modal") $("help-modal").classList.remove("open");
 });
 // ════════════════════════════════════════════════════════════════════
@@ -1609,6 +1691,75 @@ function downloadJSON(filename, data) {
   setTimeout(() => { document.body.removeChild(a); URL.revokeObjectURL(url); }, 100);
 }
 // Sort object keys recursively for deterministic JSON
 function sortKeys(o) {
   if (Array.isArray(o)) return o.map(sortKeys);
@@ -1698,7 +1849,11 @@ async function makeFilename(type, data) {
   return `taf-${type}-${name}-${suffix}-${hash}.json`;
 }
-async function buildIssueUrl(type, data) {
   const hash = await inputHash(type, data);
   const modelName = modelShortName(data, "model");
   let title, body;
@@ -1714,11 +1869,26 @@ async function buildIssueUrl(type, data) {
     body = recipeToMarkdown(data, hash);
   }
   const dedupNote = `\n\n> **Input hash**: \`#${hash}\` — search this hash in registry issues to find independent verifications. Same inputs always produce the same hash.`;
-  const params = new URLSearchParams({
-    title: title,
-    body: body + dedupNote + "\n\n---\n*Submitted via [TAF Agent](https://karlesmarin.github.io/tafagent)*",
-  });
-  return `https://github.com/${REGISTRY_REPO}/issues/new?${params.toString()}`;
 }
 function profileToMarkdown(p, hash="") {

 // ════════════════════════════════════════════════════════════════════
 document.querySelectorAll(".mode-btn").forEach(btn => {
   btn.addEventListener("click", () => {
+    document.querySelectorAll(".mode-btn").forEach(b => {
+      b.classList.remove("active");
+      b.setAttribute("aria-selected", "false");
+    });
     btn.classList.add("active");
+    btn.setAttribute("aria-selected", "true");
     const mode = btn.dataset.mode;
     state.currentMode = mode;
     // Hide all mode sections
           <div class="share-bar">
             <button class="secondary" id="profile-share-btn" data-i18n="share.btn">🔗 Copy share link</button>
             <button class="secondary" id="profile-download-btn" data-i18n="share.download">💾 Download JSON</button>
+            <button class="secondary" id="profile-download-md-btn" data-i18n="share.download_md">📝 Markdown</button>
+            <button class="secondary" id="profile-download-tex-btn" data-i18n="share.download_tex">📜 LaTeX</button>
             <button class="secondary" id="profile-submit-btn" data-i18n="share.submit">📤 Submit to registry</button>
             <span id="profile-share-status" class="subtle"></span>
           </div>
     $("profile-share-status").textContent = `✅ Downloaded ${filename}`;
     setTimeout(() => $("profile-share-status").textContent = "", 5000);
   });
+  $("profile-download-md-btn").addEventListener("click", async () => {
+    const hash = await inputHash("profile", p);
+    const base = (await makeFilename("profile", p)).replace(/\.json$/, "");
+    downloadText(`${base}.md`, profileToMarkdown(p, hash), "text/markdown;charset=utf-8");
+    $("profile-share-status").textContent = `✅ Downloaded ${base}.md`;
+    setTimeout(() => $("profile-share-status").textContent = "", 5000);
+  });
+  $("profile-download-tex-btn").addEventListener("click", async () => {
+    const hash = await inputHash("profile", p);
+    const base = (await makeFilename("profile", p)).replace(/\.json$/, "");
+    downloadText(`${base}.tex`, profileToLatex(p, hash), "application/x-tex;charset=utf-8");
+    $("profile-share-status").textContent = `✅ Downloaded ${base}.tex`;
+    setTimeout(() => $("profile-share-status").textContent = "", 5000);
+  });
   $("profile-submit-btn").addEventListener("click", async () => {
+    await submitToRegistry("profile", p, $("profile-share-status"));
+    setTimeout(() => $("profile-share-status").textContent = "", 8000);
   });
   // v0.6: γ predicted-vs-observed panel — interactive
     <div class="share-bar">
       <button class="secondary" id="compare-share-btn" data-i18n="share.btn">🔗 Copy share link</button>
       <button class="secondary" id="compare-download-btn" data-i18n="share.download">💾 Download JSON</button>
+      <button class="secondary" id="compare-download-md-btn" data-i18n="share.download_md">📝 Markdown</button>
+      <button class="secondary" id="compare-download-tex-btn" data-i18n="share.download_tex">📜 LaTeX</button>
       <button class="secondary" id="compare-submit-btn" data-i18n="share.submit">📤 Submit to registry</button>
       <span id="compare-share-status" class="subtle"></span>
     </div>
     $("compare-share-status").textContent = `✅ Downloaded ${filename}`;
     setTimeout(() => $("compare-share-status").textContent = "", 5000);
   });
+  $("compare-download-md-btn").addEventListener("click", async () => {
+    const hash = await inputHash("compare", cmp);
+    const base = (await makeFilename("compare", cmp)).replace(/\.json$/, "");
+    downloadText(`${base}.md`, compareToMarkdown(cmp, hash), "text/markdown;charset=utf-8");
+    $("compare-share-status").textContent = `✅ Downloaded ${base}.md`;
+    setTimeout(() => $("compare-share-status").textContent = "", 5000);
+  });
+  $("compare-download-tex-btn").addEventListener("click", async () => {
+    const hash = await inputHash("compare", cmp);
+    const base = (await makeFilename("compare", cmp)).replace(/\.json$/, "");
+    downloadText(`${base}.tex`, compareToLatex(cmp, hash), "application/x-tex;charset=utf-8");
+    $("compare-share-status").textContent = `✅ Downloaded ${base}.tex`;
+    setTimeout(() => $("compare-share-status").textContent = "", 5000);
+  });
   $("compare-submit-btn").addEventListener("click", async () => {
+    await submitToRegistry("compare", cmp, $("compare-share-status"));
+    setTimeout(() => $("compare-share-status").textContent = "", 8000);
   });
 }
   $("share-status").textContent = `✅ Downloaded ${filename}`;
   setTimeout(() => $("share-status").textContent = "", 5000);
 });
+$("recipe-download-md-btn").addEventListener("click", async () => {
+  if (!state.lastFullResult) return;
+  const r = state.lastFullResult;
+  const hash = await inputHash("recipe", r);
+  const base = (await makeFilename("recipe", r)).replace(/\.json$/, "");
+  downloadText(`${base}.md`, recipeToMarkdown(r, hash), "text/markdown;charset=utf-8");
+  $("share-status").textContent = `✅ Downloaded ${base}.md`;
+  setTimeout(() => $("share-status").textContent = "", 5000);
+});
+$("recipe-download-tex-btn").addEventListener("click", async () => {
+  if (!state.lastFullResult) return;
+  const r = state.lastFullResult;
+  const hash = await inputHash("recipe", r);
+  const base = (await makeFilename("recipe", r)).replace(/\.json$/, "");
+  downloadText(`${base}.tex`, recipeToLatex(r, hash), "application/x-tex;charset=utf-8");
+  $("share-status").textContent = `✅ Downloaded ${base}.tex`;
+  setTimeout(() => $("share-status").textContent = "", 5000);
+});
 $("recipe-submit-btn").addEventListener("click", async () => {
   if (!state.lastFullResult) return;
+  await submitToRegistry("recipe", state.lastFullResult, $("share-status"));
+  setTimeout(() => $("share-status").textContent = "", 8000);
 });
 // ════════════════════════════════════════════════════════════════════
 // Help modal
 // ════════════════════════════════════════════════════════════════════
+// a11y: focus trap + restore + Esc handling for the help modal.
+let __helpModalReturnFocus = null;
+function openHelpModal() {
+  const modal = $("help-modal");
+  __helpModalReturnFocus = document.activeElement;
+  modal.classList.add("open");
+  modal.setAttribute("aria-hidden", "false");
+  // Defer focus shift so the click that opened the modal isn't swallowed.
+  setTimeout(() => $("help-close")?.focus(), 0);
+}
+function closeHelpModal() {
+  const modal = $("help-modal");
+  modal.classList.remove("open");
+  modal.setAttribute("aria-hidden", "true");
+  if (__helpModalReturnFocus && typeof __helpModalReturnFocus.focus === "function") {
+    __helpModalReturnFocus.focus();
+  }
+  __helpModalReturnFocus = null;
+}
+$("help-btn").addEventListener("click", openHelpModal);
+$("help-close").addEventListener("click", closeHelpModal);
 $("help-modal").addEventListener("click", (e) => {
+  if (e.target.id === "help-modal") closeHelpModal();
+});
+// Esc closes; Tab cycles within modal when open.
+document.addEventListener("keydown", (e) => {
+  const modal = $("help-modal");
+  if (!modal.classList.contains("open")) return;
+  if (e.key === "Escape") { e.preventDefault(); closeHelpModal(); return; }
+  if (e.key !== "Tab") return;
+  const focusables = modal.querySelectorAll(
+    'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])'
+  );
+  if (!focusables.length) return;
+  const first = focusables[0];
+  const last = focusables[focusables.length - 1];
+  if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
+  else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
 });
 // ════════════════════════════════════════════════════════════════════
   setTimeout(() => { document.body.removeChild(a); URL.revokeObjectURL(url); }, 100);
 }
+function downloadText(filename, text, mime = "text/plain;charset=utf-8") {
+  const blob = new Blob([text], { type: mime });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = filename;
+  document.body.appendChild(a);
+  a.click();
+  setTimeout(() => { document.body.removeChild(a); URL.revokeObjectURL(url); }, 100);
+}
+// LaTeX-escape a plain string for inclusion in a tabular cell.
+function latexEscape(s) {
+  return String(s ?? "")
+    .replace(/\\/g, "\\textbackslash{}")
+    .replace(/[#$%&_{}]/g, m => "\\" + m)
+    .replace(/~/g, "\\textasciitilde{}")
+    .replace(/\^/g, "\\textasciicircum{}")
+    .replace(/</g, "\\textless{}")
+    .replace(/>/g, "\\textgreater{}");
+}
+function profileToLatex(p, hash = "") {
+  const ms = p.model_summary || {};
+  const kn = p.key_numbers || {};
+  let tex = `% TAF Profile — auto-generated by TAF Agent\n`;
+  if (hash) tex += `% input hash: #${hash}\n`;
+  tex += `\\begin{table}[ht]\n\\centering\n`;
+  tex += `\\caption{TAF Profile — ${latexEscape(ms.architecture_class || "?")}${hash ? ` (\\#${latexEscape(hash)})` : ""}}\n`;
+  tex += `\\begin{tabular}{lll}\n\\toprule\nRecipe & Verdict & Reason \\\\\n\\midrule\n`;
+  Object.entries(p.recipes || {}).forEach(([rid, r]) => {
+    tex += `${latexEscape(rid)} & ${latexEscape(r.verdict || "")} & ${latexEscape((r.reason || "").slice(0, 80))} \\\\\n`;
+  });
+  tex += `\\bottomrule\n\\end{tabular}\n\\end{table}\n\n`;
+  tex += `% Key numbers (JSON):\n`;
+  for (const [k, v] of Object.entries(kn)) {
+    tex += `% ${k} = ${typeof v === "object" ? JSON.stringify(v) : v}\n`;
+  }
+  return tex;
+}
+function compareToLatex(c, hash = "") {
+  let tex = `% TAF Comparison — ${c.recipe_id} (${c.recipe_name})\n`;
+  if (hash) tex += `% input hash: #${hash}\n`;
+  tex += `\\begin{table}[ht]\n\\centering\n`;
+  tex += `\\caption{TAF Comparison — ${latexEscape(c.recipe_id)} ${latexEscape(c.recipe_name || "")}${hash ? ` (\\#${latexEscape(hash)})` : ""}}\n`;
+  tex += `\\begin{tabular}{lll}\n\\toprule\nModel & Verdict & Reason \\\\\n\\midrule\n`;
+  c.rows.forEach(r => {
+    tex += `${latexEscape(r.label)} & ${latexEscape(r.verdict)} & ${latexEscape((r.reason || "").slice(0, 80))} \\\\\n`;
+  });
+  tex += `\\bottomrule\n\\end{tabular}\n\\end{table}\n`;
+  return tex;
+}
+function recipeToLatex(r, hash = "") {
+  let tex = `% TAF Recipe ${r.recipe_id} — ${r.recipe_name}\n`;
+  if (hash) tex += `% input hash: #${hash}\n`;
+  tex += `\\begin{table}[ht]\n\\centering\n`;
+  tex += `\\caption{TAF Recipe \\texttt{${latexEscape(r.recipe_id)}} — verdict: ${latexEscape(r.verdict)}${hash ? ` (\\#${latexEscape(hash)})` : ""}}\n`;
+  tex += `\\begin{tabular}{rll}\n\\toprule\nStep & Formula & Result \\\\\n\\midrule\n`;
+  (r.chain || []).forEach(s => {
+    tex += `${latexEscape(s.step)} & \\texttt{${latexEscape(s.formula || "")}} & ${latexEscape(formatResultPlain(s.result))} \\\\\n`;
+  });
+  tex += `\\bottomrule\n\\end{tabular}\n\\end{table}\n\n`;
+  tex += `% Reason: ${latexEscape(r.reason || "")}\n`;
+  if (r.mitigation) tex += `% Mitigation: ${latexEscape(r.mitigation)}\n`;
+  return tex;
+}
 // Sort object keys recursively for deterministic JSON
 function sortKeys(o) {
   if (Array.isArray(o)) return o.map(sortKeys);
   return `taf-${type}-${name}-${suffix}-${hash}.json`;
 }
+// v0.6 privacy fix: previously placed full JSON body in URL params → GH server logs +
+// referer headers captured user data. Now copy body to clipboard, open issue page
+// with title only, user pastes body manually. Title is non-sensitive (model name +
+// hash). On clipboard failure, fall back to console log so user can grab body.
+async function submitToRegistry(type, data, statusEl) {
   const hash = await inputHash(type, data);
   const modelName = modelShortName(data, "model");
   let title, body;
     body = recipeToMarkdown(data, hash);
   }
   const dedupNote = `\n\n> **Input hash**: \`#${hash}\` — search this hash in registry issues to find independent verifications. Same inputs always produce the same hash.`;
+  const fullBody = body + dedupNote + "\n\n---\n*Submitted via [TAF Agent](https://karlesmarin.github.io/tafagent)*";
+  let clipboardOk = false;
+  try {
+    await navigator.clipboard.writeText(fullBody);
+    clipboardOk = true;
+  } catch (e) {
+    console.warn("Clipboard write failed; body logged below:", e);
+    console.log("[TAF Agent] Issue body to paste:\n\n" + fullBody);
+  }
+  // Title-only URL — body intentionally omitted to avoid leaking via GH server logs / referer.
+  const params = new URLSearchParams({ title });
+  window.open(`https://github.com/${REGISTRY_REPO}/issues/new?${params.toString()}`, "_blank");
+  if (statusEl) {
+    statusEl.textContent = clipboardOk
+      ? (t("share.submit_clip_ok") || "↗ Opened GitHub. Body copied to clipboard — paste it into the issue body.")
+      : (t("share.submit_clip_fail") || "↗ Opened GitHub. Clipboard blocked — body logged in browser console (F12).");
+  }
 }
 function profileToMarkdown(p, hash="") {

scripts/README.md ADDED Viewed

	@@ -0,0 +1,38 @@

+# scripts/
+## `check_lean_manifest.py`
+Cross-checks `data/lean_status.json` against the actual `lean-taf` Lean source repo. Run before pushing to catch:
+- Theorems renamed / deleted in source but still in manifest.
+- Line numbers in manifest no longer matching the source declaration (e.g. after a refactor moved theorems).
+- New theorems in source not yet captured in manifest.
+- Commit-hash drift between manifest and current `lean-taf` HEAD.
+### Usage
+```bash
+# default — auto-detects ../lean-taf or ../NeurIPS/lean_taf/taf
+python scripts/check_lean_manifest.py
+# explicit path
+python scripts/check_lean_manifest.py --lean-taf-path /path/to/lean-taf
+# rewrite manifest in-place to match source (backs up to .bak first)
+python scripts/check_lean_manifest.py --regenerate
+```
+Exit 0 = clean, 1 = drift detected. Suitable as a pre-push hook or CI gate once `lean-taf` is checked out alongside.
+### Workflow
+1. After committing changes in `lean-taf` (renaming a theorem, adding a new one, etc.):
+2. In `tafagent/`, run `python scripts/check_lean_manifest.py` to see what drifted.
+3. If line numbers shifted but theorem set is unchanged: `python scripts/check_lean_manifest.py --regenerate` rewrites in-place.
+4. If new theorems appeared: regenerate captures them with `file`/`line` only — manually fill `claim`, `tactic`, `tags`, etc. before committing.
+5. Commit `data/lean_status.json` to `tafagent`.
+### What `--regenerate` preserves vs overwrites
+- **Overwrites**: `file`, `line`, `lean_repo.commit`, `lean_repo.commit_short`.
+- **Preserves**: `claim`, `tactic`, `preconditions`, `status`, `tags`, `source`, `ui_badge`, plus `findings`, `groups[].title/id`, `summary`, `ui_bindings`. The schema is rewritten with the same keys — anything not derivable from source is kept verbatim.

scripts/check_lean_manifest.py ADDED Viewed

	@@ -0,0 +1,231 @@

+#!/usr/bin/env python3
+"""Cross-check tafagent's lean_status.json against the lean-taf source repo.
+Detects three kinds of drift:
+  1. Theorem named in manifest but missing from source file.
+  2. Line number in manifest no longer matches the source declaration.
+  3. Theorem present in source `theorem <name>` but absent from manifest.
+Usage:
+    python scripts/check_lean_manifest.py
+    python scripts/check_lean_manifest.py --lean-taf-path /path/to/lean-taf
+    python scripts/check_lean_manifest.py --regenerate    # rewrite line numbers in-place
+By default looks for `../lean-taf` and `../NeurIPS/lean_taf/taf` (developer layout).
+Set LEAN_TAF_PATH to override. Exit 0 = clean, 1 = drift detected (CI gate).
+"""
+from __future__ import annotations
+import argparse
+import json
+import os
+import re
+import sys
+import subprocess
+from pathlib import Path
+THEOREM_RE = re.compile(r"^\s*theorem\s+([A-Za-z_][A-Za-z0-9_]*)\b")
+REPO_ROOT = Path(__file__).resolve().parent.parent
+MANIFEST = REPO_ROOT / "data" / "lean_status.json"
+LEAN_TAF_CANDIDATES = [
+    REPO_ROOT.parent / "lean-taf",
+    REPO_ROOT.parent / "NeurIPS" / "lean_taf" / "taf",
+]
+def find_lean_taf(arg_path: str | None) -> Path:
+    if arg_path:
+        p = Path(arg_path).expanduser().resolve()
+        if (p / "Taf.lean").exists():
+            return p
+        sys.exit(f"error: {p} does not contain Taf.lean — wrong path?")
+    env = os.environ.get("LEAN_TAF_PATH")
+    if env:
+        return find_lean_taf(env)
+    for c in LEAN_TAF_CANDIDATES:
+        if (c / "Taf.lean").exists():
+            return c.resolve()
+    sys.exit("error: lean-taf repo not found. Set LEAN_TAF_PATH or pass --lean-taf-path.")
+def grep_theorems(lean_root: Path) -> dict[str, tuple[str, int]]:
+    """Return {theorem_name: (relative_file, line_number)} from Taf/*.lean."""
+    out: dict[str, tuple[str, int]] = {}
+    for lean_file in (lean_root / "Taf").glob("*.lean"):
+        rel = f"Taf/{lean_file.name}"
+        with lean_file.open(encoding="utf-8") as f:
+            for lineno, line in enumerate(f, start=1):
+                m = THEOREM_RE.match(line)
+                if m:
+                    name = m.group(1)
+                    if name in out:
+                        # Duplicate theorem name across files (Lean would also reject) — flag.
+                        print(f"warn: duplicate theorem name {name!r} at {rel}:{lineno} "
+                              f"and {out[name][0]}:{out[name][1]}", file=sys.stderr)
+                    out[name] = (rel, lineno)
+    return out
+def get_lean_taf_head(lean_root: Path) -> str | None:
+    try:
+        return subprocess.check_output(
+            ["git", "-C", str(lean_root), "rev-parse", "--short", "HEAD"],
+            stderr=subprocess.DEVNULL,
+        ).decode().strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return None
+def manifest_theorems(manifest: dict) -> list[dict]:
+    out = []
+    for group in manifest.get("groups", []):
+        for t in group.get("theorems", []):
+            out.append(t)
+    return out
+def check(manifest: dict, lean_root: Path) -> tuple[int, list[dict]]:
+    """Return (number_of_drifts, list_of_drift_records)."""
+    src = grep_theorems(lean_root)
+    drifts: list[dict] = []
+    seen_in_manifest: set[str] = set()
+    for t in manifest_theorems(manifest):
+        name = t["name"]
+        seen_in_manifest.add(name)
+        if name not in src:
+            drifts.append({"kind": "missing_in_source", "name": name,
+                           "manifest_file": t.get("file"), "manifest_line": t.get("line")})
+            continue
+        src_file, src_line = src[name]
+        if t.get("file") != src_file:
+            drifts.append({"kind": "file_drift", "name": name,
+                           "manifest_file": t.get("file"), "source_file": src_file})
+        if t.get("line") != src_line:
+            drifts.append({"kind": "line_drift", "name": name,
+                           "manifest_line": t.get("line"), "source_line": src_line,
+                           "file": src_file})
+    for name, (src_file, src_line) in src.items():
+        if name not in seen_in_manifest:
+            drifts.append({"kind": "missing_in_manifest", "name": name,
+                           "source_file": src_file, "source_line": src_line})
+    # Commit-hash sanity check.
+    head = get_lean_taf_head(lean_root)
+    declared = manifest.get("lean_repo", {}).get("commit_short")
+    if head and declared and head != declared:
+        drifts.append({"kind": "commit_drift", "manifest_commit": declared, "head_commit": head})
+    return len(drifts), drifts
+def regenerate(manifest: dict, lean_root: Path) -> int:
+    """Rewrite line numbers (and file paths) in-place. Preserves claims, tactics, etc.
+    Returns count of theorems updated."""
+    src = grep_theorems(lean_root)
+    updated = 0
+    for group in manifest.get("groups", []):
+        for t in group.get("theorems", []):
+            name = t["name"]
+            if name in src:
+                src_file, src_line = src[name]
+                if t.get("file") != src_file or t.get("line") != src_line:
+                    t["file"] = src_file
+                    t["line"] = src_line
+                    updated += 1
+    head = get_lean_taf_head(lean_root)
+    if head:
+        manifest.setdefault("lean_repo", {})["commit_short"] = head
+        try:
+            full = subprocess.check_output(
+                ["git", "-C", str(lean_root), "rev-parse", "HEAD"],
+                stderr=subprocess.DEVNULL,
+            ).decode().strip()
+            manifest["lean_repo"]["commit"] = full
+        except (subprocess.CalledProcessError, FileNotFoundError):
+            pass
+    return updated
+# Drift kinds split by severity. ERROR kinds break the badges (manifest references
+# something the source doesn't have, or points at the wrong line). INFO kinds are
+# advisory — new helpers in source, or the manifest predates a doc-only commit.
+ERROR_KINDS = {"missing_in_source", "file_drift", "line_drift"}
+INFO_KINDS = {"missing_in_manifest", "commit_drift"}
+def format_drift(d: dict) -> str:
+    k = d["kind"]
+    if k == "missing_in_source":
+        return f"  [ERR] MISSING in source: {d['name']} (manifest claims {d['manifest_file']}:{d['manifest_line']})"
+    if k == "file_drift":
+        return f"  [ERR] FILE drift: {d['name']} -- manifest={d['manifest_file']} source={d['source_file']}"
+    if k == "line_drift":
+        return f"  [ERR] LINE drift: {d['name']} in {d['file']} -- manifest={d['manifest_line']} source={d['source_line']}"
+    if k == "missing_in_manifest":
+        return f"  [info] new in source: {d['name']} at {d['source_file']}:{d['source_line']} (not in manifest -- helper or unmapped)"
+    if k == "commit_drift":
+        return f"  [info] commit drift: manifest={d['manifest_commit']} head={d['head_commit']} (regenerate to update)"
+    return f"  [?] unknown drift kind: {d}"
+def main() -> int:
+    # Force UTF-8 stdout so emoji / non-ASCII labels survive Windows cp1252 console.
+    try:
+        sys.stdout.reconfigure(encoding="utf-8")
+    except Exception:
+        pass
+    ap = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
+    ap.add_argument("--lean-taf-path", help="Path to lean-taf repo (default: env LEAN_TAF_PATH or ../lean-taf or ../NeurIPS/lean_taf/taf)")
+    ap.add_argument("--regenerate", action="store_true", help="Rewrite manifest line numbers + commit hash to match source. Backs up to lean_status.json.bak.")
+    ap.add_argument("--manifest", default=str(MANIFEST), help="Path to lean_status.json (default: data/lean_status.json)")
+    ap.add_argument("--strict", action="store_true", help="Treat info-level drifts (commit, new-in-source) as errors too.")
+    args = ap.parse_args()
+    lean_root = find_lean_taf(args.lean_taf_path)
+    manifest_path = Path(args.manifest)
+    with manifest_path.open(encoding="utf-8") as f:
+        manifest = json.load(f)
+    if args.regenerate:
+        backup = manifest_path.with_suffix(".json.bak")
+        backup.write_text(json.dumps(manifest, indent=2, ensure_ascii=False), encoding="utf-8")
+        n = regenerate(manifest, lean_root)
+        manifest_path.write_text(json.dumps(manifest, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+        print(f"regenerated: {n} theorem(s) updated. backup → {backup.name}")
+        return 0
+    _, drifts = check(manifest, lean_root)
+    src_total = len(grep_theorems(lean_root))
+    manifest_total = len(manifest_theorems(manifest))
+    head = get_lean_taf_head(lean_root) or "?"
+    errors = [d for d in drifts if d["kind"] in ERROR_KINDS]
+    infos = [d for d in drifts if d["kind"] in INFO_KINDS]
+    print(f"manifest: {manifest_total} theorems  source: {src_total} theorems")
+    print(f"manifest commit: {manifest.get('lean_repo', {}).get('commit_short', '?')}  head: {head}")
+    print(f"lean_taf path: {lean_root}")
+    print()
+    if errors:
+        print(f"ERRORS ({len(errors)}):")
+        for d in errors:
+            print(format_drift(d))
+        print()
+    if infos:
+        print(f"INFO ({len(infos)}):")
+        for d in infos:
+            print(format_drift(d))
+        print()
+    if not errors and not infos:
+        print("OK -- no drift.")
+        return 0
+    if errors or (args.strict and infos):
+        print("Fix: re-run with --regenerate, then commit data/lean_status.json.")
+        return 1
+    print("OK -- only info-level drift; pass --strict to fail on these too.")
+    return 0
+if __name__ == "__main__":
+    sys.exit(main())

style.css CHANGED Viewed

@@ -1,4 +1,19 @@
 /* TAF Agent — minimal clean styling */
 :root {
   --bg: #0a0e14;
   --bg-card: #12181f;

 /* TAF Agent — minimal clean styling */
+/* a11y: skip-to-main link, visible only on keyboard focus */
+.skip-link {
+  position: absolute;
+  left: 0; top: -40px;
+  background: #58a6ff;
+  color: #0a0e14;
+  padding: 0.5em 1em;
+  text-decoration: none;
+  font-weight: 600;
+  z-index: 9999;
+  transition: top 0.15s;
+}
+.skip-link:focus { top: 0; outline: 2px solid #fff; }
 :root {
   --bg: #0a0e14;
   --bg-card: #12181f;