@bongos/core 1.24.78 → 1.24.80

package/docs/{packs/ideator.md → recipes/ideation-playbook.md}

@@ -1,25 +1,12 @@
-# Ideator pack
+# Ideation playbook — the artist's ideas half, in detail
 
-> **The role pack for `discipline = ideator`.** The kernel ([`CLAUDE.md`](../../CLAUDE.md)) is what every session reads whatever its craft; this file is the half that is only true for ideators. Read the whole thing before acting — it changes how you behave for the rest of the session. Registered in [`scripts/bongos/discipline-modes.json`](../../scripts/bongos/discipline-modes.json); the Conductor injects this pointer into a session holding a claim of this craft (task 1002992).
-
-An ideation session is not the build-and-ship loop, and **it needs no claim**. "I'm just exploring" is a first-class state: an ideator should never need a chore checked out to start thinking.
-
----
-
-## The first rule: you are the instrument, not the author
-
-In every other craft, Claude does the work and asks the human to approve it. **Here it is inverted.** The ideator is the creative driver; you are the sounding board, the research arm, and the devil's advocate they reach for. Your job is to give them room to think and to be the one they *ask* — not to hand them finished ideas and file them.
-
-- **Do not dump a batch of ideas.** Producing "5–8 ideas" on command is exactly the failure mode this pack exists to kill. Volume is not the goal; a developed, pressure-tested idea is.
-- **Provoke, don't conclude.** Offer directions, tensions, and questions — "here are three ways this could go, which pulls at you?", "what's the version of this that scares you?", "here's why this might be a bad idea, talk me out of it." Let the human choose the thread.
-- **Do the legwork they ask for, on demand.** Search the inbox, run `/recall`, check consistency with what the project already decided, work out what an idea would actually touch. They should never have to do the digging.
-- **The human decides what gets filed.** You only capture an idea once they have blessed it. The conversation is the product; the filed idea is its residue.
+> Read from [`docs/packs/artist.md`](../packs/artist.md) (part two). The ideator craft folded into the artist in the game conversion (task 1005141, BONGOS-V3); this is the detail of its pack that would not fit the pack's size budget (ADR 0061). The pack keeps the two rules and the trust boundary; everything here applies whenever the work is an idea rather than a surface.
 
 ## The second rule: be quiet about the machinery
 
 The behaviour above inverts for this role — and so does the **surface** ([ADR 0271](../adr/0271-the-ideator-surface-is-two-halves.md)). Someone came here to think about an idea, not to watch a build. **Report outcomes, not mechanism.**
 
-- **Don't narrate the plumbing.** No tool-call commentary, file paths, script names, API routes, task ids, or claim bookkeeping in your prose. You still *use* all of it — you just don't make the ideator read about it.
+- **Don't narrate the plumbing.** No tool-call commentary, file paths, script names, API routes, task ids, or claim bookkeeping in your prose. You still *use* all of it — you just don't make the artist read about it.
 - **Speak in the language of the idea.** "We tried something close to this in the spring and it died on cost" beats "I ran the recall script over the ADR corpus and got four hits."
 - **One line out, then the answer.** When legwork will take a moment, say in one short line what you're going after, then come back with what you found — not a running commentary.
 - **Quiet is never hiding.** If something breaks, or you need a decision only they can make, say so plainly and immediately. A quiet surface that swallows a problem is a broken surface.
@@ -28,13 +15,6 @@ The behaviour above inverts for this role — and so does the **surface** ([ADR
 
 ---
 
-## Step 0 — is a human here?
-
-- A normal interactive session (they are typing to you, you can ask and get an answer) → **interactive mode**.
-- An autonomous, bypass-permissions, or scheduled run where no one will answer → **autonomous mode**.
-
-If unsure, ask once: *"Are you here to ideate with me, or should I run this autonomously?"* If no answer comes, treat it as autonomous.
-
 ## Step 1 (both modes) — load the ground before you think
 
 So that every idea lands against reality rather than in a vacuum:
@@ -45,19 +25,9 @@ So that every idea lands against reality rather than in a vacuum:
 
 ---
 
-## The two grades, and the question between them
-
-An idea is filed at one of two grades, and **the step between them is a question you ask, never an assumption you make.**
-
-### A quick idea stays one line
-
-A quick idea is a spark: one line of substance and nothing more. Do not pad it, do not "develop it up" into paragraphs, do not attach a plan. Its whole value is that it costs nothing to have, and inflating it destroys that.
-
-**After a quick idea is filed, ask — every time — whether they want to develop it into a Full Idea.** One short question, then take their answer. "No" is a completely good answer and ends it; the spark stays a spark and someone can develop it later. Never develop one silently because it seemed promising.
-
 ### A Full Idea is five answered questions
 
-A **Full Idea** is the ideator craft's real output: a baseline scope of work someone else can deliver against *without re-interviewing the person who had the thought*. It is **scored on completeness**, and that score feeds credits.
+A **Full Idea** is the artist craft's real output: a baseline scope of work someone else can deliver against *without re-interviewing the person who had the thought*. It is **scored on completeness**, and that score feeds credits.
 
 **Get the questions from the template, never from memory** — they are declared once, as data, and a project can define its own:
 
@@ -65,7 +35,7 @@ A **Full Idea** is the ideator craft's real output: a baseline scope of work som
 node scripts/bongos/spark.js --template
 ```
 
-That prints each field, its label, and the substance floor the scorer expects. Ask them **as questions, in that order** — one at a time, in the ideator's own thread of thought, not as a form read aloud. Drawing five answers out of a conversation is exactly this pack's dynamic, and it is the path for someone who thinks by talking rather than by filling in boxes.
+That prints each field, its label, and the substance floor the scorer expects. Ask them **as questions, in that order** — one at a time, in the artist's own thread of thought, not as a form read aloud. Drawing five answers out of a conversation is exactly this pack's dynamic, and it is the path for someone who thinks by talking rather than by filling in boxes.
 
 #### You write down what they said
 
@@ -126,16 +96,3 @@ There is no quota in either mode. One deeply-developed idea is a great session;
 
 ---
 
-## Trust boundary — filing is open, triage is not
-
-Filing into the inbox is open to **any** authenticated builder, Xenos included. **Triage** — promote, discard, merge — reshapes the whole team's backlog and is **Metic+ only** (`/idea-triage`). So in this pack you *file*; you never verdict. If a sub-Metic ideator asks to promote their own idea, explain that triage is a trusted-builder step and their idea is now queued for it.
-
----
-
-<!-- BEGIN GENERATED ROLE RESPONSIBILITY (scripts/bongos/gen-role-responsibilities.js — do not hand-edit) -->
-## What this craft is answerable for
-
-> Make good ideas; be a philosopher / thought leader for the project; enable Engineers to scope and Artists to create with maximum efficiency — a baseline for creating scopes of work.
-
-*The ideator's written responsibility — one source (`src/role-responsibilities.js`), shown on the hall profile, taught here, and referenced by the grader. Fixed by the area owner on 2026-09-08, criterion `wa6-written-responsibilities`. Generated: do not hand-edit, and do not paraphrase it elsewhere.*
-<!-- END GENERATED ROLE RESPONSIBILITY -->

package/migrations/core_296_crafts_artisan_artist.sql

@@ -0,0 +1,72 @@
+-- core_296_crafts_artisan_artist.sql — task 1005141 (BONGOS-V3, goal 1000141, C1):
+-- rename the crafts to the game's characters.
+--
+--   engineer → artisan
+--   ideator  → artist     (ideation folds into the artist craft; spec settled point 6)
+--   artist   → artist     (unchanged)
+--   ui       → ui         (module-contributed, ADR 0272; not a character)
+--
+-- The vocabulary and its old spellings live in src/crafts.js (normalizeCraft); every
+-- write path normalizes, so after this runs nothing NEW is written with an old word.
+--
+-- FORWARD-SAFE BY SUPERSET. `bongos upgrade` rolls code back without rolling the
+-- database back (scripts/bongos/lint-migrations.js). Old code still writes 'engineer'
+-- and 'ideator', so both CHECKs below ACCEPT the old words as well as the new ones. A
+-- later contraction migration drops them once no supported core writes them. The data
+-- itself moves to the new words now, so new code never has to read an old one — and
+-- new code still normalizes on read, in case a rolled-back release wrote one since.
+--
+-- Constraints are dropped BEFORE the updates and re-added after (the 086/176 pattern).
+-- Every UPDATE is a no-op on already-migrated rows, so the file is idempotent.
+
+BEGIN;
+
+ALTER TABLE tasks    DROP CONSTRAINT IF EXISTS tasks_discipline_check;
+ALTER TABLE builders DROP CONSTRAINT IF EXISTS builders_preferred_disciplines_check;
+
+-- tasks.discipline
+UPDATE tasks SET discipline = 'artisan' WHERE discipline = 'engineer';
+UPDATE tasks SET discipline = 'artist'  WHERE discipline = 'ideator';
+
+-- Newcomer-floor stock refs carry the craft (scripts/bongos/newcomer-floor.js
+-- instanceSourceRef: 'tmpl:<craft>:<template>:<seq>'). Moved with the craft so the
+-- restock counts the stock it already made instead of minting a second set.
+UPDATE tasks SET source_ref = 'tmpl:artisan:' || substr(source_ref, length('tmpl:engineer:') + 1)
+  WHERE source_ref LIKE 'tmpl:engineer:%';
+UPDATE tasks SET source_ref = 'tmpl:artist:' || substr(source_ref, length('tmpl:ideator:') + 1)
+  WHERE source_ref LIKE 'tmpl:ideator:%';
+
+-- builders.preferred_disciplines — mapped and DEDUPED in first-seen order:
+-- {artist, ideator} is one craft now, not two.
+UPDATE builders b
+   SET preferred_disciplines = sub.mapped
+  FROM (
+    SELECT id,
+           ARRAY(
+             SELECT m.craft
+               FROM (
+                 SELECT CASE d WHEN 'engineer' THEN 'artisan' WHEN 'ideator' THEN 'artist' ELSE d END AS craft,
+                        min(ord) AS first_seen
+                   FROM unnest(preferred_disciplines) WITH ORDINALITY AS u(d, ord)
+                  GROUP BY 1
+               ) m
+              ORDER BY m.first_seen
+           ) AS mapped
+      FROM builders
+     WHERE preferred_disciplines && ARRAY['engineer', 'ideator']::text[]
+  ) sub
+ WHERE b.id = sub.id;
+
+-- builders.main_discipline (core_268; no CHECK — the vocabulary is open)
+UPDATE builders SET main_discipline = 'artisan' WHERE main_discipline = 'engineer';
+UPDATE builders SET main_discipline = 'artist'  WHERE main_discipline = 'ideator';
+
+ALTER TABLE tasks ADD CONSTRAINT tasks_discipline_check
+  CHECK (discipline IN ('artisan', 'artist', 'ui', 'engineer', 'ideator'));
+ALTER TABLE builders ADD CONSTRAINT builders_preferred_disciplines_check
+  CHECK (preferred_disciplines <@ ARRAY['artisan', 'artist', 'patron', 'ui', 'engineer', 'ideator']::text[]);
+
+INSERT INTO schema_migrations (version) VALUES ('core_296_crafts_artisan_artist')
+  ON CONFLICT DO NOTHING;
+
+COMMIT;

package/migrations/core_297_builder_character.sql

@@ -0,0 +1,30 @@
+-- core_297_builder_character.sql — the character a builder holds (task 1005147,
+-- BONGOS-V3 G2 / criterion you-are-a-character-in-first-person).
+--
+-- A builder picks one of three characters when they join: artisan, artist or patron
+-- (src/crafts.js names them). The pick is IDENTITY AND VIEW, never authority
+-- (criterion character-is-identity-not-authority): nothing that gates a claim, a vote,
+-- a deploy or a spend reads this column — rank does, on the server, as before.
+--
+-- Settled point 2 of docs/specs/bongos-v3-game-conversion.md: switching character is
+-- signing out and back in. The hall clears the column and signs out; the next sign-in
+-- finds it NULL and shows character creation again.
+--
+-- NULL means "not picked yet" (every builder who joined before this migration), and the
+-- hall asks. The column is named game_character because CHARACTER is a SQL type word.
+--
+-- ADDITIVE AND FORWARD-SAFE: a rolled-back core never reads the column, and a builder's
+-- own row is the only one any route writes.
+
+BEGIN;
+
+ALTER TABLE builders ADD COLUMN IF NOT EXISTS game_character text;
+
+ALTER TABLE builders DROP CONSTRAINT IF EXISTS builders_game_character_check;
+ALTER TABLE builders ADD CONSTRAINT builders_game_character_check
+  CHECK (game_character IS NULL OR game_character IN ('artisan', 'artist', 'patron'));
+
+INSERT INTO schema_migrations (version) VALUES ('core_297_builder_character')
+  ON CONFLICT DO NOTHING;
+
+COMMIT;

package/modules/copy-desk/proposals.js

@@ -118,7 +118,7 @@ function normalizeProposalPayload({ body = {}, entry, builderId = null } = {}) {
   }
 
   // The placeholder arithmetic. This is the one rule that makes the patch
-  // MECHANICALLY applicable rather than a note for an engineer: the applier
+  // MECHANICALLY applicable rather than a note for an artisan: the applier
   // re-injects the source's own interpolations into the holes, so the count has
   // to match and the order has to be the author's intent.
   const want = placeholderCount(current);

package/modules/economy/credits-by-craft.js

@@ -4,10 +4,10 @@
 // (task 1004433 / WA6.RP03, goal 1000095, criterion wa6-roles-read-true-in-public).
 //
 // WHY. builders.total_credits is one number, and every public surface read it as
-// "payout from shipped work". That is true for an engineer and false for the
-// other two crafts: an artist is paid per approved page (`tweak.page_approved:`),
-// an ideator per idea stream (`idea.credit.*`), and neither has to ship a task to
-// earn. The owner's 2026-09-30 rules need the split: a role other than the main
+// "payout from shipped work". That is true for an artisan and false for the
+// artist, who is paid per approved page (`tweak.page_approved:`) and per idea
+// stream (`idea.credit.*`) — the ideator's pay before task 1005141 folded that
+// craft into the artist — and need not ship a task to earn. The owner's 2026-09-30 rules need the split: a role other than the main
 // one shows (chip, Activity tab, leaderboard entry) only once it has EARNED
 // credits, and a leaderboard filtered to one role ranks by the credits earned in
 // that craft. So the split is a ledger fact, read here, once.
@@ -15,13 +15,14 @@
 // THE RULE, per credit_log row:
 //
 //   tweak.page_approved:<task>          artist   (ADR 0341 D10, the artist lane)
-//   idea.credit.* · idea_promotion_bonus ideator  (ADR 0172, every idea stream,
-//                                                 the spark/developer split too)
+//   idea.credit.* · idea_promotion_bonus artist   (ADR 0172, every idea stream,
+//                                                 the spark/developer split too;
+//                                                 also kept apart as `ideas`)
 //   task.shipped · task.confirmed ·      the craft of the TASK's discipline
 //   ship.net_negative
 //   session.token_reward                 the craft of the tasks that session
 //                                        shipped, split evenly across them; a
-//                                        session that names none is engineering
+//                                        session that names none is artisan
 //                                        (an AI build session is, by default)
 //   anything else (achievement.*,        `other` — credited, but to no craft
 //   rank_change, a hand grant)
@@ -30,7 +31,7 @@
 // module-contributed design discipline (ADR 0079, 0272) and counts as ARTIST:
 // the artist's craft is how the project looks and reads (docs/packs/artist.md),
 // and UI design is that. A discipline this table does not know (a module may
-// contribute one later) counts as engineering, the default craft, rather than
+// contribute one later) counts as artisan, the default craft, rather than
 // vanishing from every total.
 //
 // THE SUM IS EXACT. A session's reward split across three tasks is a third each,
@@ -46,15 +47,25 @@ const api = require('../../src/module-api');
 const { pool } = api;
 const { ARTIST_PAGE_REASON_PREFIX } = require('./credits');
 
-const CRAFTS = Object.freeze(['engineer', 'artist', 'ideator']);
-const DEFAULT_CRAFT = 'engineer';
+const CRAFTS = Object.freeze(['artisan', 'artist']);
+const DEFAULT_CRAFT = 'artisan';
 const OTHER = 'other';
+// Idea credit streams are ARTIST money since the ideator folded into the artist
+// (task 1005141), but the sky's idea numbers still need them on their own (a
+// "total size" of ideas must not include page credits). So the SQL tags them
+// `ideas`, the craft split counts them as artist, and each folded row also carries
+// `ideas` — that share alone, NOT a craft and not added to the total twice.
+const IDEAS = 'ideas';
 
+// ui is the artist's craft; the old spellings (engineer, ideator — task 1005141) are
+// read as today's, in case a rolled-back release wrote one after core_296 ran.
 const DISCIPLINE_CRAFT = Object.freeze({
-  engineer: 'engineer',
+  artisan: 'artisan',
   artist: 'artist',
   ui: 'artist',
-  ideator: 'ideator',
+  engineer: 'artisan',
+  ideator: 'artist',
+  [IDEAS]: 'artist',
 });
 
 // The per-task reasons whose craft is the task's own. The same three the
@@ -100,7 +111,7 @@ const CREDITS_BY_CRAFT_SQL = `
            cl.delta::numeric AS amount,
            CASE
              WHEN cl.reason LIKE $2 THEN 'artist'
-             WHEN cl.reason LIKE 'idea.credit.%' OR cl.reason = 'idea_promotion_bonus' THEN 'ideator'
+             WHEN cl.reason LIKE 'idea.credit.%' OR cl.reason = 'idea_promotion_bonus' THEN '${IDEAS}'
              WHEN cl.reason = ANY($3::text[]) THEN COALESCE(t.discipline, '${DEFAULT_CRAFT}')
              ELSE '${OTHER}'
            END AS discipline
@@ -149,7 +160,8 @@ function apportion(parts, total) {
 
 // foldCraftRows — the grouped SQL rows into one exact row per builder. Pure,
 // so the rounding and the discipline mapping are testable without a database.
-// Returns Map<builderIdString, { engineer, artist, ideator, other, total }>,
+// Returns Map<builderIdString, { artisan, artist, other, total, ideas }> (ideas = the
+// idea-stream share of artist, see IDEAS),
 // with every builder asked for present (at zero when they have earned nothing:
 // "no credits" is an answer, not a gap).
 function foldCraftRows(ids, rows) {
@@ -160,15 +172,17 @@ function foldCraftRows(ids, rows) {
     parts[OTHER] = 0;
     raw.set(id, parts);
   }
+  const ideas = new Map();
   for (const r of rows || []) {
     const parts = raw.get(String(r.builder_id));
     if (!parts) continue;
     parts[craftOfDiscipline(r.discipline)] += Number(r.amount) || 0;
+    if (r.discipline === IDEAS) ideas.set(String(r.builder_id), (ideas.get(String(r.builder_id)) || 0) + (Number(r.amount) || 0));
   }
   const out = new Map();
   for (const [id, parts] of raw) {
     const total = Math.round(Object.values(parts).reduce((a, b) => a + b, 0));
-    out.set(id, { ...apportion(parts, total), total });
+    out.set(id, { ...apportion(parts, total), total, ideas: Math.round(ideas.get(id) || 0) });
   }
   return out;
 }

package/modules/hall-ui/public/ai-studio.html

@@ -8,7 +8,7 @@
   <title>Studio — {{worldName}}</title>
   <meta name="description" content="Make something with AI in the studio: bring sketches, pictures or a PDF, say what you want, and get an answer and pictures back.">
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/studio.css?v=2026-10-09-day">
   <link rel="stylesheet" href="/builders/ai-studio.css?v=2026-10-29-ais1">
 </head>
@@ -87,10 +87,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-28-tw23"></script>

package/modules/hall-ui/public/atlas.html

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <!-- task 1003472: the island index under the map is a run of oversight rows,
        and the detail panel's facts are the family's lines, so the family sheet
        loads first and atlas.css holds only the scene. -->
@@ -90,13 +90,13 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
-<script src="/builders/atlas.js?v=2026-09-02-index" defer></script>
+<script src="/builders/atlas.js?v=2026-11-10-options" defer></script>
 </body>
 </html>

package/modules/hall-ui/public/atlas.js

@@ -386,7 +386,9 @@
     for (var i = 0; i < btns.length; i++) btns[i].addEventListener('click', function () { setView(this.getAttribute('data-view')); });
     document.getElementById('popupClose').addEventListener('click', function (ev) { ev.stopPropagation(); closePopup(); });
     svg.addEventListener('click', function () { closePopup(); });
-    document.addEventListener('keydown', function (ev) { if (ev.key === 'Escape' && popup.classList.contains('show')) closePopup(); });
+    // An Escape that closed the card is spent (preventDefault), so in game mode it does not also
+    // open the options menu, and outside it does not also bring the bars back (ADR 0399 §2.4, task 1005144).
+    document.addEventListener('keydown', function (ev) { if (ev.key === 'Escape' && popup.classList.contains('show')) { ev.preventDefault(); closePopup(); } });
     // A neighbour chip in the map's card opens that island's card.
     popup.addEventListener('click', function (ev) {
       var jump = ev.target.closest('.ab-jump'); if (!jump) return;

package/modules/hall-ui/public/blockers.html

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/hall-ask.css">
   <!-- task 1003455: the row shape (title + facts) is the oversight family's,
        the same archetype collab/copy-desk/watch/gate already ride. -->
@@ -59,10 +59,10 @@
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
@@ -72,7 +72,7 @@
 <!-- task-detail.js still owns the #/blocker/N deep-link overlay every row's
      title opens into — this page needs its link-builder (OTBTaskDetail.href)
      for the "blocking N tasks" facts line, but not the overlay's own render. -->
-<script src="/builders/task-detail.js?v=2026-07-03-taskdetail"></script>
+<script src="/builders/task-detail.js?v=2026-11-10-options"></script>
 <script src="/builders/blockers-lib.js"></script>
 <script src="/builders/hall-ask.js"></script>
 <script src="/builders/blockers.js"></script>

package/modules/hall-ui/public/board-room.html

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/hall-ask.css">
   <link rel="stylesheet" href="/builders/oversight.css">
   <!-- The room's own sheet: the sitting card and the ballot controls moved here
@@ -61,10 +61,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/city.css

@@ -89,7 +89,8 @@ html:has(body[data-page="city"]) { height: 100%; }
    the home above and below measures from the stage instead of the window. */
 .city-main { position: fixed; top: var(--topbar-h, 56px); left: var(--sidebar-w-rail, 64px); right: 0; bottom: 0; max-width: none; margin: 0; contain: layout paint; z-index: 1; }
 html[data-fullscreen="on"] .city-main { top: 0; left: 0; }
-@media (max-width: 768px) { .city-main { left: 0; } }
+/* task 1005148: at phone width with the visor up (game mode), the door rises clear of its bottom row of pills. */
+@media (max-width: 768px) { .city-main { left: 0; } html.visor-on .city-door { bottom: 120px; } }
 /* The full-screen switch floats top right over the stage, where the sun/moon
    switch sits; the strip steps in by the button's width so nothing sits under it.
    Under 640 the exit is the round button (style.css). */

package/modules/hall-ui/public/city.html

@@ -11,8 +11,9 @@
        links, injected into this head by the server like every hall page's
        (tests/hall_tokens.mjs: no hall page hardcodes a web-font stylesheet).
        The prototype carried its own Google Fonts link for the same two faces. -->
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/city.css?v=2026-10-23-decide12">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
+  <link rel="stylesheet" href="/builders/visor.css?v=2026-11-10-visor">
+  <link rel="stylesheet" href="/builders/city.css?v=2026-11-10-visor">
   <!-- the ask card in the glass language, shared with the street's deck (task 1004702) -->
   <link rel="stylesheet" href="/builders/street-deck.css?v=2026-10-17-tidy">
 </head>
@@ -106,11 +107,13 @@
 </div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode" defer></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options" defer></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers" defer></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals" defer></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode" defer></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor" defer></script>
+<script src="/builders/shell.js?v=2026-11-10-character" defer></script>
 <script src="/builders/hall-dialog.js" defer></script>
+<!-- task 1005148: the visor (glass over the scene, game mode only; ADR 0399), after the shell and hall-dialog.js -->
+<script src="/builders/visor.js?v=2026-11-10-visor" defer></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1" defer></script>
 <script src="/builders/gov-feeds.js?v=2026-10-09-living3" defer></script>
@@ -126,6 +129,6 @@
 <script src="/builders/street-deck.js?v=2026-10-13-glass1" defer></script>
 <script src="/builders/city-decide.js?v=2026-10-23-decide12" defer></script>
 <script src="/builders/city-switchboard.js?v=2026-10-23-board5" defer></script>
-<script src="/builders/city.js?v=2026-10-23-decide12" defer></script>
+<script src="/builders/city.js?v=2026-11-10-visor" defer></script>
 </body>
 </html>

package/modules/hall-ui/public/city.js

@@ -697,7 +697,9 @@
   // 1 / 2 / 3 answer the card's ask, as on the deck
   function cardKey(e) {
     if (!e) return;
-    if (e.key === 'Escape') { closeCard(); return; }
+    // Spent once it closed the card (task 1005188, found by ADR 0399 §3): without it the same press
+    // also brought the bars back, and in game mode would open the options menu (task 1005144).
+    if (e.key === 'Escape') { if (e.preventDefault) e.preventDefault(); closeCard(); return; }
     if ((e.key === 'ArrowLeft' || e.key === 'ArrowRight') && !e.ctrlKey && !e.metaKey && !e.altKey && !(e.target && /^(INPUT|TEXTAREA)$/.test(String(e.target.tagName)))) { if (e.preventDefault) e.preventDefault(); flipCard(e.key === 'ArrowLeft' ? -1 : 1); return; }
     var inText = e.target && /^(INPUT|TEXTAREA)$/.test(String(e.target.tagName));
     // Tab is the next thing that needs you in this building, never the next button
@@ -775,4 +777,8 @@
 
   window.GovCityPage = { boot: boot, draw: draw, load: load, fit: fit, openCard: openCard, closeCard: closeCard, openDecide: function (scope, how) { openDecide(scope, how); return decide; }, FEEDS: FEEDS, LIVING_FEEDS: LIVING_FEEDS, THEME_KEY: THEME_KEY };
   window.GovCityPage.ready = boot();
+  // task 1005148: the Governor City as the visor's scene. No camera until R13, so no movement
+  // actions (ADR 0399 §2.2); the card's own keys are listed for the sheet.
+  window.__visorScene = { name: 'city', place: 'Governor city', keys: [{ label: 'On a card: answer', key: '1–9' }, { label: 'On a card: next', key: '← →' }] };
+  if (window.OTBVisor) window.OTBVisor.scene(window.__visorScene);
 }());

package/modules/hall-ui/public/collab.html

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/oversight.css">
   <link rel="stylesheet" href="/builders/collab.css">
 </head>
@@ -160,10 +160,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>

package/modules/hall-ui/public/commands.html

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/commands.css">
 </head>
 <body data-page="commands" data-page-title="Commands">
@@ -52,10 +52,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/copy-desk.html

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/oversight.css">
   <link rel="stylesheet" href="/builders/copy-desk.css">
 </head>
@@ -178,10 +178,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>