@bongos/core 1.24.72 → 1.24.74

package/modules/government/db.js

@@ -1320,7 +1320,35 @@ async function insertVoteKarma({ voterId, itemId, delta }) {
   );
 }
 
+// ── the constitution in force (task 1005140) ─────────────────────────────────
+// ONE row (government_037). The board block is stored exactly as sanitizeBoard
+// returns it; constitution.js owns the rules for when it is written and how the
+// running process is brought in step with it. `q` is a client or the pool.
+async function getConstitutionRow(q = pool) {
+  const { rows } = await q.query(
+    `SELECT board, source, amendment_item_id, updated_by, updated_at
+       FROM government_constitution WHERE id = 1`,
+  );
+  return rows[0] || null;
+}
+
+async function saveConstitutionRow({ board, source, itemId = null, updatedBy = null } = {}, q = pool) {
+  const { rows } = await q.query(
+    `INSERT INTO government_constitution (id, board, source, amendment_item_id, updated_by, updated_at)
+     VALUES (1, $1::jsonb, $2, $3, $4, now())
+     ON CONFLICT (id) DO UPDATE
+       SET board = EXCLUDED.board, source = EXCLUDED.source,
+           amendment_item_id = EXCLUDED.amendment_item_id,
+           updated_by = EXCLUDED.updated_by, updated_at = now()
+     RETURNING board, source, amendment_item_id, updated_by, updated_at`,
+    [JSON.stringify(board), source, itemId, updatedBy],
+  );
+  return rows[0] || null;
+}
+
 module.exports = {
+  getConstitutionRow,
+  saveConstitutionRow,
   openBoardItemsAwaitingVoter,
   getTaskStatuses,
   listLatestGenesisStageItems,

package/modules/government/migrations/government_037_constitution.sql

@@ -0,0 +1,33 @@
+-- government_037_constitution.sql — the constitution in force is a ROW (task 1005140).
+--
+-- WHY
+--
+--   A ratified amendment used to live only in <instance root>/config/government.json.
+--   Every instance this platform provisions runs on a container whose filesystem is
+--   wiped on each deploy, restart and idle wake, so the board's decision was written,
+--   took effect, and vanished at the next container start. The project went back to
+--   the day-one monarchy without an error (found live on toast, 2026-11-07).
+--
+-- WHAT THIS ADDS
+--
+--   government_constitution — at most ONE row (id = 1): the instance's board block,
+--   exactly as sanitizeBoard (modules/government/config.js) would write it. The four
+--   keys are the whole block; nothing else rides here (rank templates stay config).
+--   `source` says how the row got here: a passed amendment, a file adopted on first
+--   read, or an operator re-applying the newest passed amendment.
+--
+--   It is NOT authority: the block names which RANK governs; who holds that rank is
+--   still a government_builder_ranks row, resolved per request.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS government_constitution (
+  id                 smallint    PRIMARY KEY DEFAULT 1 CHECK (id = 1),
+  board              jsonb       NOT NULL CHECK (jsonb_typeof(board) = 'object'),
+  source             text        NOT NULL CHECK (source IN ('amendment', 'adopted_file', 'reapply')),
+  amendment_item_id  bigint      REFERENCES government_board_items(id) ON DELETE SET NULL,
+  updated_by         bigint      REFERENCES builders(id) ON DELETE SET NULL,
+  updated_at         timestamptz NOT NULL DEFAULT now()
+);
+
+COMMIT;

package/modules/government/module.json

@@ -17,7 +17,8 @@
     ],
     "pollers": [
       "board-expiry",
-      "treasury-borrow"
+      "treasury-borrow",
+      "constitution-restore"
     ]
   },
   "provides": [

package/modules/government/pollers/constitution-restore.js

@@ -0,0 +1,45 @@
+'use strict';
+
+// modules/government/pollers/constitution-restore.js — the constitution in force
+// comes back after a restart (task 1005140).
+//
+// A provisioned instance boots on a fresh container: the file the running
+// process reads its constitution from is gone, and without this the project
+// silently answers the day-one monarchy until somebody notices. So the FIRST
+// reconcile runs as soon as the poller starts, not after a delay — every moment
+// before it is a moment the wrong rule is in force. After that it re-checks on a
+// slow interval, which also keeps a second process in step with an amendment
+// another one applied.
+//
+// Quiet when in step; one line when it restores or adopts (constitution.js).
+
+const api = require('../../../src/module-api');
+const constitution = require('../constitution');
+
+const logger = api.logger('government');
+
+const INTERVAL_MS = Number(process.env.CONSTITUTION_RESTORE_SWEEP_MS) || 5 * 60_000;
+
+let intervalTimer = null;
+
+function start({ reconcileFn = constitution.reconcile } = {}) {
+  if (process.env.CONSTITUTION_RESTORE_DISABLED === '1') {
+    logger.info('[constitution-restore] disabled (CONSTITUTION_RESTORE_DISABLED=1)');
+    return;
+  }
+  if (intervalTimer) return;
+  const tick = () => {
+    Promise.resolve()
+      .then(() => reconcileFn({ log: (m) => logger.info(m), error: (m) => logger.error(m) }))
+      .catch((e) => logger.error(`[constitution-restore] reconcile crashed: ${e && e.message}`));
+  };
+  tick();
+  intervalTimer = setInterval(tick, INTERVAL_MS);
+  if (intervalTimer.unref) intervalTimer.unref();
+}
+
+function stop() {
+  if (intervalTimer) { clearInterval(intervalTimer); intervalTimer = null; }
+}
+
+module.exports = { start, stop, INTERVAL_MS };

package/modules/government/routes/government.js

@@ -36,6 +36,7 @@ const asksDb = require('../asks-db');
 const routing = require('../routing');
 const { accessHandlers } = require('../access-routes');
 const governmentConfig = require('../config');
+const constitution = require('../constitution');
 const membershipPredicate = require('../membership-predicate');
 const positions = require('../positions');
 const decisionBoard = require('../decision-board');
@@ -724,8 +725,7 @@ module.exports = function buildGovernmentRouter() {
   // the live board block plus the full amendment history, passed and returned
   // alike. Same atom as the room — reading the rule you vote under is part of
   // casting, and the section teaches (criterion C5). The live value resolves
-  // fresh per request, so an amendment applied a moment ago reads back
-  // immediately (the same instant-effect posture as everything else here).
+  // fresh per request, so an amendment applied a moment ago reads back at once.
   router.get('/government/constitution', api.requireBuilder, api.requirePermission('board.vote.cast'), async (req, res) => {
     try {
       // ?type= and ?headcount= ask about another project type or size (task
@@ -741,6 +741,9 @@ module.exports = function buildGovernmentRouter() {
     }
   });
 
+  // rank: perm government.manage — re-apply the newest PASSED amendment (task 1005140; constitution.js).
+  router.post('/government/constitution/reapply', api.requireBuilder, api.requirePermission('government.manage'), constitution.reapplyRoute(log));
+
   // rank: perm board.vote.cast — the founding band's read (task 1004429): each
   // genesis stage's latest sitting, and who it is still waiting on under the
   // item's own snapshot. Same atom as the room — seeing who is still to vote is
@@ -1454,11 +1457,7 @@ module.exports = function buildGovernmentRouter() {
         const status =
           out.reason === 'item_not_found' ? 404 :
           out.reason === 'not_board_member' ? 403 :
-          // 'anti_self_vote' was retired by task 1003273 — an author may cast;
-          // what they cannot do is decide alone, which the close trigger and the
-          // tally enforce rather than the route. The mapping is left OUT rather
-          // than kept "just in case": a reason castVote can no longer return
-          // would be dead code pretending to be a wall.
+          // 'anti_self_vote' was retired by task 1003273 (an author may cast, never decide alone) — left OUT on purpose.
 
           out.reason === 'item_closed' ? 409 :
           out.reason === 'vote_window_expired' ? 409 :
@@ -1486,6 +1485,7 @@ module.exports = function buildGovernmentRouter() {
         already_voted: !out.fresh,
         ...(out.fresh ? { karma_delta: out.karma_delta } : {}),
         ...(closure && closure.closed ? { item_closed: true, outcome: closure.outcome } : {}),
+        ...(closure && closure.constitution_not_applied ? { constitution_not_applied: closure.constitution_not_applied } : {}),
       });
     } catch (err) {
       log.error('[gds] POST /government/board/items/:itemId/votes', err);

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

@@ -87,9 +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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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

@@ -90,9 +90,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/blockers.html

@@ -59,9 +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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/board-room.html

@@ -61,9 +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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/board-room.js

@@ -415,9 +415,13 @@
     }
     try {
       const out = await sendJson('POST', `/government/board/items/${encodeURIComponent(itemId)}/votes`, body);
-      toast(out.item_closed
-        ? `Vote cast — the sitting closed: ${out.outcome}.`
-        : 'Vote cast.');
+      // Task 1005140: a ratified change that did not take is said now, loudly,
+      // not weeks later in the Constitution tab's warning.
+      toast(out.constitution_not_applied
+        ? 'Passed, but the new constitution did not take effect. The old rules are still in force; the owner can re-apply it.'
+        : out.item_closed
+          ? `Vote cast — the sitting closed: ${out.outcome}.`
+          : 'Vote cast.');
     } catch (err) {
       if (err && err.kind === '401') return;
       toast(`Could not vote: ${err.message || err}`);

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

@@ -106,9 +106,10 @@
 </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-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-07-brand-mark" defer></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode" defer></script>
 <script src="/builders/hall-dialog.js" defer></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1" defer></script>

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

@@ -160,9 +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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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

@@ -52,9 +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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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

@@ -178,9 +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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -79,9 +79,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/goal-map.html

@@ -138,9 +138,10 @@
 </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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 

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

@@ -251,9 +251,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/government.html

@@ -155,9 +155,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/idea.html

@@ -51,9 +51,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N overlay, so a ref

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

@@ -226,9 +226,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

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

@@ -107,9 +107,10 @@
 <!-- task 1004785: the first-visit-of-the-day welcome (the tower). Before shell.js, which asks it
      before the craft picker so the two never stack. Home only. -->
 <script src="/builders/welcome-boot.js?v=2026-11-07-brand-mark" defer></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode" 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-07-brand-mark" defer></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode" defer></script>
 <script src="/builders/hall-dialog.js" defer></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/market-watch-item.html

@@ -72,9 +72,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/market-watch-rules.html

@@ -41,9 +41,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/market-watch.html

@@ -186,9 +186,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -126,9 +126,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/money.html

@@ -80,9 +80,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/my-agents.html

@@ -82,9 +82,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/primer.html

@@ -111,9 +111,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/profile.html

@@ -247,9 +247,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/project-settings.html

@@ -75,9 +75,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/roster.html

@@ -57,9 +57,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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/settings.html

@@ -392,9 +392,10 @@
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page scripts run. -->
 <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-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-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></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/shell-game.js

@@ -0,0 +1,50 @@
+// shell-game.js — game mode: the hall-wide half of the shell's full-screen switch
+// (task 1005142, BONGOS-V3 R02, goal 1000141; docs/specs/bongos-v3-game-conversion.md
+// §Reuse, do not rebuild). The switch itself is shell.js's and stays there: this
+// file only answers ONE question for it — is the hall in game mode? — and when it
+// is, every page opens in full screen (no sidebar, no top bar, no foot) whatever
+// that page remembers on its own. Nothing here hides anything: shell.js does, with
+// the same html[data-fullscreen="on"] state, the same corner button and the same
+// Escape hand-off (a page listener that calls preventDefault keeps the press).
+//
+// The mode is one localStorage key (`hall-game`), so it follows the browser across
+// every hall page, and one attribute, html[data-game="on"], for a sheet or script
+// that wants to read it. Leaving full screen in game mode (the button, Escape)
+// brings the bars back for THAT page load only: the next page opens without them
+// again, and a page's own remembered choice is never overwritten. `?game=on` /
+// `?game=off` on any hall URL sets it by hand until the start screen does (R03).
+// Loaded BEFORE shell.js on every hall page; a page without this file is simply
+// never in game mode.
+(function () {
+  'use strict';
+  var KEY = 'hall-game';
+  var HINT_KEY = 'hall-game-hint';
+  function read(store, key) { try { return window[store].getItem(key); } catch (_) { return null; } }
+  function write(store, key, value) { try { window[store].setItem(key, value); } catch (_) { /* private mode */ } }
+  function on() { return read('localStorage', KEY) === 'on'; }
+  function stamp() {
+    var root = document.documentElement;
+    if (on()) root.dataset.game = 'on'; else delete root.dataset.game;
+  }
+  // Turn the mode on or off, and have the shell show what this page should now show.
+  function set(value) {
+    write('localStorage', KEY, value ? 'on' : 'off');
+    stamp();
+    if (window.OTBShell && window.OTBShell.setFullscreen) window.OTBShell.setFullscreen(null);
+  }
+  // Whether the shell should say how to leave full screen. Outside game mode,
+  // always (its own rule); inside it, once per tab — every page opens in full
+  // screen there, and the same sentence on every page load is noise.
+  function hint() {
+    if (!on()) return true;
+    if (read('sessionStorage', HINT_KEY)) return false;
+    write('sessionStorage', HINT_KEY, '1');
+    return true;
+  }
+  try {
+    var asked = new URLSearchParams(window.location.search || '').get('game');
+    if (asked === 'on' || asked === 'off') write('localStorage', KEY, asked);
+  } catch (_) { /* old engine: the stored value stands */ }
+  stamp();
+  window.OTBShellGame = { on: on, set: set, hint: hint };
+})();