codebase-onboarder 0.6.0 → 1.0.0

package/public/js/about.js

@@ -4,38 +4,34 @@
 // The rendering needs the DOM, but the parts worth checking — the coverage
 // prose, the GitHub URL parsing, date formatting — are pure and exported for
 // that reason. Nothing here runs at import time.
-
 import { escapeHtml } from './html.js';
 import { state } from './state.js';
 import { streamExplain } from './api.js';
 import { mdLite } from './markdown.js';
 import * as llm from './llm.js';
-
 let host = null;
-let hooks = { onToast: () => {}, onOpenSettings: () => {}, repoOverview: () => '' };
-
+let hooks = { onToast: (..._args) => { }, onOpenSettings: (..._args) => { }, repoOverview: () => '' };
 export function initAbout(options) {
-  host = options.host;
-  hooks = { ...hooks, ...options };
-  host.addEventListener('click', (event) => {
-    const b = event.target.closest('[data-stack-sum]');
-    if (b) summarizeStackItem(b.dataset.stackSum);
-  });
+    host = options.host;
+    hooks = { ...hooks, ...options };
+    host.addEventListener('click', (event) => {
+        const b = event.target.closest('[data-stack-sum]');
+        if (b)
+            summarizeStackItem(b.dataset.stackSum);
+    });
 }
-
 export function renderAbout() {
-  if (state.about.rendered) return;
-  state.about.rendered = true;
-  const { scan, facts } = state;
-  const gh = scan.gitUrl ? githubRepoPath(scan.gitUrl) : null;
-
-  const sourceLine = scan.gitUrl
-    ? `Cloned from ${scan.gitUrl}`
-    : state.browserSource
-      ? 'Picked in the browser — files never left this tab.'
-      : `Read in place from ${scan.root}`;
-
-  host.innerHTML = `
+    if (state.about.rendered)
+        return;
+    state.about.rendered = true;
+    const { scan, facts } = state;
+    const gh = scan.gitUrl ? githubRepoPath(scan.gitUrl) : null;
+    const sourceLine = scan.gitUrl
+        ? `Cloned from ${scan.gitUrl}`
+        : state.browserSource
+            ? 'Picked in the browser — files never left this tab.'
+            : `Read in place from ${scan.root}`;
+    host.innerHTML = `
     <div class="doc-page">
       <h1 class="doc-title">${escapeHtml(scan.name)}</h1>
       <p class="doc-sub">${escapeHtml(scan.tempId ? scan.tempId + ' — a temp clone' : scan.root)}</p>
@@ -56,11 +52,9 @@ export function renderAbout() {
       ${renderHistorySection(state.history)}
 
       <h2 class="doc-section-h">From the remote</h2>
-      <div id="aboutRemote">${
-        gh
-          ? '<span class="doc-readme-none">Asking GitHub…</span>'
-          : `<span class="doc-readme-none">${scan.gitUrl ? 'Not a GitHub URL — no remote facts to fetch.' : 'A local repo — no remote to ask about.'}</span>`
-      }</div>
+      <div id="aboutRemote">${gh
+        ? '<span class="doc-readme-none">Asking GitHub…</span>'
+        : `<span class="doc-readme-none">${scan.gitUrl ? 'Not a GitHub URL — no remote facts to fetch.' : 'A local repo — no remote to ask about.'}</span>`}</div>
 
       <h2 class="doc-section-h">Lineage</h2>
       <ul class="about-lineage">
@@ -69,17 +63,18 @@ export function renderAbout() {
         ${scan.tempId ? `<li>The clone lives in your temp folder as <code>${escapeHtml(scan.tempId)}</code> until you hit New repo.</li>` : ''}
       </ul>
     </div>`;
-
-  if (gh) loadRemoteInfo(gh);
-  if (state.stack) renderStackZone(host.querySelector('#stackZone'));
+    if (gh)
+        loadRemoteInfo(gh);
+    if (state.stack)
+        renderStackZone(host.querySelector('#stackZone'));
 }
-
 function renderHistorySection(h) {
-  if (!h) return '';
-  if (!h.available) {
-    return `<h2 class="doc-section-h">History</h2><p class="doc-readme-none">${escapeHtml(h.reason || 'No history available.')}</p>`;
-  }
-  return `
+    if (!h)
+        return '';
+    if (!h.available) {
+        return `<h2 class="doc-section-h">History</h2><p class="doc-readme-none">${escapeHtml(h.reason || 'No history available.')}</p>`;
+    }
+    return `
     <h2 class="doc-section-h">History & Activity</h2>
     <div class="about-numbers">
       ${aboutNum(h.commitCount, h.truncated ? 'commits analyzed' : 'commits')}
@@ -93,20 +88,16 @@ function renderHistorySection(h) {
     </ul>
   `;
 }
-
 // ---- Stack: detected languages, package managers, and frameworks ----------
-
 function renderStackZone(zone) {
-  const st = state.stack;
-  if (!st) return (zone.innerHTML = '');
-
-  const langs = Object.entries(st.languages)
-    .map(([name, count]) => `<span class="stack-lang"><i>${count}</i> ${escapeHtml(name)}</span>`)
-    .join('');
-
-  const rows = st.items
-    .map(
-      (it) => `
+    const st = state.stack;
+    if (!st)
+        return (zone.innerHTML = '');
+    const langs = Object.entries(st.languages)
+        .map(([name, count]) => `<span class="stack-lang"><i>${count}</i> ${escapeHtml(name)}</span>`)
+        .join('');
+    const rows = st.items
+        .map((it) => `
       <div class="stack-item">
         <span class="stack-name">${escapeHtml(it.name)}</span>
         <span class="stack-cat">${escapeHtml(it.category)}</span>
@@ -116,11 +107,9 @@ function renderStackZone(zone) {
         <a class="stack-doc" href="${escapeHtml(it.docs)}" target="_blank" rel="noopener">docs ↗</a>
         <button class="stack-sum" data-stack-sum="${escapeHtml(it.name)}" title="Summarize from official docs">summarize</button>
         <div class="stack-body" data-stack-body></div>
-      </div>`
-    )
-    .join('');
-
-  zone.innerHTML = `
+      </div>`)
+        .join('');
+    zone.innerHTML = `
     <div class="stack-block">
       <div class="stack-langs">${langs || '<span class="doc-readme-none">No languages parsed.</span>'}</div>
       ${st.pm.length ? `<p class="stack-pm">package managers: ${escapeHtml(st.pm.join(', '))}</p>` : ''}
@@ -130,115 +119,105 @@ function renderStackZone(zone) {
         : '<p class="doc-readme-none">No declared dependencies — nothing to analyze.</p>'}
     </div>`;
 }
-
 // Fetch a library's official docs (server-side, SSRF-safe) and summarize it
 // with the AI, streamed into the row.
 async function summarizeStackItem(name) {
-  const item = state.stack.items.find((i) => i.name === name);
-  if (!item) return hooks.onToast('Unknown dependency.');
-  if (!llm.isConfigured()) {
-    hooks.onOpenSettings();
-    return hooks.onToast('Add an endpoint and model first.');
-  }
-  const row = host.querySelector(`[data-stack-sum="${CSS.escape(name)}"]`)?.closest('.stack-item');
-  const body = row?.querySelector('[data-stack-body]');
-  if (!body) return;
-
-  row.querySelector('.stack-sum').textContent = 'looking…';
-  row.querySelector('.stack-sum').disabled = true;
-
-  let docsText = '';
-  let docsTitle = '';
-  try {
-    const r = await fetch('/api/doc', {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ url: item.docs }),
+    const item = state.stack.items.find((i) => i.name === name);
+    if (!item)
+        return hooks.onToast('Unknown dependency.');
+    if (!llm.isConfigured()) {
+        hooks.onOpenSettings();
+        return hooks.onToast('Choose Hermes or an endpoint in AI connection first.');
+    }
+    const row = host.querySelector(`[data-stack-sum="${CSS.escape(name)}"]`)?.closest('.stack-item');
+    const body = row?.querySelector('[data-stack-body]');
+    if (!body)
+        return;
+    row.querySelector('.stack-sum').textContent = 'looking…';
+    row.querySelector('.stack-sum').disabled = true;
+    let docsText = '';
+    let docsTitle = '';
+    try {
+        const r = await fetch('/api/doc', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ url: item.docs }),
+        });
+        const j = await r.json();
+        if (j.text) {
+            docsText = j.text;
+            docsTitle = j.title || item.docs;
+        }
+    }
+    catch { /* summarized from knowledge */ }
+    body.innerHTML = '<br><div class="stack-body-text"><span class="caret"></span></div>';
+    const slot = body.querySelector('.stack-body-text');
+    const settings = llm.getSettings();
+    const messages = llm.stackSummaryMessages({
+        repoName: state.scan.name,
+        item,
+        docsText,
+        repoNote: hooks.repoOverview(),
     });
-    const j = await r.json();
-    if (j.text) {
-      docsText = j.text;
-      docsTitle = j.title || item.docs;
+    let text = '';
+    try {
+        for await (const delta of streamExplain({ ...settings, messages, maxTokens: 700 })) {
+            text += delta;
+            slot.innerHTML = mdLite(text) + '<span class="caret"></span>';
+        }
+        slot.innerHTML = mdLite(text)
+            + `<p class="explain-src">${docsText ? `From ${escapeHtml(docsTitle)}` : 'No docs fetched — general knowledge'} · ${escapeHtml(settings.model)}</p>`;
     }
-  } catch { /* summarized from knowledge */ }
-
-  body.innerHTML = '<br><div class="stack-body-text"><span class="caret"></span></div>';
-  const slot = body.querySelector('.stack-body-text');
-  const settings = llm.getSettings();
-  const messages = llm.stackSummaryMessages({
-    repoName: state.scan.name,
-    item,
-    docsText,
-    repoNote: hooks.repoOverview(),
-  });
-  let text = '';
-  try {
-    for await (const delta of streamExplain({ ...settings, messages, maxTokens: 700 })) {
-      text += delta;
-      slot.innerHTML = mdLite(text) + '<span class="caret"></span>';
+    catch (err) {
+        slot.innerHTML = `<p style="color:var(--warn)">${escapeHtml(err.message)}</p>`;
     }
-    slot.innerHTML = mdLite(text)
-      + `<p class="explain-src">${docsText ? `From ${escapeHtml(docsTitle)}` : 'No docs fetched — general knowledge'} · ${settings.model}</p>`;
-  } catch (err) {
-    slot.innerHTML = `<p style="color:var(--warn)">${escapeHtml(err.message)}</p>`;
-  } finally {
-    const btn = row.querySelector('.stack-sum');
-    if (btn) {
-      btn.textContent = body.textContent.trim() ? 'summarize again' : 'summarize';
-      btn.disabled = false;
+    finally {
+        const btn = row.querySelector('.stack-sum');
+        if (btn) {
+            btn.textContent = body.textContent.trim() ? 'summarize again' : 'summarize';
+            btn.disabled = false;
+        }
     }
-  }
 }
-
 // ---- the pure parts -------------------------------------------------------
-
 export function aboutNum(value, label) {
-  return `<div class="about-num"><b>${value}</b><span>${label}</span></div>`;
+    return `<div class="about-num"><b>${value}</b><span>${label}</span></div>`;
 }
-
 // What the scan left out, itemized. The line here used to read "N files skipped
 // by the ignore rules", which was one number covering eight unrelated reasons —
 // most of them not the ignore rules at all.
 export function lineageCoverage(scan) {
-  const s = scan.stats;
-  const k = s.skips || {};
-  const out = [];
-
-  if (s.truncated) {
-    out.push(
-      `<li><b>Partial scan.</b> Stopped at the ${s.truncated.atFiles}-file cap with ` +
-      `${s.truncated.dirsQueued} ${s.truncated.dirsQueued === 1 ? 'directory' : 'directories'} ` +
-      `still unvisited — every count below is a floor, not a total.</li>`
-    );
-  }
-
-  const reasons = [
-    [k.ignored, 'matched .gitignore'],
-    [k.vendorDir, 'in vendor or build folders'],
-    [k.notSource, 'not source (images, lockfiles, bundles)'],
-    [k.notCode, 'no analyzer for the extension'],
-    [k.tooLarge, 'over the size cap'],
-    [k.readFailed, 'could not be read'],
-    [k.analyzeFailed, 'could not be parsed'],
-    [k.listFailed, 'directories that would not list'],
-  ].filter(([n]) => n > 0).map(([n, why]) => `${n} ${why}`);
-  if (reasons.length) {
-    out.push(`<li>${s.filesParsed} of ${s.filesTotal} files analyzed. Left out: ${reasons.join('; ')}.</li>`);
-  }
-
-  const imp = s.imports;
-  if (imp?.total) {
-    const worst = imp.worst?.length
-      ? ` Most common misses: ${imp.worst.slice(0, 3).map((w) => `<code>${escapeHtml(w.spec)}</code>`).join(', ')}.`
-      : '';
-    out.push(
-      `<li><b>${imp.confidence}% of ${imp.total} imports placed</b> — ${imp.internal} internal, ` +
-      `${imp.external} external packages, ${imp.unresolved} unresolved.${imp.unresolved ? worst : ''}</li>`
-    );
-  }
-  return out.join('\n');
+    const s = scan.stats;
+    const k = s.skips || {};
+    const out = [];
+    if (s.truncated) {
+        out.push(`<li><b>Partial scan.</b> Stopped at the ${s.truncated.atFiles}-file cap with ` +
+            `${s.truncated.dirsQueued} ${s.truncated.dirsQueued === 1 ? 'directory' : 'directories'} ` +
+            `still unvisited — every count below is a floor, not a total.</li>`);
+    }
+    const reasons = [
+        [k.ignored, 'matched .gitignore'],
+        [k.vendorDir, 'in vendor or build folders'],
+        [k.notSource, 'not source (images, lockfiles, bundles)'],
+        [k.notCode, 'no analyzer for the extension'],
+        [k.tooLarge, 'over the size cap'],
+        [k.readFailed, 'could not be read'],
+        [k.analyzeFailed, 'could not be parsed'],
+        [k.listFailed, 'directories that would not list'],
+    ].filter(([n]) => n > 0).map(([n, why]) => `${n} ${why}`);
+    if (reasons.length) {
+        out.push(`<li>${s.filesParsed} of ${s.filesTotal} files analyzed. Left out: ${reasons.join('; ')}.</li>`);
+    }
+    const imp = s.imports;
+    if (imp?.total) {
+        const worst = imp.worst?.length
+            ? ` Most common misses: ${imp.worst.slice(0, 3).map((w) => `<code>${escapeHtml(w.spec)}</code>`).join(', ')}.`
+            : '';
+        out.push(`<li><b>${imp.confidence}% of ${imp.total} imports placed</b> — ${imp.internal} internal, ` +
+            `${imp.external} external packages, ${imp.unresolved} unresolved.${imp.unresolved ? worst : ''}</li>`);
+    }
+    return out.join('\n');
 }
-
 // The GitHub URL parsing and the reading of the API payload also exist in
 // `/shared/analyzer/github.js`, where the terminal reads them. This copy is not
 // an oversight and cannot simply be deleted: this module is loaded by Node tests
@@ -250,32 +229,31 @@ export function lineageCoverage(scan) {
 // `watchers_count` (a legacy alias for the *stargazer* count) and called it
 // "watching", printing the star number twice.
 export function githubRepoPath(url) {
-  const m = String(url ?? '').match(/github\.com[:/]([^/\s]+\/[^/\s]+?)(?:\.git)?\/?$/);
-  return m ? m[1] : null;
+    const m = String(url ?? '').match(/github\.com[:/]([^/\s]+\/[^/\s]+?)(?:\.git)?\/?$/);
+    return m ? m[1] : null;
 }
-
 export function aboutDate(iso) {
-  if (!iso) return 'unknown';
-  return new Date(iso).toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' });
+    if (!iso)
+        return 'unknown';
+    return new Date(iso).toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' });
 }
-
 async function loadRemoteInfo(repoPath) {
-  const box = host.querySelector('#aboutRemote');
-  try {
-    const res = await fetch(`https://api.github.com/repos/${repoPath}`);
-    if (!res.ok) {
-      throw new Error(res.status === 403
-        ? 'GitHub rate-limited the ask — unauthenticated allowance is 60 an hour.'
-        : `GitHub answered ${res.status}.`);
-    }
-    const r = await res.json();
-    // `subscribers_count`, not `watchers_count`. The API carries both and
-    // `watchers_count` is a legacy alias for the *stargazer* count, so reading
-    // it printed the star number a second time and called it "watching". The
-    // real watcher count is the subscribers number.
-    const watching = Number.isFinite(r.subscribers_count) ? r.subscribers_count : 0;
-    const license = r.license?.spdx_id && r.license.spdx_id !== 'NOASSERTION' ? r.license.spdx_id : '';
-    box.innerHTML = `
+    const box = host.querySelector('#aboutRemote');
+    try {
+        const res = await fetch(`https://api.github.com/repos/${repoPath}`);
+        if (!res.ok) {
+            throw new Error(res.status === 403
+                ? 'GitHub rate-limited the ask — unauthenticated allowance is 60 an hour.'
+                : `GitHub answered ${res.status}.`);
+        }
+        const r = await res.json();
+        // `subscribers_count`, not `watchers_count`. The API carries both and
+        // `watchers_count` is a legacy alias for the *stargazer* count, so reading
+        // it printed the star number a second time and called it "watching". The
+        // real watcher count is the subscribers number.
+        const watching = Number.isFinite(r.subscribers_count) ? r.subscribers_count : 0;
+        const license = r.license?.spdx_id && r.license.spdx_id !== 'NOASSERTION' ? r.license.spdx_id : '';
+        box.innerHTML = `
       <div class="about-numbers">
         ${aboutNum(r.stargazers_count ?? 0, 'stars')}
         ${aboutNum(r.forks_count ?? 0, 'forks')}
@@ -291,7 +269,9 @@ async function loadRemoteInfo(repoPath) {
         ${r.homepage ? `<li><a href="${escapeHtml(r.homepage)}" target="_blank" rel="noopener noreferrer">${escapeHtml(r.homepage)}</a></li>` : ''}
         <li class="doc-readme-none">These are GitHub's numbers, not this repository's — <code>health</code> and <code>risks</code> are about the code.</li>
       </ul>`;
-  } catch (err) {
-    box.innerHTML = `<span class="doc-readme-none">${escapeHtml(err.message)}</span>`;
-  }
+    }
+    catch (err) {
+        box.innerHTML = `<span class="doc-readme-none">${escapeHtml(err.message)}</span>`;
+    }
 }
+//# sourceMappingURL=about.js.map

package/public/js/about.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.js","sourceRoot":"","sources":["../../src/public/js/about.ts"],"names":[],"mappings":"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","sourcesContent":["// The About view: what this repo is, what it's built from, and how the scan\n// that produced this page actually went.\n//\n// The rendering needs the DOM, but the parts worth checking — the coverage\n// prose, the GitHub URL parsing, date formatting — are pure and exported for\n// that reason. Nothing here runs at import time.\n\nimport { escapeHtml } from './html.js';\nimport { state } from './state.js';\nimport { streamExplain } from './api.js';\nimport { mdLite } from './markdown.js';\nimport * as llm from './llm.js';\n\nlet host = null;\nlet hooks = { onToast: (..._args: unknown[]) => {}, onOpenSettings: (..._args: unknown[]) => {}, repoOverview: () => '' };\n\nexport function initAbout(options) {\n  host = options.host;\n  hooks = { ...hooks, ...options };\n  host.addEventListener('click', (event) => {\n    const b = event.target.closest('[data-stack-sum]');\n    if (b) summarizeStackItem(b.dataset.stackSum);\n  });\n}\n\nexport function renderAbout() {\n  if (state.about.rendered) return;\n  state.about.rendered = true;\n  const { scan, facts } = state;\n  const gh = scan.gitUrl ? githubRepoPath(scan.gitUrl) : null;\n\n  const sourceLine = scan.gitUrl\n    ? `Cloned from ${scan.gitUrl}`\n    : state.browserSource\n      ? 'Picked in the browser — files never left this tab.'\n      : `Read in place from ${scan.root}`;\n\n  host.innerHTML = `\n    <div class=\"doc-page\">\n      <h1 class=\"doc-title\">${escapeHtml(scan.name)}</h1>\n      <p class=\"doc-sub\">${escapeHtml(scan.tempId ? scan.tempId + ' — a temp clone' : scan.root)}</p>\n      <p class=\"doc-sub\">${escapeHtml(sourceLine)}</p>\n\n      <div class=\"about-numbers\">\n        ${aboutNum(scan.stats.filesParsed, 'code files')}\n        ${aboutNum(scan.stats.edgeCount, 'connections')}\n        ${aboutNum(facts.entries.length, 'entry points')}\n        ${aboutNum(facts.hubs.length, 'hubs')}\n        ${aboutNum(facts.cycles.length, 'cycles')}\n        ${aboutNum(Object.keys(scan.stats.languages).length, 'languages')}\n      </div>\n\n      <h2 class=\"doc-section-h\">Stack</h2>\n      <div id=\"stackZone\"></div>\n\n      ${renderHistorySection(state.history)}\n\n      <h2 class=\"doc-section-h\">From the remote</h2>\n      <div id=\"aboutRemote\">${\n        gh\n          ? '<span class=\"doc-readme-none\">Asking GitHub…</span>'\n          : `<span class=\"doc-readme-none\">${scan.gitUrl ? 'Not a GitHub URL — no remote facts to fetch.' : 'A local repo — no remote to ask about.'}</span>`\n      }</div>\n\n      <h2 class=\"doc-section-h\">Lineage</h2>\n      <ul class=\"about-lineage\">\n        <li>Scanned ${new Date(scan.scannedAt).toLocaleString()} in ${scan.stats.tookMs} ms.</li>\n        ${lineageCoverage(scan)}\n        ${scan.tempId ? `<li>The clone lives in your temp folder as <code>${escapeHtml(scan.tempId)}</code> until you hit New repo.</li>` : ''}\n      </ul>\n    </div>`;\n\n  if (gh) loadRemoteInfo(gh);\n  if (state.stack) renderStackZone(host.querySelector('#stackZone'));\n}\n\nfunction renderHistorySection(h) {\n  if (!h) return '';\n  if (!h.available) {\n    return `<h2 class=\"doc-section-h\">History</h2><p class=\"doc-readme-none\">${escapeHtml(h.reason || 'No history available.')}</p>`;\n  }\n  return `\n    <h2 class=\"doc-section-h\">History & Activity</h2>\n    <div class=\"about-numbers\">\n      ${aboutNum(h.commitCount, h.truncated ? 'commits analyzed' : 'commits')}\n      ${aboutNum(h.authors.length, 'contributors')}\n      ${aboutNum(h.soloFiles, 'solo-author files')}\n      ${aboutNum(h.coChanged.length, 'co-change pairs')}\n    </div>\n    <ul class=\"about-lineage\">\n      ${h.firstCommitAt ? `<li>First commit: <b>${aboutDate(h.firstCommitAt)}</b> · Latest: <b>${aboutDate(h.lastCommitAt)}</b></li>` : ''}\n      ${h.authors.length ? `<li>Top contributors: ${h.authors.slice(0, 5).map((a) => `<b>${escapeHtml(a.name || a.email)}</b> (${a.commits})`).join(', ')}.</li>` : ''}\n    </ul>\n  `;\n}\n\n// ---- Stack: detected languages, package managers, and frameworks ----------\n\nfunction renderStackZone(zone) {\n  const st = state.stack;\n  if (!st) return (zone.innerHTML = '');\n\n  const langs = Object.entries(st.languages)\n    .map(([name, count]) => `<span class=\"stack-lang\"><i>${count}</i> ${escapeHtml(name)}</span>`)\n    .join('');\n\n  const rows = st.items\n    .map(\n      (it) => `\n      <div class=\"stack-item\">\n        <span class=\"stack-name\">${escapeHtml(it.name)}</span>\n        <span class=\"stack-cat\">${escapeHtml(it.category)}</span>\n        ${it.version ? `<span class=\"stack-ver\">v${escapeHtml(it.version)}</span>` : ''}\n        ${it.dev ? '<span class=\"stack-dev\">dev</span>' : ''}\n        <span class=\"stack-lang\">${escapeHtml(it.lang)}</span>\n        <a class=\"stack-doc\" href=\"${escapeHtml(it.docs)}\" target=\"_blank\" rel=\"noopener\">docs ↗</a>\n        <button class=\"stack-sum\" data-stack-sum=\"${escapeHtml(it.name)}\" title=\"Summarize from official docs\">summarize</button>\n        <div class=\"stack-body\" data-stack-body></div>\n      </div>`\n    )\n    .join('');\n\n  zone.innerHTML = `\n    <div class=\"stack-block\">\n      <div class=\"stack-langs\">${langs || '<span class=\"doc-readme-none\">No languages parsed.</span>'}</div>\n      ${st.pm.length ? `<p class=\"stack-pm\">package managers: ${escapeHtml(st.pm.join(', '))}</p>` : ''}\n      ${st.items.length\n        ? `<div class=\"stack-grid\">${rows}</div>\n           <p class=\"stack-hint\">Each “summarize” fetches that library’s official docs and folds them into an AI field note.</p>`\n        : '<p class=\"doc-readme-none\">No declared dependencies — nothing to analyze.</p>'}\n    </div>`;\n}\n\n// Fetch a library's official docs (server-side, SSRF-safe) and summarize it\n// with the AI, streamed into the row.\nasync function summarizeStackItem(name) {\n  const item = state.stack.items.find((i) => i.name === name);\n  if (!item) return hooks.onToast('Unknown dependency.');\n  if (!llm.isConfigured()) {\n    hooks.onOpenSettings();\n    return hooks.onToast('Choose Hermes or an endpoint in AI connection first.');\n  }\n  const row = host.querySelector(`[data-stack-sum=\"${CSS.escape(name)}\"]`)?.closest('.stack-item');\n  const body = row?.querySelector('[data-stack-body]');\n  if (!body) return;\n\n  row.querySelector('.stack-sum').textContent = 'looking…';\n  row.querySelector('.stack-sum').disabled = true;\n\n  let docsText = '';\n  let docsTitle = '';\n  try {\n    const r = await fetch('/api/doc', {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ url: item.docs }),\n    });\n    const j = await r.json();\n    if (j.text) {\n      docsText = j.text;\n      docsTitle = j.title || item.docs;\n    }\n  } catch { /* summarized from knowledge */ }\n\n  body.innerHTML = '<br><div class=\"stack-body-text\"><span class=\"caret\"></span></div>';\n  const slot = body.querySelector('.stack-body-text');\n  const settings = llm.getSettings();\n  const messages = llm.stackSummaryMessages({\n    repoName: state.scan.name,\n    item,\n    docsText,\n    repoNote: hooks.repoOverview(),\n  });\n  let text = '';\n  try {\n    for await (const delta of streamExplain({ ...settings, messages, maxTokens: 700 })) {\n      text += delta;\n      slot.innerHTML = mdLite(text) + '<span class=\"caret\"></span>';\n    }\n    slot.innerHTML = mdLite(text)\n      + `<p class=\"explain-src\">${docsText ? `From ${escapeHtml(docsTitle)}` : 'No docs fetched — general knowledge'} · ${escapeHtml(settings.model)}</p>`;\n  } catch (err) {\n    slot.innerHTML = `<p style=\"color:var(--warn)\">${escapeHtml(err.message)}</p>`;\n  } finally {\n    const btn = row.querySelector('.stack-sum');\n    if (btn) {\n      btn.textContent = body.textContent.trim() ? 'summarize again' : 'summarize';\n      btn.disabled = false;\n    }\n  }\n}\n\n// ---- the pure parts -------------------------------------------------------\n\nexport function aboutNum(value, label) {\n  return `<div class=\"about-num\"><b>${value}</b><span>${label}</span></div>`;\n}\n\n// What the scan left out, itemized. The line here used to read \"N files skipped\n// by the ignore rules\", which was one number covering eight unrelated reasons —\n// most of them not the ignore rules at all.\nexport function lineageCoverage(scan) {\n  const s = scan.stats;\n  const k = s.skips || {};\n  const out = [];\n\n  if (s.truncated) {\n    out.push(\n      `<li><b>Partial scan.</b> Stopped at the ${s.truncated.atFiles}-file cap with ` +\n      `${s.truncated.dirsQueued} ${s.truncated.dirsQueued === 1 ? 'directory' : 'directories'} ` +\n      `still unvisited — every count below is a floor, not a total.</li>`\n    );\n  }\n\n  const reasons = [\n    [k.ignored, 'matched .gitignore'],\n    [k.vendorDir, 'in vendor or build folders'],\n    [k.notSource, 'not source (images, lockfiles, bundles)'],\n    [k.notCode, 'no analyzer for the extension'],\n    [k.tooLarge, 'over the size cap'],\n    [k.readFailed, 'could not be read'],\n    [k.analyzeFailed, 'could not be parsed'],\n    [k.listFailed, 'directories that would not list'],\n  ].filter(([n]) => n > 0).map(([n, why]) => `${n} ${why}`);\n  if (reasons.length) {\n    out.push(`<li>${s.filesParsed} of ${s.filesTotal} files analyzed. Left out: ${reasons.join('; ')}.</li>`);\n  }\n\n  const imp = s.imports;\n  if (imp?.total) {\n    const worst = imp.worst?.length\n      ? ` Most common misses: ${imp.worst.slice(0, 3).map((w) => `<code>${escapeHtml(w.spec)}</code>`).join(', ')}.`\n      : '';\n    out.push(\n      `<li><b>${imp.confidence}% of ${imp.total} imports placed</b> — ${imp.internal} internal, ` +\n      `${imp.external} external packages, ${imp.unresolved} unresolved.${imp.unresolved ? worst : ''}</li>`\n    );\n  }\n  return out.join('\\n');\n}\n\n// The GitHub URL parsing and the reading of the API payload also exist in\n// `/shared/analyzer/github.js`, where the terminal reads them. This copy is not\n// an oversight and cannot simply be deleted: this module is loaded by Node tests\n// (`tests/about.test.js`), and a `/shared/…` specifier does not resolve in Node,\n// so importing the shared version here would make this whole file unloadable\n// outside a browser. The duplication is therefore pinned by a test —\n// \"the two GitHub URL parsers agree\" — rather than left to drift, which is what\n// two unconnected copies of this regex had already done: the browser counted\n// `watchers_count` (a legacy alias for the *stargazer* count) and called it\n// \"watching\", printing the star number twice.\nexport function githubRepoPath(url) {\n  const m = String(url ?? '').match(/github\\.com[:/]([^/\\s]+\\/[^/\\s]+?)(?:\\.git)?\\/?$/);\n  return m ? m[1] : null;\n}\n\nexport function aboutDate(iso) {\n  if (!iso) return 'unknown';\n  return new Date(iso).toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' });\n}\n\nasync function loadRemoteInfo(repoPath) {\n  const box = host.querySelector('#aboutRemote');\n  try {\n    const res = await fetch(`https://api.github.com/repos/${repoPath}`);\n    if (!res.ok) {\n      throw new Error(res.status === 403\n        ? 'GitHub rate-limited the ask — unauthenticated allowance is 60 an hour.'\n        : `GitHub answered ${res.status}.`);\n    }\n    const r = await res.json();\n    // `subscribers_count`, not `watchers_count`. The API carries both and\n    // `watchers_count` is a legacy alias for the *stargazer* count, so reading\n    // it printed the star number a second time and called it \"watching\". The\n    // real watcher count is the subscribers number.\n    const watching = Number.isFinite(r.subscribers_count) ? r.subscribers_count : 0;\n    const license = r.license?.spdx_id && r.license.spdx_id !== 'NOASSERTION' ? r.license.spdx_id : '';\n    box.innerHTML = `\n      <div class=\"about-numbers\">\n        ${aboutNum(r.stargazers_count ?? 0, 'stars')}\n        ${aboutNum(r.forks_count ?? 0, 'forks')}\n        ${aboutNum(watching, 'watching')}\n        ${aboutNum(r.open_issues_count ?? 0, 'open issues')}\n      </div>\n      ${r.description ? `<p class=\"about-desc\">${escapeHtml(r.description)}</p>` : ''}\n      <ul class=\"about-lineage\">\n        ${license ? `<li>License: ${escapeHtml(license)}</li>` : ''}\n        <li>Created ${aboutDate(r.created_at)} · last push ${aboutDate(r.pushed_at)}.</li>\n        ${r.default_branch ? `<li>Default branch: <code>${escapeHtml(r.default_branch)}</code></li>` : ''}\n        ${r.topics?.length ? `<li>Topics: ${r.topics.map((t) => `<span class=\"stat-chip\">${escapeHtml(t)}</span>`).join(' ')}</li>` : ''}\n        ${r.homepage ? `<li><a href=\"${escapeHtml(r.homepage)}\" target=\"_blank\" rel=\"noopener noreferrer\">${escapeHtml(r.homepage)}</a></li>` : ''}\n        <li class=\"doc-readme-none\">These are GitHub's numbers, not this repository's — <code>health</code> and <code>risks</code> are about the code.</li>\n      </ul>`;\n  } catch (err) {\n    box.innerHTML = `<span class=\"doc-readme-none\">${escapeHtml(err.message)}</span>`;\n  }\n}\n"]}

package/public/js/aiDraft.d.ts

@@ -0,0 +1,4 @@
+export declare function initAiDraft(options: any): void;
+export declare function updateAiBtn(key?: string): void;
+export declare function stopAiDraft(): void;
+export declare function wireAIClicks(): void;