@bongos/core 1.25.6 → 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":4408,"placed":1633,"shared":369,"unplaced":2406,"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": "a9b4990d9b84e7f9",
+      "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": "84e8a3802285d54c",
+      "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": "22d64ad0bdbfb20a",
+      "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": "71ccdec4d840f239",
+      "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": "d3b4d1e3da4cbf34",
+      "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": "08ca51a52701caa7",
+      "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": "4184181832abeb8e",
+      "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": "70d8131ed9bed50a",
+      "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": "c3726270034f0886",
+      "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": "117557e051f209a0",
+      "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": "4a6b3e46f1553c25",
+      "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": "ddbd09c6c1629fd3",
+      "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": "fc89efd93f0419a9",
-      "reading_hash": "620b6c4d18b7e501",
-      "counts": {"lines":29,"placed":7,"shared":8,"unplaced":14},
+      "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": [
@@ -982,7 +982,7 @@
         {"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":"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},
@@ -996,7 +996,7 @@
       "surface": "builders",
       "title": "Idea",
       "states_read": ["record","missing"],
-      "files_hash": "27923dd71c6cc61e",
+      "files_hash": "3f72b14ed91b7803",
       "reading_hash": "f7d644748c87e426",
       "counts": {"lines":52,"placed":25,"shared":8,"unplaced":19},
       "omitted": {"data":25},
@@ -1061,7 +1061,7 @@
       "surface": "builders",
       "title": "Ideas",
       "states_read": ["compose","full","develop"],
-      "files_hash": "14fb04299f9c5294",
+      "files_hash": "69f7665f4d823b05",
       "reading_hash": "a62c05dcef3bf87f",
       "counts": {"lines":68,"placed":34,"shared":7,"unplaced":27},
       "omitted": {"data":118},
@@ -1142,7 +1142,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["desk","settings","out"],
-      "files_hash": "86254f61eee1660d",
+      "files_hash": "d85500e69e188b5f",
       "reading_hash": "30512dda207b5ea6",
       "counts": {"lines":23,"placed":11,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1178,7 +1178,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["dossier","out","propose","correct","filtered"],
-      "files_hash": "b0744b7328c2f1f6",
+      "files_hash": "ea3c71cb05717cc8",
       "reading_hash": "129bff28c4e4ed6d",
       "counts": {"lines":24,"placed":12,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1215,7 +1215,7 @@
       "surface": "builders",
       "title": "Market Watch rules",
       "states_read": ["in","scoring","names","propose","out"],
-      "files_hash": "159bc203c644dbed",
+      "files_hash": "6f513cf7cdfe92ae",
       "reading_hash": "ca0c62e8dce51c8b",
       "counts": {"lines":36,"placed":12,"shared":7,"unplaced":17},
       "omitted": {"data":20},
@@ -1264,7 +1264,7 @@
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "a19bba03c78ce50a",
+      "files_hash": "2d24a52c632cde42",
       "reading_hash": "6a12e9306bba5622",
       "counts": {"lines":59,"placed":29,"shared":7,"unplaced":23},
       "omitted": {"data":107},
@@ -1336,7 +1336,7 @@
       "surface": "builders",
       "title": "Money",
       "states_read": ["money","hosting","out"],
-      "files_hash": "f521ccd6c8c5928c",
+      "files_hash": "6096846da3462763",
       "reading_hash": "e355d5466b123e07",
       "counts": {"lines":83,"placed":28,"shared":7,"unplaced":48},
       "omitted": {"data":27},
@@ -1432,7 +1432,7 @@
       "surface": "builders",
       "title": "My agents",
       "states_read": ["desk","factory","saved","what-it-knows","speciality-walk","speciality-forms","nobody"],
-      "files_hash": "aaf60004a2341d14",
+      "files_hash": "9c2b1b8aaf468c84",
       "reading_hash": "5347e0496b38727d",
       "counts": {"lines":100,"placed":33,"shared":7,"unplaced":60},
       "omitted": {"data":38},
@@ -1545,7 +1545,7 @@
       "surface": "builders",
       "title": "Primer",
       "states_read": ["in","toc-open","jump","out"],
-      "files_hash": "4ba10f0fe35fcf02",
+      "files_hash": "40d793bc1f676419",
       "reading_hash": "85790bd421e5c387",
       "counts": {"lines":487,"placed":57,"shared":7,"unplaced":423},
       "omitted": {"data":18},
@@ -2045,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": "1f829822c59de8d6",
+      "files_hash": "2e5aad6962c3c8b3",
       "reading_hash": "3ff8d703d17e8c2a",
       "counts": {"lines":232,"placed":84,"shared":7,"unplaced":141},
       "omitted": {"data":263},
@@ -2290,7 +2290,7 @@
       "surface": "builders",
       "title": "Project settings",
       "states_read": ["default"],
-      "files_hash": "22d9382cc6f62dcd",
+      "files_hash": "3dde20d38f2c06da",
       "reading_hash": "283df27d0d5bfc1b",
       "counts": {"lines":43,"placed":25,"shared":7,"unplaced":11},
       "omitted": {"data":33},
@@ -2346,7 +2346,7 @@
       "surface": "builders",
       "title": "Builders",
       "states_read": ["roster","artists","search","out"],
-      "files_hash": "20931556211ad519",
+      "files_hash": "fd4aafc69104eed7",
       "reading_hash": "665ac2e36339f5d3",
       "counts": {"lines":56,"placed":17,"shared":7,"unplaced":32},
       "omitted": {"data":137},
@@ -2415,7 +2415,7 @@
       "surface": "builders",
       "title": "Options",
       "states_read": ["account","access","preferences","install-reports","sound","update"],
-      "files_hash": "16028f41e693ccde",
+      "files_hash": "6f61674891ca294c",
       "reading_hash": "898a13fda24c3c90",
       "counts": {"lines":162,"placed":104,"shared":7,"unplaced":51},
       "omitted": {"data":23},
@@ -2590,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": "e2df36c75a82662a",
+      "files_hash": "0824158dfe86879b",
       "reading_hash": "e788e6bf4be8d68c",
       "counts": {"lines":325,"placed":54,"shared":6,"unplaced":265},
       "omitted": {"data":240},
@@ -2928,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": "fe0a3ca248e50554",
+      "files_hash": "b5217f22546d2ca2",
       "reading_hash": "c4e3b4188c1db755",
       "counts": {"lines":51,"placed":29,"shared":7,"unplaced":15},
       "omitted": {"data":23},
@@ -2992,7 +2992,7 @@
       "surface": "builders",
       "title": "Task",
       "states_read": ["record","from-goal","missing"],
-      "files_hash": "44063a120d39cba9",
+      "files_hash": "9a949acc81a483c6",
       "reading_hash": "8dd803b6934e6388",
       "counts": {"lines":151,"placed":46,"shared":9,"unplaced":96},
       "omitted": {"data":111},
@@ -3156,7 +3156,7 @@
       "surface": "builders",
       "title": "Your thinking",
       "states_read": ["tour","sky","list","simple","full-idea","full","full-list","full-back","out"],
-      "files_hash": "511ee89d9ee0ab96",
+      "files_hash": "109968f4f22ab7b4",
       "reading_hash": "b73f848b46b0f9b8",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -3219,7 +3219,7 @@
       "surface": "builders",
       "title": "Tweak a page",
       "states_read": ["doc","typed","chrome","submitted","picking","out"],
-      "files_hash": "9bc999d8335172c8",
+      "files_hash": "a9131745a366382f",
       "reading_hash": "f521f8d9a7147557",
       "counts": {"lines":26,"placed":18,"shared":2,"unplaced":6},
       "omitted": {"data":19},
@@ -3258,7 +3258,7 @@
       "surface": "builders",
       "title": "Watch",
       "states_read": ["board","out","operations","security","sessions","autobongos"],
-      "files_hash": "3a3894aedea11977",
+      "files_hash": "b6a3ff14b1b63837",
       "reading_hash": "1961a0c06b9d8477",
       "counts": {"lines":72,"placed":33,"shared":7,"unplaced":32},
       "omitted": {"data":52},
@@ -3343,7 +3343,7 @@
       "surface": "builders",
       "title": "Tasks",
       "states_read": ["ready","in-progress","backlog","completed","filters-open","out","founding"],
-      "files_hash": "34f5b6e547c2319f",
+      "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.',
@@ -440,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
@@ -527,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) {
@@ -537,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);

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

@@ -313,6 +313,16 @@
   /* THE PLATE ON THE SKY (task 1005196): words and controls that sit on the hour's sky stand
      on a small plate of the night, sized to what it holds, never on a darkened sky. */
   --night-plate: color-mix(in srgb, var(--bg) 88%, transparent);
+  /* THE SMOKED PANE (task 1005252, the owner's pick from the glass lab): a plate on the visor
+     blurs what is behind it, so a scene's own words and marks (a screenshot of the hall under
+     review carries a visor of its own) go soft instead of reading as a second visor. Lighter
+     than the plate, but the backdrop is dimmed too, so ice on it still holds AA over a white
+     sky; a lit top edge makes it a pane. Where blur is missing or less transparency is asked
+     for, the plate stays the night plate. */
+  --smoke:       color-mix(in srgb, var(--bg) 62%, transparent);
+  --smoke-blur:  blur(14px) saturate(.8) brightness(.85);
+  --smoke-sheen: linear-gradient(to bottom, color-mix(in srgb, var(--ink-soft) 16%, transparent), transparent 40%);
+  --smoke-edge:  inset 0 1px 0 color-mix(in srgb, var(--ink-soft) 35%, transparent), inset 0 -1px 0 color-mix(in srgb, var(--bg) 60%, transparent);
   --line-strong: 1.5px;
   --helm-panel-w: 400px;
   --helm-row:     60px;
@@ -504,6 +514,14 @@ html[data-faces="helm"] {
   --font-body:    var(--helm-body);
 }
 
+/* Less transparency asked for (task 1005252): the visor's smoked panes go back to plates of the
+   night. `html` lifts it over visor.css, which loads after this sheet. */
+@media (prefers-reduced-transparency: reduce) {
+  html .visor__place, html .visor__who, html .visor__hint, html .visor__progress-words {
+    background: var(--night-plate); box-shadow: none; -webkit-backdrop-filter: none; backdrop-filter: none;
+  }
+}
+
 /* The Kill Switch Rule (DESIGN.md). Nothing escapes it, and no motion is
    authored in JavaScript, because JavaScript motion escapes it. */
 @media (prefers-reduced-motion: reduce) {
@@ -891,6 +909,9 @@ html[data-theme="dark"] .brand-mark__mark { --mark-ink: #e2e1e4; }
   html[data-game="on"] .visor__hint:not([data-visor-sheet]) { display: none; }
   html[data-game="on"] .visor__hint--sheet { min-width: 44px; justify-content: center; }
   html[data-game="on"] .visor__hint--sheet .visor__dots { display: block; }
+  /* task 1005252: a phone keeps the night plate, not the smoked pane — a live blur under a HUD
+     that the scene pans beneath is the costly kind of drawing, and a phone has the weakest GPU */
+  html[data-game="on"] .visor__who, html[data-game="on"] .visor__hint { background: var(--night-plate); box-shadow: none; -webkit-backdrop-filter: none; backdrop-filter: none; }
   html[data-game="on"] .visor__hint--sheet > :not(.visor__dots) { position: absolute; width: 1px; height: 1px; padding: 0; border: 0; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
   html[data-game="on"] .visor__main .visor__key { display: none; }
   html[data-game="on"] .visor__sheet { bottom: calc(var(--visor-inset-bottom) + 112px); max-height: 60vh; }
@@ -1516,6 +1537,44 @@ html.opt-window-open { overflow: hidden; }
 }
 .opt-window__x:hover { color: var(--ink); background: var(--glass); }
 .opt-window__x:focus-visible { outline: 0; box-shadow: var(--press-focus); }
+/* THE GAME MENU (shell-game.js openMenu, task 1005250): game mode's Escape. One small
+   night panel over the place, its rows stacked as buttons in three runs (what you can
+   open, leaving, going back); Return to game is the one lit row. */
+html.game-menu-open { overflow: hidden; }
+.game-menu { position: fixed; inset: 0; z-index: var(--z-modal); display: grid; place-items: center; }
+.game-menu[hidden] { display: none; }
+.game-menu::before { content: ''; position: absolute; inset: 0; background: var(--scrim); opacity: .33; pointer-events: none; }
+.game-menu__box {
+  position: relative; box-sizing: border-box;
+  width: min(300px, calc(100vw - 32px)); max-height: calc(100vh - 32px); overflow-y: auto;
+  padding: var(--ds-space-md);
+  background: var(--night-glass);
+  border: var(--line-strong) solid var(--rule);
+  border-radius: var(--press-radius);
+  box-shadow: var(--ds-shadow-pop);
+}
+.game-menu__title {
+  margin: 0 0 var(--ds-space-md); text-align: center;
+  font-family: var(--name-face); font-size: var(--ds-text-xl); font-weight: var(--name-weight);
+  letter-spacing: var(--name-space); text-transform: var(--name-case); color: var(--ink);
+}
+.game-menu__items { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--ds-space-xs); }
+.game-menu__gap { margin-top: var(--ds-space-sm); }
+.game-menu__item {
+  display: flex; align-items: center; justify-content: center; box-sizing: border-box;
+  width: 100%; min-height: 40px; padding: var(--ds-space-hair) var(--ds-space-sm);
+  background: var(--glass); color: var(--ink);
+  border: var(--line) solid var(--rule); border-radius: var(--press-radius);
+  font-family: var(--name-face); font-size: var(--ds-text-xl); font-weight: 400;
+  letter-spacing: var(--name-space); text-transform: var(--name-case); text-align: center;
+  text-decoration: none; cursor: pointer;
+}
+.game-menu__item:hover { color: var(--ink); border-color: var(--ink-soft); text-decoration: none; }
+.game-menu__item:focus-visible { outline: 0; box-shadow: var(--press-focus); }
+.game-menu__item--lit { background: var(--accent); color: var(--accent-on); border-color: transparent; font-weight: var(--name-weight-lit); }
+.game-menu__item--lit:hover { background: var(--accent-lift); color: var(--accent-on); border-color: transparent; }
+.game-menu__note { margin: var(--ds-space-sm) 0 0; font-size: var(--ds-text-md); line-height: 1.5; text-align: center; text-wrap: pretty; color: var(--ink); }
+.game-menu__note[hidden] { display: none; }
 /* Said once on entering, since the choice is remembered and a page can open in it. */
 .fullscreen-hint {
   position: fixed;

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

@@ -79,6 +79,17 @@ html[data-game="on"] .visor:not([hidden]) {
   font-size: var(--ds-text-xs); letter-spacing: var(--name-space); line-height: 1; color: var(--ink-soft);
   padding: var(--ds-space-hair) var(--ds-space-xs); background: var(--night-plate); clip-path: var(--cut-path-sm);
 }
+/* smoked glass (task 1005252): where the browser can blur, each plate is a pane of smoked glass
+   that softens the scene behind it, so a scene that carries marks of its own (the review of a
+   hall screenshot) cannot line up with ours. Still sized to its words: the sky outside the
+   plates is untouched. Asking for less transparency puts the night plate back (style.css,
+   beside the Kill Switch, since the visor adds no media query of its own). */
+@supports ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
+  .visor__place, .visor__who, .visor__hint, .visor__progress-words {
+    background: var(--smoke-sheen), var(--smoke); box-shadow: var(--smoke-edge);
+    -webkit-backdrop-filter: var(--smoke-blur); backdrop-filter: var(--smoke-blur);
+  }
+}
 
 /* the foot row: you on the left, the one thing to press in the middle, the key hints on the
    right. The two side groups lean in a little, as the glass curves. */

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

@@ -16,8 +16,9 @@
 //     went with it).
 //     Centre: your character's main action, the one accent button, with its key. Right: the
 //     quiet key hints, no boxes: your other actions and "Actions" (key A), which opens the
-//     sheet (your character's actions, then the keys of the place you are in, then Options on
-//     a key of its own; Escape closes it). Options is only in the sheet (task 1005248).
+//     sheet (your character's actions, then the keys of the place you are in, then the game
+//     menu on a key of its own; Escape closes it). It is only in the sheet (task 1005248; the
+//     game menu since task 1005250).
 //   - every key comes from resolveKeys: one owner per key, never two (task 1005248).
 //
 // The rules it keeps (ADR 0399):
@@ -65,7 +66,9 @@
   };
   var SHEET_KEY = 'a';
   var CLOSE_KEY = 'esc';   // shown once: the sheet's Close (Escape)
-  var OPTIONS = { id: 'options', label: 'Options', key: 'o', href: '/settings' };
+  // The sheet's last row is the game menu (options, log out, exit; task 1005250): shell-game.js
+  // opens it for a data-game-menu link, and the address (the options) is the fallback.
+  var OPTIONS = { id: 'options', label: 'Game menu', key: 'm', href: '/settings' };
   // Keys a scene binds on its own page (the sky's L 0 / ?, the gallery's F, the palette's K).
   // A moved key never lands on one of them; a scene that declares one keeps it.
   var AVOID = ['l', '0', '/', '?', 'f', 'k', '+', '-', '='];
@@ -377,7 +380,7 @@
         '<button class="visor__close" type="button" data-visor-close aria-label="Close actions">' + keyHtml(CLOSE_KEY) + '</button></div>' +
       '<p class="visor__cap">' + esc(NAMES[id]) + '</p><ul class="visor__rows">' + rows + '</ul>' +
       (place ? '<p class="visor__cap">This place</p><ul class="visor__rows">' + place + '</ul>' : '') +
-      '<ul class="visor__rows"><li><a class="visor__row" data-visor-act="options" href="' + esc(hallHref(keys.options.href)) + '"><span>' + esc(keys.options.label) + '</span>' + keyHtml(keys.options.key) + '</a></li></ul>';
+      '<ul class="visor__rows"><li><a class="visor__row" data-visor-act="options" data-game-menu href="' + esc(hallHref(keys.options.href)) + '"><span>' + esc(keys.options.label) + '</span>' + keyHtml(keys.options.key) + '</a></li></ul>';
   }
   function shown() { return !!(root && !root.hidden); }
   function render() {
@@ -460,6 +463,7 @@
       return;
     }
     // Options opens the game's options window over the place when it can (shell-game.js)
+    if (a.id === OPTIONS.id && window.OTBGameMenu && typeof window.OTBGameMenu.open === 'function') { window.OTBGameMenu.open(); return; }
     if (a.id === OPTIONS.id && window.OTBOptionsOverlay && typeof window.OTBOptionsOverlay.open === 'function') { window.OTBOptionsOverlay.open(); return; }
     if (a.href) window.location.assign(hallHref(a.href));
   }
@@ -475,6 +479,7 @@
     if (t.closest('[data-visor-unfocus]')) { dropFocus(); return; }
     if (t.closest('[data-visor-lead]')) { if (focus && focus.lead && !focus.lead.busy) { closeSheet(false); focus.lead.run(); } return; }
     if (t.closest('[data-visor-sheet]')) { openSheet(); return; }
+    if (t.closest('[data-game-menu]')) { closeSheet(false); return; } // shell-game.js opens the menu
     // You: your profile in the game's window, the place still drawn behind it. With no
     // window (shell-game.js absent), the link opens the profile page.
     if (t.closest('[data-visor-me]')) {
@@ -502,7 +507,11 @@
   function busy() {
     var html = document.documentElement;
     if (html.classList && (html.classList.contains('craft-picker-open') || html.classList.contains('gs-open'))) return true;
-    return !!document.querySelector('dialog[open], [aria-modal="true"]');
+    // a dialog that is up: one bound once keeps aria-modal while it is hidden (the options
+    // window, the game menu), and a hidden one must not hold the keys (task 1005250)
+    var up = document.querySelectorAll('dialog[open], [aria-modal="true"]');
+    for (var i = 0; i < up.length; i++) if (!up[i].closest('[hidden]')) return true;
+    return false;
   }
   // Which action (or the sheet) a key press means, or null. Pure, for the tests.
   function keyFor(id, e) {