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

package/corpus/sprites/src/sprite-facts.jsonl

@@ -9,6 +9,7 @@
 {"subject":"autumn sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"baby sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"badger sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"basket sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"bathroom sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"beach sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"bear sprite","predicate":"rdf:type","object":"sprite class"}
@@ -31,6 +32,7 @@
 {"subject":"butterfly sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"cabinet sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"car sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"carrot sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"castle sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"cat sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"cellar sprite","predicate":"rdf:type","object":"sprite class"}
@@ -75,8 +77,10 @@
 {"subject":"fly sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"food sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"forest sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"fox sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"friend sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"frog sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"fruit sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"furniture sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"garden sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"gardener sprite","predicate":"rdf:type","object":"sprite class"}
@@ -112,6 +116,7 @@
 {"subject":"lawyer sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"leader sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"letter sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"lettuce sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"library sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"lion sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"love sprite","predicate":"rdf:type","object":"sprite class"}
@@ -155,8 +160,10 @@
 {"subject":"river sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"road sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"room sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"root sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"salt sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"school sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"seed sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"servant sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"sheep sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"shirt sprite","predicate":"rdf:type","object":"sprite class"}
@@ -186,6 +193,7 @@
 {"subject":"teacher sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"team sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"tiger sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"tomato sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"town sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"train sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"tree sprite","predicate":"rdf:type","object":"sprite class"}
@@ -205,6 +213,7 @@
 {"subject":"wolf sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"woman sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"worker sprite","predicate":"rdf:type","object":"sprite class"}
+{"subject":"worm sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"writer sprite","predicate":"rdf:type","object":"sprite class"}
 {"subject":"adventurer sprite","predicate":"mgx:render-at","object":"icon tier"}
 {"subject":"animal sprite","predicate":"mgx:render-at","object":"icon tier"}
@@ -247,6 +256,7 @@
 {"subject":"autumn sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"baby sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"badger sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"basket sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"bathroom sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"beach sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"bear sprite","predicate":"mgx:render-at","object":"sprite tier"}
@@ -269,6 +279,7 @@
 {"subject":"butterfly sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"cabinet sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"car sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"carrot sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"castle sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"cat sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"cellar sprite","predicate":"mgx:render-at","object":"sprite tier"}
@@ -313,8 +324,10 @@
 {"subject":"fly sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"food sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"forest sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"fox sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"friend sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"frog sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"fruit sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"furniture sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"garden sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"gardener sprite","predicate":"mgx:render-at","object":"sprite tier"}
@@ -350,6 +363,7 @@
 {"subject":"lawyer sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"leader sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"letter sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"lettuce sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"library sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"lion sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"love sprite","predicate":"mgx:render-at","object":"sprite tier"}
@@ -393,8 +407,10 @@
 {"subject":"river sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"road sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"room sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"root sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"salt sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"school sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"seed sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"servant sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"sheep sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"shirt sprite","predicate":"mgx:render-at","object":"sprite tier"}
@@ -424,6 +440,7 @@
 {"subject":"teacher sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"team sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"tiger sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"tomato sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"town sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"train sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"tree sprite","predicate":"mgx:render-at","object":"sprite tier"}
@@ -443,6 +460,7 @@
 {"subject":"wolf sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"woman sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"worker sprite","predicate":"mgx:render-at","object":"sprite tier"}
+{"subject":"worm sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"writer sprite","predicate":"mgx:render-at","object":"sprite tier"}
 {"subject":"dog sprite","predicate":"mgx:take-parameter","object":"colour"}
 {"subject":"dog sprite","predicate":"mgx:accept-colour","object":"black"}

package/corpus/worlds/manifest.json

@@ -3,7 +3,7 @@
   "generated": "by scripts/build-worlds-pack.mjs from corpus/worlds/src/",
   "counts": {
     "worlds": 3,
-    "facts": 621,
+    "facts": 654,
     "rules": 40
   },
   "budgets": {
@@ -19,8 +19,8 @@
     },
     {
       "file": "src/mud-garden.jsonl",
-      "bytes": 8153,
-      "sha256": "fe60529dc755ee4318c8852448d8b8073bf10bc162c2dcf0ea16d87c83246443"
+      "bytes": 11802,
+      "sha256": "7aac1b1b3460126b6aeed2f83d71f566636cf18935e81396a6e9e7f126750418"
     },
     {
       "file": "src/spider-fly.jsonl",
@@ -41,8 +41,8 @@
     },
     {
       "file": "shards/mud-garden.jsonl.gz",
-      "bytes": 907,
-      "sha256": "7e7f176deda2bbf4e4d91d0885779467bc3c37a4bb61fb117fa27108ecc20380"
+      "bytes": 1243,
+      "sha256": "8f99eca74bd41b7f893bfca7f49cd4df8ebc53b6f61e3d9bc82ea1350cd23e83"
     },
     {
       "file": "shards/spider-fly.jsonl.gz",

package/corpus/worlds/src/mud-garden.jsonl

@@ -1,11 +1,15 @@
-{"world":"mud-garden","kind":"meta","opening":"a vegetable garden on a wet morning, with a burrow already running under it. Say \"look\" to look around, \"go down\" to follow the burrow, and \"dig north\" (or south, east, west, up, down) to open a new room."}
+{"world":"mud-garden","kind":"meta","opening":"a vegetable garden on a wet morning, with a burrow already running under it. Say \"look\" to look around and \"go down\" to follow the burrow. Above ground the only dig is straight down; once you are under the soil you can dig north, south, east or west along the burrow, or up to break the surface. A fox keeps a den off the burrow, and it does not share."}
 {"world":"mud-garden","kind":"fact","subject":"garden","predicate":"rdf:type","object":"room"}
+{"world":"mud-garden","kind":"fact","subject":"garden","predicate":"mgx:is-origin","object":"true"}
 {"world":"mud-garden","kind":"fact","subject":"burrow-1","predicate":"rdf:type","object":"room"}
 {"world":"mud-garden","kind":"fact","subject":"sett-1","predicate":"rdf:type","object":"room"}
+{"world":"mud-garden","kind":"fact","subject":"fox-den","predicate":"rdf:type","object":"room"}
 {"world":"mud-garden","kind":"fact","subject":"garden","predicate":"mgx:has-exit-down","object":"burrow-1"}
 {"world":"mud-garden","kind":"fact","subject":"burrow-1","predicate":"mgx:has-exit-up","object":"garden"}
 {"world":"mud-garden","kind":"fact","subject":"burrow-1","predicate":"mgx:has-exit-east","object":"sett-1"}
 {"world":"mud-garden","kind":"fact","subject":"sett-1","predicate":"mgx:has-exit-west","object":"burrow-1"}
+{"world":"mud-garden","kind":"fact","subject":"burrow-1","predicate":"mgx:has-exit-north","object":"fox-den"}
+{"world":"mud-garden","kind":"fact","subject":"fox-den","predicate":"mgx:has-exit-south","object":"burrow-1"}
 {"world":"mud-garden","kind":"fact","subject":"mole-1","predicate":"rdf:type","object":"adventurer"}
 {"world":"mud-garden","kind":"fact","subject":"vole-1","predicate":"rdf:type","object":"adventurer"}
 {"world":"mud-garden","kind":"fact","subject":"badger-2","predicate":"rdf:type","object":"adventurer"}
@@ -18,6 +22,12 @@
 {"world":"mud-garden","kind":"fact","subject":"vole-1","predicate":"mgx:hasMass","object":"6"}
 {"world":"mud-garden","kind":"fact","subject":"badger-2","predicate":"mgx:hasMass","object":"9"}
 {"world":"mud-garden","kind":"fact","subject":"groundhog-1","predicate":"mgx:hasMass","object":"7"}
+{"world":"mud-garden","kind":"fact","subject":"predator","predicate":"rdfs:subClassOf","object":"animal"}
+{"world":"mud-garden","kind":"fact","subject":"fox","predicate":"rdfs:subClassOf","object":"predator"}
+{"world":"mud-garden","kind":"fact","subject":"fox-1","predicate":"rdf:type","object":"fox"}
+{"world":"mud-garden","kind":"fact","subject":"fox-1","predicate":"mgx:currently-in","object":"fox-den"}
+{"world":"mud-garden","kind":"fact","subject":"fox-1","predicate":"mgx:is-predator","object":"true"}
+{"world":"mud-garden","kind":"fact","subject":"fox-1","predicate":"mgx:hasMass","object":"40"}
 {"world":"mud-garden","kind":"fact","subject":"food","predicate":"rdfs:subClassOf","object":"portable"}
 {"world":"mud-garden","kind":"fact","subject":"carrot","predicate":"rdfs:subClassOf","object":"food"}
 {"world":"mud-garden","kind":"fact","subject":"lettuce","predicate":"rdfs:subClassOf","object":"food"}
@@ -31,6 +41,28 @@
 {"world":"mud-garden","kind":"fact","subject":"tomato","predicate":"rdf:type","object":"tomato"}
 {"world":"mud-garden","kind":"fact","subject":"tomato","predicate":"mgx:located-in","object":"sett-1"}
 {"world":"mud-garden","kind":"fact","subject":"tomato","predicate":"mgx:hasMass","object":"2"}
+{"world":"mud-garden","kind":"fact","subject":"root","predicate":"rdfs:subClassOf","object":"food"}
+{"world":"mud-garden","kind":"fact","subject":"root","predicate":"mgx:hasMass","object":"2"}
+{"world":"mud-garden","kind":"fact","subject":"worm","predicate":"rdfs:subClassOf","object":"food"}
+{"world":"mud-garden","kind":"fact","subject":"worm","predicate":"mgx:hasMass","object":"2"}
+{"world":"mud-garden","kind":"fact","subject":"mouse","predicate":"rdfs:subClassOf","object":"animal"}
+{"world":"mud-garden","kind":"fact","subject":"mouse","predicate":"mgx:hasMass","object":"4"}
+{"world":"mud-garden","kind":"fact","subject":"den","predicate":"rdfs:subClassOf","object":"underground-space"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:dig-spawns","object":"root"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:dig-spawns","object":"carrot"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:dig-spawns","object":"worm"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:den-spawns","object":"carrot"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:den-spawns","object":"root"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:den-spawns","object":"worm"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:den-resident","object":"mouse"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:dig-spawn-max","object":"2"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:den-chance-in","object":"5"}
+{"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"mgx:den-resident-chance-in","object":"3"}
+{"world":"mud-garden","kind":"fact","subject":"garden","predicate":"mgx:dig-reach","object":"6"}
+{"world":"mud-garden","kind":"fact","subject":"mole-1","predicate":"mgx:mass-drain-per-turn","object":"0.06"}
+{"world":"mud-garden","kind":"fact","subject":"vole-1","predicate":"mgx:mass-drain-per-turn","object":"0.05"}
+{"world":"mud-garden","kind":"fact","subject":"badger-2","predicate":"mgx:mass-drain-per-turn","object":"0.08"}
+{"world":"mud-garden","kind":"fact","subject":"groundhog-1","predicate":"mgx:mass-drain-per-turn","object":"0.06"}
 {"world":"mud-garden","kind":"fact","subject":"stone","predicate":"rdf:type","object":"portable"}
 {"world":"mud-garden","kind":"fact","subject":"stone","predicate":"mgx:located-in","object":"garden"}
 {"world":"mud-garden","kind":"fact","subject":"seed","predicate":"rdf:type","object":"portable"}
@@ -43,6 +75,7 @@
 {"world":"mud-garden","kind":"fact","subject":"garden","predicate":"rdf:type","object":"outdoor-space"}
 {"world":"mud-garden","kind":"fact","subject":"burrow-1","predicate":"rdf:type","object":"underground-space"}
 {"world":"mud-garden","kind":"fact","subject":"sett-1","predicate":"rdf:type","object":"underground-space"}
+{"world":"mud-garden","kind":"fact","subject":"fox-den","predicate":"rdf:type","object":"underground-space"}
 {"world":"mud-garden","kind":"fact","subject":"outdoor-space","predicate":"rdfs:subClassOf","object":"space"}
 {"world":"mud-garden","kind":"fact","subject":"underground-space","predicate":"rdfs:subClassOf","object":"space"}
 {"world":"mud-garden","kind":"rule","name":"go","ruleKind":"action-signature","slots":{"subjectClass":"adventurer","targetClass":"room"}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "3.3.0",
+  "version": "4.0.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.",

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/lexicon.mjs

@@ -149,6 +149,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> }

package/src/domain/p2p/facts.mjs

@@ -0,0 +1,81 @@
+// domain/p2p/facts.mjs — the small set of new predicates the P2P layer
+// introduces on top of the existing memory store's triple shape, plus pure
+// constructors for each. Every one is a plain add-only fact, replicated the
+// same way any other fact is (appendFacts' own union-by-id behavior) — no
+// new CRDT primitive. Provenance uses the existing `ace:` tag shape
+// (`ace:p2p:<id>@<ts>`) so trust.mjs's own parser reads it with no changes
+// there: stripped of its `ace:` prefix it reads as `p2p:<id>@<ts>`, which
+// parses to { kind: "operator", sessionId: "p2p:<id>", createdAt: <ts> }.
+import { provenanceTagToSource } from "../memory/trust.mjs";
+
+export const WORLD_NAME_PREDICATE = "mgx:worldName";
+export const NODE_NAME_PREDICATE = "mgx:nodeName";
+export const PLAYED_BY_PREDICATE = "mgx:playedBy";
+export const WAVED_PREDICATE = "mgx:waved";
+
+export const P2P_PREDICATES = Object.freeze([
+  WORLD_NAME_PREDICATE,
+  NODE_NAME_PREDICATE,
+  PLAYED_BY_PREDICATE,
+  WAVED_PREDICATE,
+]);
+
+const provenanceFor = (id, timestamp) => `ace:p2p:${id}@${timestamp}`;
+
+export function worldNameFact(worldId, name, timestamp) {
+  return { subject: worldId, predicate: WORLD_NAME_PREDICATE, object: name, provenance: provenanceFor(worldId, timestamp) };
+}
+
+export function nodeNameFact(peerId, name, timestamp) {
+  return { subject: `peer:${peerId}`, predicate: NODE_NAME_PREDICATE, object: name, provenance: provenanceFor(peerId, timestamp) };
+}
+
+export function playedByFact(characterId, peerId, timestamp) {
+  return { subject: characterId, predicate: PLAYED_BY_PREDICATE, object: `peer:${peerId}`, provenance: provenanceFor(characterId, timestamp) };
+}
+
+export function waveFact(characterId, roomId, timestamp) {
+  return { subject: characterId, predicate: WAVED_PREDICATE, object: roomId, provenance: provenanceFor(`${characterId}-${roomId}`, timestamp) };
+}
+
+/** The newest asserted-at timestamp across every " | "-joined segment of a
+ *  fact's provenance — the correct read for "when was this most recently
+ *  true," since a repeat wave unions a fresh tag onto the SAME fact id
+ *  (same subject/predicate/object) rather than minting a new row. Returns
+ *  null if no segment parses to a timestamp at all. */
+export function latestProvenanceTimestamp(provenance) {
+  const tag = String(provenance || "");
+  if (!tag) return null;
+  let latest = null;
+  for (const segment of tag.split(" | ")) {
+    const source = provenanceTagToSource(segment);
+    const at = source?.createdAt ? Date.parse(source.createdAt) : NaN;
+    if (!Number.isNaN(at) && (latest === null || at > latest)) latest = at;
+  }
+  return latest;
+}
+
+/** "Currently waving" is a read-time recency question, never a retraction —
+ *  a wave fact older than the window just stops being read as current, with
+ *  nothing ever deleted from the graph. */
+export function isRecentWave(waveFactRow, nowMs, windowMs = 8000) {
+  const at = latestProvenanceTimestamp(waveFactRow?.provenance);
+  if (at === null) return false;
+  const age = nowMs - at;
+  return age >= 0 && age <= windowMs;
+}
+
+/** The latest-by-timestamp fact for a subject+predicate pair — the "current
+ *  value" read for an add-only, no-retraction fact like a node's own name
+ *  or which peer plays a character (first-claim-wins uses the OLDEST of
+ *  these instead; see playedByFact's own caller for that distinction). */
+export function latestFact(rows, subject, predicate) {
+  let best = null;
+  let bestAt = -Infinity;
+  for (const row of rows) {
+    if (row.subject !== subject || row.predicate !== predicate) continue;
+    const at = latestProvenanceTimestamp(row.provenance) ?? -Infinity;
+    if (at > bestAt) { best = row; bestAt = at; }
+  }
+  return best;
+}

package/src/domain/p2p/peer-id.mjs

@@ -0,0 +1,32 @@
+// domain/p2p/peer-id.mjs — pure id/name generation for the P2P layer. No
+// network, no DOM; safe to import from both a Node test and a browser
+// bundle. World/peer ids are UUIDs, generated client-side and never seen by
+// any server. Display names are two words drawn from the same closed-world
+// lexicon that grounds every taught fact, so a name a player sees on screen
+// is always a real word this build's vocabulary already recognizes.
+import { loadLexicon } from "../grammar/lexicon.mjs";
+
+const fallbackId = (prefix) => `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+
+export function generatePeerId() {
+  return globalThis.crypto?.randomUUID?.() ?? fallbackId("peer");
+}
+
+export function generateWorldId() {
+  return globalThis.crypto?.randomUUID?.() ?? fallbackId("world");
+}
+
+/** Two distinct words drawn from the lexicon's own noun list — a mnemonic
+ *  label, not a credential. `random` is injectable for deterministic tests;
+ *  defaults to Math.random. Callers add a numeric suffix themselves if a
+ *  live collision turns up among currently-connected peers — this function
+ *  never guesses at uniqueness on its own. */
+export function generateDisplayName(random = Math.random) {
+  const words = [...loadLexicon().nouns.keys()];
+  if (words.length < 2) return "guest-guest";
+  const pick = () => words[Math.floor(random() * words.length)];
+  const first = pick();
+  let second = pick();
+  while (second === first) second = pick();
+  return `${first}-${second}`;
+}

package/src/domain/p2p/provenance-relabel.mjs

@@ -0,0 +1,26 @@
+// domain/p2p/provenance-relabel.mjs — rewrites a fact's outgoing provenance
+// tag before it's broadcast to peers, so "who taught this" reads as a node
+// name rather than a local session id. Only teach/operator-kind tags are
+// touched; a mud world/testimony tag is already attributed to the world or
+// the character that made it, not the person at the keyboard, and rewriting
+// it would lose information rather than add it.
+import { provenanceTagToSource } from "../memory/trust.mjs";
+
+const RELABELED_KINDS = new Set(["teach", "operator"]);
+
+/** `provenance` may already be a " | "-joined union of several tags (the
+ *  same fact taught more than once, from different sources) — relabel each
+ *  segment independently and rejoin, so a segment this peer didn't author
+ *  passes through untouched. */
+export function relabelForBroadcast(provenance, myDisplayName, timestamp) {
+  const tag = String(provenance || "");
+  if (!tag) return tag;
+  return tag
+    .split(" | ")
+    .map((segment) => {
+      const source = provenanceTagToSource(segment);
+      if (!source || !RELABELED_KINDS.has(source.kind)) return segment;
+      return `teach:peer:${myDisplayName}@${timestamp}`;
+    })
+    .join(" | ");
+}