@polycode-projects/the-mechanical-code-talker 3.0.5 → 3.0.7

package/corpus/tier2/generate.mjs

@@ -719,7 +719,7 @@ export const CORPUSES = {
       nouns: [
         // human-core (+186 words: people, family, common roles)
         "draw", "set", "heavy", "stand", "free", "pack", "dead", "pick",
-        "double", "straight", "cast", "dry", "bank", "stamp", "tender", "fair",
+        "double", "cast", "dry", "bank", "stamp", "tender", "fair",
         "active", "regular", "blue", "hack", "band", "brush", "guard", "master",
         "transfer", "firm", "side", "bull", "mate", "rank", "board", "brace",
         "grade", "better", "course", "natural", "butt", "camp", "crop", "date",
@@ -733,7 +733,7 @@ export const CORPUSES = {
         "steady", "stream", "combine", "company", "convert", "general", "moderate", "alternate",
         "ace", "crab", "flop", "fund", "pair", "rake", "rock", "sick",
         "blade", "cheat", "sport", "caller", "column", "couple", "divine", "pledge",
-        "simple", "sponge", "system", "wanton", "sleeper", "business", "associate", "instrument",
+        "sponge", "system", "wanton", "sleeper", "business", "associate", "instrument",
         "substitute", "gun", "sum", "alto", "best", "buff", "dear", "mass",
         "cream", "creep", "giant", "labor", "pilot", "sneak", "stack", "staff",
         "world", "gutter", "jumper", "labour", "lather", "picket", "reader", "savage",
@@ -852,7 +852,6 @@ export const CORPUSES = {
       ["dead", "/r/HasA", "dead person"],
       ["pick", "/r/IsA", "elite"],
       ["double", "/r/IsA", "actor"],
-      ["straight", "/r/IsA", "person"],
       ["cast", "/r/IsA", "gathering"],
       ["dry", "/r/IsA", "reformer"],
       ["bank", "/r/IsA", "financial institution"],
@@ -968,7 +967,6 @@ export const CORPUSES = {
       ["couple", "/r/IsA", "pair"],
       ["divine", "/r/IsA", "reverend"],
       ["pledge", "/r/IsA", "member"],
-      ["simple", "/r/IsA", "person"],
       ["sponge", "/r/IsA", "learner"],
       ["system", "/r/IsA", "group"],
       ["system", "/r/HasA", "hierarchy"],
@@ -1845,7 +1843,7 @@ export const CORPUSES = {
         "ideal", "noble", "octet", "quack", "saint", "scrag", "shark", "shoal",
         "silly", "skunk", "super", "witch", "zombi", "agency", "anchor", "backup",
         "batter", "buster", "canary", "circus", "dealer", "domain", "doomed", "genius",
-        "gossip", "herald", "hoodoo", "hopper", "immune", "jockey", "legion", "member",
+        "gossip", "herald", "hoodoo", "hopper", "jockey", "legion", "member",
         "nature", "orphan", "parade", "peanut", "pillar", "pirate", "player", "porter",
         "pusher", "putter", "senior", "septet", "sestet", "sextet", "surety", "tapper",
         "tiller", "zombie", "adjunct", "butcher", "captive", "cascade", "chapter", "charity",
@@ -1884,7 +1882,7 @@ export const CORPUSES = {
         "canvasser", "cockscomb", "collector", "comforter", "commander", "companion", "conductor", "crossover",
         "eccentric", "executive", "fledgling", "franchise", "freelance", "incumbent", "mercenary", "moderator",
         "neighbour", "newspaper", "patriarch", "patrician", "portfolio", "quartette", "quintette", "repertory",
-        "secretary", "segregate", "spearhead", "stigmatic", "summation", "transient", "trumpeter", "voluntary",
+        "secretary", "segregate", "spearhead", "summation", "transient", "trumpeter", "voluntary",
         "absolutism", "anthropoid", "apparition", "assemblage", "collective", "contractor", "delinquent", "episcopate",
         "exaltation", "exposition", "illiterate", "judicature", "leadership", "lieutenant", "minimalist", "percussion",
         "profligate", "provincial", "rendezvous", "brotherhood", "determinant", "distributor", "interpreter", "stipendiary",
@@ -3267,7 +3265,6 @@ export const CORPUSES = {
       ["hoodoo", "/r/IsA", "priest"],
       ["priest", "/r/IsA", "spiritual leader"],
       ["hopper", "/r/IsA", "jumper"],
-      ["immune", "/r/IsA", "person"],
       ["jockey", "/r/IsA", "equestrian"],
       ["legion", "/r/IsA", "military unit"],
       ["legion", "/r/HasA", "legionnaire"],
@@ -3755,7 +3752,6 @@ export const CORPUSES = {
       ["friend", "/r/IsA", "actor"],
       ["segregate", "/r/IsA", "actor"],
       ["spearhead", "/r/IsA", "leader"],
-      ["stigmatic", "/r/IsA", "person"],
       ["summation", "/r/IsA", "collection"],
       ["transient", "/r/IsA", "traveler"],
       ["trumpeter", "/r/IsA", "messenger"],

package/corpus/tier2/human-large.jsonl

@@ -438,7 +438,6 @@
 {"start":"/c/en/hoodoo","rel":"/r/IsA","end":"/c/en/priest","weight":1,"surfaceText":"[[hoodoo]] IsA [[priest]]"}
 {"start":"/c/en/priest","rel":"/r/IsA","end":"/c/en/spiritual leader","weight":1,"surfaceText":"[[priest]] IsA [[spiritual leader]]"}
 {"start":"/c/en/hopper","rel":"/r/IsA","end":"/c/en/jumper","weight":1,"surfaceText":"[[hopper]] IsA [[jumper]]"}
-{"start":"/c/en/immune","rel":"/r/IsA","end":"/c/en/person","weight":1,"surfaceText":"[[immune]] IsA [[person]]"}
 {"start":"/c/en/jockey","rel":"/r/IsA","end":"/c/en/equestrian","weight":1,"surfaceText":"[[jockey]] IsA [[equestrian]]"}
 {"start":"/c/en/legion","rel":"/r/IsA","end":"/c/en/military unit","weight":1,"surfaceText":"[[legion]] IsA [[military unit]]"}
 {"start":"/c/en/legion","rel":"/r/HasA","end":"/c/en/legionnaire","weight":1,"surfaceText":"[[legion]] HasA [[legionnaire]]"}
@@ -926,7 +925,6 @@
 {"start":"/c/en/friend","rel":"/r/IsA","end":"/c/en/actor","weight":1,"surfaceText":"[[friend]] IsA [[actor]]"}
 {"start":"/c/en/segregate","rel":"/r/IsA","end":"/c/en/actor","weight":1,"surfaceText":"[[segregate]] IsA [[actor]]"}
 {"start":"/c/en/spearhead","rel":"/r/IsA","end":"/c/en/leader","weight":1,"surfaceText":"[[spearhead]] IsA [[leader]]"}
-{"start":"/c/en/stigmatic","rel":"/r/IsA","end":"/c/en/person","weight":1,"surfaceText":"[[stigmatic]] IsA [[person]]"}
 {"start":"/c/en/summation","rel":"/r/IsA","end":"/c/en/collection","weight":1,"surfaceText":"[[summation]] IsA [[collection]]"}
 {"start":"/c/en/transient","rel":"/r/IsA","end":"/c/en/traveler","weight":1,"surfaceText":"[[transient]] IsA [[traveler]]"}
 {"start":"/c/en/trumpeter","rel":"/r/IsA","end":"/c/en/messenger","weight":1,"surfaceText":"[[trumpeter]] IsA [[messenger]]"}

package/corpus/tier2/human-medium.jsonl

@@ -9,7 +9,6 @@
 {"start":"/c/en/dead","rel":"/r/HasA","end":"/c/en/dead person","weight":1,"surfaceText":"[[dead]] HasA [[dead person]]"}
 {"start":"/c/en/pick","rel":"/r/IsA","end":"/c/en/elite","weight":1,"surfaceText":"[[pick]] IsA [[elite]]"}
 {"start":"/c/en/double","rel":"/r/IsA","end":"/c/en/actor","weight":1,"surfaceText":"[[double]] IsA [[actor]]"}
-{"start":"/c/en/straight","rel":"/r/IsA","end":"/c/en/person","weight":1,"surfaceText":"[[straight]] IsA [[person]]"}
 {"start":"/c/en/cast","rel":"/r/IsA","end":"/c/en/gathering","weight":1,"surfaceText":"[[cast]] IsA [[gathering]]"}
 {"start":"/c/en/dry","rel":"/r/IsA","end":"/c/en/reformer","weight":1,"surfaceText":"[[dry]] IsA [[reformer]]"}
 {"start":"/c/en/bank","rel":"/r/IsA","end":"/c/en/financial institution","weight":1,"surfaceText":"[[bank]] IsA [[financial institution]]"}
@@ -125,7 +124,6 @@
 {"start":"/c/en/couple","rel":"/r/IsA","end":"/c/en/pair","weight":1,"surfaceText":"[[couple]] IsA [[pair]]"}
 {"start":"/c/en/divine","rel":"/r/IsA","end":"/c/en/reverend","weight":1,"surfaceText":"[[divine]] IsA [[reverend]]"}
 {"start":"/c/en/pledge","rel":"/r/IsA","end":"/c/en/member","weight":1,"surfaceText":"[[pledge]] IsA [[member]]"}
-{"start":"/c/en/simple","rel":"/r/IsA","end":"/c/en/person","weight":1,"surfaceText":"[[simple]] IsA [[person]]"}
 {"start":"/c/en/sponge","rel":"/r/IsA","end":"/c/en/learner","weight":1,"surfaceText":"[[sponge]] IsA [[learner]]"}
 {"start":"/c/en/system","rel":"/r/IsA","end":"/c/en/group","weight":1,"surfaceText":"[[system]] IsA [[group]]"}
 {"start":"/c/en/system","rel":"/r/HasA","end":"/c/en/hierarchy","weight":1,"surfaceText":"[[system]] HasA [[hierarchy]]"}

package/corpus/tier2/manifest.json

@@ -81,9 +81,9 @@
         "tool": "corpus/tier2/generate.mjs"
       },
       "file": "human-medium.jsonl",
-      "facts": 944,
-      "bytes": 110796,
-      "sha256": "63270a928f4d304489bd552c1e50704ff2d6f17841cf11a87a292418eaa572c0",
+      "facts": 942,
+      "bytes": 110564,
+      "sha256": "152df1c9026ace0ecf899e89b23dab77617e97fe0d7fafd50866e26a792f0454",
       "license": "MPL-2.0"
     },
     {
@@ -95,9 +95,9 @@
         "tool": "corpus/tier2/generate.mjs"
       },
       "file": "human-large.jsonl",
-      "facts": 12001,
-      "bytes": 1464850,
-      "sha256": "754d9d4c046f92994a5f5fa0abde27af65a47ec546b3051bf972bfa76b642917",
+      "facts": 11999,
+      "bytes": 1464616,
+      "sha256": "fbbe8135d4915f2bc041bf577e7b0bd1a8fd1c1bab804c8215b1d05e39db27f9",
       "license": "MPL-2.0"
     }
   ],

package/data/templates/constructions/digest-sentence-structures.toml

@@ -10,19 +10,30 @@
 # reads only [[relation]] and [[construction]] tables, so it ignores this file's
 # [[structure]] rows; the digest layer reads them through its own path.
 #
-# Each row is one (family, form) pairing:
+# Each row is one wording for a (family, form) pairing. A key may hold several
+# rows: the renderer collects them all and picks one by a deterministic hash of
+# term|family|form|variantSeed, so a key with one wording always renders that
+# wording, while a key with several gives natural variety that stays stable
+# across runs. An exact-string duplicate under a key is folded; a second, truly
+# different wording is kept as another variant.
 #   family  one of the digest families (isa | location | partOf | capableOf |
 #           usedFor) — the closed set stage 1 groups predicates under. Each is
 #           verb-coherent: every predicate in it shares this frame's verb.
 #   form    single   — one fact of the family
 #           several  — two or more facts of the family, merged into one clause
 #           chained  — one isa fact plus its rendered ancestry chain
+#           group    — one body sentence of the multi-sentence isa digest: the
+#                      facts that share an immediate parent class, named together
+#           closer   — the closing sentence of the multi-sentence isa digest:
+#                      the highest-level ontology roots the term sits under
 #   template  the skeleton. Placeholders the renderer fills (words.mjs supplies
 #             the article, plural and casing):
 #               {TERM} {TERM_CAP}          the term, lower / sentence-leading
 #               {A_TERM} {A_TERM_CAP}      "an aardvark" / "An aardvark"
 #               {TERMS} {TERMS_CAP}        "aardvarks" / "Aardvarks"
 #               {PRONOUN} {PRONOUN_CAP}    "it" / "It" (after first mention)
+#               {PARENT} {A_PARENT}        the shared immediate parent of a group
+#                                          — "mammal" / "a mammal"
 #               {OBJECT}                   the first object, raw
 #               {A_OBJECT}                 "a mammal" (article chosen per word)
 #               {OBJECTS_A}                "a mammal, a burrowing animal, and …"
@@ -48,6 +59,50 @@ family = "isa"
 form = "chained"
 template = "{A_TERM_CAP} is {CHAIN}."
 
+# ---- isa group: one body sentence for facts under a shared parent class -----
+
+[[structure]]
+family = "isa"
+form = "group"
+template = "As a kind of {PARENT}, {PRONOUN} is also {OBJECTS_A}."
+
+[[structure]]
+family = "isa"
+form = "group"
+template = "Being {A_PARENT}, {PRONOUN} is {OBJECTS_A} too."
+
+[[structure]]
+family = "isa"
+form = "group"
+template = "Within the {PARENT} family, {PRONOUN} counts as {OBJECTS_A}."
+
+[[structure]]
+family = "isa"
+form = "group"
+template = "As {A_PARENT}, {PRONOUN} is {OBJECTS_A}."
+
+# ---- isa closer: the highest-level roots the term sits under ----------------
+
+[[structure]]
+family = "isa"
+form = "closer"
+template = "More broadly, {TERMS} sit within {OBJECTS_A} in the wider hierarchy."
+
+[[structure]]
+family = "isa"
+form = "closer"
+template = "More generally, {TERMS} fall under {OBJECTS_A}."
+
+[[structure]]
+family = "isa"
+form = "closer"
+template = "Higher up, {TERMS} are kinds of {OBJECTS_PLURAL}."
+
+[[structure]]
+family = "isa"
+form = "closer"
+template = "Zooming out, {TERMS} belong among {OBJECTS_PLURAL}."
+
 # ---- location: where it is found (atLocation / locatedNear) ----------------
 
 [[structure]]
@@ -60,6 +115,21 @@ family = "location"
 form = "several"
 template = "{PRONOUN_CAP} is found in {OBJECTS_RAW}."
 
+[[structure]]
+family = "location"
+form = "several"
+template = "{PRONOUN_CAP} lives in {OBJECTS_RAW}."
+
+[[structure]]
+family = "location"
+form = "several"
+template = "You'll find {PRONOUN} in {OBJECTS_RAW}."
+
+[[structure]]
+family = "location"
+form = "several"
+template = "{PRONOUN_CAP} turns up in {OBJECTS_RAW}."
+
 # ---- partOf: what it belongs to -------------------------------------------
 
 [[structure]]
@@ -67,11 +137,41 @@ family = "partOf"
 form = "single"
 template = "{PRONOUN_CAP} is part of {A_OBJECT}."
 
+[[structure]]
+family = "partOf"
+form = "single"
+template = "{PRONOUN_CAP} belongs to {A_OBJECT}."
+
+[[structure]]
+family = "partOf"
+form = "single"
+template = "{PRONOUN_CAP} forms part of {A_OBJECT}."
+
+[[structure]]
+family = "partOf"
+form = "single"
+template = "{PRONOUN_CAP} makes up part of {A_OBJECT}."
+
 [[structure]]
 family = "partOf"
 form = "several"
 template = "{PRONOUN_CAP} is part of {OBJECTS_A}."
 
+[[structure]]
+family = "partOf"
+form = "several"
+template = "{PRONOUN_CAP} belongs to {OBJECTS_A}."
+
+[[structure]]
+family = "partOf"
+form = "several"
+template = "{PRONOUN_CAP} forms part of {OBJECTS_A}."
+
+[[structure]]
+family = "partOf"
+form = "several"
+template = "{PRONOUN_CAP} is one part of {OBJECTS_A}."
+
 # ---- capableOf: what it can do --------------------------------------------
 
 [[structure]]
@@ -84,6 +184,21 @@ family = "capableOf"
 form = "several"
 template = "{PRONOUN_CAP} can {OBJECTS_RAW}."
 
+[[structure]]
+family = "capableOf"
+form = "several"
+template = "{PRONOUN_CAP} is able to {OBJECTS_RAW}."
+
+[[structure]]
+family = "capableOf"
+form = "several"
+template = "{PRONOUN_CAP} knows how to {OBJECTS_RAW}."
+
+[[structure]]
+family = "capableOf"
+form = "several"
+template = "{PRONOUN_CAP} tends to {OBJECTS_RAW}."
+
 # ---- usedFor: what it is used for -----------------------------------------
 
 [[structure]]
@@ -91,7 +206,37 @@ family = "usedFor"
 form = "single"
 template = "{PRONOUN_CAP} is used for {OBJECT}."
 
+[[structure]]
+family = "usedFor"
+form = "single"
+template = "{PRONOUN_CAP} helps with {OBJECT}."
+
+[[structure]]
+family = "usedFor"
+form = "single"
+template = "People use {PRONOUN} for {OBJECT}."
+
+[[structure]]
+family = "usedFor"
+form = "single"
+template = "{PRONOUN_CAP} works for {OBJECT}."
+
 [[structure]]
 family = "usedFor"
 form = "several"
 template = "{PRONOUN_CAP} is used for {OBJECTS_RAW}."
+
+[[structure]]
+family = "usedFor"
+form = "several"
+template = "{PRONOUN_CAP} helps with {OBJECTS_RAW}."
+
+[[structure]]
+family = "usedFor"
+form = "several"
+template = "People use {PRONOUN} for {OBJECTS_RAW}."
+
+[[structure]]
+family = "usedFor"
+form = "several"
+template = "{PRONOUN_CAP} works for {OBJECTS_RAW}."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "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.",
@@ -47,7 +47,8 @@
     "./createCompletionsGraphAdapter": "./src/services/completions.mjs",
     "./ingest": "./src/services/extract-facts.mjs",
     "./repository-interface": "./src/adapters/repository-interface.mjs",
-    "./conformance": "./src/tools/conformance.mjs"
+    "./conformance": "./src/tools/conformance.mjs",
+    "./ask-browser": "./src/surfaces/web/graph-ask-browser-entry.mjs"
   },
   "files": [
     "bin/",
@@ -87,9 +88,11 @@
     "test": "node --disable-warning=ExperimentalWarning --test --test-concurrency=8 \"test/**/*.test.mjs\"",
     "test:smoke": "node --disable-warning=ExperimentalWarning --test test/smoke/*.test.mjs",
     "test:fast": "node --disable-warning=ExperimentalWarning --test --test-concurrency=8 test/smoke/*.test.mjs test/fast/*.test.mjs test/tools/ask.test.mjs test/tools/server.test.mjs test/estate/import-layers.test.mjs",
-    "test:e2e": "node --disable-warning=ExperimentalWarning --test \"e2e/*.test.mjs\"",
-    "test:e2e:heavy": "node --disable-warning=ExperimentalWarning --test \"e2e/heavy/*.test.mjs\"",
-    "check:readme": "TMCT_CHECK_README=1 node --disable-warning=ExperimentalWarning --test e2e/readme-examples.test.mjs",
+    "test:unit": "node --disable-warning=ExperimentalWarning --test --test-concurrency=8 $(node scripts/list-unit-test-files.mjs)",
+    "test:slow": "node --disable-warning=ExperimentalWarning --test test/bench/synthbench-code.test.mjs test/estate/generated-artifacts.test.mjs test/readme/readme.test.mjs test/corpus/bench-smoke.test.mjs test/corpus/inference.test.mjs",
+    "test:e2e": "node --disable-warning=ExperimentalWarning --test \"test-e2e/*.test.mjs\"",
+    "test:e2e:heavy": "node --disable-warning=ExperimentalWarning --test \"test-e2e/heavy/*.test.mjs\"",
+    "check:readme": "TMCT_CHECK_README=1 node --disable-warning=ExperimentalWarning --test test-e2e/readme-examples.test.mjs",
     "e2e:browsers": "playwright install chromium",
     "gen:screenshots": "node scripts/gen-screenshots.mjs",
     "check:links": "node scripts/check-links.mjs",
@@ -128,16 +131,16 @@
     "serve:public": "node --disable-warning=ExperimentalWarning bin/tmct.mjs serve --host 0.0.0.0 --port 8787",
     "example:mini": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --repo examples/mini-webapp --ephemeral",
     "example:polyglot": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --repo examples/polyglot --ephemeral",
-    "chatbench:run": "node chatbench/run.mjs",
-    "chatbench:judge": "node chatbench/judge.mjs",
-    "chatbench:judge:cached": "node chatbench/judge.mjs --cache chatbench/verdict-cache.json",
-    "agentbench:run": "node agentbench/run.mjs",
-    "infbench": "node infbench/generate-cases.mjs && node infbench/run.mjs",
-    "idxbench:run": "node idxbench/run.mjs",
-    "researchbench:run": "node researchbench/run.mjs",
-    "synthbench:code": "node synthbench/code/run.mjs",
-    "ingestbench:run": "node ingestbench/run.mjs",
-    "ingestbench:judge": "node ingestbench/judge.mjs",
+    "chatbench:run": "node test-benchmarks/chatbench/run.mjs",
+    "chatbench:judge": "node test-benchmarks/chatbench/judge.mjs",
+    "chatbench:judge:cached": "node test-benchmarks/chatbench/judge.mjs --cache test-benchmarks/chatbench/verdict-cache.json",
+    "agentbench:run": "node test-benchmarks/agentbench/run.mjs",
+    "infbench": "node test-benchmarks/infbench/generate-cases.mjs && node test-benchmarks/infbench/run.mjs",
+    "idxbench:run": "node test-benchmarks/idxbench/run.mjs",
+    "researchbench:run": "node test-benchmarks/researchbench/run.mjs",
+    "synthbench:code": "node test-benchmarks/synthbench/code/run.mjs",
+    "ingestbench:run": "node test-benchmarks/ingestbench/run.mjs",
+    "ingestbench:judge": "node test-benchmarks/ingestbench/judge.mjs",
     "corpus:matrix": "node scripts/corpus-matrix.mjs",
     "corpus:matrix:gaps": "node scripts/corpus-matrix.mjs --gaps",
     "template:coverage": "node scripts/template-coverage.mjs",

package/src/adapters/corpus/digest-bank.mjs

@@ -5,9 +5,15 @@
 // in src/domain/digest; only the TOML read lives here, so every node surface
 // (chat, `tmct digest`, the page generators) shares one seam.
 //
-// A browser bundle stubs this module out (the ask/chat dock never digests
-// in-page — the pages digest client-side from a table embedded at build time),
-// so every consumer treats a null article as "fall back to the flat fact list".
+// build-chat-bundle.mjs swaps this module for a live in-memory twin (the
+// chat dock DOES digest in-page there — chat-browser-entry.mjs feeds it the
+// build-time-embedded [[structure]] rows via setDigestStructures); every
+// other browser bundle (ask, ledger's static render) still stubs it out to
+// null, so those consumers keep treating a null article as "fall back to the
+// flat fact list". setDigestStructures below is a no-op on THIS, the real
+// node-side module — kept only for interface parity with the live bundle
+// twin, so a file that imports both under plain Node (as a chat-engine
+// contract test does) resolves the same export set either way.
 
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
@@ -19,6 +25,12 @@ import { digestStoreStats, chainsForObjects, isaObjectsOf } from "../../domain/d
 const HERE = dirname(fileURLToPath(import.meta.url));
 const BANK_FILE = join(HERE, "..", "..", "..", "data", "templates", "constructions", "digest-sentence-structures.toml");
 
+/** No-op here — the node-side adapter always reads its structures from the
+ *  committed TOML bank (below), never from an externally-supplied table. Only
+ *  the browser bundle's live twin (build-chat-bundle.mjs's stub) actually
+ *  holds state behind this setter. */
+export function setDigestStructures() {}
+
 /** The raw [[structure]] rows parsed from the committed bank, once. A missing or
  *  unparseable bank yields an empty list — the digest degrades to the caller's
  *  flat fallback rather than throwing, the same posture the construction-bank

package/src/domain/answer-variants.json

@@ -10,7 +10,7 @@
         "ask.mjs metaFallbackEntityAnswer (\"X is a Y in this codebase, defined in Z ...\")"
       ],
       "deliberatelyNotUsedBy": [
-        "ask.mjs renderCore whereShape (\"X is defined in Y at line(s) Z\" / \"X is defined in Y (no line span...)\") -- chatbench/graded-pool-max.jsonl pins this exact substring as ground truth for 11 'where is X defined' cases (2 in the always-run promoted subset), and that pool is append-only/never-edited-mid-arc per SKILL_BENCHMARK_CEFR_ENGLISH.md."
+        "ask.mjs renderCore whereShape (\"X is defined in Y at line(s) Z\" / \"X is defined in Y (no line span...)\") -- test-benchmarks/chatbench/graded-pool-max.jsonl pins this exact substring as ground truth for 11 'where is X defined' cases (2 in the always-run promoted subset), and that pool is append-only/never-edited-mid-arc per SKILL_BENCHMARK_CEFR_ENGLISH.md."
       ]
     },
     "is-dated": {

package/src/domain/ask-vocab.mjs

@@ -287,6 +287,10 @@ export const ENTITY_TO_TYPE = Object.freeze({
   method: "Method", methods: "Method",
   class: "Class", classes: "Class",
   module: "Module", modules: "Module", mod: "Module", mods: "Module", file: "Module", files: "Module",
+  // "Package" is a pseudo-type like "Change" below: no node is ever stored
+  // with that class. ask.mjs derives packages from module labels, the same
+  // derivation the architecture map uses.
+  package: "Package", packages: "Package",
   attribute: "Attribute", attributes: "Attribute", field: "Attribute", fields: "Attribute",
   variable: "GlobalVariable", variables: "GlobalVariable", global: "GlobalVariable", globals: "GlobalVariable",
   // "Change" is a pseudo-type, not a node class: ask.mjs's traverse() reads it