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

package/package.json

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

package/src/domain/reference-pack.mjs

@@ -35,25 +35,49 @@ export function isReferenceIndexEntry(e) {
     && Number.isInteger(e.r) && e.r > 0;
 }
 
-/** A shard row: {term, title, text, summary, url, revid, isa?}. */
+/** A shard row: {term, title, text, summary, url, revid, isa?, source?,
+ *  licence?}. `source`/`licence` are optional per-entry overrides of the
+ *  citation's source name and licence line (renderReferenceAnswer, below) —
+ *  absent on every real Simple English Wikipedia row the build pipeline
+ *  emits, present only on a hand-added synthetic entry (e.g. a demo/test
+ *  term) whose citation must name its OWN real source, not Wikipedia's. */
 export function isReferenceArticleRow(row) {
   if (!row || typeof row !== "object") return false;
   for (const field of ["term", "title", "text", "summary", "url"]) {
     if (typeof row[field] !== "string" || !row[field]) return false;
   }
   if (!Number.isInteger(row.revid) || row.revid <= 0) return false;
-  if (row.isa !== undefined && (typeof row.isa !== "string" || !row.isa)) return false;
+  for (const field of ["isa", "source", "licence"]) {
+    if (row[field] !== undefined && (typeof row[field] !== "string" || !row[field])) return false;
+  }
   return true;
 }
 
+/** The default citation source/licence — every article the build pipeline
+ *  (scripts/fetch-reference-pack.mjs) emits from the pinned Simple English
+ *  Wikipedia dump carries neither field, so this is what renderReferenceAnswer
+ *  falls back to for the overwhelming majority of rows. */
+export const DEFAULT_REFERENCE_SOURCE = "Simple English Wikipedia";
+export const DEFAULT_REFERENCE_LICENCE = "CC BY-SA 4.0";
+
 /** The cited answer for a clean miss the pack could ground: the article's
- *  summary with its title, licence and revision-pinned URL always visible,
- *  then the grain cue. Without the cue a reader has to recognize the source
- *  name to tell this apart from a fact read out of their own graph — both
- *  answer the same "what is X" question in the same voice. */
+ *  summary with its title, licence and source always visible, then the grain
+ *  cue. Without the cue a reader has to recognize the source name to tell
+ *  this apart from a fact read out of their own graph — both answer the same
+ *  "what is X" question in the same voice.
+ *
+ *  The source/licence line reads the article's OWN `source`/`licence` fields
+ *  when present, falling back to the Wikipedia defaults otherwise — every
+ *  real pack row renders byte-identically to before this existed. Wikipedia's
+ *  revision-pinned `?oldid=` query is a convention of that source alone, so it
+ *  is only appended when the article is citing the default source; a
+ *  non-Wikipedia entry's own `url` is shown bare. */
 export function renderReferenceAnswer(term, article) {
+  const source = article.source ?? DEFAULT_REFERENCE_SOURCE;
+  const licence = article.licence ?? DEFAULT_REFERENCE_LICENCE;
+  const url = source === DEFAULT_REFERENCE_SOURCE ? `${article.url}?oldid=${article.revid}` : article.url;
   return `${term} — ${article.summary} (source: reference article "${article.title}", `
-    + `Simple English Wikipedia, CC BY-SA 4.0 — ${article.url}?oldid=${article.revid})`
+    + `${source}, ${licence} — ${url})`
     + ` ${GENERAL_VOCABULARY_CUE}`;
 }
 

package/src/domain/spider-fly-world.mjs

@@ -122,7 +122,7 @@ export const SEED_TAXONOMY = Object.freeze([
 ]);
 
 export const WORLD_OPENING =
-  "a spider waits in its web; a fly drifts in from the edge of the board. Neither is yours to move — watch, or address one by name in chat.";
+  "a spider waits in its web; a fly drifts in from the edge of the board. Neither is yours to move. Watch, or address one by name in chat.";
 
 /** Every fact row the shipped world source carries: cell typing, grid
  *  adjacency (mgx:has-exit-<direction>), the web block (mgx:in-web) and the

package/src/domain/sprite-templates.mjs

@@ -21,12 +21,14 @@
 //     substitution (e.g. `black = "#22201d"`). A value with no entry in that
 //     map is not a match for this template at all — it falls through to a
 //     less specific one, never a guessed/invented substitution.
-//   - a fully-specific hand-authored VARIANT — `{class}-with-{property}-
-//     {value}.toml` (e.g. a hypothetical `dog-with-colour-black.toml`, not
-//     authored this pass) — carries the same `classes` as the class it
-//     specializes, plus a `[match]` table (`property`, `value`) naming the
-//     exact fact it requires, so it outranks the parameterized template
-//     when both would otherwise apply.
+//   - a fully-specific hand-authored VARIANT — carries the same `classes`
+//     as the class it specializes, plus a `[match]` table (`property`,
+//     `value`) naming the exact fact it requires, so it outranks the
+//     parameterized template when both would otherwise apply. The filename
+//     is free-form and reads `{class}-{what it shows}` in practice
+//     (`portrait-round.toml` for mgx:hasProperty = round,
+//     `bear-facing-left.toml` for mgx:faces = left) — the `[match]` table,
+//     never the name, is what selects it.
 //
 // A parameterized template's `[parameters.<name>]` table comes in two
 // shapes, picked by which of `placeholder`/`placeholders` it declares:

package/src/services/adventure-viz.mjs

@@ -84,7 +84,7 @@
 // an edit implies run through the browser bundle's own `session.applyEdit`
 // (adventure-browser-entry.mjs), never here — this module only renders and
 // reads.
-import { THEME_TOKENS_CSS, SERIF_STACK, MONO_STACK, escapeHtml, embedJson, embedScriptText } from "./viz-theme.mjs";
+import { THEME_TOKENS_CSS, SERIF_STACK, MONO_STACK, escapeHtml, embedJson, embedScriptText, scenarioLabel } from "./viz-theme.mjs";
 import { createTicker } from "./viz-ticker.mjs";
 import { worldDigestRows, roomAffordances, foldWorldState } from "./adventure.mjs";
 import { exposedFacts } from "./adventure-autoplay.mjs";
@@ -168,15 +168,21 @@ export function factsForSubject(rows, subject) {
  *  feeding it an exposure-filtered pair (as `goalStatusLines` does) is what
  *  keeps a not-yet-visited location unknown. Pure, self-contained — no
  *  reference to adventure.mjs's own private helpers, since those aren't
- *  exported. */
-export function visibleRoomOf(rows, state, subject) {
+ *  exported. `actingSubject` is the identity the world places as the
+ *  carrier/viewer — a parameter, not a baked-in name, the same way
+ *  adventure.mjs's own `runWorldCommand`/`roomAffordances` take it; it
+ *  defaults to "player" because that's the one identity Ashcombe Hall's own
+ *  world facts actually use, not because this function only ever means
+ *  that individual (mud-viz.mjs threads its own per-character viewer through
+ *  the same shape, see `mudRoomSceneObjects`/`carriedItemsFor`). */
+export function visibleRoomOf(rows, state, subject, actingSubject = "player") {
   const isRoom = (id) => (rows || []).some((r) => r.subject === id && r.predicate === "rdf:type" && r.object === "room");
   if (isRoom(subject)) return subject;
   const place = state.placements.get(subject);
   if (!place || place.predicate === "mgx:hidden-in") return null;
   if (place.predicate === "mgx:currently-in" || isRoom(place.object)) return place.object;
   const holder = place.object;
-  if (holder === "player") return null;
+  if (holder === actingSubject) return null;
   if (!state.openness.get(holder)?.open) return null;
   const holderPlace = state.placements.get(holder);
   return holderPlace && holderPlace.predicate !== "mgx:hidden-in" ? holderPlace.object : null;
@@ -185,13 +191,14 @@ export function visibleRoomOf(rows, state, subject) {
 /** Every subject actually visible in `here`, sorted, each with its sprite
  *  class — built over `visibleRoomOf` (one containment hop through an OPEN
  *  container) so this can never draw a hidden or carried object the text
- *  digest wouldn't also mention. `player` is excluded; the caller draws the
- *  player's own adventurer sprite separately. Pure. */
-export function roomSceneObjects(rows, state, here) {
+ *  digest wouldn't also mention. `actingSubject` is excluded (default
+ *  "player"); the caller draws that individual's own adventurer sprite
+ *  separately. Pure. */
+export function roomSceneObjects(rows, state, here, actingSubject = "player") {
   const out = [];
   for (const subject of [...state.placements.keys()].sort()) {
-    if (subject === "player") continue;
-    if (visibleRoomOf(rows, state, subject) !== here) continue;
+    if (subject === actingSubject) continue;
+    if (visibleRoomOf(rows, state, subject, actingSubject) !== here) continue;
     out.push({ subject, spriteClass: spriteClassForObject(rows, subject) });
   }
   return out;
@@ -329,13 +336,13 @@ export function roomKindForRoom(rows, roomId) {
   return "indoor";
 }
 
-/** Every object currently `mgx:located-in` "player", sorted, each with its
- *  sprite class — the exact placement `worldDigestRows`'/`inventoryAnswer`'s
- *  own "carries the" branch already reads, just returned as a plain list
- *  instead of prose. Pure. */
-export function carriedItems(rows, state) {
+/** Every object currently `mgx:located-in` `actingSubject` (default
+ *  "player"), sorted, each with its sprite class — the exact placement
+ *  `worldDigestRows`'/`inventoryAnswer`'s own "carries the" branch already
+ *  reads, just returned as a plain list instead of prose. Pure. */
+export function carriedItems(rows, state, actingSubject = "player") {
   return [...state.placements]
-    .filter(([, p]) => p.predicate === "mgx:located-in" && p.object === "player")
+    .filter(([, p]) => p.predicate === "mgx:located-in" && p.object === actingSubject)
     .map(([subject]) => ({ subject, spriteClass: spriteClassForObject(rows, subject) }))
     .sort((a, b) => a.subject.localeCompare(b.subject));
 }
@@ -355,10 +362,10 @@ export function carriedItems(rows, state) {
  *  Disconnected visited rooms (not reachable from each other by traveled
  *  edges) lay out as separate side-by-side blocks rather than overlapping.
  *  Pure. */
-export function visitedRoomGraph(state, visitedRoomIds) {
+export function visitedRoomGraph(state, visitedRoomIds, actingSubject = "player") {
   const DELTA = { north: [0, -1], south: [0, 1], east: [1, 0], west: [-1, 0], up: [0, -1], down: [0, 1] };
   const visited = new Set(visitedRoomIds || []);
-  const here = state.placements.get("player")?.object ?? null;
+  const here = state.placements.get(actingSubject)?.object ?? null;
   const positions = new Map();
   const edges = [];
   const edgeKeys = new Set();
@@ -558,12 +565,16 @@ export function roomCaptionText(rows, state, here) {
 export function renderAdventureHtml({
   title = DEFAULT_TITLE,
   worldPayload = { facts: [], rules: [], opening: "" },
+  scenarios = [],
   spriteTemplates = [],
   largeSpriteTemplates = [],
   engineBundleJs = "",
 } = {}) {
+  const scenarioList = scenarios.length
+    ? scenarios
+    : [{ label: scenarioLabel(worldPayload?.name), worldPayload }];
   const pageData = embedJson({
-    world: worldPayload,
+    scenarios: scenarioList,
     previewMaxTicks: PREVIEW_MAX_TICKS,
     tickWaitMs: TICK_WAIT_MS,
     spriteTemplates,
@@ -726,31 +737,56 @@ ${THEME_TOKENS_CSS}
      the frame so neither fights the plaque or the room-kind icon; west and
      east sit just inside their own walls. Stairs get a round chip instead —
      neither up nor down is a compass point, and neither hangs on a wall. */
-  .room-stage { position: relative; padding: 1.35rem 0; }
+  .room-stage { position: relative; padding: 1.85rem 0; }
+  /* the "ways out" eyebrow — this ring is the ONLY place movement controls
+     exist on the page (the pill row deliberately drops every "go", see
+     renderPills), so a first-time player needs a named affordance here, not
+     just brass plates they have to guess at. */
+  .ways-out-label {
+    font-family: ${MONO_STACK}; font-size: .68rem; letter-spacing: .14em; text-transform: uppercase;
+    color: var(--gilt); opacity: .85; margin: 0 0 -.3rem .1rem;
+  }
   .dir-ring { position: absolute; inset: 0; pointer-events: none; }
   .dir-slot { position: absolute; pointer-events: auto; }
   .dir-north { top: 0; left: 50%; transform: translateX(-50%); }
   .dir-south { bottom: 0; left: 50%; transform: translateX(-50%); }
-  .dir-west { left: .3rem; top: 50%; transform: translateY(-50%); }
-  .dir-east { right: .3rem; top: 50%; transform: translateY(-50%); }
+  .dir-west { left: .4rem; top: 50%; transform: translateY(-50%); }
+  .dir-east { right: .4rem; top: 50%; transform: translateY(-50%); }
   /* the stairs stand at the left of each band: the frame's own corner
      flourishes sit top-left and bottom-right, and this is the one inset that
      clears both. */
-  .dir-up { top: 0; left: 1.4rem; }
-  .dir-down { bottom: 0; left: 1.4rem; }
+  .dir-up { top: 0; left: 1.5rem; }
+  .dir-down { bottom: 0; left: 1.5rem; }
+  /* a brass PUSH-plate, not a name plate: real button chrome (an outer drop
+     shadow, not just the inset highlight the static room/door plaques use),
+     a bigger touch target, and a lift on hover/press — so this reads as
+     clickable at a glance instead of blending into the wallpaper the way a
+     plain brass label would. The leading triangle is a direction-neutral
+     "go" cue, the same role an arrow plays on any door-push icon. */
   .dir-door {
-    position: relative; display: inline-flex; align-items: center; justify-content: center;
-    font-family: ${MONO_STACK}; font-size: .62rem; letter-spacing: .14em; text-transform: uppercase;
-    color: var(--gilt); background: var(--parchment); border: 1px solid var(--gilt);
-    box-shadow: inset 0 0 0 2px var(--parchment-strong);
-    padding: .2rem .6rem; white-space: nowrap;
+    position: relative; display: inline-flex; align-items: center; justify-content: center; gap: .3rem;
+    font-family: ${MONO_STACK}; font-size: .74rem; font-weight: 600; letter-spacing: .08em; text-transform: uppercase;
+    color: var(--gilt); background: var(--parchment); border: 1px solid var(--gilt); border-radius: 3px;
+    box-shadow: inset 0 0 0 2px var(--parchment-strong), 0 2px 4px rgba(0, 0, 0, .25);
+    padding: .5rem .95rem; white-space: nowrap;
+    transition: transform .08s ease, box-shadow .08s ease, background .08s ease, color .08s ease;
+  }
+  .dir-door::before { content: "\\25B8"; font-size: .62em; opacity: .9; }
+  .dir-door:hover, .dir-door:focus-visible {
+    background: var(--gilt); color: var(--parchment);
+    box-shadow: inset 0 0 0 2px var(--parchment-strong), 0 4px 7px rgba(0, 0, 0, .32);
+    transform: translateY(-1.5px);
   }
-  .dir-door:hover, .dir-door:focus-visible { background: var(--parchment-strong); color: var(--ink); }
-  .dir-door.stair { border-radius: 50%; width: 1.5rem; height: 1.5rem; padding: 0; font-size: .72rem; letter-spacing: 0; }
+  .dir-door:active {
+    transform: translateY(0);
+    box-shadow: inset 0 0 0 2px var(--parchment-strong), 0 1px 2px rgba(0, 0, 0, .28);
+  }
+  .dir-door.stair { border-radius: 50%; width: 2.15rem; height: 2.15rem; padding: 0; font-size: .86rem; letter-spacing: 0; }
+  .dir-door.stair::before { content: ""; }
   /* a door onto a room this session has not stood in yet, marked with the
      same gilt dot the manor board prints for a direction it cannot draw a
      room for — one hint shape, two surfaces. */
-  .dir-door .unwalked { position: absolute; top: -.16rem; right: -.16rem; width: .34rem; height: .34rem; border-radius: 50%; background: var(--gilt); }
+  .dir-door .unwalked { position: absolute; top: -.2rem; right: -.2rem; width: .4rem; height: .4rem; border-radius: 50%; background: var(--gilt); border: 1px solid var(--parchment); }
 
   .sprite-row { display: flex; align-items: flex-end; gap: .9rem .7rem; min-height: 2.5rem; }
   /* the floor band: every non-wall-mounted stack, wrapping and pinned to the
@@ -930,6 +966,9 @@ ${THEME_TOKENS_CSS}
   .controls-row button { font-family: ${MONO_STACK}; font-size: .72rem; letter-spacing: .05em; text-transform: uppercase; padding: .38rem .85rem; border: 1px solid var(--gilt); background: var(--parchment); color: var(--ink); }
   .controls-row button:hover:not(:disabled) { background: var(--parchment-strong); }
   .controls-row button:disabled { opacity: .4; cursor: default; }
+  .controls-row select { font-family: ${MONO_STACK}; font-size: .72rem; letter-spacing: .05em; text-transform: uppercase; padding: .38rem .85rem; border: 1px solid var(--gilt); background: var(--parchment); color: var(--ink); }
+  .controls-row select:hover:not(:disabled) { background: var(--parchment-strong); }
+  .controls-row select:disabled { opacity: .4; cursor: default; }
   .controls-row .turn { margin-left: auto; font-family: ${MONO_STACK}; font-size: .72rem; letter-spacing: .05em; text-transform: uppercase; color: var(--ink); background: var(--parchment); border: 1px solid var(--gilt); padding: .3rem .6rem; font-variant-numeric: tabular-nums; }
   .goal-line { font-family: ${MONO_STACK}; font-size: .78rem; color: var(--muted); margin-top: .5rem; }
   .status { font-family: ${MONO_STACK}; font-size: .74rem; color: var(--muted); margin-top: .3rem; }
@@ -970,11 +1009,14 @@ ${THEME_TOKENS_CSS}
     <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>
+  <p class="page-note" id="pageNote">${escapeHtml(scenarioList[0].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>
+${scenarioList.length > 1 ? `        <select id="scenarioSelect" aria-label="which world to play" disabled>
+${scenarioList.map((s, i) => `          <option value="${i}"${i === 0 ? " selected" : ""}>${escapeHtml(s.label || scenarioLabel(s.worldPayload?.name))}</option>`).join("\n")}
+        </select>` : ""}
         <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>
@@ -989,6 +1031,7 @@ ${THEME_TOKENS_CSS}
         <h2>satchel</h2>
         <div class="chips" id="carryList"></div>
       </div>
+      <div class="ways-out-label" aria-hidden="true">ways out</div>
       <div class="room-stage">
         <div class="room-frame" id="roomFrame">
           <div class="room-plaque mono" id="roomName"></div>
@@ -1096,6 +1139,12 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   const renderWorldEditorText = ${renderWorldEditorText.toString()};
   const wordBeforeCursor = ${wordBeforeCursor.toString()};
   const esc = ${escapeHtml.toString()};
+  // The identity Ashcombe Hall's own world facts place as the carrier/viewer
+  // — one named constant standing in for what was six separate "player"
+  // string literals scattered through the room/inventory/map drawing calls
+  // below, so a future scenario shipping a differently-named single
+  // character never falls out of step with the calls that use it.
+  const ACTING_SUBJECT = "player";
   const el = (id) => document.getElementById(id);
   const roomFrameEl = el("roomFrame");
   const roomNameEl = el("roomName");
@@ -1139,6 +1188,15 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   const roomDetailSpritesEl = el("roomDetailSprites");
   const roomDetailCaptionEl = el("roomDetailCaption");
   const legendListEl = el("legendList");
+  const scenarioSelectEl = el("scenarioSelect");
+  const pageNoteEl = el("pageNote");
+
+  // Which of the shipped worlds is loaded. Every read of the world — the
+  // session it is opened over, its opening line, the provenance prefix edit
+  // mode filters on, the key its progress is saved under — goes through this
+  // one index, so picking another world needs no second copy of any of them.
+  let worldIndex = 0;
+  const world = () => ADVENTURE.scenarios[worldIndex].worldPayload;
 
   const params = new URLSearchParams(location.search);
   const preview = params.get("preview") === "1";
@@ -1268,12 +1326,12 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // holding it has actually been visited this session.
   function goalStatusLinesFor(rows, state, visitedRoomIds) {
     const ids = Array.from(new Set(rows.filter((r) => r.predicate === "mgx:is-objective" && r.object === "true").map((r) => r.subject)));
-    const carriedIds = new Set(carriedItems(rows, state).map((o) => o.subject));
+    const carriedIds = new Set(carriedItems(rows, state, ACTING_SUBJECT).map((o) => o.subject));
     const exposedRows = tmctAdventure.exposedFacts(rows, visitedRoomIds);
     const exposedState = tmctAdventure.foldWorldState(exposedRows);
     return ids.map((id) => {
       if (carriedIds.has(id)) return { subject: id, status: "carried", text: "carrying the " + id + " \\u2014 the adventure is won." };
-      const room = visibleRoomOf(exposedRows, exposedState, id);
+      const room = visibleRoomOf(exposedRows, exposedState, id, ACTING_SUBJECT);
       return room
         ? { subject: id, status: "known", text: "last known: the " + id + " is in the " + room + "." }
         : { subject: id, status: "unknown", text: "there's a sought-after " + id + " somewhere." };
@@ -1284,7 +1342,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // the same non-interactive chip shape the room's own pills use for
   // actions, so the sidebar reads as one visual family.
   function renderCarrying(rows, state) {
-    const items = carriedItems(rows, state);
+    const items = carriedItems(rows, state, ACTING_SUBJECT);
     carryListEl.innerHTML = items.length
       ? items.map((o) => '<span class="chip">' + esc(o.subject) + "</span>").join("")
       : '<span class="empty-note">nothing yet</span>';
@@ -1329,7 +1387,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
       + edgesSvg + hintsSvg + nodesSvg + "</svg>";
   }
   function renderRoomMap(rows, state, visitedRoomIds) {
-    mapWrapEl.innerHTML = roomMapSvg(visitedRoomGraph(state, visitedRoomIds), false) || '<span class="empty-note">nowhere yet</span>';
+    mapWrapEl.innerHTML = roomMapSvg(visitedRoomGraph(state, visitedRoomIds, ACTING_SUBJECT), false) || '<span class="empty-note">nowhere yet</span>';
   }
 
   // ---- the map lightbox — clicking the fixed-square play-mode map redraws
@@ -1337,7 +1395,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // backdrop (not the board itself) or pressing Escape closes it.
   function openMapLightbox() {
     if (!lastSnapshot) return;
-    const svg = roomMapSvg(visitedRoomGraph(lastSnapshot.state, lastSnapshot.visitedRoomIds), false);
+    const svg = roomMapSvg(visitedRoomGraph(lastSnapshot.state, lastSnapshot.visitedRoomIds, ACTING_SUBJECT), false);
     if (!svg) return;
     mapLightboxInnerEl.innerHTML = svg;
     mapLightboxEl.hidden = false;
@@ -1445,7 +1503,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   document.addEventListener("keydown", (e) => { if (e.key === "Escape" && !objLightboxEl.hidden) closeObjectLightbox(); });
 
   function renderEditMap(rows, state) {
-    editMapWrapEl.innerHTML = roomMapSvg(visitedRoomGraph(state, allRoomIds(rows)), true) || '<span class="empty-note">this world defines no rooms</span>';
+    editMapWrapEl.innerHTML = roomMapSvg(visitedRoomGraph(state, allRoomIds(rows), ACTING_SUBJECT), true) || '<span class="empty-note">this world defines no rooms</span>';
   }
   editMapWrapEl.addEventListener("click", (e) => {
     const g = e.target.closest("[data-room]");
@@ -1643,7 +1701,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // diff + write; this page only ever reads its result back.
 
   function worldOnlyRows(rows) {
-    const prefix = "world:" + ADVENTURE.world.name;
+    const prefix = "world:" + world().name;
     return (rows || []).filter((r) => typeof r.provenance === "string" && r.provenance.indexOf(prefix) === 0);
   }
 
@@ -1657,7 +1715,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     }
     roomDetailPanelEl.setAttribute("data-room-kind", roomKindForRoom(editRows, selectedRoomId));
     roomDetailTitleEl.textContent = selectedRoomId;
-    const objects = roomSceneObjects(editRows, editState, selectedRoomId);
+    const objects = roomSceneObjects(editRows, editState, selectedRoomId, ACTING_SUBJECT);
     roomDetailSpritesEl.innerHTML = objects.length
       ? objects.map((o) => spriteCardHtml(o.subject, o.spriteClass, resolveObjectSprite(editRows, o))).join("")
       : '<span class="empty-note">nothing placed here yet</span>';
@@ -1674,7 +1732,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   function renderLegend(rows) {
     const subjects = new Set(rows.filter((r) => r.predicate === "rdf:type").map((r) => r.subject));
     const classes = new Set(["adventurer"]);
-    subjects.forEach((s) => { if (s !== "player") classes.add(spriteClassForObject(rows, s)); });
+    subjects.forEach((s) => { if (s !== ACTING_SUBJECT) classes.add(spriteClassForObject(rows, s)); });
     legendListEl.innerHTML = Array.from(classes).sort().map((cls) => {
       const svg = tmctAdventure.resolveSpriteAsset(
         cls, spriteAncestryRows(rows, cls), factsForSubject(rows, cls),
@@ -1792,7 +1850,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   async function boot({ fresh = false } = {}) {
     const saved = !fresh && persist ? await persist.load() : null;
     session = await tmctAdventure.createAdventureSession(
-      ADVENTURE.world,
+      world(),
       saved && saved.payload && saved.payload.memoryPayload
         ? { restoredPayload: saved.payload.memoryPayload, restoredVisitedRoomIds: saved.payload.visitedRoomIds }
         : {},
@@ -1803,12 +1861,14 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     goalLineEl.textContent = "";
     chatlogEl.innerHTML = "";
     statusEl.textContent = "";
-    addChatLine("t", esc(ADVENTURE.world.opening || "the adventure begins."));
+    if (pageNoteEl) pageNoteEl.textContent = world().opening || "";
+    addChatLine("t", esc(world().opening || "the adventure begins."));
     if (saved && snap.turn > 0) {
       addChatLine("t", "resumed where you left off (turn " + snap.turn + ") \\u2014 progress kept best-effort on this device; reset starts the manor over.");
     }
     chatqEl.disabled = false;
     resetBtn.disabled = false; playBtn.disabled = false; stepBtn.disabled = false; editModeBtn.disabled = false;
+    if (scenarioSelectEl) scenarioSelectEl.disabled = false;
   }
 
   const ticker = createTicker({
@@ -1843,11 +1903,34 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   stepBtn.addEventListener("click", () => ticker.stepOnce());
   resetBtn.addEventListener("click", () => ticker.reset());
 
+  // Each world keeps its own saved progress, so the stamp carries the world's
+  // name and a switch opens the store belonging to the world being switched
+  // to. Without that, one world's snapshot would restore into another's graph.
+  let siteVersion = "";
+  async function openPersistFor(worldName) {
+    if (preview || !tmctAdventure.openPersistedStore) return;
+    if (!siteVersion) siteVersion = await fetchSiteVersion();
+    persist = tmctAdventure.openPersistedStore({ storeKey: "adventure", stamp: siteVersion + ":" + worldName });
+  }
+
+  if (scenarioSelectEl) {
+    scenarioSelectEl.addEventListener("change", () => withLock(async () => {
+      const picked = Number(scenarioSelectEl.value);
+      if (!ADVENTURE.scenarios[picked] || picked === worldIndex) return;
+      ticker.pause();
+      // The pending save belongs to the world being left, and it is about to
+      // be written under the world being opened. Cancel it rather than let it
+      // land in the wrong store.
+      clearTimeout(persistSaveTimer);
+      persistSaveTimer = null;
+      worldIndex = picked;
+      await openPersistFor(world().name);
+      await boot();
+    }));
+  }
+
   (async () => {
-    if (!preview && tmctAdventure.openPersistedStore) {
-      const siteVersion = await fetchSiteVersion();
-      persist = tmctAdventure.openPersistedStore({ storeKey: "adventure", stamp: siteVersion + ":" + ADVENTURE.world.name });
-    }
+    await openPersistFor(world().name);
     await boot();
     if (preview) ticker.play();
   })();