@polycode-projects/seonix 0.8.0 → 0.9.1

package/src/sessions.mjs

@@ -1,14 +1,14 @@
 // sessions.mjs — chat sessions as first-class temporal graph data, like commits.
 //
 // A `seonix chat` session leaves two artifacts under the target repo:
-//   .seonix/session-<uuidv7>.log            — the human-readable transcript (chat.mjs)
+//   .seonix/session-<uuidv7>.log            — the human-readable transcript (the chat shim)
 //   .seonix/sessions/session-<uuidv7>.jsonl — the STRUCTURED sidecar this module owns:
 //     {"type":"session", id, started, repo, seonixVersion}        (header line)
 //     {"type":"turn", ts, query, resolvedIds, answeredIds, miss}  (one per turn, flushed)
 //     {"type":"end", ts}                                          (clean close marker)
 //
 // From the sidecar the session enters the typed graph twice:
-//   - READ TIME (chat.mjs, per turn): appendSessionToGraph() upserts one `Session`
+//   - READ TIME (the chat shim, per turn): appendSessionToGraph() upserts one `Session`
 //     individual (`session:<uuidv7>`) + `mgx:asksAbout` edges into graph.json —
 //     atomically (temp + rename), re-reading the file first so a re-index that
 //     happened mid-session is tolerated: edges whose targets vanished are dropped,
@@ -141,7 +141,7 @@ export function upsertSession(entities, record) {
   return { kept: targets.length, dropped };
 }
 
-/** Read-time append (chat.mjs, once per turn): re-read graph.json FRESH (a re-index
+/** Read-time append (the chat shim, once per turn): re-read graph.json FRESH (a re-index
  *  may have replaced it mid-session), upsert, write back atomically. Throws on a
  *  missing/invalid artifact — the caller treats the append as best-effort. */
 export async function appendSessionToGraph(graphFile, record) {

package/src/source.mjs

@@ -19,12 +19,25 @@ export function clearCache() {
  *  source JSON can't be stat'd. node:sqlite is imported LAZILY here, so a gate-off load
  *  never touches sqlite (no ExperimentalWarning, no store.mjs sqlite import). */
 async function fetchFromStore(config) {
+  const { readPayload, storeFileFor } = await import("./store.mjs");
+  const dbPath = config.storeFile || storeFileFor(config.graphFile);
   let expectStat;
   try { expectStat = await stat(config.graphFile); }
-  catch { return null; } // no source JSON to verify against → let the JSON path emit its own error
+  catch {
+    // graph.json is gone. If a built store IS on disk, the freshness check has nothing to verify
+    // against and the JSON path below would ENOENT with a generic "no graph artifact" message —
+    // confusing when a usable graph.db sits right there. Give the real diagnosis instead. (A1)
+    let hasStore = false;
+    try { await stat(dbPath); hasStore = true; } catch { /* no store either */ }
+    if (hasStore)
+      throw new ToolError(
+        `graph.db present but graph.json is gone (${config.graphFile}) — the store's freshness ` +
+          `check needs graph.json, so re-index this repo: ` +
+          `\`seonix cli index_repository '{"repo_path":"<abs>"}'\`.`,
+      );
+    return null; // no store either → let the JSON path emit its own "run index_repository" error
+  }
   try {
-    const { readPayload, storeFileFor } = await import("./store.mjs");
-    const dbPath = config.storeFile || storeFileFor(config.graphFile);
     return await readPayload(dbPath, { expectStat });
   } catch (e) {
     process.stderr.write(`seonix: sqlite store unavailable (${e?.name || e?.code || e?.message || e}); using graph.json\n`);

package/src/summary.mjs

@@ -15,6 +15,7 @@
 
 import { writeFile, rename, mkdir } from "node:fs/promises";
 import { join } from "node:path";
+import { hubDemote } from "./paths.mjs";
 
 // V8's hard maximum string length (chars). A graph.json larger than this can't be
 // JSON.parse'd back into one string — the failure mode the wh estate hit at 80%.
@@ -69,10 +70,13 @@ export function hubModules(entities, { prefix = "", top = 5 } = {}) {
   const rows = [];
   for (const [id, deg] of degree) {
     if (!id.startsWith(want)) continue;
-    rows.push({ id, label: labelById.get(id) ?? id.slice(4), degree: deg });
+    const label = labelById.get(id) ?? id.slice(4);
+    // Sort weight down-weights test/non-prod hubs (0.8.1) so a shared test harness can't dominate
+    // SUMMARY.md's hub list (the wh estate symptom); the reported `degree` stays the raw value.
+    rows.push({ id, label, degree: deg, weight: deg * hubDemote(label) });
   }
-  rows.sort((a, b) => (b.degree - a.degree) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
-  return rows.slice(0, top);
+  rows.sort((a, b) => (b.weight - a.weight) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+  return rows.slice(0, top).map(({ id, label, degree }) => ({ id, label, degree }));
 }
 
 /**

package/src/toml-config.mjs

@@ -123,6 +123,19 @@ export async function normalizeConfig(raw, { configDir } = {}) {
   const tel = src.telemetry || {};
   if (tel.enabled !== undefined) cfg.telemetry = { enabled: tel.enabled };
 
+  // [interfaces] — un-typed interface (route↔handler) indexing (PLAN_UNTYPED_INTERFACES.md).
+  // OFF by default; enabled emits gated `serves` edges + Route individuals. The matcher knobs
+  // (frameworks/verbs/combine_controller_prefix/prefix_strip/match_threshold) are tunable.
+  const ifc = src.interfaces || {};
+  const interfaces = {};
+  if (ifc.enabled !== undefined) interfaces.enabled = ifc.enabled;
+  if (ifc.frameworks !== undefined) interfaces.frameworks = ifc.frameworks;
+  if (ifc.verbs !== undefined) interfaces.verbs = ifc.verbs;
+  if (ifc.combine_controller_prefix !== undefined) interfaces.combineControllerPrefix = ifc.combine_controller_prefix;
+  if (ifc.prefix_strip !== undefined) interfaces.prefixStrip = ifc.prefix_strip;
+  if (ifc.match_threshold !== undefined) interfaces.matchThreshold = ifc.match_threshold;
+  if (Object.keys(interfaces).length) cfg.interfaces = interfaces;
+
   const unwired = [];
   for (const [a, b] of UNWIRED_KEYS) {
     if (src[a] && src[a][b] !== undefined) unwired.push(`${a}.${b}`);

package/src/uuid.mjs

@@ -1,5 +1,5 @@
 // uuid.mjs — RFC 9562 UUIDv7 (node:crypto ships v4 only). Lifted verbatim from
-// chat.mjs so the chat session id, the telemetry invocation id, and the bench
+// the chat session id, the telemetry invocation id, and the bench
 // per-run stamp all share ONE time-sortable implementation (no second copy, no dep).
 
 import { randomBytes } from "node:crypto";

package/src/viz.mjs

@@ -26,8 +26,8 @@ import { loadConfig } from "./config.mjs";
 import * as source from "./source.mjs";
 import { buildTemporalGraph, buildBrowserData, gitCommitOrder, gitCommitParents, renderBrowserHtml } from "./browser.mjs";
 import { extractTimeline, renderTimelineHtml } from "./timeline.mjs";
-// The wink lemma tier is gone (PLAN_CHAT_EXTRACTION.md Stage 6): the ask panel runs tmct's engine
-// adapter-less, so there is no ~4 MB browser model to build. `--nlp` is now a no-op.
+// The ask panel runs tmct's engine bundled for the browser (see askSource() below), adapter-less —
+// there is no wink lemma tier or ~4 MB browser model.
 
 // Portable single-file gate: above this serialized graph size, embedding the
 // full raw graph inline yields an unopenable multi-hundred-MB HTML, so the
@@ -213,24 +213,12 @@ const inlineJson = (v) => JSON.stringify(v).replace(/</g, "\\u003c");
  * silently produce incomplete answers, which this project's honesty contract
  * doesn't allow (see the file-level comment's "ONE viewer, three data channels" —
  * this is a fourth, for the same one-viewer-many-modes reason).
- *
- * The OPTIONAL wink-nlp lemma tier (ask-nlp.mjs's browser twin, from nlp-bundle.mjs)
- * reaches the chat two ways: `nlpInline` inlines the ~4 MB bundle as its own <script>
- * so it registers `window.__seonixNlp` at page load (portable `viz --nlp`); `nlpPath`
- * points the page at a same-origin sibling asset the chat LAZY-loads on first ask
- * (the SITE build). Neither is present in the default local single-file — that viewer
- * stays lemma-off and fetches nothing, exactly as before, preserving its
- * no-external-fetch guarantee. ask() picks up whatever `window.__seonixNlp` is set,
- * or degrades to the adapter-less tiers when it's absent.
  */
-export function renderViewerHtml({ cytoscape, askEngine = "", embedData = null, dataPath = null, askData = null, askDataPath = null, nlpInline = null, nlpPath = null } = {}) {
+export function renderViewerHtml({ cytoscape, askEngine = "", embedData = null, dataPath = null, askData = null, askDataPath = null } = {}) {
   const embedded = embedData ? `<script type="application/json" id="seonix-data">${inlineJson(embedData)}</script>\n` : "";
   const askEmbedded = askData ? `<script type="application/json" id="seonix-ask-data">${inlineJson(askData)}</script>\n` : "";
-  const cfgObj = { ...(dataPath ? { data: dataPath } : {}), ...(askDataPath ? { ask: askDataPath } : {}), ...(nlpPath ? { nlp: nlpPath } : {}) };
+  const cfgObj = { ...(dataPath ? { data: dataPath } : {}), ...(askDataPath ? { ask: askDataPath } : {}) };
   const cfg = Object.keys(cfgObj).length ? `<script type="application/json" id="seonix-cfg">${inlineJson(cfgObj)}</script>\n` : "";
-  // Inline bundle: escape any literal </script inside the wink model data so the
-  // block can't be closed early (harmless inside JS strings, impossible outside them).
-  const nlpEmbedded = nlpInline ? `<script>${String(nlpInline).replace(/<\/script/gi, "<\\/script")}</script>\n` : "";
   return `<!doctype html><html><head><meta charset="utf-8"><title>seon code-map</title>
 <!-- generated by: seonix viz (see packages/seonix/src/viz.mjs) — one viewer, data loaded at runtime -->
 <style>
@@ -308,7 +296,7 @@ export function renderViewerHtml({ cytoscape, askEngine = "", embedData = null,
 </div>
 ${embedded}${askEmbedded}${cfg}<script>${cytoscape}</script>
 <script>${askEngine}</script>
-${nlpEmbedded}<script>
+<script>
 // Type palette (see the CVD note in viz.mjs) — viewer styling, identical for every repo.
 const COLORS={Module:'#3987e5',Class:'#c98500',Function:'#008300',Method:'#d55181',Attribute:'#9085e9',GlobalVariable:'#d95926',Commit:'#199e70'};
 const $=id=>document.getElementById(id);
@@ -351,29 +339,6 @@ function loadAskData(){
   })();
   return _askGraphPromise;
 }
-// The OPTIONAL wink-nlp lemma adapter (window.__seonixNlp — see nlp-bundle.mjs).
-// An inlined bundle registers it at page load; the site build ships it as a
-// same-origin sibling this injects LAZILY on the first ask (never at boot), so the
-// ~4 MB model is only paid for when the chat is actually used. With neither present
-// (the default local single-file) this resolves to undefined and the chat runs
-// adapter-less — ask() then falls back to its curated + fuzzy tiers, exactly as
-// before, and NOTHING is fetched, keeping the no-external-fetch guarantee intact.
-let _nlpPromise=null;
-function loadNlp(){
-  if(window.__seonixNlp) return Promise.resolve(window.__seonixNlp);
-  if(_nlpPromise) return _nlpPromise;
-  const cfgEl=document.getElementById('seonix-cfg');
-  const url=cfgEl?JSON.parse(cfgEl.textContent).nlp:null;
-  if(!url) return Promise.resolve(undefined);
-  _nlpPromise=new Promise(res=>{
-    const s=document.createElement('script');
-    s.src=url;
-    s.onload=()=>res(window.__seonixNlp);
-    s.onerror=()=>res(undefined); // a failed asset degrades to lemma-off, never a broken chat
-    document.head.appendChild(s);
-  });
-  return _nlpPromise;
-}
 function init(G){
   document.title='seon code-map — '+G.focusLabel;
   $('focuslabel').textContent=G.focusLabel;
@@ -616,10 +581,9 @@ function init(G){
       return;
     }
     out.textContent='thinking…';
-    // Load the graph and (if configured) the wink lemma adapter together, then run
-    // the mechanical ask. An undefined nlp makes ask() degrade to its adapter-less tiers.
-    Promise.all([loadAskData(),loadNlp()]).then(([askGraph,nlp])=>{
-      const {content,seonix_ask}=ask(askGraph,query,{contextId:selId,nlp});
+    // Lazy-load the graph, then run the mechanical ask over it.
+    loadAskData().then((askGraph)=>{
+      const {content,seonix_ask}=ask(askGraph,query,{contextId:selId});
       const total=(seonix_ask.matches||[]).length;
       const shown=total?highlightAsk(seonix_ask.matches.map(m=>m.id)):0;
       out.classList.toggle('miss',!!seonix_ask.miss);
@@ -709,12 +673,10 @@ function resolveFocus(graph, focusArg) {
  * code browser rides along at `/code-browser.html` (alias `/browser`) with a live
  * temporal payload — the local equivalent of the site's browser section.
  */
-export async function startVizServer({ values, cytoscape, askEngine = "", nlpBundle = null, log = () => {} }) {
+export async function startVizServer({ values, cytoscape, askEngine = "", log = () => {} }) {
   const port = Math.max(0, parseInt(values.port, 10) || 0);
   const repoUrl = values["repo-url"] || (await repoUrlFromGit(process.cwd()));
-  // With --nlp the local live view gets the same lemma tier as the site: the bundle
-  // is served in-process at /seonix-nlp.js and the viewer lazy-loads it on first ask.
-  const viewer = renderViewerHtml({ cytoscape, askEngine, nlpPath: nlpBundle ? "/seonix-nlp.js" : null });
+  const viewer = renderViewerHtml({ cytoscape, askEngine });
   const browserPage = await renderBrowserHtml({ cytoscape });
   // nav = the routes this server itself serves; injected into every payload/page
   const nav = { home: "/", graph: "/seonix-graph.html", browser: "/code-browser.html", timeline: "/timeline.html" };
@@ -815,9 +777,6 @@ export async function startVizServer({ values, cytoscape, askEngine = "", nlpBun
         res.writeHead(500, { "content-type": "application/json" });
         res.end(JSON.stringify({ error: String(err.message || err) }));
       }
-    } else if (path === "/seonix-nlp.js" && nlpBundle) {
-      res.writeHead(200, { "content-type": "text/javascript; charset=utf-8" });
-      res.end(nlpBundle);
     } else {
       res.writeHead(404, { "content-type": "text/plain" });
       res.end("not found");
@@ -856,11 +815,6 @@ export async function runVizCli(argv) {
       // truncation ("newest N of M commits"). See src/timeline.mjs.
       limit: { type: "string", default: "100" },
       scope: { type: "string", default: "product" },
-      // Include the OPTIONAL wink-nlp lemma tier in the chat (see nlp-bundle.mjs).
-      // Site mode (--data-out): written as a same-origin sibling the page lazy-loads.
-      // Portable/serve mode: inlined (single-file) / served in-process. Off by default,
-      // so the local single-file stays lean and lemma-off exactly as before.
-      nlp: { type: "boolean", default: false },
       // Portable branch only: embed the full graph inline even past the size gate
       // (INLINE_ASKDATA_MAX_BYTES). Off by default — over-threshold graphs write
       // sidecars instead of an unopenable multi-hundred-MB single file.
@@ -870,11 +824,8 @@ export async function runVizCli(argv) {
   });
   const cytoscape = await cytoscapeSource();
   const askEngine = await askSource();
-  // The wink lemma tier was removed in Stage 6 (the panel runs tmct's engine adapter-less), so there
-  // is never a bundle to wire. `--nlp` is accepted but inert; the downstream null-guards no-op.
-  const nlpBundle = null;
   if (values.serve) {
-    await startVizServer({ values, cytoscape, askEngine, nlpBundle, log: (s) => process.stderr.write(s) });
+    await startVizServer({ values, cytoscape, askEngine, log: (s) => process.stderr.write(s) });
     return; // keeps serving until Ctrl-C
   }
   const { config, graph, raw, graphBytes } = await loadGraph(values);
@@ -926,32 +877,22 @@ export async function runVizCli(argv) {
     const rel = relative(dirname(out), dataOut) || "seonix-graph-data.json";
     const askDataOut = resolve(dirname(out), "seonix-ask-data.json");
     const askRel = relative(dirname(out), askDataOut) || "seonix-ask-data.json";
-    // The wink lemma bundle rides the same sibling-asset convention as the data
-    // files — a same-origin ./seonix-nlp.js the page lazy-loads on first ask.
-    let nlpPath = null;
-    if (nlpBundle) {
-      const nlpOut = resolve(dirname(out), "seonix-nlp.js");
-      await writeFile(nlpOut, nlpBundle);
-      nlpPath = "./seonix-nlp.js";
-    }
     await Promise.all([writeFile(dataOut, JSON.stringify(data)), writeFile(askDataOut, JSON.stringify(raw))]);
     await writeFile(out, renderViewerHtml({
       cytoscape, askEngine,
       dataPath: rel === "seonix-graph-data.json" ? null : rel,
       askDataPath: askRel === "seonix-ask-data.json" ? null : askRel,
-      nlpPath,
     }));
-    return { dataOut, askDataOut, nlpPath };
+    return { dataOut, askDataOut };
   };
   if (values["data-out"]) {
     // site mode: viewer page + sibling data file (data updates don't touch the page).
     // The chat panel's full-graph channel rides the same sibling-file convention,
     // written next to the display data file rather than embedded in the page.
-    const { dataOut, askDataOut, nlpPath } = await writeSplitViewer(resolve(values["data-out"]));
+    const { dataOut, askDataOut } = await writeSplitViewer(resolve(values["data-out"]));
     process.stderr.write(
       `seonix viz: ${subgraph.nodes.length} nodes, ${subgraph.edges.length} edges around "${focus.label}" ` +
-        `(depth ${values.depth})${subgraph.truncated ? " [capped]" : ""} → ${out} + ${dataOut} + ${askDataOut}` +
-        `${nlpPath ? ` + ${resolve(dirname(out), "seonix-nlp.js")} (wink lemma tier)` : ""}\n`,
+        `(depth ${values.depth})${subgraph.truncated ? " [capped]" : ""} → ${out} + ${dataOut} + ${askDataOut}\n`,
     );
   } else if (graphBytes > inlineAskDataMaxBytes() && !values["force-inline"]) {
     // portable mode, but the graph is too big to embed: an estate-scale full-graph
@@ -970,9 +911,8 @@ export async function runVizCli(argv) {
         `(depth ${values.depth})${subgraph.truncated ? " [capped]" : ""} → ${out} + ${dataOut} + ${askDataOut}\n`,
     );
   } else {
-    // portable mode: one self-contained file, both channels embedded (+ inline wink
-    // bundle when --nlp; otherwise lemma-off, no external fetch, exactly as before)
-    await writeFile(out, renderViewerHtml({ cytoscape, askEngine, embedData: data, askData: raw, nlpInline: nlpBundle }));
+    // portable mode: one self-contained file, both data channels embedded, no external fetch.
+    await writeFile(out, renderViewerHtml({ cytoscape, askEngine, embedData: data, askData: raw }));
     process.stderr.write(
       `seonix viz: ${subgraph.nodes.length} nodes, ${subgraph.edges.length} edges around "${focus.label}" ` +
         `(depth ${values.depth})${subgraph.truncated ? " [capped]" : ""} → ${out}\n`,