@polycode-projects/the-mechanical-code-talker 2.9.0 → 2.9.4

package/src/surfaces/web/sprites-browser-entry.mjs

@@ -0,0 +1,68 @@
+// sprites-browser-entry.mjs — the esbuild entry for sprites.html's chat dock
+// (public/sprites-browser.bundle.js, built by scripts/build-sprites-bundle.mjs).
+//
+// One session factory over the real engine, mirroring
+// spider-fly-browser-entry.mjs's createSpiderFlySession minus the game: no
+// board, no tick — just the FULL chat turn engine (chat.mjs's runTurn, the
+// exact dispatch the CLI runs) over one in-memory store seeded with the
+// sprite-facts corpus the page embeds at build time
+// (src/domain/sprite-facts.mjs's rows). A question the engine can't ground in
+// those rows gets the same refusal the CLI gives — never a guess.
+//
+// The page's own inline script answers the closed set of catalog-specific
+// question shapes (sprite-catalog-viz.mjs's answerSpriteQuestion) BEFORE
+// handing a line to this session, so this bundle carries no sprite-specific
+// grammar of its own.
+import { runTurn } from "../../services/chat.mjs";
+import { createInMemoryStore, appendFacts, normFactTerm } from "../../adapters/memory/core.mjs";
+import { parseEntities } from "../../domain/codegraph.mjs";
+import { loadLexicon } from "../../domain/grammar/lexicon.mjs";
+import { SPRITE_FACTS_PROVENANCE } from "../../domain/sprite-facts.mjs";
+import { registerWinkModel } from "../../adapters/wink-model.mjs";
+
+/** A live in-memory chat session seeded with the embedded sprite-facts rows.
+ *  Returns { memoryDir, sessionId, factCount, turn }. */
+export async function createSpriteCatalogSession({ factRows = [] } = {}) {
+  const memoryDir = createInMemoryStore();
+  await appendFacts(memoryDir, factRows.map((f) => ({
+    subject: f.subject, predicate: f.predicate, object: f.object, provenance: SPRITE_FACTS_PROVENANCE,
+  })));
+
+  const graph = parseEntities({ individuals: [], objectProperties: [] });
+  const lexicon = loadLexicon();
+  const sessionId = globalThis.crypto?.randomUUID?.() ?? String(Date.now());
+
+  let focus = null;
+  let last = null;
+
+  return {
+    memoryDir,
+    sessionId,
+    factCount: factRows.length,
+
+    /** One dispatched chat turn — the SAME runTurn the CLI runs, over this
+     *  session's own memoryDir. A throwing runTurn must never kill the
+     *  session — the page has no other chance to show this turn's answer. */
+    async turn(line) {
+      let result;
+      try {
+        result = await runTurn(line, {
+          config: null, source: null, graph, focus, last, memoryDir, sessionId,
+          env: {}, lexicon, vocabHint: "",
+        });
+      } catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return { answer: `Something went wrong answering that (${message}). Try rephrasing, or /help.`, end: false, record: null };
+      }
+      focus = result.focus;
+      last = result.last;
+      return { answer: result.answer, end: Boolean(result.end), record: result.record ?? null };
+    },
+  };
+}
+
+// registerWinkModel is re-exported so the page's own inline script can hand in
+// the self-hosted wink pair (./vendor/wink.js) exactly the way chat.html/
+// ledger.html/plan.html register theirs — the bundle itself never imports
+// wink-nlp (wink-model.mjs's own header explains why).
+globalThis.tmctSprites = { createSpriteCatalogSession, registerWinkModel, normFactTerm };

package/src/tools/memory-fallthrough.mjs

@@ -4,7 +4,7 @@
 // facts instead, always citing provenance.
 
 import { dirname } from "node:path";
-import { loadMemory, readFactRows, normFactTerm } from "../adapters/memory/core.mjs";
+import { loadMemory, openConfiguredMemoryBackend, readFactRows, normFactTerm } from "../adapters/memory/core.mjs";
 
 // The reified isa-family predicates a memory Fact carries ("<subject> rdfs:subClassOf
 // <object>" / "rdf:type"): subject IS-A object. Subclasses of X = facts whose OBJECT is X;
@@ -14,11 +14,18 @@ const MEMORY_LIST_CAP = 40;
 
 /** Load the conversational-memory Facts as trust-bearing rows, failure-tolerant (no memory
  *  store / unreadable → [], so the tool still returns its honest code-map miss). repoRoot is
- *  the dir that CONTAINS .tmct/ (graphFile = <repo>/.tmct/graph.json), which is exactly the
- *  `dir` loadMemory joins MEMORY_GRAPH_REL onto. */
+ *  the dir that CONTAINS .tmct/ (graphFile = <repo>/.tmct/graph.json). The read goes through
+ *  the repo's CONFIGURED memory backend — the same store chat's taught facts land in — opened
+ *  fresh per call and closed before returning, never the retired flat-file store off a raw
+ *  repo path. */
 export async function memoryFactRows(config) {
   try {
-    return readFactRows(await loadMemory(dirname(dirname(config.graphFile))));
+    const { dir, close } = await openConfiguredMemoryBackend(dirname(dirname(config.graphFile)));
+    try {
+      return readFactRows(await loadMemory(dir));
+    } finally {
+      await close();
+    }
   } catch {
     return [];
   }