@bongos/core 1.25.4 → 1.25.6

package/docs/page-readings.json

@@ -5,14 +5,14 @@
   "adr": "0341 D3",
   "reread": "node scripts/bongos/page-reader.js --stale",
   "how": ["Generated by node scripts/bongos/page-reader.js (BV2.TW04, task 1004315; ADR 0341 D3). Do not hand-edit.","One entry per page of docs/page-inventory.json. Lines are in page order: the default state first, and a line only another state shows sits where that state shows it, with its state named.","placement: placed = a docs/copy-registry.json row renders it (file, line, string_id); shared = shell text every page of the surface carries (top bar, sidebar, footer), with its row when the registry has one; unplaced = the registry cannot place it (a rewrite becomes an engineer task, ADR 0341 D4).","text keeps {…} where the registry row has a hole, or where a value the page read from its API was filled in. A string that is only such data is counted under omitted.data, not listed.","reading_hash is over the non-shared lines (key, section, text); files_hash is over the page's inventory files. --check compares files_hash only and never opens a browser.","Rendered through the hall-preview harness (hall) and the ui-design kit stub (landing, status), at 1280x800 with the clock pinned, so a reading is the fixture world's page."],
-  "counts": {"pages":45,"lines":4411,"placed":1638,"shared":369,"unplaced":2404,"omitted_data":2980},
+  "counts": {"pages":45,"lines":4408,"placed":1633,"shared":369,"unplaced":2406,"omitted_data":2980},
   "pages": [
     {
       "id": "builders:ai-studio",
       "surface": "builders",
       "title": "Studio",
       "states_read": ["pick","describe","make","waiting","result","result-own","failed","balance","balance-all","out"],
-      "files_hash": "5b785de6639c8ec5",
+      "files_hash": "a9b4990d9b84e7f9",
       "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": "76f3f9d62c147df5",
+      "files_hash": "84e8a3802285d54c",
       "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": "8492188331702a2f",
+      "files_hash": "22d64ad0bdbfb20a",
       "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": "4218d029418aa874",
+      "files_hash": "71ccdec4d840f239",
       "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": "3a16e78aaab2e893",
+      "files_hash": "d3b4d1e3da4cbf34",
       "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": "9e9d0d3b86089631",
+      "files_hash": "08ca51a52701caa7",
       "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": "14d04212aba71360",
+      "files_hash": "4184181832abeb8e",
       "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": "498777214970f599",
+      "files_hash": "70d8131ed9bed50a",
       "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": "d93352de799f272f",
+      "files_hash": "c3726270034f0886",
       "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": "50735ca110164fe8",
+      "files_hash": "117557e051f209a0",
       "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": "23bb6e3ad6306135",
+      "files_hash": "4a6b3e46f1553c25",
       "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": "d168f2cd8aa66e32",
+      "files_hash": "ddbd09c6c1629fd3",
       "reading_hash": "37c6878d60447fd6",
       "counts": {"lines":65,"placed":27,"shared":7,"unplaced":31},
       "omitted": {"data":276},
@@ -954,9 +954,9 @@
       "surface": "builders",
       "title": "Builders' Hall",
       "states_read": ["home","out","founding","genesis","decide","demo","votes"],
-      "files_hash": "730694ff18f4468d",
-      "reading_hash": "177d0c13a53c0491",
-      "counts": {"lines":32,"placed":12,"shared":8,"unplaced":12},
+      "files_hash": "fc89efd93f0419a9",
+      "reading_hash": "620b6c4d18b7e501",
+      "counts": {"lines":29,"placed":7,"shared":8,"unplaced":14},
       "omitted": {"data":4},
       "notes": ["founding: an action failed (page.focus: Timeout 6000ms exceeded.); read as it stood"],
       "lines": [
@@ -967,7 +967,7 @@
         {"key":"L0005","section":"top bar","text":"Jump to…","placement":"shared","file":"modules/hall-ui/public/shell.js","line":536,"string_id":"eba610d25523"},
         {"key":"L0006","section":"top bar","text":"Ctrl K","placement":"shared"},
         {"key":"L0007","section":"top bar","text":"Artist","placement":"shared"},
-        {"key":"L0008","section":"Good morning, {…}","text":"Good morning, {…}","placement":"unplaced","occurrences":2},
+        {"key":"L0008","section":"Good morning, {…}","text":"Good morning, {…}","placement":"unplaced"},
         {"key":"L0009","section":"Good morning, {…}","text":"B","placement":"unplaced","occurrences":9},
         {"key":"L0010","section":"Good morning, {…}","text":"Aug","placement":"unplaced"},
         {"key":"L0011","section":"Good morning, {…}","text":"Oct","placement":"unplaced"},
@@ -977,21 +977,18 @@
         {"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.25.2","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"},
-        {"key":"L0022","section":"Good morning, {…}","text":"Where do you want to start the day?","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":188,"string_id":"0ec8d133f878","state":"founding"},
-        {"key":"L0023","section":"Good morning, {…}","text":"Start with your role","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":190,"string_id":"58cef7963b6c","state":"founding"},
-        {"key":"L0024","section":"Good morning, {…}","text":"Pick today’s craft and go straight to its room.","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":190,"string_id":"100e4665514d","state":"founding"},
-        {"key":"L0025","section":"Good morning, {…}","text":"Your home page","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":191,"string_id":"2e6866532113","state":"founding"},
-        {"key":"L0026","section":"Good morning, {…}","text":"Your work, what needs you, and what shipped.","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":191,"string_id":"e8d92c773db0","state":"founding"},
-        {"key":"L0027","section":"Update the builders hall?","text":"Update the builders hall?","placement":"unplaced"},
-        {"key":"L0028","section":"Update the builders hall?","text":"A newer version of Bongos is ready, with the latest changes and bug fixes.","placement":"placed","file":"modules/hall-ui/public/update-pill.js","line":604,"string_id":"105876fd9038"},
-        {"key":"L0029","section":"Update the builders hall?","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":3},
-        {"key":"L0030","section":"Update the builders hall?","text":"Closed a security hole where a builder's branch could choose the program the server runs while auto-resolving merge…","placement":"unplaced"},
-        {"key":"L0031","section":"Update the builders hall?","text":"Later","placement":"unplaced"},
-        {"key":"L0032","section":"Update the builders hall?","text":"Update now","placement":"placed","file":"modules/hall-ui/public/update-pill.js","line":288,"string_id":"5fe7d2d395be"}
+        {"key":"L0018","section":"{…}","text":"How do you want to see it?","placement":"placed","file":"modules/hall-ui/public/shell-game.js","line":165,"string_id":"1e8da0baf421"},
+        {"key":"L0019","section":"{…}","text":"Game","placement":"unplaced"},
+        {"key":"L0020","section":"{…}","text":"The city, {…} screen","placement":"unplaced"},
+        {"key":"L0021","section":"{…}","text":"Classic","placement":"unplaced"},
+        {"key":"L0022","section":"{…}","text":"The hall with its sidebar","placement":"unplaced"},
+        {"key":"L0023","section":"{…}","text":"Escape opens the options menu, where every setting lives.","placement":"unplaced"},
+        {"key":"L0024","section":"Update the builders hall?","text":"Update the builders hall?","placement":"unplaced"},
+        {"key":"L0025","section":"Update the builders hall?","text":"A newer version of Bongos is ready, with the latest changes and bug fixes.","placement":"placed","file":"modules/hall-ui/public/update-pill.js","line":604,"string_id":"105876fd9038"},
+        {"key":"L0026","section":"Update the builders hall?","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":3},
+        {"key":"L0027","section":"Update the builders hall?","text":"Closed a security hole where a builder's branch could choose the program the server runs while auto-resolving merge…","placement":"unplaced"},
+        {"key":"L0028","section":"Update the builders hall?","text":"Later","placement":"unplaced"},
+        {"key":"L0029","section":"Update the builders hall?","text":"Update now","placement":"placed","file":"modules/hall-ui/public/update-pill.js","line":288,"string_id":"5fe7d2d395be"}
       ]
     },
     {
@@ -999,7 +996,7 @@
       "surface": "builders",
       "title": "Idea",
       "states_read": ["record","missing"],
-      "files_hash": "02820c742a0bceb9",
+      "files_hash": "27923dd71c6cc61e",
       "reading_hash": "f7d644748c87e426",
       "counts": {"lines":52,"placed":25,"shared":8,"unplaced":19},
       "omitted": {"data":25},
@@ -1064,7 +1061,7 @@
       "surface": "builders",
       "title": "Ideas",
       "states_read": ["compose","full","develop"],
-      "files_hash": "59688a8b224ba2ec",
+      "files_hash": "14fb04299f9c5294",
       "reading_hash": "a62c05dcef3bf87f",
       "counts": {"lines":68,"placed":34,"shared":7,"unplaced":27},
       "omitted": {"data":118},
@@ -1145,7 +1142,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["desk","settings","out"],
-      "files_hash": "377ad66b86dfdd0b",
+      "files_hash": "86254f61eee1660d",
       "reading_hash": "30512dda207b5ea6",
       "counts": {"lines":23,"placed":11,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1181,7 +1178,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["dossier","out","propose","correct","filtered"],
-      "files_hash": "bb602ff95badc43c",
+      "files_hash": "b0744b7328c2f1f6",
       "reading_hash": "129bff28c4e4ed6d",
       "counts": {"lines":24,"placed":12,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1218,7 +1215,7 @@
       "surface": "builders",
       "title": "Market Watch rules",
       "states_read": ["in","scoring","names","propose","out"],
-      "files_hash": "6c2edc411eed69bc",
+      "files_hash": "159bc203c644dbed",
       "reading_hash": "ca0c62e8dce51c8b",
       "counts": {"lines":36,"placed":12,"shared":7,"unplaced":17},
       "omitted": {"data":20},
@@ -1267,7 +1264,7 @@
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "61872edf35808d71",
+      "files_hash": "a19bba03c78ce50a",
       "reading_hash": "6a12e9306bba5622",
       "counts": {"lines":59,"placed":29,"shared":7,"unplaced":23},
       "omitted": {"data":107},
@@ -1339,7 +1336,7 @@
       "surface": "builders",
       "title": "Money",
       "states_read": ["money","hosting","out"],
-      "files_hash": "cbce1cf96f277a69",
+      "files_hash": "f521ccd6c8c5928c",
       "reading_hash": "e355d5466b123e07",
       "counts": {"lines":83,"placed":28,"shared":7,"unplaced":48},
       "omitted": {"data":27},
@@ -1435,7 +1432,7 @@
       "surface": "builders",
       "title": "My agents",
       "states_read": ["desk","factory","saved","what-it-knows","speciality-walk","speciality-forms","nobody"],
-      "files_hash": "d3dbce13a5390286",
+      "files_hash": "aaf60004a2341d14",
       "reading_hash": "5347e0496b38727d",
       "counts": {"lines":100,"placed":33,"shared":7,"unplaced":60},
       "omitted": {"data":38},
@@ -1548,7 +1545,7 @@
       "surface": "builders",
       "title": "Primer",
       "states_read": ["in","toc-open","jump","out"],
-      "files_hash": "df4ef875bc5238b7",
+      "files_hash": "4ba10f0fe35fcf02",
       "reading_hash": "85790bd421e5c387",
       "counts": {"lines":487,"placed":57,"shared":7,"unplaced":423},
       "omitted": {"data":18},
@@ -2048,7 +2045,7 @@
       "surface": "builders",
       "title": "Profile",
       "states_read": ["own","works","activity","yours","activity-artist","activity-artist-ideas","other","artist","artist-ideas","out"],
-      "files_hash": "412b85b0c70da301",
+      "files_hash": "1f829822c59de8d6",
       "reading_hash": "3ff8d703d17e8c2a",
       "counts": {"lines":232,"placed":84,"shared":7,"unplaced":141},
       "omitted": {"data":263},
@@ -2293,7 +2290,7 @@
       "surface": "builders",
       "title": "Project settings",
       "states_read": ["default"],
-      "files_hash": "4f917ac224479a34",
+      "files_hash": "22d9382cc6f62dcd",
       "reading_hash": "283df27d0d5bfc1b",
       "counts": {"lines":43,"placed":25,"shared":7,"unplaced":11},
       "omitted": {"data":33},
@@ -2349,7 +2346,7 @@
       "surface": "builders",
       "title": "Builders",
       "states_read": ["roster","artists","search","out"],
-      "files_hash": "337395b2465f66fc",
+      "files_hash": "20931556211ad519",
       "reading_hash": "665ac2e36339f5d3",
       "counts": {"lines":56,"placed":17,"shared":7,"unplaced":32},
       "omitted": {"data":137},
@@ -2418,7 +2415,7 @@
       "surface": "builders",
       "title": "Options",
       "states_read": ["account","access","preferences","install-reports","sound","update"],
-      "files_hash": "77001d9bd6423a92",
+      "files_hash": "16028f41e693ccde",
       "reading_hash": "898a13fda24c3c90",
       "counts": {"lines":162,"placed":104,"shared":7,"unplaced":51},
       "omitted": {"data":23},
@@ -2593,7 +2590,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": "8cd0e137ff9ec280",
+      "files_hash": "e2df36c75a82662a",
       "reading_hash": "e788e6bf4be8d68c",
       "counts": {"lines":325,"placed":54,"shared":6,"unplaced":265},
       "omitted": {"data":240},
@@ -2931,7 +2928,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": "3378703eddb55c9f",
+      "files_hash": "fe0a3ca248e50554",
       "reading_hash": "c4e3b4188c1db755",
       "counts": {"lines":51,"placed":29,"shared":7,"unplaced":15},
       "omitted": {"data":23},
@@ -2995,7 +2992,7 @@
       "surface": "builders",
       "title": "Task",
       "states_read": ["record","from-goal","missing"],
-      "files_hash": "ddaf83cea69ef7e7",
+      "files_hash": "44063a120d39cba9",
       "reading_hash": "8dd803b6934e6388",
       "counts": {"lines":151,"placed":46,"shared":9,"unplaced":96},
       "omitted": {"data":111},
@@ -3159,7 +3156,7 @@
       "surface": "builders",
       "title": "Your thinking",
       "states_read": ["tour","sky","list","simple","full-idea","full","full-list","full-back","out"],
-      "files_hash": "63660aafe0fd02da",
+      "files_hash": "511ee89d9ee0ab96",
       "reading_hash": "b73f848b46b0f9b8",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -3222,7 +3219,7 @@
       "surface": "builders",
       "title": "Tweak a page",
       "states_read": ["doc","typed","chrome","submitted","picking","out"],
-      "files_hash": "e1bf8da355d6cfb7",
+      "files_hash": "9bc999d8335172c8",
       "reading_hash": "f521f8d9a7147557",
       "counts": {"lines":26,"placed":18,"shared":2,"unplaced":6},
       "omitted": {"data":19},
@@ -3261,7 +3258,7 @@
       "surface": "builders",
       "title": "Watch",
       "states_read": ["board","out","operations","security","sessions","autobongos"],
-      "files_hash": "293ae9537963df09",
+      "files_hash": "3a3894aedea11977",
       "reading_hash": "1961a0c06b9d8477",
       "counts": {"lines":72,"placed":33,"shared":7,"unplaced":32},
       "omitted": {"data":52},
@@ -3346,7 +3343,7 @@
       "surface": "builders",
       "title": "Tasks",
       "states_read": ["ready","in-progress","backlog","completed","filters-open","out","founding"],
-      "files_hash": "8fee1f62e3f188bc",
+      "files_hash": "34f5b6e547c2319f",
       "reading_hash": "e9b412d1ec59ceee",
       "counts": {"lines":122,"placed":49,"shared":7,"unplaced":66},
       "omitted": {"data":323},

package/modules/hall-ui/public/shell-game.js

@@ -303,9 +303,19 @@
     if (open) box.querySelector('a').focus();
   }
   // Game: on to the start screen. Classic: the screen goes and the hall is as it always was.
+  // Signed out (task 1005219): the pick is kept for the trip, the visitor signs in, and the
+  // return opens the picked menu without asking again (start() reads PENDING_KEY).
   function choose(view) {
     if (phase !== 'choose') return;
+    if (opts && typeof opts.signIn === 'function') {
+      write('localStorage', PENDING_KEY, view);
+      opts.signIn();
+      return;
+    }
     if (view === 'classic') { set(false); close(); return; }
+    toMenu();
+  }
+  function toMenu() {
     set(true);
     phase = 'menu';
     root.querySelector('#gs-ask').hidden = true;
@@ -344,10 +354,30 @@
     f[(at + step + f.length) % f.length].focus();
   }
 
-  // Put the start screen up. `o`: { name, art, done } — the project's name, the still to stand
-  // behind both screens, and what to do once the world is showing. True when it is up.
+  // The hall's front opens on the chooser once each time the site is opened (task 1005219;
+  // owner, 2026-11-12: "every visit"): one sessionStorage mark per tab, so moving about the
+  // hall (game mode sends a classic page Home) never asks again. Storage that throws: never asked twice.
+  var SEEN_KEY = 'hall-chooser-seen';
+  var PENDING_KEY = 'hall-view-pending';
+  function seen() {
+    try { return window.sessionStorage.getItem(SEEN_KEY) === '1'; } catch (_) { return true; }
+  }
+  // The view a visitor picked before signing in, read once.
+  function takePending() {
+    var v = read('localStorage', PENDING_KEY);
+    try { window.localStorage.removeItem(PENDING_KEY); } catch (_) { /* nothing kept */ }
+    return v === 'game' || v === 'classic' ? v : null;
+  }
+
+  // Put the start screen up. `o`: { name, art, done, signIn } — the project's name, the still to
+  // stand behind both screens, what to do once the world is showing, and (signed out) how to sign
+  // in once a view is picked. True when it is up; false for a classic pick made before sign-in,
+  // which goes straight to the hall.
   function start(o) {
     if (root || !document.body) return !!root;
+    write('sessionStorage', SEEN_KEY, '1');
+    var pending = o && o.signIn ? null : takePending();
+    if (pending === 'classic') { set(false); return false; }
     opts = o || {};
     phase = 'choose';
     root = document.createElement('div');
@@ -361,6 +391,7 @@
     document.addEventListener('keydown', onKey, true);
     document.body.appendChild(root);
     document.documentElement.classList.add('gs-open');
+    if (pending === 'game') { toMenu(); return true; }
     var first = root.querySelector('.gs__item--lit') || root.querySelector('.gs__item');
     if (first && first.focus) first.focus();
     return true;
@@ -522,6 +553,6 @@
       } catch (_) { /* a href the browser cannot read: leave it alone */ }
     }, true);
   }
-  window.OTBShellGame = { on: on, set: set, hint: hint, start: start, tipAt: tipAt, historySteps: historySteps, whenLabel: whenLabel, segsDone: segsDone, MENU: MENU, TIPS: TIPS,
+  window.OTBShellGame = { on: on, set: set, hint: hint, start: start, seen: seen,tipAt: tipAt, historySteps: historySteps, whenLabel: whenLabel, segsDone: segsDone, MENU: MENU, TIPS: TIPS,
     embedded: function () { return embedded; }, menuPath: menuPath, PLACES: PLACES, pageOf: pageOf, isPlace: isPlace };
 })();

package/modules/hall-ui/public/welcome-boot.js

@@ -14,8 +14,10 @@
 //     flag in localStorage that the return visit consumes) opens on the game's start screen
 //     instead (task 1005143, shell-game.js); without that file it is greeted here as before. Storage that
 //     throws cannot remember, so such a browser is never shown it (it would replay on every visit).
-//   - A visitor who is not signed in sees the Welcome on Home, every visit, with a "Sign in with
-//     GitHub" button in place of the role choices. Only on Home, never over a deep link (#/task/N, #/idea/N).
+//   - Home opens on the game's Game / Classic chooser once each time the site is opened, signed in
+//     or not (task 1005219); signed out, a pick goes on to sign in and the return opens that menu.
+//     A visitor who is not signed in sees this Welcome only in a hall without shell-game.js, with a
+//     "Sign in with GitHub" button in place of the role choices. Only on Home, never over a deep link (#/task/N, #/idea/N).
 //   - shell.js asks onAccess() BEFORE the craft picker; a load where the welcome showed marks the
 //     picker asked (OTBCraftMode.markAsked), so the two never stack.
 //   - Picking a role also sets the hall's craft mode. Governing is a seat (craft-mode.js), so the
@@ -368,29 +370,43 @@
   function onAccess(access, builder) {
     if (shown) return true;
     if (deepLink()) return false;
+    var game = window.OTBShellGame;
+    var canChoose = !!(game && typeof game.start === 'function');
     if (access && access.authed === false) {
       if (!onHome()) return false;
       shown = true;
+      // The hall's front opens on Game or Classic (task 1005219): the pick is kept, the visitor
+      // signs in, and comes back to that menu (shell-game.js). Without that file, the welcome.
+      if (canChoose && game.start({
+        name: projectName(window.__BRANDING__), art: artFor(timeOfDay(new Date())),
+        signIn: function () { markSigningIn(); go(SIGNIN_HREF); },
+      })) return true;
       show(null);
       return true;
     }
     if (!access || access.authed !== true || !builder || builder.id == null) return false;
     var key = DAY_KEY + builder.id, now = new Date();
+    // Every time the site is opened, Home asks Game or Classic first (task 1005219; owner,
+    // 2026-11-12: "every visit"), and that stands in for the day's welcome.
+    var ask = canChoose && onHome() && typeof game.seen === 'function' && !game.seen();
     try {
       // Every fresh sign-in is greeted; otherwise only the day's first visit.
       var fresh = takeSignedIn();
-      if (!fresh && !firstVisitToday(window.localStorage.getItem(key), now)) return false;
+      if (!fresh && !ask && !firstVisitToday(window.localStorage.getItem(key), now)) return false;
       window.localStorage.setItem(key, localDay(now));
-    } catch (_) { return false; }
+    } catch (_) { if (!ask) return false; }
     shown = true;
     var c = craft();
-    // A fresh sign-in opens on the game's start screen instead (task 1005143, shell-game.js): the
-    // same still behind it, and the craft picker asked once the world is showing.
-    var game = window.OTBShellGame;
-    if (fresh && game && typeof game.start === 'function' && game.start({
-      name: projectName(window.__BRANDING__), art: artFor(timeOfDay(now)),
-      done: function () { if (c && typeof c.onAccess === 'function') c.onAccess(access, builder); },
-    })) return true;
+    // A fresh sign-in, or a new visit to Home, opens on the game's start screen instead (tasks
+    // 1005143, 1005219; shell-game.js): the same still behind it, and the craft picker asked once
+    // the world is showing. Classic picked before signing in: no screen, straight to the hall.
+    if ((fresh || ask) && canChoose) {
+      if (game.start({
+        name: projectName(window.__BRANDING__), art: artFor(timeOfDay(now)),
+        done: function () { if (c && typeof c.onAccess === 'function') c.onAccess(access, builder); },
+      })) return true;
+      if (fresh) return false;
+    }
     if (c && typeof c.markAsked === 'function') c.markAsked();
     show(builder);
     return true;

package/modules/hall-ui/records/start-screen.md

@@ -29,3 +29,13 @@ Tests: `tests/hall_start_screen.mjs` (the hand-off and pure parts in a vm; both
 Every sign-in now opens on a chooser before the start screen: **Game** or **Classic**, each with one line saying what it is. The view chosen last time (the browser's `hall-game` copy) is marked "Last time", lit with the accent on its edge, and focused, so Enter keeps it. Game goes on to the start screen as before; Classic closes the screen and the hall is as it always was. Either choice is saved to the account (`PATCH /api/bongos/me/hall-view`). The Extras list lost The docs: it is not a game place. Tests: `tests/hall_start_screen.mjs`.
 
 **In the start menu's shape (task 1005206, owner 2026-11-11, from the V3 Helm start-screen mock-up).** The chooser is drawn like the menu it leads to: "How do you want to see it?" is a small label in the name voice, and the view Enter takes (last time's, else Game) is the accent bar with its "Enter" key, exactly as Start is (`.gs__item--lit` shares Start's rules); the other view is a quiet row on a hairline. Each row keeps its one line; on the lit bar the line and the "Last time" tag take `--accent-on`. Focus starts on the lit row.
+
+## Land on the chooser (task 1005219, owner 2026-11-12)
+
+The hall's front (Home, `/builders`) now opens on the Game / Classic chooser **every time the site is opened**, signed in or not: one `sessionStorage` mark per tab (`hall-chooser-seen`), so moving about the hall — game mode sends a classic page Home — never asks twice. This supersedes "a new visit keeps the welcome" and "a signed-out visitor keeps the welcome" above; the painted welcome remains only for a hall without `shell-game.js` and for the day's first visit to a page other than Home.
+
+- **Signed out:** the pick is kept in `localStorage` (`hall-view-pending`) and the visitor goes to GitHub sign-in (`/api/bongos/auth/web/start`, which returns by the referer). On the return `start()` spends the pick: Game opens straight on the start screen's menu, Classic shows no screen and the hall is as it always was. Either is saved to the account then, as at the chooser.
+- **Signed in:** the pick goes straight to that menu, as at sign-in.
+- The marketing page at the apex root is unchanged (the owner's pick: the hall's front, not the apex).
+
+Tests: `tests/hall_start_screen.mjs` (the vm hand-off, and the signed-out round trip for both picks in a real browser).

package/modules/onboarding/genesis-home.js

@@ -276,6 +276,40 @@ async function startFounding(builderId, deps = {}) {
   return { ok: true, mode };
 }
 
+// isTestProject(deps) — is this hall a TEST project? The platform marks one (task 1005036,
+// modules/provisioning/test-project.js) and the mark arrives as branding project.test. Genesis is paused
+// for every other project (owner, 2026-11-01), so only a test project may switch it on by hand.
+function isTestProject(deps = {}) {
+  try {
+    const b = deps.branding !== undefined ? deps.branding : require('../../src/module-api').branding();
+    return !!(b && b.project && b.project.test === 'on');
+  } catch (_) { return false; }
+}
+
+// ownerStart(builderId, deps) — the owner's own start (POST /founding/start): a test project only.
+async function ownerStart(builderId, deps = {}) {
+  if (!isTestProject(deps)) return { ok: false, reason: 'not_a_test_project' };
+  return startFounding(builderId, deps);
+}
+
+// setEnabled(enabled, builderId, deps) — the Test features panel's genesis switch (task 1005036): a test
+// project only. On starts genesis if it never started (startFounding turns the switch on); if it already
+// began, it just turns the switch back on. Off pauses it — the founding record is kept, the hall opens full.
+async function setEnabled(enabled, builderId, deps = {}) {
+  if (!isTestProject(deps)) return { ok: false, reason: 'not_a_test_project' };
+  const s = seams(deps);
+  if (enabled === true) {
+    const started = await s.get(fm.KEYS.STARTED_AT);
+    if (!(started && started.value)) return startFounding(builderId, deps);
+    const ended = await s.get(fm.KEYS.ENDED_AT);
+    if (ended && ended.value) return { ok: false, reason: 'already_alive' };
+    await s.set(fm.KEYS.ENABLED, 'true', builderId);
+  } else {
+    await s.set(fm.KEYS.ENABLED, 'false', builderId);
+  }
+  return { ok: true, enabled: enabled === true, mode: await fm.foundingModeFor(modeDeps(s)) };
+}
+
 // savePlan — the decide stage's door: record the plan, file the five stages as tasks,
 // and move to scope. Only while deciding.
 async function savePlan(body, builderId, deps = {}) {
@@ -508,7 +542,7 @@ async function onTaskShipped(deps = {}) {
 
 module.exports = {
   PLAN_KEY, STAGE_INFO, PROPER, DEMO_PEOPLE, DEMO_HOURS, intIn, parsePlan, shapeGenesis, demoMinutes, demoPlan,
-  readGenesis, startFounding, savePlan, applyGovernmentChoice, closeStage, comeAlive, skipGenesis, onStagePassed,
+  readGenesis, startFounding, ownerStart, setEnabled, savePlan, applyGovernmentChoice, closeStage, comeAlive, skipGenesis, onStagePassed,
   putFinishedStages, onTaskShipped,
   // the founding-mode deps this file reads the mode with, for founding-birth.js (task 1004506)
   modeDepsFor: (deps) => modeDeps(seams(deps)),

package/modules/onboarding/routes/onboarding.js

@@ -124,7 +124,7 @@ const GENESIS_REFUSALS = {
   not_at_legislation: 409, legislation_not_passed: 409, stage_tasks_unfinished: 409,
   no_stage_tasks: 409, unknown_stage: 400, no_board: 503,
   bad_days: 400, bad_passes: 400, bad_advisors: 400, bad_government: 400, bad_expected_builders: 400,
-  bad_demo: 400, bad_minutes: 400,
+  bad_demo: 400, bad_minutes: 400, not_a_test_project: 403,
 };
 let genesisListening = false;
 
@@ -158,7 +158,12 @@ function mountGenesisRoutes(router) {
     await foundingBirth.ensureBirth();
     return { genesis: await genesis.readGenesis(), viewer_id: String(req.builder.id) };
   }));
-  router.post('/founding/start', api.requireBuilder, owns, handle((req) => genesis.startFounding(req.builder.id)));
+  router.post('/founding/start', api.requireBuilder, owns, handle((req) => genesis.ownerStart(req.builder.id)));
+  // The Test features panel's genesis switch (task 1005036): a test project only, the owner's call.
+  router.put('/founding/enabled', api.requireBuilder, owns, (req, res, next) => {
+    if (api.validateOrRespond(req, res, { enabled: { type: 'boolean' } })) return;
+    next();
+  }, handle((req) => genesis.setEnabled(req.body && req.body.enabled === true, req.builder.id)));
   // The plan's ranges and vocabularies are genesis-home.js parsePlan's (one source);
   // this schema only names the fields so an unknown one is refused.
   router.post('/founding/plan', api.requireBuilder, owns, (req, res, next) => {

package/modules/provisioning/catalog-bridge.js

@@ -19,6 +19,7 @@
 
 const api = require('../../src/module-api');
 const { effectiveSettings } = require('./provisioning');
+const { isTestProject } = require('./test-project');
 
 const log = api.logger('provisioning');
 
@@ -57,6 +58,8 @@ function catalogStatusForInstance(row) {
 }
 
 function catalogEntryForInstance(row, { ownerGithubId } = {}) {
+  // A test project is never on the public map (task 1005036, ./test-project.js): the honest refusal, not a failure.
+  if (isTestProject(row)) return null;
   const origin = catalogOriginForInstance(row);
   if (!origin) return null;
   const owner = Number(ownerGithubId);

package/modules/provisioning/migrations/provisioning_037_update_subscribed.sql

@@ -0,0 +1,21 @@
+-- provisioning_037_update_subscribed.sql — whether an instance takes unattended patch upgrades,
+-- stored on the instance row (task 1004150, ADR 0325 decision 5).
+--
+-- WHY. Every other fleet fact lives in provisioning_instances; "which instances the nightly sweep
+-- moves on its own" lived only in config/update-subscriptions.json. That left GET /provisioning/fleet
+-- unable to answer the one question a fleet view exists for, and let a restored control-plane backup
+-- bring back every instance row with an empty roster — the sweep then reported failed=0 while
+-- upgrading nothing. On the row, the subscription and its update_channel (provisioning_029) travel
+-- and restore together.
+--
+-- DEFAULT false: an instance is armed only by an explicit act, as the shipped-empty roster was
+-- (ADR 0136). The roster file stays honoured as an override, so an operator's current arming is
+-- not silently dropped.
+--
+-- Additive and namespaced (ADR 0083): no down-migration, idempotent — safe to re-run.
+
+BEGIN;
+
+ALTER TABLE provisioning_instances ADD COLUMN IF NOT EXISTS update_subscribed boolean NOT NULL DEFAULT false;
+
+COMMIT;