@bongos/core 1.24.87 → 1.24.89

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/bongos/package-core.js",
-  "core_version": "1.24.87",
-  "core_contract": "1.24.87",
-  "source_commit": "ac248b7311ba49f65477247a4292e68fca010d8c",
+  "core_version": "1.24.89",
+  "core_contract": "1.24.89",
+  "source_commit": "5379d8d8c473f29a6a69c4a6cd8458725b28826a",
   "source_ref": "HEAD",
-  "built_at": "2026-11-12T03:26:09.005Z",
+  "built_at": "2026-11-12T11:58:41.405Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 649,
+    "docs_redacted": 650,
     "agent_docs_stubbed": 32,
     "functional_verbatim": 3963,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 4645,
-  "tree_sha256": "73166098aa464b4f9f38b84d85eeb0c5a058651a053950a7d7052046b8b0fc8a",
+  "file_count": 4646,
+  "tree_sha256": "5a23648bc1d06d4c1415182578d2dcfad9ec48293b2e8a30820fac4f3d35b5c4",
   "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": "48d3029a2e32badc357b42e6aa81ae3e6f9f3031209e23b4dae7d353e383691b"
+      "sha256": "3a8d76921a19be8f9af2059d585146e394a336acac1946b4cd50be25d5fa98ea"
     },
     {
       "path": "docs/modules-contract.md",
@@ -3117,7 +3122,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "d35610b6f68ee39d58c74078a17b6ac637c07a293438ba494caf7075ab593503"
+      "sha256": "8581eedd1c9d8abe50d77c03342e77f2a73bf2d0c6be2ded59e3a72e5cf66d9a"
     },
     {
       "path": "docs/project-context.template.md",
@@ -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": "0cb64655e54223cdff610bfb96281e693c1dba675c2d439768ab88ac94d9a4c4"
+      "sha256": "dfcd92429bb72ee47cc5783fd56148f2a00b02a8a2dea8d750687fa27d3ddf3f"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "38ca001fcd82b936dfe409fbbfe53ebc276b2078ed315c54753c50f102f80e0e"
+      "sha256": "35173cdd89c199b1307a5cbb2caaa3c60568c4243bc6f562c93d0b9d7fcfebf5"
     },
     {
       "path": "public-docs/index.html",
@@ -12122,7 +12127,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "09a0270f5c8b3933b5dae932250ea2a1a12511f4bbc6b843780f34270289a6d2"
+      "sha256": "d5d3cf8f58f096b887edea5841198e927ed5fe7be4135845eb5510b2ed6648e8"
     },
     {
       "path": "scripts/bongos/CLAUDE.md",
@@ -16127,7 +16132,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "e82e08ead956cec3b48bb3de900d0b6bf6478b6a50b1900181165197727bd724"
+      "sha256": "6f1af2279eb6a432adddf60b50baebdcac4700035c5e65b87fb5ade7736de92e"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -19032,7 +19037,7 @@
     {
       "path": "tests/hall_city_living.mjs",
       "mode": "0000644",
-      "sha256": "ae98eec1a5f8279e4b50dc64f208e1c7b8b248847ed0d156b27c914a1b697d55"
+      "sha256": "1b6744e38a44f486978a1f3ecf275fa260a6d79b0779242fdd4827980b14593d"
     },
     {
       "path": "tests/hall_city_rewording.mjs",
@@ -19377,7 +19382,7 @@
     {
       "path": "tests/hall_visor.mjs",
       "mode": "0000644",
-      "sha256": "fc78f108f610fa15299b0a73f3ce1a69fa138e950353a1d7d99044e1b70b4e5d"
+      "sha256": "055de4ac3afe4e7883be6cb462e00879bafc4c7593186ae7d728dbd5ee13f6f6"
     },
     {
       "path": "tests/hall_work_history_id.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

@@ -3424,5 +3424,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.24.85 with no explicit bump. run 43115337105. (task 1002620)
   1.24.87 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         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)
 ---------------------------------------------------------------------------
 ```