codebase-onboarder 0.6.0 → 1.0.0

package/public/js/aiDraft.js

@@ -8,156 +8,197 @@
 // Three states for one button: draw, drawn (flip back to static), and drawing.
 // Nothing here is required for the app to work; with no endpoint configured the
 // button opens the settings drawer and says so.
-
-import { extractAIDiagram, matchNodeText } from '/shared/diagram/aiMermaid.js';
+import { extractAIDiagram, matchNodeText } from '../../shared/diagram/aiMermaid.js';
 import { streamExplain } from './api.js';
 import { state, aiViewKey } from './state.js';
 import { gatherFileContext } from './repoFiles.js';
-import {
-  diagramTarget, externalsFor, overviewFacts, layersFacts, servicesFacts,
-  fileFacts, tourStopFacts, folderFacts,
-} from '/shared/diagram/aiFacts.js';
+import { diagramTarget, externalsFor, overviewFacts, layersFacts, servicesFacts, fileFacts, tourStopFacts, folderFacts, } from '../../shared/diagram/aiFacts.js';
 import * as llm from './llm.js';
-
 const MAX_TOKENS = 4000;
-const PROGRESS_MS = 250;
-
+const PROGRESS_MS = 1000;
 let btn = null;
 let statusEl = null;
 let nodeHost = null;
+let pending = null;
 let hooks = {
-  onRender: () => {},
-  onOpenFile: () => {},
-  onOpenSettings: () => {},
-  onToast: () => {},
+    onRender: (..._args) => { },
+    onValidate: async (_source) => { },
+    onOpenFile: (..._args) => { },
+    onOpenSettings: (..._args) => { },
+    onToast: (..._args) => { },
 };
-
 export function initAiDraft(options) {
-  btn = options.host;
-  statusEl = options.statusEl;
-  nodeHost = options.nodeHost;
-  hooks = { ...hooks, ...options };
-
-  btn.addEventListener('click', () => {
-    const key = aiViewKey();
-    if (state.aiActiveKey === key) {
-      state.aiActiveKey = null; // back to static
-      hooks.onRender();
-      return;
-    }
-    if (state.aiDiagrams[key]) {
-      state.aiActiveKey = key; // cached draft, instant
-      hooks.onRender();
-      return;
-    }
-    drawWithAI(key);
-  });
+    btn = options.host;
+    statusEl = options.statusEl;
+    nodeHost = options.nodeHost;
+    hooks = { ...hooks, ...options };
+    btn.addEventListener('click', () => {
+        if (pending) {
+            stopAiDraft();
+            updateAiBtn();
+            hooks.onToast('Sketch cancelled.');
+            return;
+        }
+        const key = aiViewKey();
+        if (state.aiActiveKey === key) {
+            state.aiActiveKey = null; // back to static
+            updateAiBtn(key);
+            hooks.onRender();
+            return;
+        }
+        if (state.aiDiagrams[key]) {
+            state.aiActiveKey = key; // cached draft, instant
+            updateAiBtn(key);
+            hooks.onRender();
+            return;
+        }
+        return drawWithAI(key);
+    });
 }
-
 // Which of the three things the button currently offers. Called on every canvas
 // render, because the answer depends on the view.
 export function updateAiBtn(key = aiViewKey()) {
-  btn.hidden = state.view === 'docs' || state.view === 'about'
-    || (state.view === 'atlas' && !state.atlasOpen);
-  if (state.aiActiveKey === key) {
-    btn.textContent = 'Static';
-    btn.title = 'Back to the static diagram';
-  } else {
-    btn.textContent = state.aiDiagrams[key] ? 'AI draft ✓' : 'AI draft';
-    btn.title = 'Ask the AI to draw this view';
-  }
+    if (pending && (pending.scan !== state.scan || pending.key !== key))
+        stopAiDraft();
+    btn.hidden = state.view === 'docs' || state.view === 'about'
+        || (state.view === 'atlas' && !state.atlasOpen);
+    if (pending) {
+        btn.textContent = 'Cancel sketch';
+        btn.title = 'Stop generating this sketch';
+        btn.setAttribute('aria-busy', 'true');
+    }
+    else if (state.aiActiveKey === key) {
+        btn.textContent = 'Static';
+        btn.title = 'Back to the static diagram';
+    }
+    else {
+        btn.textContent = state.aiDiagrams[key] ? 'AI sketch ✓' : 'AI sketch';
+        btn.title = 'Ask the AI to draw this view';
+    }
+    if (!pending)
+        btn.removeAttribute('aria-busy');
+}
+export function stopAiDraft() {
+    pending?.controller.abort();
+    pending = null;
+    if (statusEl)
+        statusEl.hidden = true;
+    statusEl?.removeAttribute('aria-busy');
 }
-
 // AI nodes carry no stable ids — clicks are matched by label text instead.
 export function wireAIClicks() {
-  for (const g of nodeHost.querySelectorAll('g.node')) {
-    const path = matchNodeText(g.textContent, state.scan.files);
-    if (!path) continue;
-    g.style.cursor = 'pointer';
-    g.addEventListener('click', (event) => {
-      event.stopPropagation();
-      hooks.onOpenFile(path);
-    });
-  }
+    for (const g of nodeHost.querySelectorAll('g.node')) {
+        const path = matchNodeText(g.textContent, state.scan.files);
+        if (!path)
+            continue;
+        g.style.cursor = 'pointer';
+        g.addEventListener('click', (event) => {
+            event.stopPropagation();
+            hooks.onOpenFile(path);
+        });
+    }
 }
-
 async function drawWithAI(key) {
-  if (!llm.isConfigured()) {
-    hooks.onOpenSettings();
-    hooks.onToast('Add an endpoint and model first.');
-    return;
-  }
-  const settings = llm.getSettings();
-  btn.disabled = true;
-  btn.textContent = 'drawing…';
-  statusEl.hidden = false;
-
-  // Live progress: elapsed time plus how much the model has written so far. A
-  // reasoning model can be quiet for half a minute, and a canvas that says
-  // nothing is indistinguishable from one that has hung.
-  const startedAt = Date.now();
-  let received = 0;
-  const tick = () => {
-    const secs = Math.round((Date.now() - startedAt) / 1000);
-    const kb = received >= 1000 ? (received / 1000).toFixed(1) + 'k' : String(received);
-    statusEl.textContent = `The AI is sketching this view… ${kb} chars · ${secs}s`;
-  };
-  tick();
-  const progressTimer = setInterval(tick, PROGRESS_MS);
-
-  try {
-    const { kind, facts } = await factsForView();
-    const messages = llm.diagramMessages({ repoName: state.scan.name, kind, facts });
-    let text = '';
-    // Big budget, and no visible thinking where the dialect allows it:
-    // reasoning models otherwise spend the whole allowance before a single
-    // diagram line appears. Azure rejects that parameter outright.
-    const providerOptions = llm.isAzureHost(settings.baseUrl) ? {} : { reasoning: { exclude: true } };
-    for await (const delta of streamExplain({ ...settings, messages, maxTokens: MAX_TOKENS, providerOptions })) {
-      text += delta;
-      received += delta.length;
+    if (!llm.isConfigured()) {
+        hooks.onOpenSettings();
+        hooks.onToast('Choose Hermes or an endpoint in AI connection first.');
+        return;
     }
-    const parsed = extractAIDiagram(text);
-    if (!parsed) throw new Error('The model answered without a diagram. Try again.');
-    state.aiDiagrams[key] = { body: parsed.body, caption: parsed.caption };
-    state.aiActiveKey = key;
-    statusEl.hidden = true;
-    hooks.onRender();
-  } catch (err) {
-    statusEl.hidden = true;
-    hooks.onToast(err.message);
-  } finally {
-    clearInterval(progressTimer);
-    btn.disabled = false;
+    if (!state.scan)
+        return;
+    const settings = llm.getSettings();
+    const job = pending = { key, scan: state.scan, controller: new AbortController() };
     updateAiBtn(key);
-  }
+    statusEl.hidden = false;
+    statusEl.setAttribute('aria-busy', 'true');
+    // Live progress: elapsed time plus how much the model has written so far. A
+    // reasoning model can be quiet for half a minute, and a canvas that says
+    // nothing is indistinguishable from one that has hung.
+    const startedAt = Date.now();
+    let received = 0;
+    const tick = () => {
+        if (pending !== job)
+            return;
+        const secs = Math.round((Date.now() - startedAt) / 1000);
+        const kb = received >= 1000 ? (received / 1000).toFixed(1) + 'k' : String(received);
+        statusEl.textContent = `${settings.connection === 'hermes' ? 'Hermes' : 'The AI'} is sketching this view… ${kb} chars · ${secs}s`;
+    };
+    tick();
+    const progressTimer = setInterval(tick, PROGRESS_MS);
+    try {
+        const { kind, facts } = await factsForView();
+        job.controller.signal.throwIfAborted();
+        const messages = llm.diagramMessages({ repoName: job.scan.name, kind, facts });
+        let text = '';
+        // Big budget, and no visible thinking where the dialect allows it:
+        // reasoning models otherwise spend the whole allowance before a single
+        // diagram line appears. Azure rejects that parameter outright.
+        const providerOptions = llm.isAzureHost(settings.baseUrl) ? {} : { reasoning: { exclude: true } };
+        for await (const delta of streamExplain({ ...settings, messages, maxTokens: MAX_TOKENS, providerOptions, purpose: 'diagram', signal: job.controller.signal })) {
+            text += delta;
+            received += delta.length;
+            if (text.length > 120000)
+                throw new Error('The sketch was too large. Try a smaller folder or file.');
+        }
+        job.controller.signal.throwIfAborted();
+        const parsed = extractAIDiagram(text);
+        if (!parsed)
+            throw new Error('The model answered without a diagram. Try again.');
+        try {
+            await hooks.onValidate(parsed.body);
+        }
+        catch {
+            throw new Error('The AI returned a diagram that could not be drawn. Try again.');
+        }
+        job.controller.signal.throwIfAborted();
+        if (pending !== job || state.scan !== job.scan || aiViewKey() !== key)
+            return;
+        state.aiDiagrams[key] = { body: parsed.body, caption: parsed.caption };
+        state.aiActiveKey = key;
+        statusEl.hidden = true;
+        await hooks.onRender();
+    }
+    catch (err) {
+        if (pending === job && !job.controller.signal.aborted) {
+            statusEl.hidden = true;
+            hooks.onToast(err.message);
+        }
+    }
+    finally {
+        clearInterval(progressTimer);
+        if (pending === job) {
+            pending = null;
+            statusEl.removeAttribute('aria-busy');
+            updateAiBtn();
+        }
+    }
 }
-
 // Picks the sheet for the current view and fetches the source the file-shaped
 // ones need. The choosing is pure and tested in aiFacts.js; this is the read.
 async function factsForView() {
-  const { scan, facts, manifest, patterns } = state;
-  const target = diagramTarget(state);
-
-  switch (target.view) {
-    case 'map': return overviewFacts(scan, facts);
-    case 'patterns': return layersFacts(facts, patterns);
-    case 'services': return servicesFacts(scan, manifest);
-    case 'tour': {
-      const stop = state.tour.stops[state.tour.idx];
-      if (!stop) return tourStopFacts({ stop: null });
-      return tourStopFacts({
-        ctx: await gatherFileContext(target.path),
-        externals: externalsFor(scan, target.path),
-        stop,
-        index: state.tour.idx,
-        total: state.tour.stops.length,
-      });
+    const { scan, facts, manifest, patterns } = state;
+    const target = diagramTarget(state);
+    switch (target.view) {
+        case 'map': return overviewFacts(scan, facts);
+        case 'patterns': return layersFacts(facts, patterns);
+        case 'services': return servicesFacts(scan, manifest);
+        case 'tour': {
+            const stop = state.tour.stops[state.tour.idx];
+            if (!stop)
+                return tourStopFacts({ stop: null });
+            return tourStopFacts({
+                ctx: await gatherFileContext(target.path),
+                externals: externalsFor(scan, target.path),
+                stop,
+                index: state.tour.idx,
+                total: state.tour.stops.length,
+            });
+        }
+        case 'file': return fileFacts({
+            ctx: await gatherFileContext(target.path),
+            externals: externalsFor(scan, target.path),
+        });
+        default: return folderFacts(scan, facts, target.path);
     }
-    case 'file': return fileFacts({
-      ctx: await gatherFileContext(target.path),
-      externals: externalsFor(scan, target.path),
-    });
-    default: return folderFacts(scan, facts, target.path);
-  }
 }
+//# sourceMappingURL=aiDraft.js.map

package/public/js/aiDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiDraft.js","sourceRoot":"","sources":["../../src/public/js/aiDraft.ts"],"names":[],"mappings":"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","sourcesContent":["// The \"AI draft\" button: ask a model to redraw whatever the canvas is showing.\n//\n// Every view has a static diagram built from the import graph, and that is what\n// loads. This is the optional second opinion — the model gets a fact sheet (see\n// aiFacts.js) and answers with Mermaid, which is cached per view so flipping\n// between the two is instant afterwards.\n//\n// Three states for one button: draw, drawn (flip back to static), and drawing.\n// Nothing here is required for the app to work; with no endpoint configured the\n// button opens the settings drawer and says so.\n\nimport { extractAIDiagram, matchNodeText } from '../../shared/diagram/aiMermaid.js';\nimport { streamExplain } from './api.js';\nimport { state, aiViewKey } from './state.js';\nimport { gatherFileContext } from './repoFiles.js';\nimport {\n  diagramTarget, externalsFor, overviewFacts, layersFacts, servicesFacts,\n  fileFacts, tourStopFacts, folderFacts,\n} from '../../shared/diagram/aiFacts.js';\nimport * as llm from './llm.js';\n\nconst MAX_TOKENS = 4000;\nconst PROGRESS_MS = 1000;\n\nlet btn = null;\nlet statusEl = null;\nlet nodeHost = null;\nlet pending: { key: string; scan: typeof state.scan; controller: AbortController } | null = null;\nlet hooks = {\n  onRender: (..._args: unknown[]) => {},\n  onValidate: async (_source: string) => {},\n  onOpenFile: (..._args: unknown[]) => {},\n  onOpenSettings: (..._args: unknown[]) => {},\n  onToast: (..._args: unknown[]) => {},\n};\n\nexport function initAiDraft(options) {\n  btn = options.host;\n  statusEl = options.statusEl;\n  nodeHost = options.nodeHost;\n  hooks = { ...hooks, ...options };\n\n  btn.addEventListener('click', () => {\n    if (pending) { stopAiDraft(); updateAiBtn(); hooks.onToast('Sketch cancelled.'); return; }\n    const key = aiViewKey();\n    if (state.aiActiveKey === key) {\n      state.aiActiveKey = null; // back to static\n      updateAiBtn(key);\n      hooks.onRender();\n      return;\n    }\n    if (state.aiDiagrams[key]) {\n      state.aiActiveKey = key; // cached draft, instant\n      updateAiBtn(key);\n      hooks.onRender();\n      return;\n    }\n    return drawWithAI(key);\n  });\n}\n\n// Which of the three things the button currently offers. Called on every canvas\n// render, because the answer depends on the view.\nexport function updateAiBtn(key = aiViewKey()) {\n  if (pending && (pending.scan !== state.scan || pending.key !== key)) stopAiDraft();\n  btn.hidden = state.view === 'docs' || state.view === 'about'\n    || (state.view === 'atlas' && !state.atlasOpen);\n  if (pending) {\n    btn.textContent = 'Cancel sketch';\n    btn.title = 'Stop generating this sketch';\n    btn.setAttribute('aria-busy', 'true');\n  } else if (state.aiActiveKey === key) {\n    btn.textContent = 'Static';\n    btn.title = 'Back to the static diagram';\n  } else {\n    btn.textContent = state.aiDiagrams[key] ? 'AI sketch ✓' : 'AI sketch';\n    btn.title = 'Ask the AI to draw this view';\n  }\n  if (!pending) btn.removeAttribute('aria-busy');\n}\n\nexport function stopAiDraft() {\n  pending?.controller.abort();\n  pending = null;\n  if (statusEl) statusEl.hidden = true;\n  statusEl?.removeAttribute('aria-busy');\n}\n\n// AI nodes carry no stable ids — clicks are matched by label text instead.\nexport function wireAIClicks() {\n  for (const g of nodeHost.querySelectorAll('g.node')) {\n    const path = matchNodeText(g.textContent, state.scan.files);\n    if (!path) continue;\n    g.style.cursor = 'pointer';\n    g.addEventListener('click', (event) => {\n      event.stopPropagation();\n      hooks.onOpenFile(path);\n    });\n  }\n}\n\nasync function drawWithAI(key) {\n  if (!llm.isConfigured()) {\n    hooks.onOpenSettings();\n    hooks.onToast('Choose Hermes or an endpoint in AI connection first.');\n    return;\n  }\n  if (!state.scan) return;\n  const settings = llm.getSettings();\n  const job = pending = { key, scan: state.scan, controller: new AbortController() };\n  updateAiBtn(key);\n  statusEl.hidden = false;\n  statusEl.setAttribute('aria-busy', 'true');\n\n  // Live progress: elapsed time plus how much the model has written so far. A\n  // reasoning model can be quiet for half a minute, and a canvas that says\n  // nothing is indistinguishable from one that has hung.\n  const startedAt = Date.now();\n  let received = 0;\n  const tick = () => {\n    if (pending !== job) return;\n    const secs = Math.round((Date.now() - startedAt) / 1000);\n    const kb = received >= 1000 ? (received / 1000).toFixed(1) + 'k' : String(received);\n    statusEl.textContent = `${settings.connection === 'hermes' ? 'Hermes' : 'The AI'} is sketching this view… ${kb} chars · ${secs}s`;\n  };\n  tick();\n  const progressTimer = setInterval(tick, PROGRESS_MS);\n\n  try {\n    const { kind, facts } = await factsForView();\n    job.controller.signal.throwIfAborted();\n    const messages = llm.diagramMessages({ repoName: job.scan.name, kind, facts });\n    let text = '';\n    // Big budget, and no visible thinking where the dialect allows it:\n    // reasoning models otherwise spend the whole allowance before a single\n    // diagram line appears. Azure rejects that parameter outright.\n    const providerOptions = llm.isAzureHost(settings.baseUrl) ? {} : { reasoning: { exclude: true } };\n    for await (const delta of streamExplain({ ...settings, messages, maxTokens: MAX_TOKENS, providerOptions, purpose: 'diagram', signal: job.controller.signal })) {\n      text += delta;\n      received += delta.length;\n      if (text.length > 120000) throw new Error('The sketch was too large. Try a smaller folder or file.');\n    }\n    job.controller.signal.throwIfAborted();\n    const parsed = extractAIDiagram(text);\n    if (!parsed) throw new Error('The model answered without a diagram. Try again.');\n    try { await hooks.onValidate(parsed.body); }\n    catch { throw new Error('The AI returned a diagram that could not be drawn. Try again.'); }\n    job.controller.signal.throwIfAborted();\n    if (pending !== job || state.scan !== job.scan || aiViewKey() !== key) return;\n    state.aiDiagrams[key] = { body: parsed.body, caption: parsed.caption };\n    state.aiActiveKey = key;\n    statusEl.hidden = true;\n    await hooks.onRender();\n  } catch (err) {\n    if (pending === job && !job.controller.signal.aborted) {\n      statusEl.hidden = true;\n      hooks.onToast(err.message);\n    }\n  } finally {\n    clearInterval(progressTimer);\n    if (pending === job) { pending = null; statusEl.removeAttribute('aria-busy'); updateAiBtn(); }\n  }\n}\n\n// Picks the sheet for the current view and fetches the source the file-shaped\n// ones need. The choosing is pure and tested in aiFacts.js; this is the read.\nasync function factsForView() {\n  const { scan, facts, manifest, patterns } = state;\n  const target = diagramTarget(state);\n\n  switch (target.view) {\n    case 'map': return overviewFacts(scan, facts);\n    case 'patterns': return layersFacts(facts, patterns);\n    case 'services': return servicesFacts(scan, manifest);\n    case 'tour': {\n      const stop = state.tour.stops[state.tour.idx];\n      if (!stop) return tourStopFacts({ stop: null });\n      return tourStopFacts({\n        ctx: await gatherFileContext(target.path),\n        externals: externalsFor(scan, target.path),\n        stop,\n        index: state.tour.idx,\n        total: state.tour.stops.length,\n      });\n    }\n    case 'file': return fileFacts({\n      ctx: await gatherFileContext(target.path),\n      externals: externalsFor(scan, target.path),\n    });\n    default: return folderFacts(scan, facts, target.path);\n  }\n}\n"]}

package/public/js/analysisPanel.d.ts

@@ -0,0 +1,7 @@
+export declare function subscribeAnalysis(listener: any): () => boolean;
+export declare function ensureToolsStatus(force?: boolean): Promise<any>;
+export declare function runDeepAnalysis(options?: Record<string, any>): Promise<any>;
+export declare function installEngine(id: any): Promise<any>;
+export declare function runOutcomeMessage(report: any): string;
+export declare function initAnalysisPanel(options: any): void;
+export declare function renderAnalysisPanel(): void;