@polycode-projects/the-mechanical-code-talker 2.11.6 → 2.11.10

package/src/domain/reference-pack.mjs

@@ -139,9 +139,16 @@ const ISA_GENERIC_HEADS = new Set([
   "type", "kind", "sort", "form", "class", "variety", "group", "part",
   "piece", "member", "way", "term", "name", "word", "thing", "example",
   "family", "genus", "species", "unit", "series", "set", "list", "number",
-  "amount",
+  "amount", "body", "mass",
 ]);
 const ISA_ARTICLES = new Set(["a", "an", "the"]);
+// The classifier heads an of-chain reads THROUGH to the real class ("a kind
+// of dog" → dog). Any other head before "of" keeps the outer phrase: "a body
+// of ice" states composition, and "a game of skill" is a game — neither
+// makes the of-object the class.
+const ISA_OF_READ_THROUGH = new Set([
+  "type", "kind", "sort", "form", "class", "variety", "species", "breed", "genus",
+]);
 
 /** The isa lemma of a lead's first sentence, or null. The copula must sit in
  *  the first sentence; an of-chain resolves to its final noun ("a kind of
@@ -158,8 +165,13 @@ export function isaOf(plain, lexicon) {
     window.push(word);
     if (window.length >= 6) break;
   }
-  const lastOf = window.lastIndexOf("of");
-  let headWords = lastOf >= 0 ? window.slice(lastOf + 1) : window;
+  let headWords = window;
+  for (let ofIdx = headWords.indexOf("of"); ofIdx > 0; ofIdx = headWords.indexOf("of")) {
+    const outer = headWords[ofIdx - 1]?.split("-").pop();
+    if (outer && ISA_OF_READ_THROUGH.has(outer)) { headWords = headWords.slice(ofIdx + 1); continue; }
+    headWords = headWords.slice(0, ofIdx);
+    break;
+  }
   while (headWords.length && ISA_ARTICLES.has(headWords[0])) headWords = headWords.slice(1);
   if (!headWords.length) return null;
   const headToken = headWords[headWords.length - 1].split("-").pop();

package/src/services/adventure-viz.mjs

@@ -570,7 +570,6 @@ ${THEME_TOKENS_CSS}
   main { max-width: 920px; margin: 0 auto; padding: 1.4rem 1.2rem 2.2rem; }
   .eyebrow { font-family: ${MONO_STACK}; font-size: .7rem; letter-spacing: .12em; text-transform: uppercase; color: var(--gilt); }
   .titlebar { display: flex; align-items: baseline; justify-content: space-between; gap: 1rem; flex-wrap: wrap; margin: .3rem 0 1rem; }
-  h1 { font-size: 1.4rem; margin: 0; text-wrap: balance; }
   button { font: inherit; color: inherit; background: none; cursor: pointer; }
   button:focus-visible { outline: 2px solid var(--ink); outline-offset: 2px; }
   .mode-toggle { font-family: ${MONO_STACK}; font-size: .72rem; letter-spacing: .04em; text-transform: uppercase; padding: .4rem .8rem; border: 1px solid var(--gilt); background: var(--parchment); color: var(--ink); white-space: nowrap; }
@@ -646,8 +645,11 @@ ${THEME_TOKENS_CSS}
   /* the room-kind icon — filled through the exact same property-aware
      sprite resolver the room's own object cards use, keyed on the room's own
      name (so library/kitchen/garden reach their large TOMLs, everything else
-     falls back through room's own ancestor chain to the generic room icon). */
-  .room-kind-icon { position: absolute; top: .55rem; right: .6rem; width: 28px; height: 28px; opacity: .92; }
+     falls back through room's own ancestor chain to the generic room icon).
+     Rendered at 120px — twice a room-object sprite's own 60px frame
+     (.sprite-frame below) — so the room itself reads as the biggest thing
+     drawn in its own scene. */
+  .room-kind-icon { position: absolute; top: .5rem; right: .6rem; width: 120px; height: 120px; opacity: .92; }
   .room-kind-icon svg { width: 100%; height: 100%; display: block; }
   .room-kind-icon:empty { display: none; }
   .sprite-row { display: flex; align-items: flex-end; gap: .9rem .7rem; min-height: 2.5rem; }
@@ -735,6 +737,19 @@ ${THEME_TOKENS_CSS}
   .map-viewport > div { width: 100%; height: 100%; }
   .map-viewport svg { width: 100%; height: 100%; display: block; }
   .map-viewport .empty-note { color: var(--parchment); opacity: .8; }
+  /* the play-mode map only: a fixed SQUARE viewport (width pinned to the
+     same 190px height above, centered) rather than stretching to the side
+     column's own width — the svg still scales to fit inside it either way,
+     this just keeps the board's own footprint stable and click-to-enlarge
+     honest about what it's enlarging. */
+  .map-viewport-fixed { width: 190px; margin: 0 auto; cursor: zoom-in; }
+  /* the lights-down map lightbox — the same board, the same roomMapSvg
+     output, just drawn bigger over a dimmed backdrop. Closes on a click
+     anywhere outside the enlarged board, or Escape. */
+  .map-lightbox { position: fixed; inset: 0; z-index: 60; display: flex; align-items: center; justify-content: center; padding: 2.4rem; background: rgba(10, 8, 4, .74); }
+  .map-lightbox[hidden] { display: none; }
+  .map-lightbox-inner { width: min(70vmin, 640px); height: min(70vmin, 640px); background: var(--baize); border: 3px solid var(--gilt); box-shadow: inset 0 0 0 1px var(--baize-line), 0 12px 48px rgba(0, 0, 0, .5); padding: 16px; box-sizing: border-box; }
+  .map-lightbox-inner svg { width: 100%; height: 100%; display: block; }
   .roommap .room-edge { stroke: var(--board-path); stroke-width: 7; }
   .roommap .room-hint { fill: var(--board-path); opacity: .8; }
   .roommap .room-node rect { fill: var(--parchment); stroke: var(--baize-line); stroke-width: 1.5; }
@@ -764,6 +779,19 @@ ${THEME_TOKENS_CSS}
      a quoted manuscript line reporting what "look" would say right now. */
   .caption { background: var(--parchment); border-left: 3px solid var(--gilt); padding: .55rem .7rem; font-size: .86rem; font-style: italic; margin: 0 0 .5rem; }
   .caption:empty { display: none; margin: 0; }
+  /* "what would you like to do" — the room's own contextual pills sit
+     top-right of the heading, on the header's own row; more pills than fit
+     wrap onto further lines still pinned to the right (justify-content:
+     flex-end on the inner .pills flex box), so the block grows down and
+     toward the left rather than pushing the heading around. */
+  .command-head { display: flex; align-items: flex-start; justify-content: space-between; gap: .3rem .6rem; margin: 0 0 .5rem; padding-bottom: .3rem; border-bottom: 1px solid var(--line); }
+  .command-head h2 { flex: 0 0 auto; margin: 0; padding: 0; border-bottom: none; }
+  /* nowrap on .command-head itself keeps the pills box on the SAME row as
+     the heading (top-right); .pills' own min-width: 0 lets IT shrink below
+     its natural width so ITS children (not the whole box) are what wraps
+     onto further lines, staying right-anchored rather than dropping the
+     whole pill row under the heading. */
+  .command-head .pills { flex: 1 1 auto; min-width: 0; justify-content: flex-end; margin-bottom: 0; }
   .chatask { display: flex; align-items: center; gap: .5rem; border-top: 1px solid var(--line); padding-top: .5rem; }
   .chatask .prompt { color: var(--taught); font-size: .78rem; font-family: ${MONO_STACK}; }
   .chatask input { flex: 1; font-family: ${MONO_STACK}; font-size: .78rem; background: var(--bg); color: var(--ink); border: 1px solid var(--line); padding: .32rem .55rem; min-width: 0; }
@@ -799,23 +827,34 @@ ${THEME_TOKENS_CSS}
   body.preview .side, body.preview .stage-left > .panel, body.preview .controls-row, body.preview .status { display: none; }
   body.preview main { padding: 0; max-width: none; }
   body.preview .stage { display: block; }
-  body.preview .eyebrow, body.preview h1, body.preview .mode-toggle, body.preview #editStage, body.preview .page-note { display: none; }
+  body.preview .eyebrow, body.preview .mode-toggle, body.preview #editStage, body.preview .page-note { display: none; }
 </style>
 </head>
 <body>
 <main>
-  <div class="eyebrow">tmct &middot; the adventure</div>
   <div class="titlebar">
-    <h1>A room, drawn from exactly what the text already says is there</h1>
+    <div class="eyebrow">tmct &middot; the adventure</div>
     <button id="editModeBtn" type="button" class="mode-toggle" disabled>edit the world</button>
   </div>
   <p class="page-note">${escapeHtml(worldPayload.opening)}</p>
   <div class="stage" id="playStage">
     <div class="stage-left">
+      <div class="controls-row" id="playControls">
+        <button id="resetBtn" type="button" disabled>reset</button>
+        <button id="playBtn" type="button" disabled>&#9654; play</button>
+        <button id="stepBtn" type="button" disabled>step</button>
+        <span class="turn mono" id="turnLabel">turn: 0</span>
+      </div>
+      <div class="goal-line" id="goalLine"></div>
+      <div class="status" id="status">loading the engine&hellip;</div>
       <div class="panel goals">
         <h2>quest</h2>
         <div id="goalList"></div>
       </div>
+      <div class="panel carrying">
+        <h2>satchel</h2>
+        <div class="chips" id="carryList"></div>
+      </div>
       <div class="room-frame" id="roomFrame">
         <div class="room-plaque mono" id="roomName"></div>
         <div class="room-kind-icon" id="roomKindIcon"></div>
@@ -825,39 +864,32 @@ ${THEME_TOKENS_CSS}
           <div class="you-slot" id="youSlot"></div>
         </div>
       </div>
-      <div class="controls-row" id="playControls">
-        <button id="resetBtn" type="button" disabled>reset</button>
-        <button id="playBtn" type="button" disabled>&#9654; play</button>
-        <button id="stepBtn" type="button" disabled>step</button>
-        <span class="turn mono" id="turnLabel">turn: 0</span>
-      </div>
-      <div class="goal-line" id="goalLine"></div>
-      <div class="status" id="status">loading the engine&hellip;</div>
-      <div class="panel carrying">
-        <h2>satchel</h2>
-        <div class="chips" id="carryList"></div>
-      </div>
       <div class="panel command">
-        <h2>speak to the manor</h2>
+        <div class="command-head">
+          <h2>What would you like to do</h2>
+          <div class="pills" id="pills"></div>
+        </div>
         <form class="chatask" id="chatform">
           <span class="prompt mono">tmct&gt;</span>
           <input id="chatq" type="text" placeholder="go north" aria-label="Type a command, or ask a question" disabled>
         </form>
       </div>
+    </div>
+    <aside class="side" aria-label="The adventure's log and chat">
       <div class="panel roommap">
         <h2>the manor, so far</h2>
-        <div class="map-viewport"><div id="mapWrap"></div></div>
+        <div class="map-viewport map-viewport-fixed" id="mapViewport"><div id="mapWrap"></div></div>
       </div>
-    </div>
-    <aside class="side" aria-label="The adventure's log and chat">
       <div class="chat">
         <h2>the manor's own account</h2>
         <div class="chatlog" id="chatlog" aria-live="polite"></div>
-        <div class="pills" id="pills"></div>
         <div class="caption" id="caption"></div>
       </div>
     </aside>
   </div>
+  <div class="map-lightbox" id="mapLightbox" role="dialog" aria-modal="true" aria-label="The manor map, enlarged" hidden>
+    <div class="map-lightbox-inner roommap" id="mapLightboxInner"></div>
+  </div>
 
   <div class="stage editor-stage" id="editStage" aria-label="The world editor">
     <div class="panel edittext">
@@ -925,6 +957,9 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   const chatqEl = el("chatq");
   const carryListEl = el("carryList");
   const mapWrapEl = el("mapWrap");
+  const mapViewportEl = el("mapViewport");
+  const mapLightboxEl = el("mapLightbox");
+  const mapLightboxInnerEl = el("mapLightboxInner");
   const goalListEl = el("goalList");
   const editModeBtn = el("editModeBtn");
   const editorTextEl = el("editorText");
@@ -1120,6 +1155,25 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   function renderRoomMap(rows, state, visitedRoomIds) {
     mapWrapEl.innerHTML = roomMapSvg(visitedRoomGraph(state, visitedRoomIds), false) || '<span class="empty-note">nowhere yet</span>';
   }
+
+  // ---- the map lightbox — clicking the fixed-square play-mode map redraws
+  // the SAME roomMapSvg output larger, over a dimmed backdrop; clicking the
+  // backdrop (not the board itself) or pressing Escape closes it.
+  function openMapLightbox() {
+    if (!lastSnapshot) return;
+    const svg = roomMapSvg(visitedRoomGraph(lastSnapshot.state, lastSnapshot.visitedRoomIds), false);
+    if (!svg) return;
+    mapLightboxInnerEl.innerHTML = svg;
+    mapLightboxEl.hidden = false;
+  }
+  function closeMapLightbox() {
+    mapLightboxEl.hidden = true;
+    mapLightboxInnerEl.innerHTML = "";
+  }
+  mapViewportEl.addEventListener("click", openMapLightbox);
+  mapLightboxEl.addEventListener("click", (e) => { if (e.target === mapLightboxEl) closeMapLightbox(); });
+  document.addEventListener("keydown", (e) => { if (e.key === "Escape" && !mapLightboxEl.hidden) closeMapLightbox(); });
+
   function renderEditMap(rows, state) {
     editMapWrapEl.innerHTML = roomMapSvg(visitedRoomGraph(state, allRoomIds(rows)), true) || '<span class="empty-note">this world defines no rooms</span>';
   }

package/src/services/chat-page-viz.mjs

@@ -117,6 +117,26 @@ export function loadProgressLine(parts) {
     : "loading the engine… " + mb(loaded) + " MB";
 }
 
+/**
+ * The "researched this session" panel's own reading of a settled research
+ * turn's answer — the passage it read and where it read it, straight off
+ * research.mjs's own `renderResearchAnswer` shape (`term — summary (source:
+ * research article "title", Simple English Wikipedia, CC BY-SA 4.0 — url)`),
+ * never a second fetch: the citation text is already the retrieved passage,
+ * this just pulls its pieces apart for display. Returns null on anything
+ * else (a miss, a status/stop reply, or text that doesn't open this way) —
+ * an honest "nothing to show" rather than a guessed passage.
+ *
+ * Self-contained, `.toString()`-splice safe — the same discipline every
+ * other pure export in this module holds.
+ */
+export function parseResearchAnswer(answer) {
+  const text = String(answer || "");
+  const m = /^(.*?) — ([\s\S]*?) \(source: research article "([^"]+)", Simple English Wikipedia, CC BY-SA 4\.0 — (\S+)\)/.exec(text);
+  if (!m) return null;
+  return { term: m[1], passage: m[2], title: m[3], url: m[4] };
+}
+
 /**
  * The exported transcript as ONE Markdown document, in the SAME shape the
  * Node CLI/TUI's own .tmct/session-<id>.md writes (session-log-format.mjs,
@@ -286,6 +306,24 @@ ${THEME_TOKENS_CSS}
   .statsPanel .forget-btn:hover { color: var(--ink); }
   .statsPanel .persist-note { color: var(--muted); font-size: .64rem; margin: .4rem 0 0; }
 
+  /* the "researched this session" panel: its own section under the memory
+     stats, filled from window.tmctChat.researchedFactRows() plus each
+     settled research turn's own answer text — the passage tmct actually
+     read, the article it read it from, and the facts that passage grounded.
+     A sibling section, not folded into #statsPanelStats — that div's own
+     re-render (renderStatsPanelInto) clears and rebuilds its children on
+     every turn, which would wipe this section's own history too if it lived
+     inside it. */
+  #researchedPanel:not(:empty) { margin-top: 1rem; padding-top: 1rem; border-top: 1px solid var(--line); }
+  .statsPanel .researched-item { margin: 0 0 .9rem; padding-bottom: .8rem; border-bottom: 1px dashed var(--line); }
+  .statsPanel .researched-item:last-child { border-bottom: none; padding-bottom: 0; margin-bottom: 0; }
+  .statsPanel .researched-title { display: block; color: var(--ink); font-weight: 600; }
+  .statsPanel .researched-passage { display: block; color: var(--muted); margin: .3rem 0; }
+  .statsPanel .researched-link { display: inline-block; margin: 0 0 .3rem; }
+  .statsPanel .researched-facts { margin: .3rem 0 0; padding-left: 1.1rem; }
+  .statsPanel .researched-facts li { margin: .12rem 0; }
+  .statsPanel .researched-none { color: var(--muted); font-style: italic; margin: .3rem 0 0; }
+
   @media (max-width: 860px) {
     .statsPanel { display: none; }
   }
@@ -361,8 +399,9 @@ ${THEME_TOKENS_CSS}
     </form>
     <div class="statusline" id="status">loading the engine&hellip;</div>
   </div>
-  <aside class="statsPanel" id="statsPanel" aria-label="This session's memory">
-    <p class="empty">loading memory stats&hellip;</p>
+  <aside class="statsPanel" id="statsPanel" aria-label="This session's memory and research">
+    <div id="statsPanelStats"><p class="empty">loading memory stats&hellip;</p></div>
+    <div id="researchedPanel"></div>
   </aside>
 <script src="./chat-browser.bundle.js"></script>
 <script>
@@ -371,6 +410,7 @@ ${THEME_TOKENS_CSS}
   const provBucketFor = ${provBucketFor.toString()};
   const provenanceChipFor = ${provenanceChipFor.toString()};
   const loadProgressLine = ${loadProgressLine.toString()};
+  const parseResearchAnswer = ${parseResearchAnswer.toString()};
   const sessionLogTimeOfDay = ${sessionLogTimeOfDay.toString()};
   const sessionLogHeaderMarkdown = ${sessionLogHeaderMarkdown.toString()};
   const sessionLogTurnMarkdown = ${sessionLogTurnMarkdown.toString()};
@@ -390,7 +430,8 @@ ${THEME_TOKENS_CSS}
   const inputEl = el("composerInput");
   const sendBtn = el("composerSend");
   const statusEl = el("status");
-  const statsPanelEl = el("statsPanel");
+  const statsPanelEl = el("statsPanelStats");
+  const researchedPanelEl = el("researchedPanel");
   const wikiModeFieldset = el("wikiMode");
   const wikiModeRadios = Array.prototype.slice.call(wikiModeFieldset.querySelectorAll('input[type="radio"]'));
   const synthSliderEl = el("synthSlider");
@@ -708,6 +749,98 @@ ${THEME_TOKENS_CSS}
     });
   }
 
+  // ---- researched this session: what "research <topic>" has actually read
+  // and grounded so far — each entry pairs the passage a settled research
+  // turn's own answer cites (parseResearchAnswer, off the SAME "(source:
+  // research article ...)" text the chat bubble already shows) with the real
+  // facts that turn stored, read back through window.tmctChat.
+  // researchedFactRows(memoryDir) rather than re-deriving them from the
+  // answer text — the citation names WHERE tmct read, the fact rows name
+  // WHAT it kept, and this panel never invents either from the other.
+  const researchedEntries = [];
+  const researchedFactKeysSeen = new Set();
+
+  function renderResearchedPanel() {
+    researchedPanelEl.textContent = "";
+    researchedPanelEl.appendChild(Object.assign(document.createElement("h2"), { textContent: "researched this session" }));
+    if (!researchedEntries.length) {
+      const empty = document.createElement("p");
+      empty.className = "empty";
+      empty.textContent = 'nothing yet — ask it to "research <a topic>" and what it reads, with the passage and the facts it grounded, lands here.';
+      researchedPanelEl.appendChild(empty);
+      return;
+    }
+    for (const entry of researchedEntries.slice(-8).reverse()) {
+      const item = document.createElement("div");
+      item.className = "researched-item";
+      const title = document.createElement("span");
+      title.className = "researched-title";
+      title.textContent = entry.title || "(untitled)";
+      item.appendChild(title);
+      if (entry.passage) {
+        const passage = document.createElement("span");
+        passage.className = "researched-passage";
+        passage.textContent = entry.passage;
+        item.appendChild(passage);
+      }
+      if (entry.url) {
+        const link = document.createElement("a");
+        link.className = "researched-link";
+        link.href = entry.url;
+        link.target = "_blank";
+        link.rel = "noopener noreferrer";
+        link.textContent = "source \\u2197";
+        item.appendChild(link);
+      }
+      if (entry.facts.length) {
+        const list = document.createElement("ul");
+        list.className = "researched-facts";
+        for (const fact of entry.facts) {
+          const li = document.createElement("li");
+          li.textContent = fact.subject + " " + fact.predicate + " " + fact.object;
+          list.appendChild(li);
+        }
+        item.appendChild(list);
+      } else {
+        const none = document.createElement("p");
+        none.className = "researched-none";
+        none.textContent = "no new fact grounded from this passage.";
+        item.appendChild(none);
+      }
+      researchedPanelEl.appendChild(item);
+    }
+  }
+
+  /** After a settled, non-miss research turn: read back the facts that turn
+   *  actually stored (a set-diff against every research fact seen so far, so
+   *  a later step never re-lists an earlier one's facts) and pair them with
+   *  this turn's own cited passage. A turn that grounded nothing new (an
+   *  empty article, or a re-fetch of an already-known one) still gets its
+   *  own entry — the passage was still read, even where nothing new stuck. */
+  async function noteResearchLearned(result) {
+    if (result.research === undefined || !result.record || result.record.miss) return;
+    if (!window.tmctChat.researchedFactRows || !window.tmctChatSession) return;
+    let rows;
+    try { rows = await window.tmctChat.researchedFactRows(window.tmctChatSession.memoryDir); }
+    catch { return; }
+    const newFacts = [];
+    for (const row of rows) {
+      const key = row.subject + "|" + row.predicate + "|" + row.object;
+      if (researchedFactKeysSeen.has(key)) continue;
+      researchedFactKeysSeen.add(key);
+      newFacts.push(row);
+    }
+    const parsed = parseResearchAnswer(result.answer);
+    if (!parsed && !newFacts.length) return;
+    researchedEntries.push({
+      title: parsed ? parsed.title : "",
+      passage: parsed ? parsed.passage : "",
+      url: parsed ? parsed.url : "",
+      facts: newFacts,
+    });
+    renderResearchedPanel();
+  }
+
   // "supplement" (typed /wiki supplement only) has no radio; the statusline
   // still names it, read straight off the session's own liveReference getter
   // rather than the last radio the page itself set.
@@ -791,6 +924,7 @@ ${THEME_TOKENS_CSS}
       // that changed nothing costs at most one coalesced write.
       if (result.record && result.record.via !== "command") scheduleSave();
       await renderStatsPanel(); // a teach or learned-load turn grew this session's memory; a plain ask leaves it unchanged either way
+      await noteResearchLearned(result);
     } catch (err) {
       settleAssistantBubble(pendingRow,
         "something went wrong answering that (" + (err && err.message ? err.message : err) + ") \\u2014 try rephrasing",
@@ -1018,6 +1152,18 @@ ${THEME_TOKENS_CSS}
     addSystemLine("tmct \\u2014 the real engine, running in this page \\u2014 " + statsSummaryLine(stats, bandLabelFor)
       + "." + restoredNote + " Ask it something, or teach it a fact of your own.");
     await renderStatsPanel(stats);
+    // A restored session may already carry earlier research facts (they
+    // persist with everything else this session taught) — seed the
+    // seen-set from them so a later research turn only reports what's
+    // actually new, without fabricating passages for a visit this page
+    // was never open to read.
+    if (window.tmctChat.researchedFactRows) {
+      try {
+        const existingResearch = await window.tmctChat.researchedFactRows(window.tmctChatSession.memoryDir);
+        for (const row of existingResearch) researchedFactKeysSeen.add(row.subject + "|" + row.predicate + "|" + row.object);
+      } catch { /* best-effort seeding only — a fresh session has none to seed */ }
+    }
+    renderResearchedPanel();
     inputEl.placeholder = seedPayload ? 'try "what is a dog" or "list facts"' : window.tmctChat.vocabExampleHint(false);
     renderStatus();
     setBusy(false);