@bongos/core 1.24.78 → 1.24.80

package/modules/hall-ui/public/speciality-tools.js

@@ -621,8 +621,7 @@
                   <span>Role it sits under</span>
                   <select name="discipline" required>
                     <option value="">Pick one…</option>
-                    <option value="engineer">Engineer</option>
-                    <option value="ideator">Ideator</option>
+                    <option value="artisan">Artisan</option>
                     <option value="artist">Artist</option>
                     <option value="ui">UI design</option>
                   </select>

package/modules/hall-ui/public/street-inside.js

@@ -81,7 +81,6 @@
     let top = h;
     if (craft === 'artist') { const bh = Math.round(h * 0.8); S.box(out, T, x, 0, w, bh, T.work, { d: 6, win: true, lit: lit }); S.sawtooth(out, x, -bh, w, 3, 12, T.roof, T.glass); top = bh + 12; }
     else if (craft === 'ui') { S.box(out, T, x, 0, w, h, T.glass, { d: 6, grid: 3 }); S.box(out, T, x - 2, 0, w + 4, 4, T.roof, { d: 6, z: h }); top = h + 4; }
-    else if (craft === 'ideator') { S.box(out, T, x, 0, w, 22, T.work, { d: 6, door: true }); S.gable(out, x, -22, w, 14, T.roof); top = 36; }
     else S.box(out, T, x, 0, w, h, T.work, { d: 6, win: true, lit: lit });
     if (!lit) {
       const fx = x + w / 2;
@@ -410,7 +409,7 @@
         stageEdge: p.draw === 'awaiting a tester' ? 'rgba(251,149,105,0.6)' : T.ruleStrong,
       })),
       legend: [
-        { key: 'a', text: 'Shape is the craft: tower for engineer, studio roof for artist, glass front for UI, a small pavilion for ideator.' },
+        { key: 'a', text: 'Shape is the craft: tower for artisan, studio roof for artist, glass front for UI.' },
         { key: 'b', text: 'Stage is the status: staked plot, slab, scaffold, built, then lit once shipped. A flag means it waits on a check.' },
       ],
     };
@@ -670,7 +669,7 @@
   }
 
   // ---------- the real districts ----------
-  const CRAFTS = Object.freeze(['engineer', 'artist', 'ui', 'ideator']);
+  const CRAFTS = Object.freeze(['artisan', 'artist', 'ui']);
   // A task's status as the prototype's construction stage: [drawing stage, pill words].
   const STAGES = Object.freeze({
     shipped: ['shipped', 'shipped'], confirmed: ['graded · landing', 'graded · landing'], completed: ['being graded', 'being graded'],
@@ -699,7 +698,7 @@
     const shown = mine.slice().sort((a, b) => rank(a) - rank(b) || recent(a) - recent(b) || Number(a.id) - Number(b.id)).slice(0, MAX_ITEMS)
       .sort((a, b) => PIPELINE.indexOf(a.status) - PIPELINE.indexOf(b.status) || Number(a.id) - Number(b.id));
     const items = shown.map((t) => {
-      const craft = CRAFTS.indexOf(t.discipline) >= 0 ? t.discipline : 'engineer';
+      const craft = CRAFTS.indexOf(t.discipline) >= 0 ? t.discipline : 'artisan';
       const st = STAGES[t.status];
       const built = ['ready', 'backlog'].indexOf(st[0]) < 0;
       return [String(t.title || 'task ' + t.id), String(t.kind || 'task'), craft, st[0], built ? taskHeight(t) : 0, st[1], '/builders/task/' + encodeURIComponent(t.id)];

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

@@ -10,7 +10,7 @@
   <!-- The faces (Manrope, JetBrains Mono) come from the branding pack's font
        links, injected into this head by the server like every hall page's
        (tests/hall_tokens.mjs: no hall page hardcodes a web-font stylesheet). -->
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/street.css?v=2026-10-09-living3">
   <link rel="stylesheet" href="/builders/street-card.css?v=2026-10-04-record1">
   <link rel="stylesheet" href="/builders/street-deck.css?v=2026-10-17-tidy">
@@ -229,10 +229,10 @@
 </div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1"></script>

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

@@ -12,7 +12,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/studio.css?v=2026-10-09-day">
   <link rel="stylesheet" href="/builders/approval-queue.css?v=2026-09-29-aqfix">
   <link rel="stylesheet" href="/builders/home-gallery.css?v=2026-11-04-studio">
@@ -222,10 +222,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <!-- The kit, for its ONE renderer: the full-size ship-time visual figure
@@ -243,7 +243,7 @@
 <script src="/builders/studio-lib.js?v=2026-10-09-day"></script>
 <script src="/builders/ai-studio-lib.js?v=2026-10-29-ais1"></script>
 <script src="/builders/studio.js?v=2026-10-09-day"></script>
-<script src="/builders/home-gallery.js?v=2026-11-04-studio"></script>
+<script src="/builders/home-gallery.js?v=2026-11-10-options"></script>
 <script src="/builders/home-studio.js?v=2026-11-04-studio"></script>
 </body>
 </html>

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

@@ -712,6 +712,16 @@ html[data-theme="dark"] .brand-mark__mark { --mark-ink: #e2e1e4; }
   .founding-band { flex-wrap: wrap; row-gap: 2px; padding: 8px 16px; }
   .founding-band__desc { display: none; }
   .founding-band__stage { margin-left: 0; white-space: normal; }
+  /* task 1005148, the visor (visor.css): the top of a phone belongs to the scene and the shell’s
+     corner buttons, so the compass and the place line step aside and all three pills share the
+     bottom row: the main action, Actions (its dots and key only), the sprite with the credits. */
+  html[data-game="on"] .visor:not([hidden]) { --visor-inset-right: var(--ds-space-gutter-narrow); --visor-inset-left: var(--ds-space-gutter-narrow); --visor-inset-bottom: 40px; }
+  html[data-game="on"] .visor__place, html[data-game="on"] .visor__cell, html[data-game="on"] .visor__mark { display: none; }
+  html[data-game="on"] .visor__pill--actions { top: auto; right: auto; left: 50%; bottom: var(--visor-inset-bottom); transform: translateX(-50%); padding: 0 var(--ds-space-xs); }
+  html[data-game="on"] .visor__pill--actions > span:not(.visor__dots) { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
+  html[data-game="on"] .visor__sheet { top: auto; bottom: calc(var(--visor-inset-bottom) + 56px); right: var(--visor-inset-right); max-height: 70vh; }
+  html[data-game="on"] .visor__me .visor__name { display: none; }
+  html[data-game="on"] .visor__me { padding: 4px var(--ds-space-xs) 4px 4px; }
 }
 /* task 1004424 (BV2.PS10): THE FOUNDING MARK. A pill in .rank-badge's grammar (same
    height, type and radius) so it sits beside a rank without competing with it; the
@@ -1255,7 +1265,15 @@ html[data-fullscreen="on"] .app-topbar {
   pointer-events: none;
 }
 html[data-fullscreen="on"] .app-topbar > :not(.topbar-side),
-html[data-fullscreen="on"] .topbar-side > :not(.fullscreen-toggle) { display: none; }
+html[data-fullscreen="on"] .topbar-side > :not(.fullscreen-toggle):not(.upd-pill) { display: none; }
+/* task 1005191: the Update pill stays with the bars away. Game mode opens every page
+   this way, and an update nobody can see is an update nobody takes. */
+html[data-fullscreen="on"] .upd-pill {
+  pointer-events: auto;
+  min-height: 36px;
+  margin-right: 8px;
+  box-shadow: var(--shadow-pop);
+}
 /* task 1004430: the way back must read on ANY ground. The hall's glass is
    near-clear, so over the black sky in the light theme it was a dark glyph on
    black — the page looked stuck without its bars. The card tone plus a drop
@@ -1281,6 +1299,16 @@ html[data-fullscreen="on"] .fullscreen-toggle:hover { color: var(--accent-ink);
 /* A page with no full-screen layout of its own steps its content clear of the
    corner button; the sky and the studio lay themselves out (shell.js `plain`). */
 html[data-fullscreen="on"][data-fullscreen-plain="on"] .app-content { padding-top: 60px; }
+/* EMBEDDED (html[data-embed="on"], shell-game.js; task 1005144, ADR 0401): a screen
+   opened inside the options menu's frame. The menu is the chrome, so the page keeps
+   none of its own — no sidebar, scrim, foot or top bar — and sits on the frame's
+   ground. The page keeps its one <header> in the DOM (hidden), as full screen does. */
+html[data-embed="on"] .app-sidebar,
+html[data-embed="on"] .app-scrim,
+html[data-embed="on"] .app-foot,
+html[data-embed="on"] .app-topbar { display: none; }
+html[data-embed="on"] .app-body { margin-left: 0; }
+html[data-embed="on"] .app-content { padding-top: 0; }
 /* Said once on entering, since the choice is remembered and a page can open in it. */
 .fullscreen-hint {
   position: fixed;
@@ -1313,7 +1341,8 @@ html[data-fullscreen="on"][data-fullscreen-plain="on"] .app-content { padding-to
   flex-shrink: 0;
 }
 .craft-switch__opt,
-.craft-switch__open {
+.craft-switch__open,
+.craft-switch__me {
   display: inline-flex;
   align-items: center;
   gap: 6px;
@@ -1330,10 +1359,12 @@ html[data-fullscreen="on"][data-fullscreen-plain="on"] .app-content { padding-to
   white-space: nowrap;
 }
 .craft-switch__opt:hover,
-.craft-switch__open:hover { color: var(--ink); background: var(--glass); }
+.craft-switch__open:hover,
+.craft-switch__me:hover { color: var(--ink); background: var(--glass); }
 .craft-switch__opt[aria-pressed="true"] { color: var(--ink); background: var(--glass-strong); }
 .craft-switch__opt:focus-visible,
-.craft-switch__open:focus-visible { outline: 2px solid var(--focus); outline-offset: 1px; }
+.craft-switch__open:focus-visible,
+.craft-switch__me:focus-visible { outline: 2px solid var(--focus); outline-offset: 1px; }
 .craft-switch__icon { width: 15px; height: 15px; flex-shrink: 0; }
 .craft-switch__open { display: none; }
 @media (max-width: 1180px) {
@@ -1344,7 +1375,23 @@ html[data-fullscreen="on"][data-fullscreen-plain="on"] .app-content { padding-to
   .craft-switch { padding: 2px; }
   .craft-switch__opt[aria-pressed="false"] { display: none; }
   .craft-switch--unset .craft-switch__open { display: inline-flex; padding: 0 7px; }
-}
+  .craft-switch__me { padding: 0 2px; }
+  .craft-switch__me .craft-switch__label { display: none; }
+}
+
+/* THE CHARACTER (task 1005147). A builder who holds a character wears its sprite in
+   the top bar in place of the switch: one button, which offers "Change character"
+   (signing out). The sprites are pixel art, so they scale by whole pixels. */
+.craft-sprite { display: block; image-rendering: pixelated; object-fit: contain; }
+.craft-switch__me { padding: 0 10px 0 4px; color: var(--ink); }
+/* The chip is the figure's head: the portrait cropped round its top third. */
+.craft-sprite--chip { width: 26px; height: 26px; border-radius: var(--radius-pill); object-fit: cover; object-position: 50% 22%; }
+/* Character creation: each door is the owner's portrait — the figure on its plinth
+   in the torch-lit hall — filling the top of the door, the words beneath it. */
+.craft-plinth { display: block; overflow: hidden; }
+.craft-sprite--door { width: 100%; height: auto; aspect-ratio: 250 / 290; transition: transform 200ms cubic-bezier(.2, .7, .3, 1); }
+.craft-door--character:hover .craft-sprite--door,
+.craft-door--character:focus-visible .craft-sprite--door { transform: scale(1.03); }
 
 /* The picker: a dialog over a scrim, four doors in a row above the
    "ask me again" box. Each door carries its scene from the approved prototype,
@@ -1427,7 +1474,8 @@ html.setup-gate-open { overflow: hidden; }
 .setup-gate__craft[aria-pressed="true"] { border-color: var(--accent); background: var(--accent-tint); }
 /* The save is the shared primary door (controls.css, task 1005084). */
 .setup-gate__save { margin-top: 12px; }
-.setup-gate__err { margin: 8px 0 0; font-size: 14px; color: var(--danger); }
+.setup-gate__err,
+.craft-picker__error { margin: 8px 0 0; font-size: 14px; color: var(--danger); }
 .setup-gate__foot { margin: 24px 0 0; font-size: 14px; }
 .setup-gate__foot a { color: var(--ink-soft); }
 @media (max-width: 640px) { .setup-gate__panel { padding: 28px 20px 20px; border-radius: 18px; } }
@@ -1525,9 +1573,9 @@ html.setup-gate-open { overflow: hidden; }
   overflow: hidden;
   background: #101012;
 }
-.craft-art--artistry { background: #0c1122; }
+.craft-art--artist { background: #0c1122; }
 .craft-art--ideating { background: #05060d; }
-.craft-art--governing { background: #000; }
+.craft-art--patron { background: #000; }
 .craft-art__dot { position: absolute; border-radius: 999px; box-sizing: border-box; }
 .craft-art__dot--star { background: #d8dcf0; }
 .craft-art__dot--lit { background: var(--accent); border-radius: 0; }
@@ -1592,6 +1640,11 @@ html.setup-gate-open { overflow: hidden; }
   .craft-door__head { padding: 10px 16px 0; }
   .craft-door__name { font-size: 18px; }
   .craft-door__line { flex: 0 0 100%; padding: 0 16px; box-sizing: border-box; }
+  /* A phone stacks the three as rows: the portrait on the left, the words beside it. */
+  .craft-door.craft-door--character { display: grid; grid-template-columns: 86px minmax(0, 1fr); grid-template-rows: auto 1fr; align-content: start; gap: 4px 14px; padding: 0; }
+  .craft-plinth { grid-row: 1 / span 2; width: 86px; }
+  .craft-door.craft-door--character > .craft-door__head { padding: 12px 14px 0 0; }
+  .craft-door.craft-door--character > .craft-door__line { padding: 0 14px 12px 0; }
 }
 
 /* THE CRAFT MODE LOOKS (task 1004495; direction docs/design/craft-mode-direction.md).
@@ -1601,37 +1654,30 @@ html.setup-gate-open { overflow: hidden; }
    what to press: the accent stays the action colour in every mode. Light values
    clear 5.4:1 on the hall's paper; the dark values are the prototype's. Light
    keeps the paper ground; only dark changes the ground and the glass. */
-html[data-craft="artistry"] { --craft: #2e3c6e; --craft-on: #f1e6d2; }
-html[data-craft="ideating"] { --craft: #7a5a0c; --craft-on: #fdf6dd; }
-html[data-craft="governing"] { --craft: #33479e; --craft-on: #eef1ff; }
-html[data-theme="dark"][data-craft="artistry"] {
+html[data-craft="artist"] { --craft: #2e3c6e; --craft-on: #f1e6d2; }
+html[data-craft="patron"] { --craft: #33479e; --craft-on: #eef1ff; }
+html[data-theme="dark"][data-craft="artist"] {
   --craft: #f1e6d2; --craft-on: #0c1122;
   --bg: #07080d; --bg-frame: #0a0b12;
   --glass: rgba(150, 170, 230, .11); --glass-strong: rgba(170, 190, 240, .17);
   --glass-edge: rgba(241, 230, 210, .16);
 }
-html[data-theme="dark"][data-craft="ideating"] {
-  --craft: #f2d27a; --craft-on: #1d1604;
-  --bg: #05060d;
-  --glass: rgba(140, 150, 225, .10); --glass-strong: rgba(160, 170, 240, .16);
-  --glass-edge: rgba(242, 210, 122, .16);
-}
-html[data-theme="dark"][data-craft="governing"] {
+html[data-theme="dark"][data-craft="patron"] {
   --craft: #aabeff; --craft-on: #0a1030;
   --glass-edge: rgba(170, 190, 255, .16);
 }
 /* The shared treatment: the switch's current pill, the current tab and the top
    bar's hairline take the mode colour. */
-html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing"]) .craft-switch__opt[aria-pressed="true"] {
+html:is([data-craft="artist"], [data-craft="patron"]) .craft-switch__opt[aria-pressed="true"] {
   background: var(--craft); color: var(--craft-on);
 }
-html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing"]) .nav-item--active {
+html:is([data-craft="artist"], [data-craft="patron"]) .nav-item--active {
   background: color-mix(in srgb, var(--craft) 14%, transparent); color: var(--craft);
 }
-html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing"]) .nav-item--active .nav-icon,
-html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing"]) .nav-item--active .nav-item__label { color: var(--craft); }
-html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing"]) .nav-item--active::before { background: var(--craft); }
-html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing"]) .app-topbar {
+html:is([data-craft="artist"], [data-craft="patron"]) .nav-item--active .nav-icon,
+html:is([data-craft="artist"], [data-craft="patron"]) .nav-item--active .nav-item__label { color: var(--craft); }
+html:is([data-craft="artist"], [data-craft="patron"]) .nav-item--active::before { background: var(--craft); }
+html:is([data-craft="artist"], [data-craft="patron"]) .app-topbar {
   border-bottom-color: color-mix(in srgb, var(--craft) 30%, transparent);
 }
 /* The header mark: the mode's own words beside the page title (craft-mode.js
@@ -1735,7 +1781,7 @@ html:is([data-craft="artistry"], [data-craft="ideating"], [data-craft="governing
   .craft-plate .craft-art { width: calc(100% / .582); transform: scale(.582); }
 }
 /* The plate follows the theme (owner, 2026-10-03): light shows each scene's day. */
-html[data-theme="light"] .craft-plate .craft-art--artistry { background: #dfe3ef; }
+html[data-theme="light"] .craft-plate .craft-art--artist { background: #dfe3ef; }
 html[data-theme="light"] .craft-plate .craft-art__dot--star { background: #2e3c6e; }
 html[data-theme="light"] .craft-plate .craft-art__moon { background: #f3c98b; box-shadow: 0 0 0 9px rgba(243, 201, 139, .28); }
 html[data-theme="light"] .craft-plate .craft-art__ground { background: #c3c9dc; }
@@ -1745,28 +1791,8 @@ html[data-theme="light"] .craft-plate .craft-art__dot--gold { background: #c9a23
 html[data-theme="light"] .craft-plate .craft-art__dot--glow { background: #b8891c; box-shadow: 0 0 10px rgba(184, 137, 28, .45); }
 html[data-theme="light"] .craft-plate .craft-art__dot--proto { box-shadow: inset 0 0 0 1px rgba(122, 90, 12, .6); }
 html[data-theme="light"] .craft-plate .craft-art__ring { box-shadow: inset 0 0 0 1px rgba(122, 90, 12, .35); }
-html[data-theme="light"] .craft-plate .craft-art--governing { background: #e9ecf6; }
+html[data-theme="light"] .craft-plate .craft-art--patron { background: #e9ecf6; }
 html[data-theme="light"] .craft-plate .craft-art__city { filter: invert(1) hue-rotate(180deg); }
-/* Ideating's star dust: a few faint fixed specks across the rail itself. */
-html[data-craft="ideating"] .app-sidebar {
-  background-image:
-    radial-gradient(1px 1px at 14px 40px, rgba(242, 210, 122, .5), transparent),
-    radial-gradient(1px 1px at 46px 130px, rgba(242, 210, 122, .35), transparent),
-    radial-gradient(1.5px 1.5px at 120px 90px, rgba(242, 210, 122, .4), transparent),
-    radial-gradient(1px 1px at 200px 190px, rgba(242, 210, 122, .35), transparent),
-    radial-gradient(1px 1px at 30px 230px, rgba(242, 210, 122, .3), transparent),
-    radial-gradient(1.5px 1.5px at 170px 260px, rgba(242, 210, 122, .3), transparent);
-  background-size: 246px 280px;
-}
-html[data-theme="light"][data-craft="ideating"] .app-sidebar {
-  background-image:
-    radial-gradient(1px 1px at 14px 40px, rgba(184, 137, 28, .45), transparent),
-    radial-gradient(1px 1px at 46px 130px, rgba(184, 137, 28, .3), transparent),
-    radial-gradient(1.5px 1.5px at 120px 90px, rgba(184, 137, 28, .35), transparent),
-    radial-gradient(1px 1px at 200px 190px, rgba(184, 137, 28, .3), transparent),
-    radial-gradient(1px 1px at 30px 230px, rgba(184, 137, 28, .25), transparent),
-    radial-gradient(1.5px 1.5px at 170px 260px, rgba(184, 137, 28, .25), transparent);
-}
 
 /* THE MODE TOOLS (task 1004496, craft-mode.js TOOLS): a round button beside the
    switch, in the mode's colour, shown only in its own mode. Artistry's palette

package/modules/hall-ui/public/task-detail.js

@@ -451,8 +451,8 @@
       // A create with no discipline the server cannot infer from the wording is
       // refused (task 1002988), so the builder names the craft here. Engineer is
       // the default, the same fallback bug routing uses (ideas/inbox.js).
-      var craftOptions = [['engineer', 'Engineer'], ['artist', 'Artist'], ['ideator', 'Ideator'], ['ui', 'UI']].map(function (c) {
-        return '<option value="' + c[0] + '"' + (c[0] === 'engineer' ? ' selected' : '') + '>' + c[1] + '</option>';
+      var craftOptions = [['artisan', 'Artisan'], ['artist', 'Artist'], ['ui', 'UI']].map(function (c) {
+        return '<option value="' + c[0] + '"' + (c[0] === 'artisan' ? ' selected' : '') + '>' + c[1] + '</option>';
       }).join('');
       box.innerHTML =
         '<form class="td-form" data-form="promote">'
@@ -509,7 +509,7 @@
         title: title,
         description: body + provenance,
         priority: Number(form.priority.value) || 3,
-        discipline: (form.discipline && form.discipline.value) || 'engineer',
+        discipline: (form.discipline && form.discipline.value) || 'artisan',
         source: 'idea_inbox',
         source_ref: 'idea:' + idea.id,
       };
@@ -750,7 +750,8 @@
   }
 
   window.addEventListener('keydown', function (e) {
-    if (e.key === 'Escape' && document.getElementById('deeplink-card')) clearLink();
+    // Spent once it closed the card (ADR 0399 §2.4 row 5, task 1005144).
+    if (e.key === 'Escape' && document.getElementById('deeplink-card')) { e.preventDefault(); clearLink(); }
   });
   window.addEventListener('hashchange', resolve);
 

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

@@ -8,7 +8,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-03-roadmap1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <!-- The record archetype (shared with idea.html) and this page's own two
        shapes. Promoted out of an inline <style> by task 1003305 — the block was
        the hall's last substantive one and sat at its hall_audit ratchet. -->
@@ -57,17 +57,17 @@
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N deep-link overlay
      (and the #/task/N → /task/N redirect, task 751); load it here too so those
      links still resolve from this page. -->
-<script src="/builders/task-detail.js?v=2026-07-03-taskdetail2" defer></script>
+<script src="/builders/task-detail.js?v=2026-11-10-options" defer></script>
 <script src="/builders/brand-apply.js?v=2026-06-19-r56" defer></script>
 <script src="/builders/md-reader.js" defer></script>
 <script src="/builders/hall-visual.js?v=2026-09-16-visual1" defer></script>

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

@@ -304,3 +304,13 @@ html[data-fullscreen="on"] .sky-stage .top { padding-right: 184px; }
   .card { max-width: 240px; }
 }
 @media (prefers-reduced-motion: reduce) { * { transition: none !important; } }
+
+/* task 1005148: with the visor up (html.visor-on, game mode; visor.js), the sky's own layers keep
+   clear of the glass, as ADR 0399 §2.3 asks of a scene's pop-ups: the top row, the composer, the
+   jump field and the two side panels step below the compass and the place line, and the foot and
+   the tour rise above the visor's corner pills. Outside game mode nothing here applies. */
+html.visor-on .top { padding-top: calc(60px + env(safe-area-inset-top, 0px)); }
+html.visor-on .composer, html.visor-on .jump { top: calc(116px + env(safe-area-inset-top, 0px)); }
+html.visor-on .panel, html.visor-on .room { top: calc(180px + env(safe-area-inset-top, 0px)); bottom: calc(200px + env(safe-area-inset-bottom, 0px)); }
+html.visor-on .foot { padding-bottom: calc(132px + env(safe-area-inset-bottom, 0px)); }
+html.visor-on .tour, html.visor-on .start { bottom: calc(210px + env(safe-area-inset-bottom, 0px)); }

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

@@ -12,8 +12,9 @@
        links, injected into this head by the server like every hall page's
        (tests/hall_tokens.mjs: no hall page hardcodes a web-font stylesheet).
        The template carried its own Google Fonts link for the same two faces. -->
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/thinking.css?v=2026-09-27-split">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
+  <link rel="stylesheet" href="/builders/visor.css?v=2026-11-10-visor">
+  <link rel="stylesheet" href="/builders/thinking.css?v=2026-11-10-visor">
 </head>
 <!-- THE SKY (task 1004231 / sky part 3 of 5, goal 1000095; ADR 0331, ADR 0227
      §11). This page is docs/design/mocks/sky/sky.template.html — the prototype
@@ -139,11 +140,13 @@
 </div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
+<!-- task 1005148: the visor (glass over the scene, game mode only; ADR 0399), after the shell and hall-dialog.js -->
+<script src="/builders/visor.js?v=2026-11-10-visor"></script>
 <script src="/builders/palette.js" defer></script>
 
 <script src="/builders/idea-objects.js?v=2026-09-27-split"></script>
@@ -152,7 +155,7 @@
 <script src="/builders/sky-data.js?v=2026-09-30-uat1"></script>
 <script src="/builders/sky-layout.js?v=2026-09-27-split"></script>
 <script src="/builders/sky-draw.js?v=2026-09-27-split"></script>
-<script src="/builders/sky-interaction.js?v=2026-09-30-uat1"></script>
+<script src="/builders/sky-interaction.js?v=2026-11-10-visor"></script>
 <script src="/builders/sky-panel.js?v=2026-09-30-uat1"></script>
 <script src="/builders/sky-composer.js?v=2026-09-27-split"></script>
 <script src="/builders/sky-tour.js?v=2026-09-27-split"></script>

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

@@ -10,7 +10,7 @@
   <link rel="icon" href="/modules/ui-design/public/brand/favicon.svg" type="image/svg+xml">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-11-10-options">
   <link rel="stylesheet" href="/builders/tweak-editor.css?v=2026-09-29-tw27-aqfix">
 </head>
 <!-- THE TWEAK EDITOR (task 1004321 / BV2.TW10, goal 1000095; ADR 0341 D4 and
@@ -143,14 +143,14 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
-<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/shell-game.js?v=2026-11-10-options"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
-<script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
+<script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
+<script src="/builders/shell.js?v=2026-11-10-character"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/brand-holes.js?v=2026-09-29-aqfix"></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-29-tw27"></script>
-<script src="/builders/tweak-editor.js?v=2026-09-29-tw27-aqfix"></script>
+<script src="/builders/tweak-editor.js?v=2026-11-10-options"></script>
 </body>
 </html>

package/modules/hall-ui/public/tweak-editor.js

@@ -647,7 +647,11 @@
     if (ev.target && ev.target.classList && ev.target.classList.contains('tw-line')) flush();
   });
   document.addEventListener('keydown', (ev) => {
-    if (ev.key === 'Escape') { closeRefused(); setMenu(false); }
+    if (ev.key === 'Escape') {
+      // Spent only when it closed something (ADR 0399 §2.4 row 5, task 1005144).
+      if (!$('tw-refused').hidden || $('tw-openwrap').classList.contains('is-open')) ev.preventDefault();
+      closeRefused(); setMenu(false);
+    }
     if (ev.target && ev.target.id === 'tw-divider') {
       const next = lib.splitFromKey(st.splitSize, ev.key);
       if (next !== null) { ev.preventDefault(); setSize(next); remember(SIZE_KEY, String(st.splitSize)); }

package/modules/hall-ui/public/update-pill.js

@@ -38,6 +38,8 @@
   'use strict';
 
   var RUN_KEY = 'bongos.update.run';
+  var LATER_KEY = 'bongos.update.later';
+  var LATER_MS = 24 * 60 * 60 * 1000;
   var MSG = 'bongos-update'; // the tag deploy-handoff.js answers to; both sides check it
   var VERSION_RE = /^\d+\.\d+\.\d+$/;
   // A hub door as the server words it (core-update.js updateDoor): an origin and
@@ -152,12 +154,34 @@
     return slow ? 'slow' : 'starting';
   }
 
+  // THE POP-UP (task 1005191). The owner, 2026-11-10: the pill alone was not seen. Game mode
+  // opens every page without its bars, and a project sat 3 minor versions behind. So an
+  // update that is ready also ASKS, once, in the hall's own dialog. Any way of closing it
+  // other than Update now is "later": that version is not asked about again in this browser
+  // for a day. The pill stays, so later never means lost.
+  function readLater(storage) {
+    var l = null;
+    try { l = JSON.parse((storage && storage.getItem(LATER_KEY)) || 'null'); } catch (e) { l = null; }
+    return l && isVersion(l.v) && isFinite(l.at) ? l : null;
+  }
+  function keepLater(storage, version, now) {
+    try { if (storage && isVersion(version)) storage.setItem(LATER_KEY, JSON.stringify({ v: version, at: now })); } catch (e) { /* it asks again next page */ }
+  }
+  /** Whether the pop-up opens: only for an update that is ready, and not for a version the
+   *  owner already said "later" to inside the last day. A newer version asks again at once. */
+  function askDue(o) {
+    if (!o || o.face !== 'ready' || !isVersion(o.offered)) return false;
+    var l = o.later;
+    if (l && l.v === o.offered && o.now >= l.at && o.now - l.at < LATER_MS) return false;
+    return true;
+  }
+
   // ---------- the page half ----------
 
   var state = {
     api: null, update: null, held: null, sw: null, swAsked: null, swError: null, ended: null, note: null,
     face: 'none', stage: null, run: null, error: null, pill: null, card: null,
-    popup: null, plan: null, offered: null, looks: 0, timer: null, popupTimer: null, listening: false,
+    popup: null, plan: null, offered: null, asked: false, looks: 0, timer: null, popupTimer: null, listening: false,
   };
 
   function doc() { return root && root.document; }
@@ -316,7 +340,7 @@
       d.body.appendChild(c);
       state.card = c;
       if (root.addEventListener) root.addEventListener('resize', function () { if (state.card && !state.card.hidden) placeCard(); });
-      d.addEventListener('keydown', function (e) { if (e.key === 'Escape' && state.card && !state.card.hidden) { closeCard(); if (state.pill) state.pill.focus(); } });
+      d.addEventListener('keydown', function (e) { if (e.key === 'Escape' && state.card && !state.card.hidden) { e.preventDefault(); closeCard(); if (state.pill) state.pill.focus(); } }); // spent: ADR 0399 §2.4, task 1005144
       d.addEventListener('click', function (e) {
         if (!state.card || state.card.hidden) return;
         var t = e.target;
@@ -556,6 +580,69 @@
     if (root.location && root.location.reload) root.location.reload();
   }
 
+  // ---------- the pop-up ----------
+
+  // Not in the hub's handoff window, not on the update door itself, and not over the setup
+  // screen: each of those is already the thing the owner is doing.
+  function askAllowed() {
+    var d = doc();
+    if (!d || !root.OTBDialog || typeof root.OTBDialog.open !== 'function' || state.asked) return false;
+    var el = d.documentElement;
+    if (el && el.dataset && el.dataset.handoff === 'on') return false;
+    if (root.OTBSetupGate) return false;
+    return !(root.location && root.location.pathname === '/deploy');
+  }
+
+  function askBodyHtml(plan) {
+    var u = state.update || {};
+    var h = highlights((state.sw.update || {}).whats_new, HIGHLIGHTS);
+    var list = h.lines.length ? '<ul class="upd-card__list">' + h.lines.map(function (l) { return '<li>' + esc(l) + '</li>'; }).join('') + '</ul>' : '';
+    var note = plan.kind === 'cli'
+      ? 'This project is updated on the server that runs it: <code>bongos upgrade</code> there takes this version, and puts the old one back if it fails.'
+      : 'Takes a few minutes. The project restarts once, and goes back to the version it runs now on its own if the new one is not healthy.';
+    var versions = isVersion(u.running) && isVersion(state.offered) ? '<p class="upd-card__ver">' + mono(u.running) + ' → ' + mono(state.offered) + '</p>' : '';
+    return '<p>A newer version of Bongos is ready, with the latest changes and bug fixes.</p>' + list +
+      '<p class="upd-card__note">' + note + '</p>' + versions;
+  }
+
+  // Asked from the same reading the card uses, so the pop-up and the card name one version
+  // and the two-step rule holds: the pop-up shows the version, Update now sends that one.
+  function maybeAsk() {
+    if (!askAllowed() || !askDue({ face: state.face, offered: state.offered, later: readLater(store()), now: now() })) return;
+    var read = readSoftwareUpdate();
+    if (!read) { ask(); return; }
+    read.then(ask);
+  }
+  function ask() {
+    if (!state.sw || !askAllowed() || !askDue({ face: state.face, offered: state.offered, later: readLater(store()), now: now() })) return;
+    var plan = doorPlan(state.sw);
+    if (plan.kind === 'none') return; // a viewer the door would refuse is not asked
+    var d = doc();
+    var body = d.createElement('div');
+    body.className = 'upd-ask';
+    body.innerHTML = askBodyHtml(plan);
+    var canGo = plan.kind === 'local' || plan.kind === 'hub';
+    var offered = state.offered;
+    var actions = canGo
+      ? [{ label: 'Later', value: 'later', kind: 'ghost' }, { label: 'Update now', value: 'go' }]
+      : [{ label: 'Close', value: 'later', kind: 'ghost' }];
+    state.asked = true;
+    var dlg = root.OTBDialog.open({ title: 'Update the builders hall?', body: body, actions: actions, initialFocus: '[data-dialog-value="' + (actions.length - 1) + '"]' });
+    // Update now runs inside the press itself: a hosted project opens the hub's window, and
+    // a browser allows that only from the click, not from the dialog's settled promise.
+    if (canGo && dlg && dlg.el && dlg.el.addEventListener) {
+      dlg.el.addEventListener('click', function (e) {
+        var t = e && e.target;
+        var b = t && t.closest ? t.closest('[data-dialog-value]') : null;
+        if (!b || b.getAttribute('data-dialog-value') !== '1') return;
+        if (updateNow()) openCard();
+      });
+    }
+    if (dlg && dlg.result && dlg.result.then) {
+      dlg.result.then(function (v) { if (v !== 'go') keepLater(store(), offered, now()); });
+    }
+  }
+
   /** shell.js hands over GET /core-update's answer; the pill decides what, if anything, to show. */
   function mount(data, opts) {
     state.api = opts && opts.api;
@@ -575,6 +662,7 @@
     state.face = face;
     drawPill();
     if (face === 'running') schedule();
+    if (face === 'ready') maybeAsk();
     return face;
   }
 
@@ -590,6 +678,7 @@
     // the pure half, for the tests
     highlights: highlights, doorPlan: doorPlan, pillState: pillState, stageOf: stageOf,
     readRun: readRun, keepRun: keepRun, forgetRun: forgetRun, isVersion: isVersion,
+    askDue: askDue, readLater: readLater, keepLater: keepLater, LATER_KEY: LATER_KEY, LATER_MS: LATER_MS,
     RUN_KEY: RUN_KEY, MSG: MSG, SLOW_MS: SLOW_MS, GIVE_UP_MS: GIVE_UP_MS,
     _state: state,
   };