@polycode-projects/the-mechanical-code-talker 4.1.1 → 4.1.2

package/README.md

@@ -152,7 +152,7 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
 
 ```output cmd="node examples/raw-fact-shape.mjs" cwd=repo
 {
-  "id": "fact:d5327019d311a956",
+  "id": "fact:d5327019d311a956@src:corpus:human",
   "label": "dog mgx:capableOf bark",
   "class": "Fact",
   "derived_from": [],
@@ -183,6 +183,11 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
       "key": "createdAt",
       "value": "<timestamp>"
     },
+    {
+      "prop": "mgx:sourceId",
+      "key": "sourceId",
+      "value": "src:corpus:human"
+    },
     {
       "prop": "mgx:factProvenance",
       "key": "provenance",
@@ -202,12 +207,9 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
       "prop": "mgx:trustInputs",
       "key": "trustInputs",
       "value": {
-        "sourceTypes": [
-          "corpus"
-        ],
-        "corroboration": 1,
-        "createdAt": "<timestamp>",
-        "recency": 1
+        "sourceType": "corpus",
+        "sourceId": "src:corpus:human",
+        "createdAt": "<timestamp>"
       }
     },
     {
@@ -219,7 +221,7 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
 }
 
 {
-  "id": "fact:08d02295fc0fed1c",
+  "id": "fact:08d02295fc0fed1c@src:corpus:human",
   "label": "dog rdfs:subClassOf animal",
   "class": "Fact",
   "derived_from": [],
@@ -250,6 +252,11 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
       "key": "createdAt",
       "value": "<timestamp>"
     },
+    {
+      "prop": "mgx:sourceId",
+      "key": "sourceId",
+      "value": "src:corpus:human"
+    },
     {
       "prop": "mgx:factProvenance",
       "key": "provenance",
@@ -269,12 +276,9 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
       "prop": "mgx:trustInputs",
       "key": "trustInputs",
       "value": {
-        "sourceTypes": [
-          "corpus"
-        ],
-        "corroboration": 1,
-        "createdAt": "<timestamp>",
-        "recency": 1
+        "sourceType": "corpus",
+        "sourceId": "src:corpus:human",
+        "createdAt": "<timestamp>"
       }
     },
     {
@@ -289,8 +293,17 @@ are two of them exactly as they sit in the graph — `dog capableOf bark` and
 Every attribute value here is a plain string except `mgx:trustInputs`, which
 is `JSON.stringify`'d into its `value` field in the actual store (parsed back
 out above for readability) since the flat attribute list has nowhere else to
-put a nested object. `mgx:trustScore` is computed from exactly those inputs —
-source type, corroboration count, recency — never guessed.
+put a nested object.
+
+The id says who asserted it: `fact:<triple-hash>@<source-id>`. One record is
+one source asserting one triple, so a fact two sources agree on is two
+records sharing the hash. The part before the `@` is the fact id you see in
+citations and premise lists, and it never changes. Each record's own
+`mgx:trustScore` is just that one source's prior, from its type and its own
+track record — never guessed. What the whole fact is worth, corroboration
+across sources and how recently each of them said it, is folded over those
+records when you read them, so it answers for today rather than for the day
+it was written.
 
 Point it at a codebase's graph and the same engine answers structural questions.
 `examples/mini-webapp` ships in this repo, so this runs as written:
@@ -307,8 +320,8 @@ tmct> /exit
 **[Try it live in your browser →](https://tmct.polycode.co.uk/)**
 runs the actual query engine client-side. No server, no install. The landing
 page answers codebase questions live, and eight more pages each ground their
-own domain: a full chat seeded with 72,098 facts (the same nine bands as
-`npm run init:xl`, uncapped, 4.4 MB on the wire), the
+own domain: a full chat seeded with 63,470 facts (the same nine bands as
+`npm run init:xl`), the
 **memory ledger** (every fact as a readable sentence; drill by clicking the
 terms inside), and the **code explorer** (the same ledger UI refocused on a
 code graph, with a hint rail of suggested next questions). An **ingest

package/bin/tmct.mjs

@@ -559,6 +559,7 @@ async function writeStandaloneViewPage(archetype, rest) {
   const outPath = resolvePath(process.cwd(), strFlag(rest, ["--output", "--out"], `${archetype}.html`));
   let html;
   if (archetype === "sprites") {
+    const engineBundleJs = await buildEngineBundleJs("build-sprites-bundle.mjs");
     const { readSpriteTemplateFiles } = await import("../src/adapters/corpus/sprite-template-files.mjs");
     const { readSpriteLargeTemplateFiles } = await import("../src/adapters/corpus/sprite-large-template-files.mjs");
     const { loadSpriteOntologyFactRows, renderSpriteCatalogHtml } = await import("../src/services/sprite-catalog-viz.mjs");
@@ -566,6 +567,8 @@ async function writeStandaloneViewPage(archetype, rest) {
       iconTemplates: readSpriteTemplateFiles(),
       largeTemplates: readSpriteLargeTemplateFiles(),
       factRows: await loadSpriteOntologyFactRows(),
+      spritesBundleAvailable: true,
+      engineBundleJs,
     });
   } else if (archetype === "spider-fly") {
     const engineBundleJs = await buildEngineBundleJs("build-spider-fly-bundle.mjs");

package/data/templates/responses.jsonl

@@ -64,8 +64,11 @@
 {"id":"orientation-friendly","class":"orientation","register":"friendly","template":"I'm tmct — a deterministic, offline code-graph assistant (no LLM). I answer questions about THIS codebase's structure — imports, calls, definitions,\nhistory and counts. For example:\n  which modules import {example1}\n  what calls {example2}\n  how many classes are there\n/help for commands, /stats for an overview of the graph."}
 {"id":"miss-no-previous-answer","class":"miss","register":"friendly","template":"No previous answer to expand yet — ask me a question first, then say \"why\" or \"say more\"."}
 {"id":"conversational-greeting-empty","class":"conversational","register":"friendly","template":"Hi. I'm tmct. {vocabHint} Point me at a repo with `--repo <path>` for code-structure questions too (imports, calls, definitions). /help for commands."}
+{"id":"conversational-greeting-empty-browser","class":"conversational","register":"friendly","template":"Hi. I'm tmct. {vocabHint} /help for commands."}
 {"id":"orientation-empty","class":"orientation","register":"friendly","template":"I'm tmct — a deterministic, offline chat assistant (no LLM). {vocabHint} /memory for what I remember.\nFor code structure (imports, calls, definitions) point me at a repo: `--repo <path>`, or try the shipped example `npm run example:mini`. tmct reads graphs; it doesn't index code itself.\n/help for commands."}
+{"id":"orientation-empty-browser","class":"orientation","register":"friendly","template":"I'm tmct — a deterministic, offline chat assistant (no LLM). {vocabHint} /memory for what I remember, or ask about what's already loaded.\n/help for commands."}
 {"id":"identity-self","class":"conversational","register":"friendly","template":"I'm tmct — a deterministic, offline chat assistant. No LLM: wink-nlp parsing over a seeded ontology/lexicon, plus a code graph when you point me at a repo with `--repo <path>`. /help for commands, /stats for an overview."}
+{"id":"identity-self-browser","class":"conversational","register":"friendly","template":"I'm tmct — a deterministic, offline chat assistant. No LLM: wink-nlp parsing over a seeded ontology/lexicon, plus a code graph when one is loaded. {vocabHint} /help for commands, /stats for an overview."}
 {"id":"identity-not-an-llm","class":"conversational","register":"friendly","template":"No — no LLM involved. tmct is deterministic: wink-nlp parsing over a graph/ontology, not a language model. /help for commands."}
 {"id":"identity-no-feelings","class":"conversational","register":"friendly","template":"No — I don't have feelings, opinions, or consciousness. tmct is deterministic: wink-nlp parsing over a graph/ontology, not a mind. /help for commands."}
 {"id":"identity-honest-miss","class":"conversational","register":"friendly","template":"No — I never make up an answer. If a question doesn't ground to a taught fact or a real graph entity, I say so plainly instead of guessing. /help for commands."}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "4.1.1",
+  "version": "4.1.2",
   "private": false,
   "type": "module",
   "description": "The Mechanical Code Talker (tmct) — a tolerant, offline, $0 chat surface that guides you toward precision queries about a software repository. ELIZA/PARRY-style but domain-obsessed with code. No model calls; indexes a repo on request (tmct index) or reads any producer's graph.",
@@ -107,6 +107,7 @@
     "check:publish": "node scripts/check-publish.mjs",
     "check:all": "npm run check:links && npm run check:pii && npm run check:licences && npm run check:publint && npm run check:tool-docs && npm run check:budgets",
     "smoke:deploy": "node scripts/post-deploy-smoke.mjs",
+    "wait:site": "node scripts/wait-for-site.mjs",
     "chat": "node --disable-warning=ExperimentalWarning bin/tmct.mjs",
     "chat:repo": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --repo",
     "chat:plain": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --plain",