@polycode-projects/the-mechanical-code-talker 4.0.0 → 4.1.0

package/data/sprites/letter-icon.toml

@@ -1,11 +1,14 @@
 # letter — Ashcombe Hall's own objective (hidden in the cabinet): an
-# envelope with a folded flap (a lighter overlay, the same carved-highlight
-# trick as the lid on container.toml) and a small wax seal.
+# envelope with a folded flap (a darker overlay, the same carved-seam trick
+# as the lid on container.toml) and a wax seal. The seal is a fixed red —
+# a wax seal's colour comes from the wax pressed into it, not the paper
+# underneath, the same reasoning as the flame on lamp.toml.
 classes = ["letter"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <rect x="3" y="6" width="18" height="13" rx="1.2" fill="currentColor"/>
-  <path d="M3 6 L21 6 L21 6.8 L12 13.8 L3 6.8 Z" fill="currentColor" opacity="0.32"/>
-  <circle cx="12" cy="12.4" r="1.15" fill="currentColor" opacity="0.8"/>
+  <path d="M3 6 L21 6 L21 6.8 L12 13.8 L3 6.8 Z" fill="color-mix(in srgb, currentColor 78%, black)"/>
+  <path d="M4 7.6 L11 12.9" stroke="color-mix(in srgb, currentColor 25%, white)" stroke-width="0.5" opacity="0.6"/>
+  <circle cx="12" cy="12.4" r="1.15" fill="#8a2e2e"/>
 </svg>
 """

package/data/sprites/library-icon.toml

@@ -1,12 +1,23 @@
 # library — a room floor plan marked by an open book, so the room-kind icon
 # reads as a library rather than a plain room: the washed square is room.toml's
 # own shape, the two-page V is the same open-book cue the large tier uses.
+# One page is shaded a touch darker than the other so the spine reads as a
+# fold rather than a seam drawn on a flat card. The wash is a fixed
+# white/black tint rather than currentColor-mixed (see room-icon.toml's own
+# header for why).
 classes = ["library"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
-  <rect x="3" y="3" width="18" height="18" rx="1" fill="currentColor" opacity="0.14"/>
+  <defs>
+    <linearGradient id="library-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#library-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
-  <path d="M12 9 C10.4 7.9 8.2 7.6 6.4 8.1 V15.6 C8.2 15.1 10.4 15.4 12 16.5 C13.6 15.4 15.8 15.1 17.6 15.6 V8.1 C15.8 7.6 13.6 7.9 12 9 Z" fill="currentColor" opacity="0.75"/>
-  <path d="M12 9 V16.5" stroke="currentColor" stroke-width="0.5" opacity="0.5"/>
+  <path d="M12 9 C10.4 7.9 8.2 7.6 6.4 8.1 V15.6 C8.2 15.1 10.4 15.4 12 16.5 Z" fill="currentColor"/>
+  <path d="M12 9 C13.6 7.9 15.8 7.6 17.6 8.1 V15.6 C15.8 15.1 13.6 15.4 12 16.5 Z" fill="color-mix(in srgb, currentColor 78%, black)"/>
+  <path d="M12 9 V16.5" stroke="color-mix(in srgb, currentColor 30%, white)" stroke-width="0.4"/>
 </svg>
 """

package/data/sprites/pan-icon.toml

@@ -1,11 +1,15 @@
 # pan — the kitchen's default portable: a frying pan seen from above with a
-# long handle, so a taken pan reads as its own thing rather than the generic
-# portable box.
+# long handle. The cooking surface reads darker than the rim (a pan's own
+# interior is seasoned/scorched, its rim stays brighter metal) and the
+# handle carries a rivet, so a taken pan reads as its own thing rather than
+# the generic portable box.
 classes = ["pan"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <circle cx="10" cy="14" r="6" fill="currentColor"/>
-  <circle cx="10" cy="14" r="3.6" fill="currentColor" opacity="0.35"/>
+  <circle cx="10" cy="14" r="4.8" fill="color-mix(in srgb, currentColor 70%, black)"/>
+  <path d="M6.6 11 A4.8 4.8 0 0 1 13 10" fill="none" stroke="color-mix(in srgb, currentColor 20%, white)" stroke-width="0.6" stroke-linecap="round" opacity="0.6"/>
   <rect x="15" y="13" width="7" height="2" rx="1" fill="currentColor"/>
+  <circle cx="16.4" cy="14" r="0.5" fill="color-mix(in srgb, currentColor 55%, black)"/>
 </svg>
 """

package/data/sprites/person-icon.toml

@@ -1,10 +1,14 @@
 # person — the generic fallback for anyone with no NPC sprite of their own
-# (see butler/housekeeper/cook/gardener for the named Ashcombe Hall staff).
+# (see butler/housekeeper/cook/gardener for the named Ashcombe Hall staff):
+# two shoulder notches break the torso silhouette where sleeves would seam,
+# so it reads as a clothed figure rather than a bare blob-with-a-head, while
+# staying deliberately unadorned next to the named staff's own props.
 classes = ["person"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <circle cx="12" cy="6.6" r="3.3" fill="currentColor"/>
   <path d="M6 21 C6 15.3 8.7 12.8 12 12.8 C15.3 12.8 18 15.3 18 21 Z" fill="currentColor"/>
-  <path d="M12 12.8 C13.1 12.8 14.1 13 15 13.4" fill="none" stroke="currentColor" stroke-width="0.9" opacity="0.4" stroke-linecap="round"/>
+  <path d="M7.6 14.4 L9.4 13" stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="0.7" opacity="0.6" stroke-linecap="round"/>
+  <path d="M16.4 14.4 L14.6 13" stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="0.7" opacity="0.6" stroke-linecap="round"/>
 </svg>
 """

package/data/sprites/poodle-icon.toml

@@ -5,7 +5,7 @@ classes = ["poodle"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <ellipse cx="13" cy="15" rx="6.4" ry="4.6" fill="currentColor"/>
-  <ellipse cx="10.8" cy="13.2" rx="1.8" ry="1.3" fill="currentColor" opacity="0.28"/>
+  <ellipse cx="10.8" cy="13.2" rx="1.8" ry="1.3" fill="color-mix(in srgb, currentColor 70%, black)"/>
   <circle cx="7" cy="8.5" r="4" fill="currentColor"/>
   <g fill="currentColor">
     <circle cx="4" cy="6" r="1.6"/>

package/data/sprites/portable-icon.toml

@@ -1,12 +1,14 @@
 # portable — the generic fallback for any carryable object with no sprite
-# of its own: a drawstring parcel silhouette, replacing the old
-# generic-gift-box outline so it reads as "an unspecified small thing"
-# rather than a gift.
+# of its own: a drawstring parcel silhouette with a small tag hanging from
+# the neck, so it reads as "an unspecified small thing someone packed"
+# rather than a gift or a sack of grain.
 classes = ["portable"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <path d="M12 6 C7.5 6 5 9.4 5 13.4 C5 17.7 8.1 20 12 20 C15.9 20 19 17.7 19 13.4 C19 9.4 16.5 6 12 6 Z" fill="currentColor"/>
   <path d="M9.4 6.4 C9.9 4.6 10.8 3.4 12 3.4 C13.2 3.4 14.1 4.6 14.6 6.4" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"/>
-  <ellipse cx="9.8" cy="11.6" rx="1.6" ry="2.1" fill="currentColor" opacity="0.28"/>
+  <ellipse cx="9.8" cy="11.6" rx="1.6" ry="2.1" fill="color-mix(in srgb, currentColor 25%, white)"/>
+  <path d="M14.4 6.6 L17.4 8.8 L15.6 10.4 L14 8 Z" fill="color-mix(in srgb, currentColor 65%, black)"/>
+  <circle cx="16.1" cy="8.5" r="0.35" fill="color-mix(in srgb, currentColor 20%, white)"/>
 </svg>
 """

package/data/sprites/portrait-icon.toml

@@ -1,12 +1,15 @@
 # portrait — Ashcombe Hall's own drawing-room portrait (a container, hiding
 # the key): a gilt arched frame around a lighter canvas, with a bust
-# silhouette so it reads as a picture of someone, not an empty frame.
+# silhouette so it reads as a picture of someone, not an empty frame. Canvas
+# and figure use fixed cream/sepia tones rather than currentColor opacity —
+# a painting's own palette doesn't belong to the page theme, and a flat
+# opacity wash would shift between a light and a dark backdrop anyway.
 classes = ["portrait"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <path d="M4 21 V7 C4 4 6.8 2 12 2 C17.2 2 20 4 20 7 V21 Z" fill="currentColor"/>
-  <path d="M6.3 19.4 V8.3 C6.3 6.2 8.4 4.8 12 4.8 C15.6 4.8 17.7 6.2 17.7 8.3 V19.4 Z" fill="currentColor" opacity="0.28"/>
-  <circle cx="12" cy="10.4" r="2.3" fill="currentColor" opacity="0.7"/>
-  <path d="M8 18.4 C8 15.2 9.6 13.4 12 13.4 C14.4 13.4 16 15.2 16 18.4 Z" fill="currentColor" opacity="0.7"/>
+  <path d="M6.3 19.4 V8.3 C6.3 6.2 8.4 4.8 12 4.8 C15.6 4.8 17.7 6.2 17.7 8.3 V19.4 Z" fill="#f4ecd8"/>
+  <circle cx="12" cy="10.4" r="2.3" fill="#8a6a52"/>
+  <path d="M8 18.4 C8 15.2 9.6 13.4 12 13.4 C14.4 13.4 16 15.2 16 18.4 Z" fill="#8a6a52"/>
 </svg>
 """

package/data/sprites/room-icon.toml

@@ -1,10 +1,19 @@
 # room — a schematic floor plan: a washed interior (a solid tint, not a
 # hollow box) plus a doorway arch, kept abstract since a room is a space
-# to draw, not an object to render literally.
+# to draw, not an object to render literally. The wash is a fixed
+# white/black tint rather than currentColor-mixed: a tint built from
+# currentColor reverses which side looks lighter between a light and a
+# dark theme, a plain white/black one never does.
 classes = ["room"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
-  <rect x="3" y="3" width="18" height="18" rx="1" fill="currentColor" opacity="0.14"/>
+  <defs>
+    <linearGradient id="room-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#room-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
   <path d="M9 21 L9 13 A3 3 0 0 1 15 13 L15 21" fill="none" stroke="currentColor" stroke-width="1.6"/>
 </svg>

package/data/sprites/spider-icon.toml

@@ -1,12 +1,18 @@
 # spider — the spider-and-fly board's own agent. A confident two-lobe body
-# (a lighter carved patch on the abdomen for shading) and eight thin
-# outward legs.
+# (a darker carved patch on the abdomen for shading), two small fixed-dark
+# eye dots (the same restrained fixed-accent technique the large tier's
+# badger/vole use for an identity marking, not a coat colour) and eight
+# thin outward legs.
 classes = ["spider"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <ellipse cx="12" cy="16" rx="5.2" ry="4.8" fill="currentColor"/>
-  <ellipse cx="10.3" cy="14.3" rx="1.8" ry="1.4" fill="currentColor" opacity="0.3"/>
+  <ellipse cx="10.3" cy="14.3" rx="1.8" ry="1.4" fill="color-mix(in srgb, currentColor 70%, black)"/>
   <circle cx="12" cy="9.6" r="3.2" fill="currentColor"/>
+  <g fill="#1c1c1c">
+    <circle cx="10.7" cy="8.7" r="0.5"/>
+    <circle cx="13.3" cy="8.7" r="0.5"/>
+  </g>
   <g stroke="currentColor" stroke-width="1.1" fill="none" stroke-linecap="round">
     <path d="M9.4 8 L2.2 4.4"/>
     <path d="M9 10.2 L1.4 9.4"/>

package/data/sprites/study-icon.toml

@@ -1,11 +1,19 @@
 # study — a room floor plan marked by a writing desk against one wall, so the
 # room-kind icon reads as the study you start in rather than a plain room.
+# The wash is a fixed white/black tint rather than currentColor-mixed (see
+# room-icon.toml's own header for why).
 classes = ["study"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
-  <rect x="3" y="3" width="18" height="18" rx="1" fill="currentColor" opacity="0.14"/>
+  <defs>
+    <linearGradient id="study-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#study-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
-  <rect x="7" y="11" width="10" height="2.4" fill="currentColor" opacity="0.7"/>
+  <rect x="7" y="11" width="10" height="2.4" fill="currentColor"/>
   <path d="M8 13.4 V17 M16 13.4 V17" stroke="currentColor" stroke-width="1.2"/>
   <rect x="9.6" y="7.6" width="4.8" height="3" fill="none" stroke="currentColor" stroke-width="1"/>
 </svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "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.",
@@ -111,11 +111,12 @@
     "chat:repo": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --repo",
     "chat:plain": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --plain",
     "chat:narrate": "node --disable-warning=ExperimentalWarning bin/tmct.mjs chat --narrate",
-    "init": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init",
-    "init:sqlite": "npm run init",
+    "init": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus seon && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus conceptnet && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus aws && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus python && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus java",
+    "init:small": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init",
+    "init:sqlite": "npm run init:small",
     "init:persona:human": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init --with-persona human",
     "init:persona:empty": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init --with-persona empty",
-    "init:large": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus seon && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus conceptnet && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus aws && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus python && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus java",
+    "init:large": "npm run init",
     "init:xl": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init --persona-size large && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus seon && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus conceptnet && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus aws && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus python && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus java && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus wordnet-xl",
     "init:xxl": "node --disable-warning=ExperimentalWarning bin/tmct.mjs init --persona-size large && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus seon && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus conceptnet && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus aws && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus python && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus java && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus wordnet-full && node --disable-warning=ExperimentalWarning bin/tmct.mjs import --corpus namenet",
     "memory": "node --disable-warning=ExperimentalWarning bin/tmct.mjs memory",

package/src/adapters/memory/core.mjs

@@ -172,6 +172,26 @@ export function createInMemoryStore() {
   return { backend: BACKEND_MEMORY, payload: emptyMemory() };
 }
 
+/** Assign `seedPayload` onto `memoryDir`'s own payload — spread over the
+ *  store's own (possibly empty) payload rather than replacing it outright,
+ *  so a partial seed (individuals and objectProperties only) still carries
+ *  the classes/prefixes scaffolding the write path recounts, and a later
+ *  teach turn works regardless of what the seed carries. A no-op when
+ *  `seedPayload` is null/undefined — a browser session with nothing to seed
+ *  keeps its own fresh empty payload untouched. */
+export function applySeedPayload(memoryDir, seedPayload) {
+  if (seedPayload) memoryDir.payload = { ...memoryDir.payload, ...seedPayload };
+}
+
+/** A structurally independent copy of a memory payload — `structuredClone`
+ *  where available, falling back to a JSON round-trip for an environment
+ *  without it. Returns null for a null/undefined `payload`, so a caller can
+ *  seed a fresh session with "no seed yet" rather than an empty object. */
+export function cloneMemoryPayload(payload) {
+  if (!payload) return null;
+  try { return structuredClone(payload); } catch { return JSON.parse(JSON.stringify(payload)); }
+}
+
 // ---- Backend C — SQLite: a live node:sqlite connection, per-row
 // INSERT/REPLACE/DELETE diffed against what's already stored (write cost
 // proportional to what changed, not total store size). Reads are cached on

package/src/domain/ask-vocab.mjs

@@ -189,6 +189,77 @@ export const RELATIONS = {
   },
 };
 
+// ---- world relations: the predicates a WORLD graph stores about its own
+// individuals, as opposed to RELATIONS above, which is a code vocabulary —
+// a module imports a module, a commit touches a file, and none of its verbs
+// name where a thing is or how it feels. A game board, a burrow and a manor
+// all record those, in the same `mgx:` predicates, so the words for them are
+// curated once here.
+//
+// Each entry is keyed by its stored predicate and carries the LISTING NOUNS a
+// question reaches it by ("the locations of…", "the moods of…") plus `reads`,
+// the third-person phrase one subject's answer is written in. No `verbs` list
+// and no VERB_TO_KIND entry: these answer a listing over a named set, not the
+// "does X <verb> Y" shapes RELATIONS' verbs compile to, and folding them in
+// would put "is in" into the code grammar's own verb table. ----
+
+export const WORLD_RELATIONS = Object.freeze({
+  placement: Object.freeze({
+    predicate: "mgx:currently-in",
+    comment: "individual -> place: where the subject is right now.",
+    nouns: Object.freeze(["location", "locations", "position", "positions", "place", "places", "whereabouts", "room", "rooms"]),
+    reads: "is in",
+  }),
+  mood: Object.freeze({
+    predicate: "mgx:feels",
+    comment: "individual -> mood word: how the subject feels right now.",
+    nouns: Object.freeze(["mood", "moods", "feeling", "feelings", "emotion", "emotions"]),
+    reads: "feels",
+  }),
+  mass: Object.freeze({
+    predicate: "mgx:mass",
+    comment: "individual -> number: the subject's current mass.",
+    nouns: Object.freeze(["mass", "masses", "weight", "weights"]),
+    reads: "has mass",
+  }),
+});
+
+/** listing noun -> WORLD_RELATIONS key ("locations" -> "placement"). */
+export const WORLD_NOUN_TO_RELATION = Object.freeze(Object.fromEntries(
+  Object.entries(WORLD_RELATIONS).flatMap(([token, { nouns }]) => nouns.map((n) => [n, token])),
+));
+
+/** Every stored world predicate, for a caller projecting fact rows into a
+ *  graph `ask` can traverse. */
+export const WORLD_PREDICATES = Object.freeze(
+  Object.values(WORLD_RELATIONS).map((r) => r.predicate),
+);
+
+// The regular English 3rd-person-singular suffix rule (the same regular
+// -s/-es/-ies shape src/domain/inflect.mjs's own `pluralOf` applies to a
+// noun) — not imported from there, since inflect.mjs sits downstream of
+// interpret/normalize.mjs, which imports THIS module: importing it back
+// here would be a real circular dependency, not just a style choice.
+function thirdPersonSingular(w) {
+  if (/(?:[sxz]|ch|sh)$/i.test(w)) return `${w}es`;
+  if (/[^aeiou]y$/i.test(w)) return `${w.slice(0, -1)}ies`;
+  return `${w}s`;
+}
+
+/** The third-person-singular sentence phrase for a stored relation `kind`
+ *  ("inherits" -> "inherits from", "cochange" -> "co-changes with"), derived
+ *  from RELATIONS' own `bare` infinitive rather than a second hand-curated
+ *  verb table. A symbol-grain kind ("callsSymbol", "touchesSymbol") reads its
+ *  coarse sibling's phrase; an unrecognized kind falls back to a plain
+ *  camelCase split. */
+export function phraseForRelation(kind) {
+  const key = String(kind || "");
+  const entry = RELATIONS[key] || (key.endsWith("Symbol") && RELATIONS[key.slice(0, -6)]) || null;
+  if (!entry) return key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase();
+  const [head, ...rest] = entry.bare.split(" ");
+  return [thirdPersonSingular(head), ...rest].join(" ");
+}
+
 /** The closed set of reverse `inherits` verb phrasings a strategy checks to
  *  decide whether to swap subject/object. The three "the"-definite forms are
  *  named here but not reachable through VERB_TO_KIND (see above). */

package/src/domain/ask.mjs

@@ -26,6 +26,7 @@ import {
   PASSIVE_PARTICIPLE_TO_KIND, GENERIC_AGENT_WORDS, REDUCED_RELATIVE_CLAUSES,
   AGGREGATE_TRIGGERS, LIST_TRIGGERS, SUPERLATIVE_EXTREMES, EDGE_NOUN_TO_METRIC, METRIC_IMPLIES_ENTITY, ANAPHORA_TRIGGERS,
   MEMBERSHIP_KINDS, CASCADE_NOISE, CASCADE_SYNONYMS, HELP_TRIGGERS,
+  WORLD_RELATIONS, WORLD_NOUN_TO_RELATION, WORLD_PREDICATES,
   stripTrailingScopeFiller,
 } from "./ask-vocab.mjs";
 import { expandContractions, normalizeQuery, applyNegationFrames, applyPhrasingFrames, matchNegationSet, STOPWORDS, splitWords, wordsOf, escapeRegex } from "./interpret/normalize.mjs";
@@ -2135,6 +2136,7 @@ function evalComposite(graph, ast, opts = {}) {
     return { compositeKind: "count", count: evalSet(graph, ast.base, opts).length, entityType: ast.entityType, matches: [] };
   }
   if (ast.node === "list") return { compositeKind: "list", matches: evalSet(graph, ast.base, opts), entityType: ast.entityType, scoped: ast.scoped };
+  if (ast.node === "worldRelation") return evalWorldRelation(graph, ast);
   if (ast.node === "superlative") return evalSuperlative(graph, ast);
   if (ast.node === "temporal") return evalTemporal(graph, ast, opts);
   if (ast.node === "recentCommits") return evalRecentCommits(graph);
@@ -2292,6 +2294,20 @@ function renderComposite(parsed, result, graph) {
       : "";
     return { content: `${compositeList(result.matches)}${hint}.`, miss: false, ambiguous: false, matches: result.matches };
   }
+  // One sentence per subject, in id order, in the world's own words — the
+  // subject's id, the relation's `reads` phrase, and the stored object
+  // verbatim. Nothing is derived: an empty set is the honest miss, never a
+  // sentence about a subject the world has no row for.
+  if (result.compositeKind === "worldRelation") {
+    const asked = listJoin(result.askedClasses);
+    const noun = WORLD_RELATIONS[result.relation].nouns[1];
+    if (!result.pairs.length) {
+      return { content: `no ${noun} on record for ${asked} in this graph.`, miss: true, ambiguous: false, matches: [] };
+    }
+    const reads = WORLD_RELATIONS[result.relation].reads;
+    const sentences = result.pairs.map((p) => `${p.subject.label || p.subject.id} ${reads} ${p.object}`);
+    return { content: `${sentences.join("; ")}.`, miss: false, ambiguous: false, matches: result.matches };
+  }
   // A non-empty inherited result is disclosed out loud ("X has no own <kind>
   // — inherited from <ancestor>: …"), never silently presented as the owner's own.
   if (result.compositeKind === "membership") {
@@ -4403,6 +4419,148 @@ function dynamicClassQuery(graph, query) {
   return listM ? { node: "list", entityType, base, scoped: false } : { node: "count", entityType, base };
 }
 
+// ---- world-relation listing: "list the locations of flies and spiders", the
+// plural, multi-class form of a question a world graph can already answer. A
+// listing over ONE world predicate (ask-vocab.mjs's WORLD_RELATIONS) filtered
+// to one or more subject CLASSES, resolved dynamically against whatever
+// classes actually have an individual in this graph — so a world's own
+// taxonomy needs no entry in the closed code-graph noun table, exactly as the
+// count/list fallback above resolves its class noun. Fires only once the
+// normal cascade has already produced an honest miss, and misses honestly
+// itself when any asked class has no individual here. ----
+
+// A class list: "flies and spiders", "spiders, flies and eggs". Each part must
+// be a single bare noun — a phrase with anything else in it is a restrictor
+// this shape can't honour, so it declines rather than dropping it.
+function parseWorldClassList(graph, text) {
+  const parts = String(text || "").split(/\s*,\s*|\s+and\s+/i).map((s) => s.trim()).filter(Boolean);
+  if (!parts.length) return null;
+  const asked = [];
+  const classes = [];
+  for (const part of parts) {
+    const word = part.replace(/^(?:all\s+)?(?:the\s+)?/i, "").trim();
+    if (!/^[a-z][a-z'-]*$/i.test(word)) return null;
+    const cls = resolveDynamicClass(graph, word);
+    if (!cls) return null;
+    asked.push(word.toLowerCase());
+    classes.push(cls);
+  }
+  return { asked: [...new Set(asked)], classes: [...new Set(classes)] };
+}
+
+const WORLD_LISTING_RE = new RegExp(
+  `^(?:${LIST_TRIGGERS_SORTED.map(escapeRegex).join("|")})\\s+(?:all\\s+)?(?:the\\s+)?([a-z][a-z'-]*)\\s+(?:of|for)\\s+(.+?)[?.!\\s]*$`,
+  "i",
+);
+// "where are the flies and spiders" — the same listing said the natural way.
+// Singular too ("where is the spider"): the class list resolves either way, and
+// with only the code-graph `where` lane to fall back on the answer would be
+// "no recorded code location" for a subject whose cell this graph plainly
+// holds. A phrase that isn't a bare class noun ("where is auth.mjs defined")
+// fails parseWorldClassList and keeps the definition-site reading.
+const WORLD_WHERE_RE = /^where(?:'s|\s+is|\s+are)\s+(?:all\s+)?(?:the\s+)?(.+?)[?.!\s]*$/i;
+
+/** Compile "<list trigger> the <world-relation noun> of <class> and <class>"
+ *  (or "where are the <class> and <class>") into a world-relation listing AST,
+ *  or null when this isn't that shape. */
+function worldRelationQuery(graph, query) {
+  const q = String(query || "").trim();
+  const listM = q.match(WORLD_LISTING_RE);
+  const relation = listM ? WORLD_NOUN_TO_RELATION[listM[1].toLowerCase()] : "placement";
+  if (!relation) return null;
+  const subjectText = listM ? listM[2] : q.match(WORLD_WHERE_RE)?.[1];
+  if (!subjectText) return null;
+  const resolved = parseWorldClassList(graph, subjectText);
+  if (!resolved) return null;
+  return {
+    node: "worldRelation",
+    relation,
+    predicate: WORLD_RELATIONS[relation].predicate,
+    classes: resolved.classes,
+    askedClasses: resolved.asked,
+  };
+}
+
+const normalizePredicate = (p) => String(p || "").toLowerCase();
+
+function evalWorldRelation(graph, ast) {
+  const wanted = new Set(ast.classes);
+  const latest = new Map();
+  for (const group of graph?.relations || []) {
+    if (normalizePredicate(group.prop) !== ast.predicate && normalizePredicate(group.predicate) !== ast.predicate) continue;
+    // A world appends a fresh row per turn rather than rewriting one, so the
+    // LAST edge for a subject is its current value — the same last-wins fold
+    // every world's own state reader applies to its rows.
+    for (const edge of group.edges || []) {
+      const subject = graph.byId?.get(edge.subject);
+      if (subject && wanted.has(subject.class)) latest.set(edge.subject, { subject, object: edge.object });
+    }
+  }
+  const pairs = [...latest.values()].sort((a, b) => String(a.subject.id).localeCompare(String(b.subject.id)));
+  return {
+    compositeKind: "worldRelation",
+    relation: ast.relation,
+    askedClasses: ast.askedClasses,
+    pairs,
+    matches: pairs.map((p) => p.subject),
+  };
+}
+
+// A world writes each turn's facts against a stamped subject ("spider-1@turn3",
+// "player@step7") and folds them back onto the base id, newest stamp winning —
+// spider-fly.mjs's foldSpiderFlyState and domain.mjs's foldWorldState both do
+// exactly this. An unstamped row is the world's own starting value, stamp 0.
+const WORLD_SNAPSHOT_RE = /^(.+)@(?:turn|step)(\d+)$/;
+
+function splitWorldSnapshot(term) {
+  const m = WORLD_SNAPSHOT_RE.exec(String(term ?? ""));
+  return m ? { base: m[1], stamp: Number(m[2]) } : { base: String(term ?? ""), stamp: 0 };
+}
+
+/** Project plain world fact rows (`{subject, predicate, object}`, the shape
+ *  memory/core.mjs's readFactRows returns) into the `{individuals,
+ *  objectProperties}` payload parseEntities consumes, so a page holding a live
+ *  world can hand `ask` a graph of it instead of an empty one. Only the
+ *  WORLD_PREDICATES rows are carried: a board's own geometry (every cell and
+ *  every exit) is thousands of rows no natural-language listing asks for.
+ *  Turn-stamped rows are folded onto their base subject, so the graph carries
+ *  each subject's CURRENT value and never a stale one from an earlier turn.
+ *
+ *  A subject's class comes from its own `rdf:type` row when the world states
+ *  one; `classOf(id)` is the fallback for a world that names its individuals
+ *  by convention instead (spider-fly's "spider-1" is a spider because of its
+ *  id). Returning null from `classOf` drops the subject — that is the seam a
+ *  caller filters through, so "which subjects still count as live" stays a
+ *  rule of the world module rather than of this projection. Pure. */
+export function worldRelationGraphPayload(rows, { classOf = () => null } = {}) {
+  const declaredClass = new Map();
+  for (const row of rows || []) {
+    if (row?.predicate === "rdf:type" && row.subject && row.object) {
+      declaredClass.set(splitWorldSnapshot(row.subject).base, String(row.object));
+    }
+  }
+  const wanted = new Set(WORLD_PREDICATES);
+  const individuals = new Map();
+  const newest = new Map();
+  for (const row of rows || []) {
+    if (!row?.subject || !wanted.has(row.predicate)) continue;
+    const { base, stamp } = splitWorldSnapshot(row.subject);
+    const cls = declaredClass.get(base) || classOf(base);
+    if (!cls) continue;
+    const key = `${row.predicate}${base}`;
+    const prior = newest.get(key);
+    if (prior && prior.stamp > stamp) continue;
+    individuals.set(base, { id: base, label: base, class: cls });
+    newest.set(key, { stamp, predicate: row.predicate, subject: base, object: splitWorldSnapshot(row.object).base });
+  }
+  const groups = new Map();
+  for (const edge of newest.values()) {
+    if (!groups.has(edge.predicate)) groups.set(edge.predicate, { prop: edge.predicate, predicate: edge.predicate, examples: [] });
+    groups.get(edge.predicate).examples.push({ subject: edge.subject, object: edge.object });
+  }
+  return { individuals: [...individuals.values()], objectProperties: [...groups.values()] };
+}
+
 // Matches T5's own bare-object capture (grammar.mjs meta-whatis), reused below to
 // extract the term for the article-insertion fallback rather than duplicating it.
 const BARE_META_WHATIS_RE = /^what\s+(?:is|are)\s+(?:an?\s+)?(.+?)[?.!\s]*$/i;
@@ -4447,6 +4605,16 @@ export function ask(graph, query, { contextId = null, nlp = undefined, prev = nu
       if (!dynRendered.miss) { parsed = dyn; result = dynResult; rendered = dynRendered; relaxed = null; }
     }
   }
+  // World-relation listing ("list the locations of flies and spiders"), on the
+  // same terms: only after an honest miss, and only when it answers for real.
+  if (rendered.miss && !rendered.ambiguous) {
+    const world = worldRelationQuery(graph, query);
+    if (world) {
+      const worldResult = traverse(graph, world, { contextId, prev });
+      const worldRendered = render(world, worldResult, graph);
+      if (!worldRendered.miss) { parsed = world; result = worldResult; rendered = worldRendered; relaxed = null; }
+    }
+  }
   // Bare "what is X" (no article) meta fallback, narrow to ask() and never
   // touching the outer `parsed` even on a miss — chat.mjs's own gates key off
   // `!envelope.parsed`, so populating it here would steal turns from lanes

package/src/domain/game-config.mjs

@@ -143,6 +143,17 @@ export function mudMassDrainPerTurn(mudConfig, characterId) {
   return Number.isFinite(drain) ? drain : 0;
 }
 
+/** The mass denominator a spider-and-fly class's HUD bar and sprite
+ *  expression both scale against — "how full" reads the same on either. `cls`
+ *  is "spider" or "fly"; any other class (an egg, or a class this world adds
+ *  later) has no denominator and gets null, never a guessed number. `config`
+ *  is the page's own `{ maxSpiderMass, maxFlyMass }` pair. Pure. */
+export function massScaleFor(cls, config) {
+  if (cls === "spider") return config?.maxSpiderMass ?? null;
+  if (cls === "fly") return config?.maxFlyMass ?? null;
+  return null;
+}
+
 /**
  * Fold a normalized tmct.toml's `games`/`planning` tables (the raw sparse
  * pass-through src/adapters/toml-config.mjs's normalizeConfig produces —