@polycode-projects/the-mechanical-code-talker 3.3.0 → 4.0.1

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": "3.3.0",
+  "version": "4.0.1",
   "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/p2p/webrtc-transport.mjs

@@ -0,0 +1,146 @@
+// One WebRTC DataChannel between two browsers, and nothing else. The caller
+// carries the offer and answer SDP strings between the two machines however it
+// likes — a link, a paste, an already-open channel to a third peer — and this
+// module never learns what travels over the channel once it is open: it takes
+// plain JS values in and hands plain JS values out.
+//
+// `connectionState` is a live GETTER PROPERTY, not a method: read
+// `transport.connectionState`, never `transport.connectionState()`. It reports
+// RTCPeerConnection's own state ("new" | "connecting" | "connected" | "failed"
+// | "closed"), so a caller can poll it without registering a handler.
+//
+// `iceServers` defaults to [] and this design keeps it empty: no STUN, no
+// TURN, no third party in the loop at all. Peers that cannot already reach
+// each other directly (same machine, same LAN, or a NAT that allows it) never
+// finish the handshake, which is the stated boundary of staying serverless.
+//
+// Both `createOffer` and `createAnswerFor` resolve only once ICE gathering has
+// completed, so the SDP string they return already carries every candidate.
+// Nothing here trickles, because a pasted blob is a one-shot message rather
+// than a live connection back to the other side.
+//
+// Late handler registration still fires: `onOpen` on an already-open channel
+// and `onClose` on an already-closed one call back immediately, so a caller
+// that registers after the transition never silently misses it. Each fires at
+// most once.
+
+const CHANNEL_LABEL = "tmct";
+
+export function createTransport({ iceServers = [] } = {}) {
+  const PeerConnection = globalThis.RTCPeerConnection;
+  if (typeof PeerConnection !== "function") {
+    throw new Error("no RTCPeerConnection here: this transport runs in a browser, not in bare node");
+  }
+
+  const connection = new PeerConnection({ iceServers });
+  const messageHandlers = [];
+  const openHandlers = [];
+  const closeHandlers = [];
+
+  let channel = null;
+  let openAnnounced = false;
+  let closeAnnounced = false;
+  let tornDown = false;
+
+  function announceOpen() {
+    if (openAnnounced) return;
+    openAnnounced = true;
+    for (const handler of openHandlers) handler();
+  }
+
+  function announceClose() {
+    if (closeAnnounced) return;
+    closeAnnounced = true;
+    for (const handler of closeHandlers) handler();
+  }
+
+  function receive(event) {
+    let value;
+    try {
+      value = JSON.parse(event.data);
+    } catch {
+      // A peer sending something that isn't JSON must not be able to throw
+      // inside our receive path, so the frame is dropped rather than raised.
+      return;
+    }
+    for (const handler of messageHandlers) handler(value);
+  }
+
+  function attachChannel(dataChannel) {
+    channel = dataChannel;
+    dataChannel.addEventListener("open", announceOpen);
+    dataChannel.addEventListener("close", announceClose);
+    dataChannel.addEventListener("message", receive);
+    if (dataChannel.readyState === "open") announceOpen();
+  }
+
+  connection.addEventListener("datachannel", (event) => attachChannel(event.channel));
+  connection.addEventListener("connectionstatechange", () => {
+    const state = connection.connectionState;
+    if (state === "failed" || state === "closed") announceClose();
+  });
+
+  async function whenIceGatheringCompletes() {
+    if (connection.iceGatheringState === "complete") return;
+    await new Promise((resolve) => {
+      const settle = () => {
+        if (connection.iceGatheringState !== "complete") return;
+        connection.removeEventListener("icegatheringstatechange", settle);
+        resolve();
+      };
+      connection.addEventListener("icegatheringstatechange", settle);
+    });
+  }
+
+  return {
+    async createOffer() {
+      attachChannel(connection.createDataChannel(CHANNEL_LABEL));
+      await connection.setLocalDescription(await connection.createOffer());
+      await whenIceGatheringCompletes();
+      return connection.localDescription.sdp;
+    },
+
+    async createAnswerFor(offerSdp) {
+      await connection.setRemoteDescription({ type: "offer", sdp: offerSdp });
+      await connection.setLocalDescription(await connection.createAnswer());
+      await whenIceGatheringCompletes();
+      return connection.localDescription.sdp;
+    },
+
+    async completeWithAnswer(answerSdp) {
+      await connection.setRemoteDescription({ type: "answer", sdp: answerSdp });
+    },
+
+    send(data) {
+      const state = channel ? channel.readyState : "missing";
+      if (state !== "open") throw new Error(`cannot send over a data channel that is ${state}`);
+      channel.send(JSON.stringify(data));
+    },
+
+    onMessage(handler) {
+      messageHandlers.push(handler);
+    },
+
+    onOpen(handler) {
+      openHandlers.push(handler);
+      if (openAnnounced) handler();
+    },
+
+    onClose(handler) {
+      closeHandlers.push(handler);
+      if (closeAnnounced) handler();
+    },
+
+    close() {
+      if (tornDown) return;
+      tornDown = true;
+      channel?.close();
+      connection.close();
+      announceClose();
+    },
+
+    get connectionState() {
+      return connection.connectionState;
+    },
+  };
+}

package/src/domain/game-config.mjs

@@ -27,25 +27,32 @@ export const DEFAULT_GAME_CONFIG = Object.freeze({
     minHatchlingMass: 3,
     webDurationTurns: 10,
   }),
+  // The drains are what make a mud character mortal: every scripted turn
+  // charges one, and a character whose mass reaches zero starves and takes no
+  // more turns. They are sized against the demo page's own default run (400
+  // shared turns, so roughly 200 each for two animals) — an animal that never
+  // eats dies about two thirds of the way through, and one that forages does
+  // not. A drain that emptied a starting mass in twenty turns would end every
+  // run before it had shown anything.
   mud: Object.freeze({
     moleInitialMass: 8,
-    moleMassDecrementPerTurn: 0.3,
+    moleMassDecrementPerTurn: 0.06,
     moleSpeed: 1,
     moleDigReach: 1,
     voleInitialMass: 6,
-    voleMassDecrementPerTurn: 0.25,
+    voleMassDecrementPerTurn: 0.05,
     voleSpeed: 1,
     voleDigReach: 1,
     badgerInitialMass: 20,
-    badgerMassDecrementPerTurn: 0.5,
+    badgerMassDecrementPerTurn: 0.08,
     badgerSpeed: 2,
     badgerDigReach: 2,
     groundhogInitialMass: 12,
-    groundhogMassDecrementPerTurn: 0.4,
+    groundhogMassDecrementPerTurn: 0.06,
     groundhogSpeed: 2,
     groundhogDigReach: 2,
     meerkatInitialMass: 9,
-    meerkatMassDecrementPerTurn: 0.35,
+    meerkatMassDecrementPerTurn: 0.05,
     meerkatSpeed: 1,
     meerkatDigReach: 1,
   }),
@@ -122,6 +129,20 @@ function mergeSection(defaults, raw, keyMap) {
   return out;
 }
 
+/** The species a mud character id names — "mole-1" -> "mole" — which is how
+ *  every per-species knob above is keyed. Pure. */
+export function mudSpeciesOf(characterId) {
+  return String(characterId).replace(/-\d+$/, "");
+}
+
+/** What one turn costs `characterId` in mass, from the resolved `mud` section.
+ *  Zero for a species the config carries no drain for: a knob nobody set is not
+ *  a reason to invent a number and starve something with it. Pure. */
+export function mudMassDrainPerTurn(mudConfig, characterId) {
+  const drain = mudConfig?.[`${mudSpeciesOf(characterId)}MassDecrementPerTurn`];
+  return Number.isFinite(drain) ? drain : 0;
+}
+
 /**
  * Fold a normalized tmct.toml's `games`/`planning` tables (the raw sparse
  * pass-through src/adapters/toml-config.mjs's normalizeConfig produces —

package/src/domain/grammar/ace.mjs

@@ -28,7 +28,7 @@
 
 import {
   loadLexicon, lookupNoun, lookupVerb, lookupAdjective, lookupProperName,
-  predicateOf, numberOf, classify,
+  predicateOf, numberOf, classify, OF_CLASSIFIER_HEADS, OF_PARTITIVE_HEADS,
 } from "./lexicon.mjs";
 import { fuzzyMatchInSet } from "../interpret/fuzzy.mjs";
 
@@ -85,7 +85,15 @@ function local(lexicon, term) {
 const stripDet = (tokens) =>
   tokens.length > 1 && DET.has(tokens[0].toLowerCase()) ? tokens.slice(1) : tokens;
 
-/** Resolve a 1–2 word noun phrase: PROPERNAME | code-ref | NOUN | ADJ NOUN.
+/** A token a compound noun phrase may be built out of: a plain word (never a
+ *  code-shaped ref, a number or a CURIE) that is not a DECLARED proper name —
+ *  a name in a compound slot ("GitLab pipeline") is a structural miss, not a
+ *  compound. Shared by both compound arms of resolveNP below. */
+const compoundableWord = (lexicon, token) =>
+  /^[a-z][a-z'-]*$/i.test(token) && !lookupProperName(lexicon, token);
+
+/** Resolve a noun phrase: PROPERNAME | code-ref | NOUN | ADJ NOUN | NOUN NOUN
+ *  | NOUN of NOUN (the last two opt-in, see `allowCompound`).
  *  Returns { term, individual, extras, unknown } — `term` null on a miss with
  *  the undeclared tokens in `unknown` (empty `unknown` = structurally
  *  unparseable phrase → the caller returns a hard null). `extras` carries the
@@ -149,8 +157,7 @@ function resolveNP(lexicon, tokensIn, { allowCompound = false } = {}) {
     // DECLARED proper name in either slot ("GitLab pipeline") keeps the
     // structural miss below — a name in the wrong slot, not a compound.
     if (allowCompound
-      && !lookupProperName(lexicon, tokens[0]) && !lookupProperName(lexicon, tokens[1])
-      && /^[a-z][a-z'-]*$/i.test(tokens[0]) && /^[a-z][a-z'-]*$/i.test(tokens[1])) {
+      && compoundableWord(lexicon, tokens[0]) && compoundableWord(lexicon, tokens[1])) {
       const n0 = lookupNoun(lexicon, tokens[0], { singularOnly: false });
       const n1 = lookupNoun(lexicon, tokens[1], { singularOnly });
       if (n0 && n1) {
@@ -162,6 +169,35 @@ function resolveNP(lexicon, tokensIn, { allowCompound = false } = {}) {
     const unknown = tokens.filter((t) => !classify(t, lexicon));
     return { term: null, individual: false, extras: [], unknown };
   }
+  // "NOUN of NOUN" is ONE compound noun ("unit of work", "chain of command",
+  // "conflict of interest"), joined with its own "of" the same way two plain
+  // nouns are joined with a space, so the taught fact and the query side
+  // unify on one term. Opt-in through the same `allowCompound` gate and the
+  // same compoundableWord shape test as the two-noun arm above; the head noun
+  // leads, so an "a"/"an" agrees with IT.
+  //
+  // Which "of" this claims is decided by the head, against the two closed
+  // of-frame vocabularies in lexicon.mjs — the same ones the fact extractor
+  // reads. A CLASSIFIER head is a rewrite of the inner noun rather than a
+  // compound ("a kind of dog" is a dog), and a PARTITIVE head states quantity
+  // or composition rather than a class ("a piece of cake", "a lot of dogs");
+  // both decline here and land on the miss below. The relational reading is
+  // pattern 7's and is claimed before any of this: parseAce routes "the N of N
+  // is VALUE" to parseOfForm, so "the version of tmct is 0.2.0" never reaches
+  // a copula split at all. An inner determiner is likewise out of the shape —
+  // "a piece of the cake" is four tokens and no compound noun carries one.
+  if (tokens.length === 3 && allowCompound && tokens[1].toLowerCase() === "of"
+    && compoundableWord(lexicon, tokens[0]) && compoundableWord(lexicon, tokens[2])) {
+    const head = tokens[0].toLowerCase();
+    const inner = tokens[2].toLowerCase();
+    if (!OF_CLASSIFIER_HEADS.has(head) && !OF_PARTITIVE_HEADS.has(head)) {
+      const headNoun = lookupNoun(lexicon, head, { singularOnly });
+      const innerNoun = lookupNoun(lexicon, inner, { singularOnly: false });
+      if (headNoun && innerNoun) {
+        return { term: `${ns}${head} of ${inner}`, individual: false, noun: headNoun, extras: [], unknown: [] };
+      }
+    }
+  }
   // 0 or 3+ tokens: not a fragment NP. Name the undeclared words if any.
   return { term: null, individual: false, extras: [], unknown: tokens.filter((t) => !classify(t, lexicon)) };
 }

package/src/domain/grammar/lexicon-core.json

@@ -9448,7 +9448,8 @@
     "danger": {},
     "push": {},
     "refusal": {},
-    "tooling": {}
+    "tooling": {},
+    "trelvox": {}
   },
   "verbs": {
     "import": {},

package/src/domain/grammar/lexicon.mjs

@@ -43,6 +43,24 @@ export const QUANTIFIERS = Object.freeze({
   exactly: "owl:cardinality",
 });
 
+// The two closed head vocabularies that say what an "of" between two nouns is
+// DOING, so every reader of the of-frame decides it the same way instead of
+// each growing its own list. A CLASSIFIER head reads THROUGH to the inner noun
+// — "a kind of dog" is a dog, "a type of mammal" is a mammal — so the phrase
+// is a rewrite of the inner noun, never a term of its own. A PARTITIVE head
+// states quantity or composition — "a piece of cake", "a lot of dogs", "a body
+// of ice" — so the phrase names no class at all. Anything else ("unit of
+// work", "chain of command") is a compound noun the of belongs to.
+/** Of-frame heads that read through to the inner noun. */
+export const OF_CLASSIFIER_HEADS = Object.freeze(new Set([
+  "type", "kind", "sort", "form", "class", "variety", "species", "breed", "genus",
+]));
+/** Of-frame heads that state quantity or composition, not a class. */
+export const OF_PARTITIVE_HEADS = Object.freeze(new Set([
+  "body", "mass", "group", "collection", "set", "series", "number", "amount",
+  "piece", "part", "lot", "pair", "bunch", "pile",
+]));
+
 const NUMBER_WORDS = Object.freeze({
   one: 1, two: 2, three: 3, four: 4, five: 5,
   six: 6, seven: 7, eight: 8, nine: 9, ten: 10,
@@ -149,6 +167,19 @@ export function loadLexicon(extra, ns = DEFAULT_NS) {
   return lex;
 }
 
+/** `lexicon` with `names` additionally declared as proper names. The noun,
+ *  verb and adjective maps are SHARED with the base lexicon rather than
+ *  re-ingested — a caller that re-declares on every turn (a live game world
+ *  minting ids as it is played) would otherwise rebuild nine thousand core
+ *  entries to add half a dozen. Proper names outrank every other category, so
+ *  a name with no dictionary reading of its own ("groundhog-1", "carrot-2")
+ *  resolves as itself instead of dying as an undeclared word. */
+export function withProperNames(lexicon, names) {
+  const properNames = new Map(lexicon.properNames);
+  for (const name of names) properNames.set(String(name).toLowerCase(), String(name));
+  return { ...lexicon, properNames };
+}
+
 /** Noun lookup with plural folding; returns the entry ({lemma, property?}) or
  *  null. `opts.singularOnly` (an "a"/"an" determiner) prunes the irregular-
  *  plural fold in favor of a standalone-singular entry when both exist for

package/src/domain/memory/trust.mjs

@@ -40,11 +40,13 @@ function parseChatTagRest(rest) {
  *      same tier the hand-written tier2 corpus already scores at; the :turnN
  *      segment a snapshot write carries records when, not who, and is not
  *      part of the Source identity)
- *   mud:<character>[:turnN]    -> { kind:"corpus",   name:"mud:<character>" }
+ *   mud:<character>[:turnN][:gone] -> { kind:"corpus", name:"mud:<character>" }
  *     (one character's own testimony in a multi-character world — what it told
- *      someone, what it examined for itself. Same tier as the world, but one
- *      Source per character; the `mud:` prefix in the name keeps that Source
- *      apart from a world of the same literal name)
+ *      someone, what it examined for itself, and with `:gone` what it saw leave
+ *      the world. Same tier as the world, but one Source per character; the
+ *      `mud:` prefix in the name keeps that Source apart from a world of the
+ *      same literal name. Both trailing segments say when and what, not who, so
+ *      neither is part of the Source identity)
  *   ace:chat:<session>@<ts>    -> { kind:"operator",  createdAt:<ts>, sessionId:<session> }
  *   teach:chat:<session>@<ts>  -> { kind:"teach",     createdAt:<ts>, sessionId:<session> }
  *   web:<url> | url:<url>      -> { kind:"web",       url:<url> }