@bongos/core 1.24.88 → 1.24.90

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/bongos/package-core.js",
-  "core_version": "1.24.88",
-  "core_contract": "1.24.88",
-  "source_commit": "9cae78916698991df76bd7767758abec0b14492b",
+  "core_version": "1.24.90",
+  "core_contract": "1.24.90",
+  "source_commit": "8b084c190e038c91f0cd34788d09ef2aaaf11a22",
   "source_ref": "HEAD",
-  "built_at": "2026-11-12T11:35:17.869Z",
+  "built_at": "2026-11-12T12:22:11.337Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 649,
+    "docs_redacted": 650,
     "agent_docs_stubbed": 32,
-    "functional_verbatim": 3963,
+    "functional_verbatim": 3964,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 4645,
-  "tree_sha256": "f48750290cca4d1cd80ef79b32ed0dfb13062b4da5e2dca2e23fb747fb892e61",
+  "file_count": 4647,
+  "tree_sha256": "904d7883071b44b177146ffb3f7ac3b50033d6f3a86d5b162f91c48e1f5e397b",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -2474,10 +2474,15 @@
       "mode": "0000644",
       "sha256": "2b1d542cca6f0766d214c9b42b38094fa5aeeb3926f66f1cd88ae62bcb3d06e4"
     },
+    {
+      "path": "docs/adr/0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md",
+      "mode": "0000644",
+      "sha256": "d98e0ea9a8a9b541bb58361bb124a4884c8165758aa8e3243e743368467e79ed"
+    },
     {
       "path": "docs/adr/README.md",
       "mode": "0000644",
-      "sha256": "6ec9829802a80562a413b4dc571552c84bb52ab96a0dc155cbdce8233fc1fe49"
+      "sha256": "ca848f718bbc048e492417b7b92b00359d691473891950302d5d7d232da2a1ad"
     },
     {
       "path": "docs/api-reference.md",
@@ -2512,12 +2517,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "349a712a81588492c8694f0c7c5ea267414d892c53a076a6c838fd0ef8b6c23d"
+      "sha256": "c37bd90219c6e760347c3cc48f3647a0f255b4ae084edbb010ec5a33f7ea04dc"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "1f076a4c1e82f2ba9b6b27b050d5da9f8df6c14ad91f0cfe19d7041c3f3a6630"
+      "sha256": "f493610562231d36902d6f4b8c0842574ac19f960a58a59812cec7bd04048073"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -3032,7 +3037,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "a12a9637942f1c88b7f388c2c27860eeefda541a8688233f4fdc0df15db11d9c"
+      "sha256": "40c2f5de03f98c8bcbf0f169f0bb1d6066803f6ab96171ddf29b9cf4491abad6"
     },
     {
       "path": "docs/modules-contract.md",
@@ -3117,7 +3122,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "d35610b6f68ee39d58c74078a17b6ac637c07a293438ba494caf7075ab593503"
+      "sha256": "10f19956b0f3c1b7e14f5433b40f417ce54a8f4291f4194fb98163522f9a83fd"
     },
     {
       "path": "docs/project-context.template.md",
@@ -6327,7 +6332,7 @@
     {
       "path": "modules/hall-ui/public/craft-mode.js",
       "mode": "0000644",
-      "sha256": "743c515009a46b46833807b9ddb4e5d9304cb3107c9e62a7b87bd7cffe29c3c6"
+      "sha256": "15dc97554ec17cde2938078650290333d5d15a847654688381d5a9b218d90b9f"
     },
     {
       "path": "modules/hall-ui/public/craft-review.css",
@@ -6917,12 +6922,12 @@
     {
       "path": "modules/hall-ui/public/page-notes.css",
       "mode": "0000644",
-      "sha256": "fc40a2d1f548d5ed15583d5d7fb26a2f7926fc2f10e9612fb525a936353ea26a"
+      "sha256": "cd73ad050eaa76bbe04033f41cc7069bf126d8678ff567ab0f40409cb70a6af5"
     },
     {
       "path": "modules/hall-ui/public/page-notes.js",
       "mode": "0000644",
-      "sha256": "eef2a37a877a38801cce227786ac53623e89d8b1e07521beefb4c21fb503f935"
+      "sha256": "b8ee9540a09ccc9c46b4d8ad7a5cc916405c1b7b24ca73d45dda078145613666"
     },
     {
       "path": "modules/hall-ui/public/paintbrush.js",
@@ -7342,7 +7347,7 @@
     {
       "path": "modules/hall-ui/public/style.css",
       "mode": "0000644",
-      "sha256": "0912992b2572931af010bca4c8141619b9c8671c3aed55d7aec0243479bb916c"
+      "sha256": "d42939b4e5777cd304c272caa057f6723b8cff8a372b4275a7caa6dade7200b4"
     },
     {
       "path": "modules/hall-ui/public/task-detail.js",
@@ -7382,7 +7387,7 @@
     {
       "path": "modules/hall-ui/public/thinking.css",
       "mode": "0000644",
-      "sha256": "c6a055278702bb005b65202ef8a0b367283f13092c3e99faf91d39025b3019df"
+      "sha256": "99df2ce6bb017b78d0fd4f3f4f4607cecfea3e3a9275aaded09c4a66bdfe5a9f"
     },
     {
       "path": "modules/hall-ui/public/thinking.html",
@@ -7432,12 +7437,12 @@
     {
       "path": "modules/hall-ui/public/visor.css",
       "mode": "0000644",
-      "sha256": "8f5750cba2621d04e0dbff0efe4bff29c9b071ef84de342e0b93e2ab32b03a07"
+      "sha256": "8c7c3088fb756d2e6fddc6d9d9df81fb67ada498628dc3a9ff67a8cbb97ab3e6"
     },
     {
       "path": "modules/hall-ui/public/visor.js",
       "mode": "0000644",
-      "sha256": "92a14b637f97f86ae3661a26a22b78cce3e098c4c85e6c1d672eb3b4a05e6dc5"
+      "sha256": "7c3dec2c81435516e15a35d4245557215c84d809f76ac9b49f95529a935518ec"
     },
     {
       "path": "modules/hall-ui/public/vote-control.js",
@@ -7582,7 +7587,7 @@
     {
       "path": "modules/hall-ui/records/game-mode.md",
       "mode": "0000644",
-      "sha256": "0c9b326ed5c49a7157a4f7eac4207229e006b0bf5b4205d3a6f2b2b5d21176b0"
+      "sha256": "bcf581da178354e3c366668b2b6b3641181ea6691bba754ad43876f0cacee0a0"
     },
     {
       "path": "modules/hall-ui/records/genesis-home.md",
@@ -7747,7 +7752,7 @@
     {
       "path": "modules/hall-ui/records/visor.md",
       "mode": "0000644",
-      "sha256": "563d2c2291aed7ca650c977900fe54eac57350d56ca520585de953a28be764be"
+      "sha256": "515c6e31880265d11477e723fd0307d49409b6c04d5e53aa6579ef809c88269b"
     },
     {
       "path": "modules/hall-ui/records/welcome-tower.md",
@@ -12097,12 +12102,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "f1d1734b747e9b279bf00ec7f8d782362aef5a0793dd8d3563ab746de80412e7"
+      "sha256": "7cd685f627a16c373b7c02c103aa377c1978526abdd4551c1dfe2b4e73b7eed4"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "15d8be448f60457c3fe8bb3246555e17d813dc97c55e59ca10ec821e28bd6813"
+      "sha256": "b1a500b3e515779422782bf3f0e36f3c33ec5616170ceecdcb1b58650ab43aee"
     },
     {
       "path": "public-docs/index.html",
@@ -12122,7 +12127,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "ff81223c009e439843f7b19017c9c4d2e3fed034b8487bf801a0818aff14f066"
+      "sha256": "9c99264a25217b3386e20b6a4151551200345eb1b7d3d9bb55a03dd0c259bef7"
     },
     {
       "path": "scripts/bongos/CLAUDE.md",
@@ -16127,7 +16132,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "d18338a71f96f04825f9fcc95d8567c380149ebc18879fb161ff28263315e04b"
+      "sha256": "3f89e6652915fa721adbcd8cdb5d45d62aa319df8928f03f8684d01c303a3064"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -19079,6 +19084,11 @@
       "mode": "0000644",
       "sha256": "c7219ac3c13252fe64fb35a7d1dfa297af70ba25d8834a91fa7775feb468cdd3"
     },
+    {
+      "path": "tests/hall_game_review_tab.mjs",
+      "mode": "0000644",
+      "sha256": "472c1b226c80b3da8881c4d4abdf0ab7abbeefd24930ddc478671e06dcae9784"
+    },
     {
       "path": "tests/hall_goals_band.mjs",
       "mode": "0000644",
@@ -19377,7 +19387,7 @@
     {
       "path": "tests/hall_visor.mjs",
       "mode": "0000644",
-      "sha256": "fc78f108f610fa15299b0a73f3ce1a69fa138e950353a1d7d99044e1b70b4e5d"
+      "sha256": "055de4ac3afe4e7883be6cb462e00879bafc4c7593186ae7d728dbd5ee13f6f6"
     },
     {
       "path": "tests/hall_work_history_id.mjs",
@@ -20822,7 +20832,7 @@
     {
       "path": "tests/page_notes_panel.mjs",
       "mode": "0000644",
-      "sha256": "98e1382b0bf02f19209ed68ebf43408eea81f0732692a4c28363bfbc9d80a741"
+      "sha256": "69d321a78de7347b1129499c0798e6c0f0c9621bf2c7870fb0fbd227c26e4ac9"
     },
     {
       "path": "tests/page_reader.mjs",

package/docs/adr/0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md

@@ -0,0 +1,37 @@
+# 0403 — In game mode the visor is the control and the scene is the view
+
+- **Status:** Accepted
+- **Date:** 2026-11-11
+- **Decided by:** the owner, while reviewing [task 1005203](https://cloudbongos.com/builders#/task/1005203) (the visor's progress segments).
+- **Goal:** [goal 1000142](https://cloudbongos.com/builders#/goal/1000142) — the V3 game conversion.
+- **Builds on:** [ADR 0399](0399-the-visor-is-glass-over-the-scene-and-owns-no-camera.md) (the visor is glass over the scene), [ADR 0402](0402-helm-is-the-halls-look-and-the-hall-is-dark-only.md) (the Helm look).
+
+## 1. The decision
+
+In game mode the screen has two jobs, and each has one place:
+
+- **The visor is the control.** Every main call to action you can see (a button that starts something: claim, decide, file, review, open a place) lives on the visor's glass: the one accent button, the key hints, or the Actions sheet.
+- **The scene is the view.** The city, the sky and Home show the project. They can be looked at and moved through (pan, zoom, pick a star or a building to see it), but they carry no call-to-action buttons of their own.
+
+A scene that has something to be done offers it to the visor: it registers the action with `OTBVisor.scene({ actions, keys })` (ADR 0399 §2.2), and the visor draws it. What you picked in the scene can change what the visor offers, but the button is still on the glass.
+
+This holds for every game place (`shell-game.js` `PLACES`) and every scene built later. Classic mode is unchanged.
+
+## 2. Why
+
+One place for every control means a player always knows where to look to act, and the world stays a picture of the project rather than a page of buttons. It is the reason the visor exists.
+
+## 3. What does not yet keep it (found 2026-11-11)
+
+Each is its own task; none is changed by this record.
+
+- **The Governor City:** the "decide N in a row" button and the city door sit in the scene. ([task 1005209](https://cloudbongos.com/builders#/task/1005209))
+- **The sky:** the thought composer and its file button, the list / explore / my ideas buttons and the jump field are the sky's own top row. ([task 1005210](https://cloudbongos.com/builders#/task/1005210))
+- **Home:** the gallery's tabs and links (Most popular, Latest, The full gallery, Your studio). ([task 1005211](https://cloudbongos.com/builders#/task/1005211))
+- **The Artist's feedback tab** (`page-notes.js` `.pn__tab`) stays parked on the right edge; a session is already hiding it in game mode.
+
+## 4. Consequences
+
+- A new game scene is reviewed against this first: a button in the scene is a defect, not a style choice.
+- The visor will need room for more than one main action per place (a scene's actions already go in the sheet's "This place" list); how a scene's lead action reaches the accent button is the visor's next design question.
+- Records: `modules/hall-ui/records/game-mode.md` and `records/visor.md` carry the rule for anyone editing a game page.

package/docs/adr/README.md

@@ -518,3 +518,4 @@ These 20 numbers are each shared by exactly two files. They are **accepted histo
 | 0401 | [**One options menu opens every settings screen in a frame** ([task 1005144](https://cloudbongos.com/builders#/task/1005144), goal 1000141). `/settings` is the options menu: a search box over a grouped list. Settings' own panels stay native; My agents, Project settings, Modules, Permissions and Market Watch's settings and rules open inside it in an `<iframe>` of the old address with `?embed=1`, which `shell-game.js` reads only inside a frame to drop the page's chrome, send an unused Escape to the menu and open links to other pages in the whole window. A plain visit to an old address 302s to `/settings?open=<entry>` (the old #anchor rides along); the framed request keeps its own page gate and routes. In game mode the last Escape opens the menu and closes it again. Rejected: merging seven pages' scripts into one, a second /options page, links out of the menu.](0401-one-options-menu-opens-every-settings-screen-in-a-frame.md) | hall / game frame |
 | 0400 | [**A chain reserves work; each sub-quest is still claimed on its own** ([task 1005158](https://cloudbongos.com/builders#/task/1005158), spike V3G.R18, goal 1000144). C5 of the game conversion: work is claimed as a chain, not picked from a flat table. Owner ruling (interview answer 3): a chain RESERVES, tasks are still claimed one at a time. **Decision:** three new tables (`chains` inside one goal, `chain_tasks` with a task in at most one open chain, `chain_party`), none of them a claim — no `claims` row, no session binding, no worktree — so `gateOneActiveClaimPerSession` (ADR 0097) and its unique index never see a chain. **Order is derived, never stored** (ADR 0153's rejection holds): the topological order of `task_dependencies` over the chain's members, ties by priority/estimate/id — `sequence.js`'s `topoOrder`, moved into one shared module. Every sub-quest claims through the unchanged `POST /claims` ladder. **The one addition** is a narrowing-only `CHAIN_RESERVED` check placed AFTER the last existing rung on both insert sites + the dry run + the feed: an outsider can't claim a reserved chain's sub-quest, while every existing refusal keeps its code, message and precedence. Party size (raid quorum vs routine) is refused at the chain's own join door, never in the claim ladder; character counts seats and is never read by a claim rung. A reservation lapses after days with no claim or ship, reported before it acts (ADR 0226). Rejected: a chain as N claims, loosening the session guard, chain = goal, a stored order, an early-ladder check (would mask rank/deps refusals), a feed-only reservation.](0400-a-chain-reserves-work-and-each-sub-quest-is-still-claimed-alone.md) | lifecycle / claims / game conversion |
 | 0402 | [**Helm is the hall's look, and the hall is dark only** ([task 1005192](https://cloudbongos.com/builders#/task/1005192)). The game (the hall, everything after sign-in) wears Helm; the landing, the hub and the status page keep the chrome world. The kit: two voices (Barlow Condensed in wide capitals names a thing, Barlow says everything else), four colours with one job each (Night the ground, Ice what you read, White names and numbers, the accent only what you can act on), three shapes (the cut corner for anything pressable, the segment for progress, the arc for the visor). The values live in the hall's token block; `src/hall-helm.js` recognises a hall page by the sheet it links, pins it dark and hands it the Helm faces unless its pack chose its own. The light/dark switch is gone; the light tier stays until its own removal. The shared button spends every Helm token with the old pill as the fallback, so the status page does not move.](0402-helm-is-the-halls-look-and-the-hall-is-dark-only.md) | design system / hall |
+| 0403 | [**In game mode the visor is the control and the scene is the view** ([task 1005203](https://cloudbongos.com/builders#/task/1005203), goal 1000142; owner 2026-11-11). Every main call to action you can see in game mode lives on the visor (the accent button, the key hints, the Actions sheet); the city, the sky and Home only show the project and can be moved through, never carry buttons of their own. A scene offers its actions to the visor through `OTBVisor.scene`. Found not yet keeping it: the city's decide button and door, the sky's top row and composer, Home's gallery links, the Artist's feedback tab.](0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md) | hall / game frame |

package/docs/copy-inventory.md

@@ -316,7 +316,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `4df46e2be815` | certain | Clear the key? | `modules/hall-ui/public/market-watch-settings.js:218` |
 | `593dda3178eb` | certain | Click to copy | `modules/hall-ui/public/copy-on-click.js:137` |
 | `34624d39ff29` | certain | Clone the project to your machine and run | `modules/hall-ui/public/setup-gate.js:34` |
-| `3a426bad2c49` | certain | Close actions | `modules/hall-ui/public/visor.js:178` |
+| `3a426bad2c49` | certain | Close actions | `modules/hall-ui/public/visor.js:222` |
 | `70f6a704d504` | certain | Close it | `modules/hall-ui/public/copy-desk.html:140` |
 | `053e576ba9a3` | certain | Close options | `modules/hall-ui/public/shell-game.js:453` |
 | `d12a2fb5730d` | certain | Close this flag | `modules/hall-ui/public/copy-desk.html:116` |
@@ -1486,7 +1486,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `9a685b01e2c6` | certain | This page opens at a higher rank. | `modules/hall-ui/public/watch.html:237` |
 | `e7a289134dc3` | certain | This page shows no words the reader could find. | `modules/hall-ui/public/tweak-editor.js:246` |
 | `d4b3b5556986` | certain | This page's reference docs | `modules/hall-ui/public/page-notes.js:166` |
-| `79e4a934b434` | certain | This place | `modules/hall-ui/public/visor.js:180` |
+| `79e4a934b434` | certain | This place | `modules/hall-ui/public/visor.js:224` |
 | `5bdcbec770dd` | certain | This project has no slash commands yet. | `modules/hall-ui/public/commands.js:37` |
 | `f53b83bfbe54` | certain | This project has no watch rules yet. | `modules/hall-ui/public/market-watch-rules.js:62` |
 | `e97b2d549f10` | certain | This project is hosted on {…}, and that is where it is taken offline or removed. Both links below open this pr | `modules/hall-ui/public/project-settings.js:412` |

package/docs/copy-registry.json

@@ -5208,7 +5208,7 @@
       "surface": "builders-hall",
       "text": "Close actions",
       "file": "modules/hall-ui/public/visor.js",
-      "line": 178,
+      "line": 222,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -15738,7 +15738,7 @@
       "surface": "builders-hall",
       "text": "This place",
       "file": "modules/hall-ui/public/visor.js",
-      "line": 180,
+      "line": 224,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/module-api-changelog.md

@@ -3426,5 +3426,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.24.86 with no explicit bump. run 43147929315. (task 1002620)
   1.24.88 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.24.87 with no explicit bump. run 43210223245. (task 1002620)
+  1.24.89 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.24.88 with no explicit bump. run 43213545598. (task 1002620)
+  1.24.90 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.24.89 with no explicit bump. run 43217068783. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/page-readings.json

@@ -12,7 +12,7 @@
       "surface": "builders",
       "title": "Studio",
       "states_read": ["pick","describe","make","waiting","result","result-own","failed","balance","balance-all","out"],
-      "files_hash": "c6fe46384d8bff8c",
+      "files_hash": "23f9e59301672d58",
       "reading_hash": "d9e0e85bcee4aff4",
       "counts": {"lines":106,"placed":41,"shared":7,"unplaced":58},
       "omitted": {"data":17},
@@ -131,7 +131,7 @@
       "surface": "builders",
       "title": "Repo Atlas",
       "states_read": ["map","truth","detail","index","out"],
-      "files_hash": "4b34e7e147b15e04",
+      "files_hash": "79e0951cb18465bb",
       "reading_hash": "6934dead335b2507",
       "counts": {"lines":25,"placed":14,"shared":7,"unplaced":4},
       "omitted": {"data":5},
@@ -169,7 +169,7 @@
       "surface": "builders",
       "title": "Blockers",
       "states_read": ["default"],
-      "files_hash": "4550334cb3ae91c4",
+      "files_hash": "19846a8c445f37ea",
       "reading_hash": "60d73d854ced958a",
       "counts": {"lines":36,"placed":17,"shared":7,"unplaced":12},
       "omitted": {"data":51},
@@ -218,7 +218,7 @@
       "surface": "builders",
       "title": "Board Room",
       "states_read": ["room","out","sitting-meta","objection-form"],
-      "files_hash": "ec52d3968ea2f2fc",
+      "files_hash": "291a782052c75cdf",
       "reading_hash": "0260b797b8dc1526",
       "counts": {"lines":52,"placed":21,"shared":7,"unplaced":24},
       "omitted": {"data":17},
@@ -283,7 +283,7 @@
       "surface": "builders",
       "title": "The city",
       "states_read": ["city","fullscreen","focus","pins","living","card","card-ask"],
-      "files_hash": "d0715a562faaa050",
+      "files_hash": "909fdbd80b138fd3",
       "reading_hash": "277096d903879a57",
       "counts": {"lines":26,"placed":9,"shared":6,"unplaced":11},
       "omitted": {"data":7},
@@ -322,7 +322,7 @@
       "surface": "builders",
       "title": "Collab",
       "states_read": ["board","out"],
-      "files_hash": "216de45c5d2118a5",
+      "files_hash": "e2742d78f9cccca8",
       "reading_hash": "e6452bf92231656f",
       "counts": {"lines":82,"placed":36,"shared":6,"unplaced":40},
       "omitted": {"data":23},
@@ -417,7 +417,7 @@
       "surface": "builders",
       "title": "Commands",
       "states_read": ["in","out"],
-      "files_hash": "7e077f709d50d716",
+      "files_hash": "40d23c5b0a81a29a",
       "reading_hash": "ecc452689a8ee9d7",
       "counts": {"lines":71,"placed":49,"shared":7,"unplaced":15},
       "omitted": {"data":177},
@@ -501,7 +501,7 @@
       "surface": "builders",
       "title": "Copy desk",
       "states_read": ["queue","out","search","composer","closer","proposer"],
-      "files_hash": "b0a766d3737c46fb",
+      "files_hash": "f3cf83236fe02237",
       "reading_hash": "3819ef6fa8f6fb7c",
       "counts": {"lines":72,"placed":36,"shared":7,"unplaced":29},
       "omitted": {"data":94},
@@ -586,7 +586,7 @@
       "surface": "builders",
       "title": "Deploy",
       "states_read": ["work","out"],
-      "files_hash": "543e811b353093c2",
+      "files_hash": "fd49d5d95913e541",
       "reading_hash": "3770e8b2fa56bee1",
       "counts": {"lines":14,"placed":5,"shared":7,"unplaced":2},
       "omitted": {"data":5},
@@ -613,7 +613,7 @@
       "surface": "builders",
       "title": "The sky",
       "states_read": ["tour","sky","wells","ledger","full","full-back","out"],
-      "files_hash": "597d96868864c1ce",
+      "files_hash": "48204568b1300984",
       "reading_hash": "4a879397a84631e3",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -676,7 +676,7 @@
       "surface": "builders",
       "title": "Goals",
       "states_read": ["list","filters","cards","detail","dependencies","out","uat","uat-panel","author"],
-      "files_hash": "aa6b14fc4d9c3833",
+      "files_hash": "5bf411f2510edcc9",
       "reading_hash": "13a5d07b3804b627",
       "counts": {"lines":187,"placed":61,"shared":7,"unplaced":119},
       "omitted": {"data":315},
@@ -876,7 +876,7 @@
       "surface": "builders",
       "title": "Government",
       "states_read": ["constitution","out","permissions","board","constitution-tab"],
-      "files_hash": "1da7a621974799ea",
+      "files_hash": "7de9a6b413426928",
       "reading_hash": "37c6878d60447fd6",
       "counts": {"lines":65,"placed":27,"shared":7,"unplaced":31},
       "omitted": {"data":276},
@@ -954,8 +954,8 @@
       "surface": "builders",
       "title": "Builders' Hall",
       "states_read": ["home","out","founding","genesis","decide","demo"],
-      "files_hash": "a872d5c364c55966",
-      "reading_hash": "21e68b6037037652",
+      "files_hash": "72688333d07fc19e",
+      "reading_hash": "583ba51e45463d65",
       "counts": {"lines":32,"placed":12,"shared":8,"unplaced":12},
       "omitted": {"data":5},
       "notes": ["founding: an action failed (page.focus: Timeout 6000ms exceeded.); read as it stood"],
@@ -977,7 +977,7 @@
         {"key":"L0015","section":"Needs your attention13","text":"Ideas awaiting triage","placement":"placed","file":"modules/hall-ui/public/builders.js","line":320,"string_id":"e181637c5a5e"},
         {"key":"L0016","section":"Needs your attention13","text":"Requires project {…} fix","placement":"unplaced"},
         {"key":"L0017","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":514,"string_id":"1883ad7f07fc"},
-        {"key":"L0018","section":"Needs your attention13","text":"core 1.24.86","placement":"unplaced"},
+        {"key":"L0018","section":"Needs your attention13","text":"core 1.24.88","placement":"unplaced"},
         {"key":"L0019","section":"Needs your attention13","text":"Skip","placement":"unplaced"},
         {"key":"L0020","section":"Needs your attention13","text":"Built on","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":183,"string_id":"fef59346ffee"},
         {"key":"L0021","section":"Needs your attention13","text":"cloudbongos.com","placement":"unplaced"},
@@ -999,7 +999,7 @@
       "surface": "builders",
       "title": "Idea",
       "states_read": ["record","missing"],
-      "files_hash": "45ceed00f030bc7b",
+      "files_hash": "387333f4d59fe55e",
       "reading_hash": "f7d644748c87e426",
       "counts": {"lines":52,"placed":25,"shared":8,"unplaced":19},
       "omitted": {"data":25},
@@ -1064,7 +1064,7 @@
       "surface": "builders",
       "title": "Ideas",
       "states_read": ["compose","full","develop"],
-      "files_hash": "3d118453abc50e92",
+      "files_hash": "e0cd78a4a3e96ead",
       "reading_hash": "a62c05dcef3bf87f",
       "counts": {"lines":68,"placed":34,"shared":7,"unplaced":27},
       "omitted": {"data":118},
@@ -1145,7 +1145,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["desk","settings","out"],
-      "files_hash": "fc40724d7d6eeba8",
+      "files_hash": "5edfd91add4496ef",
       "reading_hash": "30512dda207b5ea6",
       "counts": {"lines":23,"placed":11,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1181,7 +1181,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["dossier","out","propose","correct","filtered"],
-      "files_hash": "707e88b9c33df6de",
+      "files_hash": "e7612a858ce69c69",
       "reading_hash": "129bff28c4e4ed6d",
       "counts": {"lines":24,"placed":12,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1218,7 +1218,7 @@
       "surface": "builders",
       "title": "Market Watch rules",
       "states_read": ["in","scoring","names","propose","out"],
-      "files_hash": "9287a77f105c6266",
+      "files_hash": "30ee116ca9f2faa1",
       "reading_hash": "ca0c62e8dce51c8b",
       "counts": {"lines":36,"placed":12,"shared":7,"unplaced":17},
       "omitted": {"data":20},
@@ -1267,7 +1267,7 @@
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "fa19c00a28d82386",
+      "files_hash": "4c650bba10ed03f6",
       "reading_hash": "6a12e9306bba5622",
       "counts": {"lines":59,"placed":29,"shared":7,"unplaced":23},
       "omitted": {"data":107},
@@ -1339,7 +1339,7 @@
       "surface": "builders",
       "title": "Money",
       "states_read": ["money","hosting","out"],
-      "files_hash": "24eceeda13f9613c",
+      "files_hash": "07e5b1082ee23839",
       "reading_hash": "e355d5466b123e07",
       "counts": {"lines":83,"placed":28,"shared":7,"unplaced":48},
       "omitted": {"data":27},
@@ -1435,7 +1435,7 @@
       "surface": "builders",
       "title": "My agents",
       "states_read": ["desk","factory","saved","what-it-knows","speciality-walk","speciality-forms","nobody"],
-      "files_hash": "6eb2fa533e472d78",
+      "files_hash": "1f5fa9dcd66e0b32",
       "reading_hash": "5347e0496b38727d",
       "counts": {"lines":100,"placed":33,"shared":7,"unplaced":60},
       "omitted": {"data":38},
@@ -1548,7 +1548,7 @@
       "surface": "builders",
       "title": "Primer",
       "states_read": ["in","toc-open","jump","out"],
-      "files_hash": "49bc305cc0a68912",
+      "files_hash": "778c4ef963b2de8f",
       "reading_hash": "85790bd421e5c387",
       "counts": {"lines":487,"placed":57,"shared":7,"unplaced":423},
       "omitted": {"data":18},
@@ -2048,7 +2048,7 @@
       "surface": "builders",
       "title": "Profile",
       "states_read": ["own","works","activity","yours","activity-artist","activity-artist-ideas","other","artist","artist-ideas","out"],
-      "files_hash": "f601980d294202ae",
+      "files_hash": "3eddfd923b8a83b4",
       "reading_hash": "3ff8d703d17e8c2a",
       "counts": {"lines":232,"placed":84,"shared":7,"unplaced":141},
       "omitted": {"data":263},
@@ -2293,7 +2293,7 @@
       "surface": "builders",
       "title": "Project settings",
       "states_read": ["default"],
-      "files_hash": "f97afd8db25ab57f",
+      "files_hash": "7daa1c29c3b880ee",
       "reading_hash": "283df27d0d5bfc1b",
       "counts": {"lines":43,"placed":25,"shared":7,"unplaced":11},
       "omitted": {"data":33},
@@ -2349,7 +2349,7 @@
       "surface": "builders",
       "title": "Builders",
       "states_read": ["roster","artists","search","out"],
-      "files_hash": "78bee0a7d5694b4a",
+      "files_hash": "17eca3360848c786",
       "reading_hash": "665ac2e36339f5d3",
       "counts": {"lines":56,"placed":17,"shared":7,"unplaced":32},
       "omitted": {"data":137},
@@ -2418,7 +2418,7 @@
       "surface": "builders",
       "title": "Options",
       "states_read": ["account","access","preferences","install-reports","sound","update"],
-      "files_hash": "5b875d5fa3a5aadb",
+      "files_hash": "edfa4c2b264538a8",
       "reading_hash": "898a13fda24c3c90",
       "counts": {"lines":162,"placed":104,"shared":7,"unplaced":51},
       "omitted": {"data":23},
@@ -2593,7 +2593,7 @@
       "surface": "builders",
       "title": "The street",
       "states_read": ["street","fullscreen","card","focus","here","inside-rules","inside-disputes","inside-people","inside-planning","inside-automation","inside-review","inside-release","inside-treasury","floor","amend","district","desk","desk-facts","desk-quiet","desk-people-builders","desk-people-tier","desk-disputes","desk-automation-goals","desk-release-core","desk-rules","desk-rules-category","desk-planning-priorities","desk-planning-ideas","desk-planning-blockers","pins","pins-pager","living","deck","deck-treasury","sitting","object","voted","admission","settled","blocker","blocker-more","report","report-more","core","core-more","recheck","recheck-more","idea","idea-more","queue","queue-more","automation","automation-more"],
-      "files_hash": "ee5fc115e8cea60a",
+      "files_hash": "f9f49021adf5c83f",
       "reading_hash": "e788e6bf4be8d68c",
       "counts": {"lines":325,"placed":54,"shared":6,"unplaced":265},
       "omitted": {"data":240},
@@ -2931,7 +2931,7 @@
       "surface": "builders",
       "title": "Studio",
       "states_read": ["home","out","flow","flow-pick","status","words-offer","words-edit","reviews","full","full-back","approvals","approvals-before","approvals-phone","approvals-note","approved","sent-back","approvals-page"],
-      "files_hash": "5f9a6a164cbdb945",
+      "files_hash": "1c9edb7ed9addf39",
       "reading_hash": "c4e3b4188c1db755",
       "counts": {"lines":51,"placed":29,"shared":7,"unplaced":15},
       "omitted": {"data":23},
@@ -2995,7 +2995,7 @@
       "surface": "builders",
       "title": "Task",
       "states_read": ["record","from-goal","missing"],
-      "files_hash": "5347d1b5fd53ce39",
+      "files_hash": "34cc9d19049cbc81",
       "reading_hash": "8dd803b6934e6388",
       "counts": {"lines":151,"placed":46,"shared":9,"unplaced":96},
       "omitted": {"data":111},
@@ -3159,7 +3159,7 @@
       "surface": "builders",
       "title": "Your thinking",
       "states_read": ["tour","sky","list","simple","full-idea","full","full-list","full-back","out"],
-      "files_hash": "85dc67fbd8d04fec",
+      "files_hash": "b8b404b0285a8e4d",
       "reading_hash": "b73f848b46b0f9b8",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -3222,7 +3222,7 @@
       "surface": "builders",
       "title": "Tweak a page",
       "states_read": ["doc","typed","chrome","submitted","picking","out"],
-      "files_hash": "9fc57b5fc123dfb4",
+      "files_hash": "cb5f7a46c069e9d2",
       "reading_hash": "f521f8d9a7147557",
       "counts": {"lines":26,"placed":18,"shared":2,"unplaced":6},
       "omitted": {"data":19},
@@ -3261,7 +3261,7 @@
       "surface": "builders",
       "title": "Watch",
       "states_read": ["board","out","operations","security","sessions","autobongos"],
-      "files_hash": "ce010b0e2809d5f1",
+      "files_hash": "f671ac6ffb1abbbb",
       "reading_hash": "1961a0c06b9d8477",
       "counts": {"lines":72,"placed":33,"shared":7,"unplaced":32},
       "omitted": {"data":52},
@@ -3346,7 +3346,7 @@
       "surface": "builders",
       "title": "Tasks",
       "states_read": ["ready","in-progress","backlog","completed","filters-open","out","founding"],
-      "files_hash": "12f66ee39aee12b2",
+      "files_hash": "88429188a01e8339",
       "reading_hash": "e9b412d1ec59ceee",
       "counts": {"lines":122,"placed":49,"shared":7,"unplaced":66},
       "omitted": {"data":323},

package/modules/hall-ui/public/craft-mode.js

@@ -1063,6 +1063,8 @@
     spriteSrc: spriteSrc,
     // task 1005148: the visor's two reads — the /me the gate saw, and a tool by id.
     me: function () { return lastMe; },
-    openTool: function (id) { var t = toolFor(id); if (t) loadTool(t).then(function (api) { api.open(); }, function () { /* tool did not load */ }); },
+    // A tool opens only for the character whose tool it is (task 1005207): the
+    // review sheet is the Artist's, so no other character can open it this way.
+    openTool: function (id) { var t = toolFor(id); if (t && toolsFor(wearing()).indexOf(t) !== -1) loadTool(t).then(function (api) { api.open(); }, function () { /* tool did not load */ }); },
   };
 })();

package/modules/hall-ui/public/page-notes.css

@@ -58,6 +58,10 @@ html.pn-open { overflow: hidden; }
   box-shadow: 0 0 0 1px var(--craft, var(--rule)), var(--pn-shadow-pop);
   cursor: pointer;
 }
+/* Game mode (task 1005207): the glass shows only the visor, so the parked tab
+   is not drawn. The visor's "Review this page" (R) opens the sheet, and closing
+   it leaves nothing at the edge. Classic mode keeps the tab. */
+html[data-game="on"] .pn__tab { display: none; }
 .pn__tab:hover { background: var(--pn-glass); }
 .pn__tab:focus-visible { outline: 2px solid var(--focus); outline-offset: 1px; }
 .pn__tab-icon { width: 18px; height: 18px; }

package/modules/hall-ui/public/page-notes.js

@@ -361,7 +361,13 @@
     if (tab) {
       tab.setAttribute('aria-expanded', on ? 'false' : 'true');
       tab.setAttribute('aria-label', on ? 'Show the review panel' : 'Hide the review panel');
-      if (on && !quiet) tab.focus();
+      // In game mode the tab is not drawn (page-notes.css, task 1005207), so focus
+      // leaves the tucked panel for the page instead of a tab nobody can see.
+      if (on && !quiet) {
+        if (tab.getClientRects && tab.getClientRects().length === 0) {
+          if (sheet.contains(document.activeElement) && document.activeElement.blur) document.activeElement.blur();
+        } else tab.focus();
+      }
     }
     if (on) save();
     else if (state.pending) { state.pending = false; openDraft(); }

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

@@ -878,7 +878,7 @@ html[data-theme="dark"] .brand-mark__mark { --mark-ink: #e2e1e4; }
      with the count over its word, the one accent button (its name may take two lines; its key is in the sheet), and of
      the key hints only Actions, as its dots (every other hint is a row in its sheet). */
   html[data-game="on"] #visor { --visor-inset-bottom: 52px; }
-  html[data-game="on"] .visor__place, html[data-game="on"] .visor__notch, html[data-game="on"] .visor__frame--top, html[data-game="on"] .visor__name { display: none; }
+  html[data-game="on"] .visor__place, html[data-game="on"] .visor__progress, html[data-game="on"] .visor__notch, html[data-game="on"] .visor__frame--top, html[data-game="on"] .visor__name { display: none; }
   html[data-game="on"] .visor__foot { grid-template-columns: auto minmax(0, 1fr) auto; column-gap: var(--ds-space-hair); }
   html[data-game="on"] .visor__me, html[data-game="on"] .visor__hints { transform: none; }
   html[data-game="on"] .visor__me { gap: var(--ds-space-hair); }

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

@@ -308,9 +308,10 @@ html[data-fullscreen="on"] .sky-stage .top { padding-right: 184px; }
 /* task 1005148: with the visor up (html.visor-on, game mode; visor.js), the sky's own layers keep
    clear of the glass, as ADR 0399 §2.3 asks of a scene's pop-ups: the top row, the composer, the
    jump field and the two side panels step below the compass and the place line, and the foot and
-   the tour rise above the visor's corner pills. Outside game mode nothing here applies. */
-html.visor-on .top { padding-top: calc(60px + env(safe-area-inset-top, 0px)); }
-html.visor-on .composer, html.visor-on .jump { top: calc(116px + env(safe-area-inset-top, 0px)); }
-html.visor-on .panel, html.visor-on .room { top: calc(180px + env(safe-area-inset-top, 0px)); bottom: calc(200px + env(safe-area-inset-bottom, 0px)); }
+   the tour rise above the visor's corner pills. Task 1005203 put the version's progress under
+   the place, so the top offsets grew by its 24px. Outside game mode nothing here applies. */
+html.visor-on .top { padding-top: calc(84px + env(safe-area-inset-top, 0px)); }
+html.visor-on .composer, html.visor-on .jump { top: calc(140px + env(safe-area-inset-top, 0px)); }
+html.visor-on .panel, html.visor-on .room { top: calc(204px + env(safe-area-inset-top, 0px)); bottom: calc(200px + env(safe-area-inset-bottom, 0px)); }
 html.visor-on .foot { padding-bottom: calc(132px + env(safe-area-inset-bottom, 0px)); }
 html.visor-on .tour, html.visor-on .start { bottom: calc(210px + env(safe-area-inset-bottom, 0px)); }

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

@@ -13,7 +13,7 @@
 html[data-game="on"] .visor:not([hidden]) {
   display: block; position: fixed; inset: 0; z-index: 4; pointer-events: none;
   /* where the glass sits, so a scene's pop-up can keep clear of it (ADR 0399 §2.3) */
-  --visor-inset-top: 64px; --visor-inset-bottom: 76px;
+  --visor-arc: 64px; --visor-inset-top: 88px; --visor-inset-bottom: 76px;
   --visor-inset-right: max(var(--ds-space-gutter-narrow), var(--helm-inset)); --visor-inset-left: var(--visor-inset-right);
   color: var(--ink); font-family: var(--font-body);
 }
@@ -22,14 +22,14 @@ html[data-game="on"] .visor:not([hidden]) {
    top arc, its notch and the place all sit inside the top inset, above where a scene starts its
    own top row; the foot arc runs under the foot row. */
 .visor__frame { position: absolute; left: 0; width: 100%; overflow: visible; }
-.visor__frame--top { top: calc(var(--visor-inset-top) - 50px); height: 42px; }
+.visor__frame--top { top: calc(var(--visor-arc) - 50px); height: 42px; }
 .visor__frame--foot { bottom: calc(var(--visor-inset-bottom) - 44px); height: 18px; }
 .visor__frame path { vector-effect: non-scaling-stroke; }
 .visor__line { fill: none; stroke: var(--ink-soft); stroke-opacity: .6; stroke-width: var(--line-strong); }
 .visor__line--under { stroke: var(--bg); stroke-opacity: 1; stroke-width: 5px; }
 .visor__dot { fill: var(--ink-soft); stroke: var(--bg); stroke-width: var(--line-strong); }
 .visor__notch, .visor__sight { position: absolute; left: 50%; transform: translate(-50%, -50%); overflow: visible; }
-.visor__notch { top: calc(var(--visor-inset-top) - 36px); width: 12px; height: 9px; }
+.visor__notch { top: calc(var(--visor-arc) - 36px); width: 12px; height: 9px; }
 .visor__sight { top: 50%; width: 24px; height: 24px; }
 
 /* type over the scene stands on a small plate of the night, cut like everything pressable and
@@ -42,11 +42,29 @@ html[data-game="on"] .visor:not([hidden]) {
 
 /* the place, under the top arc */
 .visor__place {
-  position: absolute; left: 50%; top: calc(var(--visor-inset-top) - 26px); transform: translateX(-50%); margin: 0;
+  position: absolute; left: 50%; top: calc(var(--visor-arc) - 26px); transform: translateX(-50%); margin: 0;
   font-size: var(--ds-text-2xl); letter-spacing: var(--name-space-wide); line-height: 1.2;
   color: var(--ink-soft); white-space: nowrap; padding: 0 var(--ds-space-xs);
 }
 
+/* the version's progress under the place (task 1005203): the kit's four segments, then the same
+   reading in words (a row of bars is never the only reading). Done quarters are ice, the quarter
+   being built is the accent, the rest are outlines; each segment wears an outline of the night so it
+   reads over a midday sky. It sits under the arc band, inside the top inset (--visor-inset-top). */
+.visor__progress {
+  position: absolute; left: 50%; top: calc(var(--visor-arc) + 6px); transform: translateX(-50%);
+  display: flex; align-items: center; gap: var(--ds-space-xs); white-space: nowrap;
+}
+.visor__segs { flex-wrap: nowrap; }
+.visor__segs .seg { border-color: var(--ink-soft); outline: var(--line-strong) solid var(--night-plate); }
+.visor__segs .seg--done { background: var(--ink-soft); border-color: transparent; }
+.visor__segs .seg--now { background: var(--accent); border-color: transparent; }
+.visor__progress-words {
+  margin: 0; font-family: var(--name-face); font-weight: var(--name-weight); text-transform: var(--name-case);
+  font-size: var(--ds-text-xs); letter-spacing: var(--name-space); line-height: 1; color: var(--ink-soft);
+  padding: var(--ds-space-hair) var(--ds-space-xs); background: var(--night-plate); clip-path: var(--cut-path-sm);
+}
+
 /* the foot row: you on the left, the one thing to press in the middle, the key hints on the
    right. The two side groups lean in a little, as the glass curves. */
 .visor__foot {

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

@@ -90,6 +90,39 @@
     var s = String(Math.abs(v)).replace(/\B(?=(\d{3})+(?!\d))/g, ',');
     return (v < 0 ? '−' : '') + s + (Math.abs(v) === 1 ? ' credit' : ' credits');
   }
+  // ---------- the version's progress (task 1005203) ----------
+  // Four segments under the place: the version the project is building, in quarters. The
+  // owner chose it (2026-11-11): the same number /status reports, never an invented one. The
+  // version is the starred focus while it is still open, else the first one building; with
+  // neither (or the read failing) there are no segments, never empty ones.
+  var progress = null; // { id, name, pct } once read
+  function pickVersion(rows, focusId) {
+    if (!Array.isArray(rows)) return null;
+    var open = function (r) { return r && r.status !== 'shipped' && r.status !== 'frozen'; };
+    var hit = null;
+    for (var i = 0; i < rows.length && !hit; i++) if (focusId && rows[i] && rows[i].version_id === focusId && open(rows[i])) hit = rows[i];
+    for (var j = 0; j < rows.length && !hit; j++) if (rows[j] && rows[j].status === 'building') hit = rows[j];
+    if (!hit) return null;
+    var pct = Number(hit.percent_complete);
+    if (!isFinite(pct)) return null;
+    return { id: String(hit.version_id || ''), name: String(hit.name || ''), pct: Math.max(0, Math.min(100, Math.round(pct))) };
+  }
+  // Each segment is a quarter: a quarter wholly built is done; the quarter being built now is
+  // the accent (it is where a claim lands); the rest are outlines. Pure, for the tests.
+  function segStates(pct) {
+    var out = [], full = Math.floor(Math.max(0, Math.min(100, pct)) / 25);
+    for (var i = 0; i < 4; i++) out.push(i < full ? 'done' : (i === full ? 'now' : 'todo'));
+    return out;
+  }
+  function readProgress() {
+    if (typeof fetch !== 'function') return;
+    var get = function (u) { return fetch(u, { credentials: 'same-origin' }).then(function (r) { return r.ok ? r.json() : null; }, function () { return null; }); };
+    Promise.all([get('/api/bongos/versions/progress'), get('/api/bongos/versions/focus')]).then(function (res) {
+      progress = pickVersion(res[0] && res[0].progress, res[1] && res[1].focus_version_id);
+      if (progress) render();
+    });
+  }
+
   // A link on the hall's own host: '/work' on the builders host, '/builders/work' on the apex.
   function hallHref(p) {
     var here = String((window.location && window.location.pathname) || '');
@@ -150,6 +183,7 @@
     var n = credits();
     return frameSvg() +
       (scene.place ? '<p class="visor__place">' + esc(scene.place) + '</p>' : '') +
+      progressHtml() +
       '<div class="visor__foot">' +
         '<div class="visor__me">' +
           (sprite ? '<img class="visor__sprite" src="' + esc(sprite) + '" alt="" width="250" height="290" decoding="async">' : '') +
@@ -165,6 +199,16 @@
         '</div>' +
       '</div>';
   }
+  // The kit's segments (controls.css .seg), always beside the words that say the same thing.
+  function progressHtml() {
+    if (!progress) return '';
+    var segs = segStates(progress.pct).map(function (s) { return '<li class="seg' + (s === 'todo' ? '' : ' seg--' + s) + '"></li>'; }).join('');
+    var said = progress.id + (progress.name ? ', ' + progress.name : '') + ': ' + progress.pct + '% built';
+    return '<div class="visor__progress" data-visor-progress title="' + esc(said) + '">' +
+      '<ol class="segs visor__segs" aria-hidden="true">' + segs + '</ol>' +
+      '<p class="visor__progress-words"><span class="sr-only">' + esc(said) + '</span>' +
+      '<span aria-hidden="true">' + esc(progress.id) + ' · ' + progress.pct + '%</span></p></div>';
+  }
   function sheetHtml(id) {
     var rows = actionsFor(id).map(function (a) {
       return '<li><a class="visor__row" data-visor-act="' + esc(a.id) + '" ' + actionAttrs(a) + '><span>' + esc(a.label) + '</span>' + keyHtml(a.key) + '</a></li>';
@@ -319,6 +363,7 @@
     document.addEventListener('otbcraft:me', render);
     document.addEventListener('otb:craft', render);
     render();
+    readProgress();
   }
   if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', start);
   else start();
@@ -335,5 +380,7 @@
     keyFor: keyFor,
     creditsText: creditsText,
     character: character,
+    pickVersion: pickVersion,
+    segStates: segStates,
   };
 })();

package/modules/hall-ui/records/game-mode.md

@@ -4,6 +4,7 @@ Covers: every shelled hall page (`shell-game.js`, `shell.js`). Spec: `docs/specs
 
 ## What it settled
 
+- **The visor is the control, the scene is the view ([ADR 0403](../../../docs/adr/0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md), owner 2026-11-11).** Every main call to action in game mode is on the visor; a game place's scene shows the project and can be moved through, but carries no buttons of its own. A scene hands its actions to the visor (`OTBVisor.scene`). A button in a scene is a defect.
 - **Game mode is the existing full-screen switch, made hall-wide. There is no second full-screen mode.** The switch was already on every page (task 1004430) but remembered per page, so a reader had to turn it on 33 times. Game mode is one `localStorage` key, `hall-game`; while it is `on`, `shell.js` `storedFullscreen()` answers yes for every page, whatever that page remembers. What hides, the corner button and the Escape hand-off are the shell's, unchanged.
 - **`shell-game.js` holds the mode and nothing else**: `window.OTBShellGame` = `on()`, `set(bool)`, `hint()`. It stamps `html[data-game="on"]` for a sheet or script that wants to read the mode. `shell.js` reads it through a fallback object, so a page without the file is never in game mode. It is its own file because `shell.js` sits on the 1,500-line ratchet; the start screen and options menu (R03, R04) are expected to grow here, not in `shell.js`.
 - **Load order**: `shell-game.js` before `shell-trail.js` / `craft-mode.js` / `shell.js`, loaded the same way (deferred or not) as the shell on that page. Test-pinned.

package/modules/hall-ui/records/visor.md

@@ -2,16 +2,21 @@
 
 Covers: `visor.js` + `visor.css`, loaded on Home, `/city`, `/goal-map` and `/thinking`, and the three scene registrations (`sky-interaction.js`, `city.js`, `home-city.js`). Spec: `docs/specs/bongos-v3-game-conversion.md` C2 `you-are-a-character-in-first-person`. Game mode itself is in `game-mode.md`.
 
+## The rule every game page keeps (ADR 0403, owner 2026-11-11)
+
+The visor is the control and the scene is the view: every main call to action in game mode is on the glass (the accent button, the key hints, the Actions sheet), and a scene carries none of its own. A scene that has something to do registers it with `OTBVisor.scene({ actions, keys })`. ADR 0403 §3 lists the scenes that do not keep it yet.
+
 ## The minimal visor (Helm look 3, task 1005195)
 
 The glass was redrawn to the owner's mock-up "Cloud city: in the visor, minimal". Look and layout only: every action, key, id, aria attribute, copy string and data source in `visor.js` is as task 1005148 left it. Where this section and the older bullets below disagree about the look or where a part sits, this section is current.
 
 - **What is on the glass.** Two thin arcs (one along the top, one under the foot row), a notch under the top arc, a ring-and-dot sight at the centre, the place in the name voice under the top arc, and one foot row: the sprite in a cut box with the character's name and the credits (white count, ice word); the one accent button, cut corner, with its key; the quiet key hints (a key in a small box and a name, no box round the pair). The compass cells, the side lines, the centre cross and the round pills are gone.
 - **Where each control went.** The main action is the accent button, centred. The character's other actions (after the game-places filter) are key hints on the right; they were rows in the sheet only. **Actions (A)** is demoted from a top-right pill to a key hint and still opens the same sheet, which now stands over the hints. **Options (Esc)** is the last hint, the same link the sheet's last row is. Nothing was removed.
-- **In the mock-up, not built, because the visor has no data for it:** the four progress segments, the marker and name on the building in view (the visor owns no camera, ADR 0399 §2.2), and the party bars with a speaker's name and a Voice key. Each is a scene or a later task handing the visor real data; none is drawn empty.
+- **The four progress segments (task 1005203).** Under the place: the version the project is building, in quarters, then the same reading in words (`BONGOS-V2 · 89%`; the screen reader hears the version's name too). The owner chose the measure (2026-11-11): the version's `percent_complete` from the public `GET /versions/progress`, the number /status reports. The version is the starred focus (`GET /versions/focus`) while it is still open, else the first one `building`; with neither, or a failed read, no segments. A quarter wholly built is the soft ink, the quarter being built is the accent, the rest are outlines; each wears an outline of the night, and the words stand on a night plate (`--night-plate`, the rule task 1005196 set), for a midday sky. The arc band is `--visor-arc` (64px) and the scene inset grew to 88px (`--visor-inset-top`), so the sky's top offsets in `thinking.css` grew by 24px. Hidden on a phone, with the place. Harness fixture: `versions__progress.json`.
+- **In the mock-up, not built, because the visor has no data for it:** the marker and name on the building in view (the visor owns no camera, ADR 0399 §2.2), and the party bars with a speaker's name and a Voice key. Each is a scene or a later task handing the visor real data; none is drawn empty.
 - **It reads over any sky, with no per-hour style, and it darkens none of it** (task 1005196, owner 2026-11-11: "I don't like how dark the edges of the view are"). The glass paints nothing of its own: the bands of `--night-glass` at its top and bottom edge are gone, and so is the dark halo round its type. The marks carry themselves. The place, each key hint and your name and credits stand on a small cut plate of the night (`--night-plate`, the ground at 88%), sized to the words; every line is drawn twice (a wider solid stroke of the night under the ice hairline, `.visor__line--under`), so an arc is ice on night and a dark line on cream cloud; a key sits on a chip of the night. One new token, `--night-plate`. Tried first and dropped: a 4px night stroke round each letter with no plate, which filled the condensed capitals in.
 - **A phone.** The shared phone block in `style.css` (no breakpoint of the visor's own): the top arc, its notch and the place step aside (the top of a phone is the scene's and the shell's); the foot row stays one line with nothing leaning (the sprite, the count over its word, the accent button whose name may wrap and whose key is left to the sheet, and of the hints only Actions, as three dots on a night chip). Between a phone and a wide desk the hints wrap onto a second line, right-aligned, rather than run into the button.
-- **Scenes.** The top arc, the notch and the place sit inside the top 64px (`--visor-inset-top`), the band the sky already leaves free, so no scene's top row is struck through. Home no longer shifts its greeting row left (there is no pill top-right to clear). The city's door rises above the foot row at every width, because the accent button is centred where the door stood. The sky's `visor-on` offsets are unchanged.
+- **Scenes.** The top arc, the notch and the place sit inside the top 64px (`--visor-arc`; the segments under them take the inset to 88px, `--visor-inset-top`), so no scene's top row is struck through. Home no longer shifts its greeting row left (there is no pill top-right to clear). The city's door rises above the foot row at every width, because the accent button is centred where the door stood. The sky's `visor-on` offsets are unchanged.
 - **Looking at it.** The stand-in scene in `tests/hall_visor.mjs` over the hall's real sheets; put a bright gradient behind it to check midday.
 
 ## What it settled (task 1005148)

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.88",
+  "version": "1.24.90",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.24.88",
+      "version": "1.24.90",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.88",
+  "version": "1.24.90",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -11631,5 +11631,17 @@
       "id": "1005188",
       "text": "Pressing Escape to close a building card on the city page no longer also brings the sidebar back."
     }
+  ],
+  "1.24.89": [
+    {
+      "id": "1005203",
+      "text": "In the game, the visor now shows four small bars for how much of the current version is built, and every main button in the game now belongs on the visor."
+    }
+  ],
+  "1.24.90": [
+    {
+      "id": "1005207",
+      "text": "In the game view the Artist's feedback tab no longer sits on the screen; the Artist opens the feedback sheet from the visor, and only the Artist can open it."
+    }
   ]
 }

package/src/module-api.js

@@ -81,7 +81,7 @@ const { sleep } = require('./sleep');
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.24.88'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.24.90'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('discord'); log.info('mounted');

package/tests/hall_game_review_tab.mjs

@@ -0,0 +1,86 @@
+// tests/hall_game_review_tab.mjs — no parked review tab on the game's glass (task 1005207).
+//
+// Game mode (html[data-game="on"]) shows only the visor, so the Artist's docked review
+// sheet (page-notes.js + page-notes.css) draws no tab at the right edge. The visor's
+// "Review this page" (R) still opens the sheet, and closing it leaves nothing behind.
+// Classic mode keeps the tab exactly as it was. Driven in a real browser over the
+// REAL page-notes.js and the hall's real sheets.
+import assert from 'node:assert/strict';
+import { test, after } from 'node:test';
+import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const HALL = path.join(ROOT, 'modules/hall-ui/public');
+
+const lib = require(path.join(ROOT, 'modules', 'ui-design', 'kit', 'lib.js'));
+let browser = null;
+try { browser = await lib.launchBrowser(); } catch (e) { if (!(e instanceof lib.NoBrowserError)) throw e; }
+after(() => browser && browser.close());
+const skip = !browser && 'no system Edge or Chrome';
+
+const ORIGIN = 'http://hall.test';
+const TYPES = { '.js': 'text/javascript', '.css': 'text/css' };
+const PAGE = (game) => `<!doctype html><html data-theme="dark"${game ? ' data-game="on"' : ''}><head><meta charset="utf-8">
+<link rel="stylesheet" href="/builders/style.css"></head>
+<body data-page="home"><button id="before">page</button>
+<script>window.OTB = { escapeHtml: (s) => String(s == null ? '' : s).replace(/[&<>"']/g, (c) => '&#' + c.charCodeAt(0) + ';') };</script>
+<script src="/builders/page-notes.js"></script></body></html>`;
+
+async function open(game) {
+  const ctx = await browser.newContext({ viewport: { width: 1280, height: 800 } });
+  await ctx.route(ORIGIN + '/**', (route) => {
+    const p = new URL(route.request().url()).pathname;
+    if (p === '/') return route.fulfill({ contentType: 'text/html', body: PAGE(game) });
+    // The sheet's reads: an empty draft and an empty list are enough to draw it.
+    if (p.startsWith('/api/bongos/page-notes')) return route.fulfill({ contentType: 'application/json', body: JSON.stringify({ note: { id: 1, body_md: '', status: 'draft' }, images: [], notes: [] }) });
+    const f = path.join(HALL, p.replace(/^\/builders\//, ''));
+    if (p.startsWith('/builders/') && TYPES[path.extname(p)] && fs.existsSync(f)) return route.fulfill({ contentType: TYPES[path.extname(p)], body: fs.readFileSync(f) });
+    return route.fulfill({ status: 404, body: '' });
+  });
+  const page = await ctx.newPage();
+  const errors = [];
+  page.on('pageerror', (e) => errors.push(String(e.message)));
+  await page.goto(ORIGIN + '/');
+  await page.waitForFunction(() => !!window.OTBPageNotes);
+  // What craft-mode.js does for the Artist: dock the sheet, tucked away behind its tab.
+  await page.evaluate(() => window.OTBPageNotes.dock());
+  return { ctx, page, errors };
+}
+const tabShown = (page) => page.evaluate(() => {
+  const t = document.querySelector('#page-notes .pn__tab');
+  return !!t && getComputedStyle(t).display !== 'none' && t.getClientRects().length > 0;
+});
+const panelShown = (page) => page.evaluate(() => getComputedStyle(document.querySelector('#page-notes .pn__panel')).visibility !== 'hidden'
+  && !document.getElementById('page-notes').classList.contains('pn--collapsed'));
+
+test('classic mode keeps the parked tab at the right edge', { skip }, async () => {
+  const { ctx, page, errors } = await open(false);
+  assert.equal(await tabShown(page), true);
+  assert.deepEqual(errors, []);
+  await ctx.close();
+});
+
+test('game mode: no parked tab; R opens the sheet, and closing leaves nothing at the edge', { skip }, async () => {
+  const { ctx, page, errors } = await open(true);
+  assert.equal(await tabShown(page), false, 'parked, nothing shows on the glass');
+  await page.waitForTimeout(350); // the slide-out
+  assert.equal(await panelShown(page), false);
+  // The visor's "Review this page" is OTBCraftMode.openTool('palette') → OTBPageNotes.open().
+  await page.evaluate(() => window.OTBPageNotes.open());
+  assert.equal(await panelShown(page), true, 'R still opens the sheet');
+  assert.equal(await tabShown(page), false, 'open, still no tab beside it');
+  await page.click('#page-notes [data-pn-close]');
+  await page.waitForTimeout(350);
+  assert.equal(await panelShown(page), false, 'closed, the sheet is gone');
+  assert.equal(await tabShown(page), false, 'and no tab is left behind');
+  assert.equal(await page.evaluate(() => document.getElementById('page-notes').contains(document.activeElement)), false,
+    'focus leaves the tucked sheet instead of landing on a tab nobody can see');
+  await page.evaluate(() => window.OTBPageNotes.open());
+  assert.equal(await panelShown(page), true, 'and R opens it again');
+  assert.deepEqual(errors, []);
+  await ctx.close();
+});

package/tests/hall_visor.mjs

@@ -66,6 +66,33 @@ test('a key means an action only when nothing else spent it', () => {
   assert.equal(V.keyFor('artisan', ev('Escape')), null, 'the ambient glass never takes Escape (ADR 0399 §2.4)');
 });
 
+// task 1005203: the four segments are the version the project is building, in quarters.
+test('progress: the starred version while open, else the one building, else none', () => {
+  const V = loadPure();
+  const plain = (x) => JSON.parse(JSON.stringify(x));
+  const rows = [
+    { version_id: 'V1', name: 'One', status: 'shipped', percent_complete: 100 },
+    { version_id: 'V2', name: 'Two', status: 'building', percent_complete: 89 },
+    { version_id: 'V3', name: 'Three', status: 'planning', percent_complete: 39 },
+  ];
+  assert.deepEqual(plain(V.pickVersion(rows, 'V3')), { id: 'V3', name: 'Three', pct: 39 }, 'the starred version wins while it is open');
+  assert.equal(V.pickVersion(rows, 'V1').id, 'V2', 'a starred version that shipped falls back to the one building');
+  assert.equal(V.pickVersion(rows, null).id, 'V2');
+  assert.equal(V.pickVersion(rows.filter((r) => r.status !== 'building'), null), null, 'nothing building: no segments, never empty ones');
+  assert.equal(V.pickVersion(null, 'V2'), null, 'a failed read draws nothing');
+  assert.equal(V.pickVersion([{ version_id: 'V9', status: 'building' }], null), null, 'no percent: no invented one');
+});
+
+test('progress: each segment is a quarter, and only the quarter being built is the accent', () => {
+  const V = loadPure();
+  const s = (p) => JSON.parse(JSON.stringify(V.segStates(p)));
+  assert.deepEqual(s(0), ['now', 'todo', 'todo', 'todo']);
+  assert.deepEqual(s(24), ['now', 'todo', 'todo', 'todo']);
+  assert.deepEqual(s(25), ['done', 'now', 'todo', 'todo']);
+  assert.deepEqual(s(89), ['done', 'done', 'done', 'now']);
+  assert.deepEqual(s(100), ['done', 'done', 'done', 'done'], 'a finished version has nothing left to build');
+});
+
 test('credits, never a payout: the count reads as credits, with thousands grouped', () => {
   const V = loadPure();
   assert.equal(V.creditsText(56021), '56,021 credits');

package/tests/page_notes_panel.mjs

@@ -95,6 +95,26 @@ test('THE PANEL: docked at the edge in Artist alone, with no top-bar button, and
   assert.deepEqual(none.loaded, [], 'and nothing loads');
 });
 
+test('the review sheet is the Artist\'s alone: openTool (the visor\'s R) opens it for no other character (task 1005207)', async () => {
+  const a = boot({ session: { 'hall-craft': 'artist' } });
+  await flush();
+  a.craft.openTool('palette');
+  await flush();
+  assert.deepEqual(a.opened, ['dock', 'open'], 'the Artist opens it');
+  for (const m of ['artisan', 'patron']) {
+    const p = boot({ session: { 'hall-craft': m } });
+    await flush();
+    p.craft.openTool('palette');
+    await flush();
+    assert.deepEqual(p.opened, [], `${m}: nothing opens`);
+    assert.deepEqual(p.loaded, [], `${m}: the sheet's script never loads`);
+  }
+  const none = boot();
+  none.craft.openTool('palette');
+  await flush();
+  assert.deepEqual(none.opened, [], 'with no character, nothing opens');
+});
+
 test('a screen in the options menu frame docks no second panel: the menu around it has one', async () => {
   const p = boot({ session: { 'hall-craft': 'artist' }, embedded: true });
   await flush();