@bongos/core 1.25.5 → 1.25.7

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":1634,"shared":369,"unplaced":2405,"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": "3d35f6429c350fff",
       "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": "edfe4cc950edf0d4",
       "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": "f922e0329e8eb75f",
       "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": "4e378a78e17d9366",
       "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": "914cb0dece28a131",
       "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": "3a06128fed49c33c",
       "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": "706fcc645c941fde",
       "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": "d9a01382c115a92a",
       "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": "b39bb32c17c12975",
       "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": "c8473c8bd6bfcff3",
       "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": "ac39a09e8a923863",
       "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": "ea32e1399fe5b394",
       "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": "db319ffd04ab0951",
+      "reading_hash": "c5f4986bd90e2a2a",
+      "counts": {"lines":29,"placed":8,"shared":8,"unplaced":13},
       "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":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232"},
+        {"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": "3f72b14ed91b7803",
       "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": "69f7665f4d823b05",
       "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": "d85500e69e188b5f",
       "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": "ea3c71cb05717cc8",
       "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": "6f513cf7cdfe92ae",
       "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": "2d24a52c632cde42",
       "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": "6096846da3462763",
       "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": "9c2b1b8aaf468c84",
       "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": "40d793bc1f676419",
       "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": "2e5aad6962c3c8b3",
       "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": "3dde20d38f2c06da",
       "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": "fd4aafc69104eed7",
       "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": "6f61674891ca294c",
       "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": "0824158dfe86879b",
       "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": "b5217f22546d2ca2",
       "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": "9a949acc81a483c6",
       "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": "109968f4f22ab7b4",
       "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": "a9131745a366382f",
       "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": "b6a3ff14b1b63837",
       "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": "fb251657db11b790",
       "reading_hash": "e9b412d1ec59ceee",
       "counts": {"lines":122,"placed":49,"shared":7,"unplaced":66},
       "omitted": {"data":323},

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

@@ -103,7 +103,7 @@
     { label: 'The atlas', href: '/atlas' },
   ];
   var TIPS = [
-    'Escape opens the options menu, where every setting lives.',
+    'Escape opens the game menu: options, log out and exit.',
     'Every tower is a goal. It gains a floor each time work ships under it.',
     'A crane marks a site someone worked on this week.',
     'A salmon dot on a tower means something there is waiting on you.',
@@ -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;
@@ -409,10 +440,103 @@
       if (host && host.OTBOptions && typeof host.OTBOptions.escape === 'function') { host.OTBOptions.escape(); return; }
       if (host && host.OTBOptionsOverlay && host.OTBOptionsOverlay.isOpen()) { host.OTBOptionsOverlay.close(); return; }
       if (embedded) return;
-      openOverlay();
+      if (menuOpen()) { closeMenu(); return; }
+      openMenu();
     }, 0);
   }
 
+  // ---------- the game menu (task 1005250) ----------
+  // Game mode has no sidebar, so it had no way to sign out or to quit. The last Escape (and
+  // the visor's Menu hint and the Actions sheet's last row) now opens ONE small menu over the
+  // place, as a game does: Options (the options window below), Change character, Log out,
+  // Exit game, Return to game. It is the hall's shared dialog (OTBDialog.bind): Escape, the
+  // scrim, the focus trap and the focus return are its. A new advanced action is one row in
+  // GAME_MENU and one line in onMenuClick. Rules: modules/hall-ui/records/game-menu.md.
+  var GAME_MENU = [
+    { id: 'options', label: 'Options' },
+    { id: 'character', label: 'Change character' },
+    // shell.js turns a click on any link to the logout address into the real sign-out
+    { id: 'logout', label: 'Log out', href: '/api/bongos/auth/logout', gap: true },
+    { id: 'exit', label: 'Exit game' },
+    { id: 'return', label: 'Return to game', gap: true },
+  ];
+  var menuEl = null, menuDlg = null;
+  function menuOpen() { return !!(menuDlg && menuDlg.isOpen()); }
+  function closeMenu() { if (menuOpen()) menuDlg.close(); }
+  // Change character is craft-mode.js's; a page without it shows no such row.
+  function menuRows() {
+    var C = window.OTBCraftMode;
+    return GAME_MENU.filter(function (m) { return m.id !== 'character' || !!(C && typeof C.changeCharacter === 'function'); });
+  }
+  function menuRowHtml(m) {
+    var attrs = ' class="game-menu__item' + (m.id === 'return' ? ' game-menu__item--lit' : '') + '" data-gm="' + m.id + '"';
+    return '<li' + (m.gap ? ' class="game-menu__gap"' : '') + '>' +
+      (m.href ? '<a' + attrs + ' href="' + esc(m.href) + '">' + esc(m.label) + '</a>' : '<button type="button"' + attrs + '>' + esc(m.label) + '</button>') + '</li>';
+  }
+  var exitTimer = 0;
+  // Any new word in the note (a fresh opening clears it) drops a pending Exit check, so an
+  // Exit pressed just before the menu was shut cannot speak into the next opening.
+  function menuSay(text) {
+    clearTimeout(exitTimer); exitTimer = 0;
+    var note = menuEl && menuEl.querySelector('.game-menu__note');
+    if (!note) return;
+    note.textContent = text;
+    note.hidden = !text;
+  }
+  // Exit closes the tab. A browser only lets a script close a tab a script opened, so when
+  // the tab is still here a moment later the menu says so (the start screen's Quit, again).
+  function exitGame() {
+    try { window.close(); } catch (_) { /* refused */ }
+    clearTimeout(exitTimer);
+    exitTimer = setTimeout(function () { exitTimer = 0; if (menuOpen()) menuSay('Your browser kept this tab open. Close it to quit.'); }, 300);
+  }
+  function onMenuClick(e) {
+    var el = e.target && e.target.closest ? e.target.closest('[data-gm]') : null;
+    var id = el ? el.getAttribute('data-gm') : '';
+    if (id === 'return') closeMenu();
+    else if (id === 'options') { closeMenu(); openOverlay(); }
+    else if (id === 'character') { closeMenu(); window.OTBCraftMode.changeCharacter(); }
+    else if (id === 'exit') exitGame();
+    else if (id === 'logout') menuSay('Logging out');
+  }
+  // The arrows walk the rows, as on the start screen (Tab is the dialog's own trap).
+  function onMenuKey(e) {
+    var step = e.key === 'ArrowDown' ? 1 : e.key === 'ArrowUp' ? -1 : 0;
+    if (!step || !menuEl) return;
+    var rows = Array.prototype.slice.call(menuEl.querySelectorAll('[data-gm]'));
+    if (!rows.length) return;
+    e.preventDefault();
+    var at = rows.indexOf(document.activeElement);
+    rows[(at + step + rows.length) % rows.length].focus();
+  }
+  function openMenu() {
+    try { buildMenu(); } catch (_) {
+      // No menu can be drawn here: the options, as before the game menu existed.
+      menuEl = null; menuDlg = null;
+      openOverlay();
+    }
+  }
+  function buildMenu() {
+    if (!menuEl) {
+      if (!window.OTBDialog || typeof window.OTBDialog.bind !== 'function') throw new Error('no dialog');
+      menuEl = document.createElement('div');
+      menuEl.className = 'game-menu';
+      menuEl.hidden = true;
+      menuEl.addEventListener('click', onMenuClick);
+      menuEl.addEventListener('keydown', onMenuKey);
+      menuEl.innerHTML = '<div class="game-menu__box" aria-labelledby="game-menu-title">' +
+        '<h2 class="game-menu__title" id="game-menu-title">Game menu</h2>' +
+        '<ul class="game-menu__items"></ul>' +
+        '<p class="game-menu__note" role="status" hidden></p></div>';
+      document.body.appendChild(menuEl);
+      menuDlg = window.OTBDialog.bind(menuEl, { panel: menuEl.querySelector('.game-menu__box'), lockClass: 'game-menu-open' });
+    }
+    // The rows are drawn at each opening: they follow what the page has, and the note starts empty.
+    menuEl.querySelector('.game-menu__items').innerHTML = menuRows().map(menuRowHtml).join('');
+    menuSay('');
+    menuDlg.open();
+  }
+
   // ---------- the options window (game mode) ----------
   // In game mode the options menu opens as a window OVER the place you are in, not
   // as a page of its own, so the place stays drawn behind it and its colours show
@@ -496,6 +620,7 @@
   function overlayHere() { return on() && !(document.body && document.body.getAttribute('data-page') === 'settings'); }
   if (!embedded) {
     window.OTBOptionsOverlay = { open: openOverlay, openProfile: openProfile, close: closeOverlay, isOpen: overlayOpen };
+    window.OTBGameMenu = { open: openMenu, close: closeMenu, isOpen: menuOpen };
     // A link to the menu (the visor's Options row, the profile chip, the start
     // screen's Options) opens the window in game mode instead of leaving the place.
     if (document.addEventListener) document.addEventListener('click', function (e) {
@@ -506,6 +631,8 @@
       try { to = new URL(a.getAttribute('href'), window.location.href); } catch (_) { return; }
       if (to.origin !== window.location.origin || to.pathname.replace(/\.html$/, '') !== menuPath()) return;
       e.preventDefault();
+      // the visor's Menu hint and the Actions sheet's last row: the game menu, not the options
+      if (a.getAttribute('data-game-menu') !== null) { openMenu(); return; }
       var q = to.search.replace(/([?&])from=[^&#]*&?/, '$1').replace(/[?&]$/, '');
       openOverlay(q + to.hash);
     }, true);
@@ -522,6 +649,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 };
 })();