@bongos/core 1.24.91 → 1.24.93

package/docs/page-readings.json

@@ -283,7 +283,7 @@
       "surface": "builders",
       "title": "The city",
       "states_read": ["city","fullscreen","focus","pins","living","card","card-ask"],
-      "files_hash": "43c2a3f5444895d6",
+      "files_hash": "d9dd949934a5b719",
       "reading_hash": "277096d903879a57",
       "counts": {"lines":26,"placed":9,"shared":6,"unplaced":11},
       "omitted": {"data":7},
@@ -613,7 +613,7 @@
       "surface": "builders",
       "title": "The sky",
       "states_read": ["tour","sky","wells","ledger","full","full-back","out"],
-      "files_hash": "ca4e9b0498d510b8",
+      "files_hash": "f54ebe767edaf0c8",
       "reading_hash": "4a879397a84631e3",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -954,8 +954,8 @@
       "surface": "builders",
       "title": "Builders' Hall",
       "states_read": ["home","out","founding","genesis","decide","demo"],
-      "files_hash": "0091ac704ef9996f",
-      "reading_hash": "67b29854aad1bffe",
+      "files_hash": "6fce98a5eabe1c82",
+      "reading_hash": "42901560779fc4d1",
       "counts": {"lines":32,"placed":12,"shared":8,"unplaced":12},
       "omitted": {"data":5},
       "notes": ["founding: an action failed (page.focus: Timeout 6000ms exceeded.); read as it stood"],
@@ -977,7 +977,7 @@
         {"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.24.89","placement":"unplaced"},
+        {"key":"L0018","section":"Needs your attention13","text":"core 1.24.90","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"},
@@ -3159,7 +3159,7 @@
       "surface": "builders",
       "title": "Your thinking",
       "states_read": ["tour","sky","list","simple","full-idea","full","full-list","full-back","out"],
-      "files_hash": "3e3d0ce3f938dfc4",
+      "files_hash": "3cce7079079c7782",
       "reading_hash": "b73f848b46b0f9b8",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},

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

@@ -88,8 +88,12 @@ html:has(body[data-page="city"]) { height: 100%; }
    the home above and below measures from the stage instead of the window. */
 .city-main { position: fixed; top: var(--topbar-h, 56px); left: var(--sidebar-w-rail, 64px); right: 0; bottom: 0; max-width: none; margin: 0; contain: layout paint; z-index: 1; }
 html[data-fullscreen="on"] .city-main { top: 0; left: 0; }
-/* tasks 1005148 and 1005195: with the visor up (game mode), the door rises clear of its foot row, whose one button is centred too. */
-html.visor-on .city-door { bottom: 150px; }
+/* tasks 1005148, 1005195 and 1005209: with the visor up (game mode), the door (now its line alone) rises clear of the
+   foot row, whose one button is centred too, even when the key hints wrap onto a second line. */
+html.visor-on .city-door { bottom: 224px; }
+/* task 1005209 (ADR 0403): with the visor up the door's button and the archived links are the
+   visor's (D on the glass, the rest in its Actions sheet), so the scene carries none of its own. */
+html.visor-on .city-start, html.visor-on .city-archived { display: none; }
 @media (max-width: 768px) { .city-main { left: 0; } }
 /* The full-screen switch floats top right over the stage, where the sun/moon
    switch sits; the strip steps in by the button's width so nothing sits under it.

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

@@ -411,6 +411,7 @@
       start.setAttribute('href', model.cta.href);
       start.setAttribute('aria-label', model.cta.aria);
     }
+    if (model.cta) registerScene(model.cta);
     drawPlaque(model.plaque || null);
     if (openKey) renderCard(openKey);
     return model;
@@ -759,6 +760,47 @@
   window.GovCityPage.ready = boot();
   // task 1005148: the Governor City as the visor's scene. No camera until R13, so no movement
   // actions (ADR 0399 §2.2); the card's own keys are listed for the sheet.
-  window.__visorScene = { name: 'city', place: 'Governor city', keys: [{ label: 'On a card: answer', key: '1–9' }, { label: 'On a card: next', key: '← →' }] };
-  if (window.OTBVisor) window.OTBVisor.scene(window.__visorScene);
+  // task 1005209 (ADR 0403): in game mode the city's door and its two archived links are the
+  // visor's. The door is the lead action, on the glass as a key hint with D; the archived
+  // links are in the sheet's "This place" list. city.css takes them off the scene under
+  // html.visor-on; in classic mode they stay where they were and these do nothing new.
+  function doorLabel(cta) { return cta && cta.label ? String(cta.label) : 'start governing'; }
+  function sceneFor(cta) {
+    var label = doorLabel(cta);
+    return {
+      name: 'city', place: 'Governor city',
+      actions: [
+        { label: label, key: 'd', bind: true, lead: true, run: function () {
+          if (window.GovCityDecide && window.GovDeck) openDecide(null);
+          else if (window.location) window.location.hash = '#decide';
+        } },
+      ].concat(archivedActions()),
+      keys: [{ label: 'On a card: answer', key: '1–9' }, { label: 'On a card: next', key: '← →' }],
+    };
+  }
+  // The archived links, read off the page's own line (city.html), so the sheet says and opens
+  // exactly what the line does: "Archived: Street", "Archived: Building Level Views".
+  function archivedActions() {
+    var line = document.querySelector ? document.querySelector('.city-archived') : null;
+    var links = line && line.querySelectorAll ? Array.prototype.slice.call(line.querySelectorAll('a[href]')) : [];
+    return links.map(function (a) {
+      var href = a.getAttribute('href');
+      return { label: 'Archived: ' + a.textContent, run: function () { window.location.assign(href); } };
+    });
+  }
+  // Registered once per door label: draw() calls this on every poll, and only a new label
+  // (a different streak, say) rebuilds the scene and reads the archived links again.
+  // Order matters here: boot() ran above and its first draw() has normally registered
+  // already, with the real door label. sceneLabel deliberately has no initial value, so the
+  // line after this function only registers the fallback when that draw did not register.
+  var sceneLabel;
+  function registerScene(cta) {
+    var label = doorLabel(cta);
+    if (label === sceneLabel) return;
+    sceneLabel = label;
+    var next = sceneFor(cta);
+    window.__visorScene = next;
+    if (window.OTBVisor) window.OTBVisor.scene(next);
+  }
+  if (sceneLabel == null) registerScene(null);
 }());

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

@@ -158,5 +158,7 @@
 <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>
+<!-- task 1005210: the sky as the visor's scene (ADR 0403), after every other sky file -->
+<script src="/builders/sky-visor.js"></script>
 </body>
 </html>

package/modules/hall-ui/public/sky-interaction.js

@@ -13,7 +13,7 @@
 // `filed_via` exists on at least one thought; until then it is hidden and
 // every thought shows (the README's "must not ship" row).
 //
-// Keys: L the list, ? the tour, 0 fit, / the composer, Escape closes, arrows
+// Keys: L the list, ? the tour, 0 fit, / the composer (J jumps, from the visor in game mode), Escape closes, arrows
 // pan, + and - zoom.
 
 (() => {
@@ -75,11 +75,11 @@
   // An Escape the sky USED (the tour, the menu, a pick) calls preventDefault, so
   // the shell's full-screen switch leaves that press alone (task 1004327).
   addEventListener('keydown', (e) => {
-    if (e.target && (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA')) { if (e.key === 'Escape') e.target.blur(); return; }
+    if (e.target && (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA')) { if (e.key === 'Escape') { e.target.blur(); if (e.target.id === 'thought' || e.target.id === 'jump') { e.preventDefault(); if (SKY.closeField) SKY.closeField(e.target.id, true); } } return; }
     const { cam } = S; const step = 60 / cam.k;
     if (e.key === 'ArrowLeft') { cam.x -= step; S.dirty = true; } else if (e.key === 'ArrowRight') { cam.x += step; S.dirty = true; } else if (e.key === 'ArrowUp') { cam.y -= step; S.dirty = true; } else if (e.key === 'ArrowDown') { cam.y += step; S.dirty = true; }
     else if (e.key === '+' || e.key === '=') { cam.k = clamp(cam.k * 1.3, .015, 9); S.dirty = true; } else if (e.key === '-') { cam.k = clamp(cam.k / 1.3, .015, 9); S.dirty = true; }
-    else if (e.key === '0') SKY.fitAll(); else if (e.key === 'Escape') { if (!$('tour').hidden) { e.preventDefault(); SKY.endTour(); } else if (!menu.hidden) { e.preventDefault(); hideMenu(); } else { if (S.picked || !$('panel').hidden) e.preventDefault(); pick(null); } } else if (e.key === '/') { e.preventDefault(); $('thought').focus(); }
+    else if (e.key === '0') SKY.fitAll(); else if (e.key === 'Escape') { if (!$('tour').hidden) { e.preventDefault(); SKY.endTour(); } else if (!menu.hidden) { e.preventDefault(); hideMenu(); } else { if (S.picked || !$('panel').hidden) e.preventDefault(); pick(null); } } else if (e.key === '/') { e.preventDefault(); if (SKY.openField) SKY.openField('thought'); else $('thought').focus(); }
     else if (e.key === '?') SKY.startTour(); else if (e.key.toLowerCase() === 'l') SKY.toggleRoom(); else return;
   });
   function pick(h, fly) { if (h && h.kind === 'ltask') { SKY.renderPanel({ kind: 'ltask', ref: h.ref }); S.dirty = true; return; } S.picked = h; SKY.renderPanel(S.picked); SKY.renderRoom(); S.dirty = true; if (fly && S.picked && S.lens !== 'simple') { if (S.picked.kind === 'goal') SKY.fitGoal(S.picked.ref); else if (S.picked.kind === 'idea') SKY.fitThought(S.picked.ref); } }
@@ -148,10 +148,5 @@
 
   Object.assign(SKY, { card, menu, glyphHtml, ideaTitle, sizeWords, showCard, showMenu, hideMenu, pick, setLens, togglePill, updateStats, altText, TAU, hash });
 
-  // task 1005148: the sky as the visor's scene (ADR 0399 §2.2). The visor owns no camera:
-  // "Back to centre" is the camera's own fitAll, and the keys listed are the ones bound above.
-  window.__visorScene = { name: 'sky', place: '', // the sky's own heading names the place
-    actions: [{ label: 'Back to centre', key: '0', run: () => SKY.fitAll() }],
-    keys: [{ label: 'Look around', key: 'drag' }, { label: 'List view', key: 'L' }, { label: 'Search', key: '/' }, { label: 'Take the tour', key: '?' }] };
-  if (window.OTBVisor) window.OTBVisor.scene(window.__visorScene);
+  // task 1005148 / 1005210: the sky as the visor's scene lives in sky-visor.js, after this file.
 })();

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

@@ -0,0 +1,96 @@
+// modules/hall-ui/public/sky-visor.js — THE SKY as the visor's scene (task 1005148; task
+// 1005210, ADR 0403). Loaded after sky-interaction.js on /goal-map and /thinking.
+//
+// The visor owns no camera (ADR 0399 §2.2): every action here presses one of the sky's own
+// controls or opens one of its own fields, so a pill does exactly what it did in classic mode.
+(() => {
+  'use strict';
+
+  const SKY = window.OTBSky; const S = SKY.S;
+  const { $, on } = SKY;
+
+  // task 1005210 (ADR 0403): in game mode the visor is the control and the sky is the view. Its
+  // top row (the lens switch and every pill), the jump field and the thought composer leave the
+  // scene (thinking.css, html.visor-on) and come back as visor actions: writing a thought is the
+  // lead action, on the sky's own "/"; jumping is J; each pill is a row in the Actions sheet
+  // that presses the pill itself, so a pill does exactly what it did. The rows are read off the
+  // page's own buttons (their words, their pressed state, whether this lens shows them), and the
+  // scene registers again whenever one of those changes. Panning, zooming and picking a star
+  // stay in the sky. In classic mode nothing here shows or moves.
+  const FIELDS = ['thought', 'jump'];
+  function fieldWrap(id) { const el = $(id); return el && el.closest ? el.closest('.composer, .jump') : null; }
+  function openField(id) {
+    for (const other of FIELDS) if (other !== id) closeField(other, true);
+    const wrap = fieldWrap(id); if (wrap) wrap.classList.add('is-open');
+    $(id).focus();
+  }
+  // A field closes when it is left with nothing in it, or on Escape (its words are kept).
+  // The composer stays while a full idea is being asked or a receipt waits to be read.
+  function closeField(id, force) {
+    const wrap = fieldWrap(id); if (!wrap || !wrap.classList.contains('is-open')) return;
+    if (!force) {
+      if (wrap.contains(document.activeElement)) return;
+      if ($(id).value.trim()) return;
+      if (id === 'thought' && (!$('fullSteps').hidden || !$('receipt').hidden)) return;
+    }
+    wrap.classList.remove('is-open');
+  }
+  for (const id of FIELDS) {
+    const wrap = fieldWrap(id); if (!wrap) continue;
+    wrap.addEventListener('focusout', () => setTimeout(() => closeField(id), 0));
+  }
+  on('receiptX', 'click', () => setTimeout(() => closeField('thought'), 0));
+  // the sky binds these keys itself (sky-interaction.js); the rest are rows in the sheet
+  const OWN_KEYS = { roomBtn: 'L', tourBtn: '?', fitBtn: '0' };
+  function visible(el) { return !!el && !el.hidden && !(el.closest && el.closest('[hidden]')); }
+  function rowFor(b) {
+    const words = (b.textContent || '').trim();
+    const name = words.length > 1 ? words : (b.getAttribute('aria-label') || b.getAttribute('title') || '');
+    const pressed = b.getAttribute('aria-pressed');
+    const label = name.charAt(0).toUpperCase() + name.slice(1) + (pressed == null ? '' : pressed === 'true' ? ' · on' : ' · off');
+    return { label, key: OWN_KEYS[b.id] || '', run: () => b.click() };
+  }
+  // The foot's clock and legend are the sky's too: in game mode each shows only while the visor
+  // has it open (thinking.css), so the scene carries none of their buttons until asked.
+  function footOpen(id) { const el = $(id); return !!el && el.classList.contains('is-open'); }
+  function footRow(id, name) {
+    return { label: name + (footOpen(id) ? ' · on' : ' · off'), key: '', run: () => {
+      const el = $(id); if (!el) return;
+      const open = !el.classList.contains('is-open');
+      el.classList.toggle('is-open', open);
+      // a clock classic mode was told to hide comes back through its own pill
+      if (open && el.hidden && id === 'time') $('clockBtn').click();
+    } };
+  }
+  function skyScene() {
+    const actions = [{ label: 'Write a thought', key: '/', lead: true, run: () => openField('thought') }];
+    if (visible(fieldWrap('jump'))) actions.push({ label: 'Jump to a goal or a thought', key: 'j', bind: true, run: () => openField('jump') });
+    document.querySelectorAll('#lensGroup button, #tools button').forEach((b) => {
+      if (!visible(b)) return;
+      // the clock pill keeps classic mode's remembered choice; in game mode the clock opens from here
+      if (b.id === 'clockBtn') { actions.push(footRow('time', 'Clock')); return; }
+      actions.push(rowFor(b));
+    });
+    if (visible($('legend'))) actions.push(footRow('legend', 'Legend'));
+    return { name: 'sky', place: '', // the sky's own heading names the place
+      actions, keys: [{ label: 'Look around', key: 'drag' }, { label: 'Zoom', key: '+ −' }] };
+  }
+  let sceneSig = null;
+  function registerScene() {
+    const next = skyScene();
+    const sig = next.actions.map((a) => a.label + '|' + a.key).join('\n');
+    if (sig === sceneSig) return;
+    sceneSig = sig;
+    window.__visorScene = next;
+    if (window.OTBVisor) window.OTBVisor.scene(next);
+  }
+  // a pill's pressed state or a lens's set of pills changed: the sheet follows
+  if (typeof MutationObserver === 'function') {
+    const watch = new MutationObserver(registerScene);
+    for (const id of ['tools', 'lensGroup']) { const el = $(id); if (el) watch.observe(el, { subtree: true, attributes: true, attributeFilter: ['aria-pressed', 'hidden'] }); }
+    const jump = fieldWrap('jump'); if (jump) watch.observe(jump, { attributes: true, attributeFilter: ['hidden'] });
+    for (const id of ['time', 'legend']) { const el = $(id); if (el) watch.observe(el, { attributes: true, attributeFilter: ['class', 'hidden'] }); }
+  }
+  Object.assign(SKY, { openField, closeField, skyScene });
+  registerScene();
+})();

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

@@ -315,3 +315,11 @@ html.visor-on .composer, html.visor-on .jump { top: calc(140px + env(safe-area-i
 html.visor-on .panel, html.visor-on .room { top: calc(204px + 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)); }
+/* task 1005210 (ADR 0403): with the visor up the sky carries no control of its own. The top
+   row's lens switch and pills are rows in the visor's Actions sheet; the composer and the jump
+   field open from the visor ("Write a thought" on /, "Jump" on J) and close again when left
+   empty (sky-interaction.js openField / closeField). The brand and its figures stay, as words. */
+html.visor-on .top .tools, html.visor-on .top .lens { display: none; }
+html.visor-on .composer:not(.is-open), html.visor-on .jump:not(.is-open) { display: none; }
+html.visor-on .jump.is-open:not([hidden]) { display: block; }
+html.visor-on .time:not(.is-open), html.visor-on .legend:not(.is-open) { display: none; }

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

@@ -159,5 +159,7 @@
 <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>
+<!-- task 1005210: the sky as the visor's scene (ADR 0403), after every other sky file -->
+<script src="/builders/sky-visor.js"></script>
 </body>
 </html>

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

@@ -133,12 +133,18 @@
   var scene = null;
   // A scene says what it is and, if it has a camera, the actions that move it (ADR 0399
   // §2.2). `keys` are lines for the sheet's "this place" list: keys the scene already binds.
+  // An action's `key` is a key the scene already binds, shown beside it; with `bind: true`
+  // the visor binds it instead (in game mode, after the character's keys), for a scene button
+  // that had no key of its own. `lead: true` puts the action on the glass as the first key
+  // hint (ADR 0403: in game mode the scene's buttons are the visor's; task 1005209).
   function registerScene(s) {
     if (!s || typeof s !== 'object') return;
     scene = {
       name: String(s.name || ''),
       place: String(s.place || ''),
-      actions: (Array.isArray(s.actions) ? s.actions : []).filter(function (a) { return a && a.label && typeof a.run === 'function'; }),
+      actions: (Array.isArray(s.actions) ? s.actions : []).filter(function (a) { return a && a.label && typeof a.run === 'function'; }).map(function (a) {
+        return { label: String(a.label), key: a.key ? String(a.key).toLowerCase() : '', bind: !!a.bind, lead: !!a.lead, run: a.run };
+      }),
       keys: (Array.isArray(s.keys) ? s.keys : []).filter(function (k) { return k && k.label && k.key; }),
     };
     render();
@@ -174,6 +180,10 @@
   function hintHtml(a) {
     return '<a class="visor__hint" data-visor-act="' + esc(a.id) + '" ' + actionAttrs(a) + '>' + keyHtml(a.key) + '<span>' + esc(a.label) + '</span></a>';
   }
+  // The scene's lead action, as the first quiet hint (task 1005209).
+  function placeHintHtml(a, i) {
+    return '<button class="visor__hint visor__hint--place" type="button" data-visor-scene="' + i + '">' + (a.key ? keyHtml(a.key) : '') + '<span>' + esc(a.label) + '</span></button>';
+  }
   function actionAttrs(a) {
     return a.href ? 'href="' + esc(hallHref(a.href)) + '"' : 'href="#" role="button"';
   }
@@ -192,7 +202,7 @@
         '</div>' +
         '<a class="visor__main" data-visor-act="' + esc(main.id) + '" ' + actionAttrs(main) + '>' +
           '<span>' + esc(main.label) + '</span>' + keyHtml(main.key) + '</a>' +
-        '<div class="visor__hints">' + acts.slice(1).map(hintHtml).join('') +
+        '<div class="visor__hints">' + scene.actions.map(function (a, i) { return a.lead ? placeHintHtml(a, i) : ''; }).join('') + acts.slice(1).map(hintHtml).join('') +
           '<button class="visor__hint visor__hint--sheet" type="button" data-visor-sheet aria-expanded="false" aria-controls="visor-sheet">' +
             '<span class="visor__dots" aria-hidden="true"></span>' + keyHtml(SHEET_KEY) + '<span>Actions</span></button>' +
           '<a class="visor__hint visor__hint--options" href="' + esc(hallHref('/settings')) + '">' + keyHtml('Esc') + '<span>Options</span></a>' +
@@ -264,7 +274,8 @@
     sheet.setAttribute('role', 'dialog');
     sheet.setAttribute('aria-labelledby', 'visor-sheet-title');
     sheet.innerHTML = sheetHtml(id);
-    sheet.addEventListener('click', onClick);
+    // no listener of its own: the sheet sits inside #visor, whose click listener already
+    // sees its rows (a second one ran every row twice, so a toggle undid itself; task 1005210)
     root.appendChild(sheet);
     var btn = root.querySelector('[data-visor-sheet]');
     if (btn) { btn.setAttribute('aria-expanded', 'true'); btn.hidden = true; }
@@ -297,6 +308,7 @@
   // ---------- running an action ----------
   function run(a) {
     if (!a) return;
+    if (typeof a.run === 'function') { a.run(); return; }
     if (a.tool) {
       var C = craft();
       if (C && typeof C.openTool === 'function') C.openTool(a.tool);
@@ -342,11 +354,15 @@
     if (k === SHEET_KEY) return 'sheet';
     var acts = actionsFor(id);
     for (var i = 0; i < acts.length; i++) if (acts[i].key === k) return acts[i];
+    // then the keys the visor binds for the place (task 1005209); the character's win a clash
+    var own = scene ? scene.actions : [];
+    for (var j = 0; j < own.length; j++) if (own[j].bind && own[j].key === k) return own[j];
     return null;
   }
   // Bubble, on window: a scene or pop-up that used the key has called preventDefault by now.
   function onKey(e) {
-    if (!shown() || inField(e.target) || busy()) return;
+    // The glass is game mode's alone (visor.css); outside it, its keys are not bound either.
+    if (!shown() || document.documentElement.dataset.game !== 'on' || inField(e.target) || busy()) return;
     var hit = keyFor(character(), e);
     if (!hit) return;
     e.preventDefault();

package/modules/hall-ui/records/visor.md

@@ -1,10 +1,24 @@
 # The visor — the first-person HUD over every scene (task 1005148, BONGOS-V3 R08; ADR 0399)
 
-Covers: `visor.js` + `visor.css`, loaded on Home, `/city`, `/goal-map` and `/thinking`, and the three scene registrations (`sky-interaction.js`, `city.js`, `home-city.js`). Spec: `docs/specs/bongos-v3-game-conversion.md` C2 `you-are-a-character-in-first-person`. Game mode itself is in `game-mode.md`.
+Covers: `visor.js` + `visor.css`, loaded on Home, `/city`, `/goal-map` and `/thinking`, and the three scene registrations (`sky-visor.js`, `city.js`, `home-city.js`). Spec: `docs/specs/bongos-v3-game-conversion.md` C2 `you-are-a-character-in-first-person`. Game mode itself is in `game-mode.md`.
 
 ## The rule every game page keeps (ADR 0403, owner 2026-11-11)
 
-The visor is the control and the scene is the view: every main call to action in game mode is on the glass (the accent button, the key hints, the Actions sheet), and a scene carries none of its own. A scene that has something to do registers it with `OTBVisor.scene({ actions, keys })`. ADR 0403 §3 lists the scenes that do not keep it yet.
+The visor is the control and the scene is the view: every main call to action in game mode is on the glass (the accent button, the key hints, the Actions sheet), and a scene carries none of its own. A scene that has something to do registers it with `OTBVisor.scene({ actions, keys })`. ADR 0403 §3 lists the scenes that do not keep it yet; the Governor City keeps it since task 1005209 and the sky since task 1005210 (below).
+
+## A place's own buttons on the glass (task 1005209, the Governor City first)
+
+- **The scene contract grew two flags.** A scene action's `key` is still a key the scene binds itself, shown beside it in the sheet. With `bind: true` the visor binds that key instead, after the character's keys (a clash goes to the character), for a scene button that had no key of its own. With `lead: true` the action is also the first quiet key hint on the glass (`.visor__hint--place`). Every scene action is still a row under "This place" in the sheet.
+- **The glass binds keys in game mode only.** `onKey` now returns unless `html[data-game="on"]`: the glass was never drawn outside game mode, so its keys no longer act there either (before, a held character's letter keys still ran on a classic page).
+- **The Governor City keeps ADR 0403.** In game mode (`html.visor-on`) the door's button (`#cityStart`) and the archived Street links leave the scene (`city.css`). The door is the lead action, on D, in the door's own words and case ("decide 37 in a row", or "start governing"; lowercase is the door's, task 1005210); it re-registers only when those words change. The archived links are rows in the sheet ("Archived: Street", "Archived: Building Level Views"), read off the page's own archived line so the words and the addresses cannot drift; reached by A and the keyboard. The city line stays on the scene as words, raised to `bottom: 224px` because the extra hint wraps the hints onto a second line at a desk width and the centred accent button rises with it. A building's card is a pop-up, not the scene, and keeps its own buttons and keys. Classic mode is as it was.
+
+## The sky on the glass (task 1005210)
+
+- **What left the sky in game mode** (`thinking.css`, under `html.visor-on`): the top row's lens switch and every pill, the jump field, the thought composer, and the foot's clock and legend. The brand line and its figures stay, as words. A building-like pop-up (the panel, the list, the start dialog, the tour) is not the scene and keeps its buttons.
+- **Where it went** (`sky-visor.js`, loaded after every other sky file; the registration moved out of `sky-interaction.js`). "Write a thought" is the lead action, on the sky's own `/`; "Jump to a goal or a thought" is J (bound by the visor). Each visible pill is a row in the sheet, in its own words with "· on" / "· off" for a toggle, and pressing the row presses the pill, so it does exactly what it did; List, the tour and Fit keep the sky's own L, ? and 0. "Clock" and "Legend" open the foot's two parts. The rows are read off the page's buttons and the scene registers again when a pill's pressed state, a pill's presence (the lens decides it) or the foot changes.
+- **The fields open and close.** A field opens with `is-open` (one at a time) and closes when focus leaves it empty, or on Escape, which keeps its words and is spent there (no options menu). The composer stays open while a full idea is being asked or a receipt waits.
+- **A visor fix that came with it.** The sheet had a click listener of its own inside `#visor`'s, so every row ran twice; a toggle row undid itself. The sheet's listener is gone.
+- **Not done:** the tour still spots the pills it explains, which are off the glass in game mode. Tests: `tests/hall_sky_visor.mjs` (both pages' own markup, the real visor and sheets, in a real browser).
 
 ## The minimal visor (Helm look 3, task 1005195)
 

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.91",
+  "version": "1.24.93",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.24.91",
+      "version": "1.24.93",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.91",
+  "version": "1.24.93",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -11644,10 +11644,24 @@
       "text": "In the game view the Artist's feedback tab no longer sits on the screen; the Artist opens the feedback sheet from the visor, and only the Artist can open it."
     }
   ],
-  "1.24.91": [
+  "1.24.92": [
+    {
+      "id": "1005209",
+      "text": "In game mode the Governor City no longer has a button of its own: \"Decide N in a row\" is now on the visor (press D), and the archived Street links are in the visor's Actions list. Classic mode is unchanged."
+    },
+    {
+      "id": "1005118",
+      "text": "Signing the command line back in is now one Approve click in the browser — no copying, no pasting, and the sign-in key never appears in the chat."
+    },
     {
       "id": "1005206",
       "text": "The screen you land on after signing in, where you pick Game or Classic, now looks like the V3 game start menu: your usual choice is the bright salmon bar with its Enter key, the other a quiet row."
     }
+  ],
+  "1.24.93": [
+    {
+      "id": "1005210",
+      "text": "In game mode the sky (Goals and Thinking) no longer has buttons of its own: \"Write a thought\" is on the visor (press /), jumping is J, and the lens switch, the pills, the clock and the legend are rows in the visor's Actions li"
+    }
   ]
 }

package/scripts/bongos/cli-lib.js

@@ -567,15 +567,16 @@ function printUnauthGuidanceAndExit() {
   console.error('');
   if (isTerminalSurface()) {
     // No checkout here, so `node scripts/bongos/*.js` is not a path this reader has (task 1003730).
-    console.error(`  Recover the fast (UI-first) way — run ${surfaceAction('reauth')}`);
-    console.error('  (opens your Settings page; under "CLI Access" click "Re-issue CLI');
-    console.error('   token", copy the one-liner, paste it back — no terminal Device Flow.)');
+    console.error(`  Sign back in — run ${surfaceAction('reauth')}`);
+    console.error('  (a page opens in your browser: click "Approve" and you are back in.');
+    console.error('   Nothing to copy or paste.)');
     console.error('  Fallback (browser sign-in): npx bongos login <instance-url>');
   } else {
-    console.error('  Recover the fast (UI-first) way — run /builder-reauth, or:');
+    // Task 1005118: one Approve click in the browser. Claude runs it when asked.
+    console.error('  Sign back in — ask Claude to "sign me back in" (/builder-reauth), or run:');
     console.error('    node scripts/bongos/reauth.js');
-    console.error('  (opens your Settings page; under "CLI Access" click "Re-issue CLI');
-    console.error('   token", copy the one-liner, paste it back — no terminal Device Flow.)');
+    console.error('  (a page opens in your browser: click "Approve" and you are back in.');
+    console.error('   Nothing to copy or paste.)');
     console.error('  Fallback (terminal Device Flow): node scripts/bongos/setup.js --force');
   }
   console.error('');

package/scripts/bongos/login.js

@@ -104,14 +104,19 @@ const { sleep } = require('../../src/sleep'); // the one shared sleep (task 1004
 // instance's /auth/device/exchange — a hosted instance has no GitHub app of its own.
 // The instance's OWN admission gate runs at poll (direct) or exchange (federated),
 // so the stranger path is identical for both.
-async function runDeviceFlow(base, { log, idp = null }) {
+// `browser: true` (a returning builder's re-sign-in, task 1005118) asks the
+// instance for its own approval page instead of GitHub's code entry: a browser
+// that is already signed in approves with one click. An older instance ignores
+// the ask and answers GitHub's flow, which this loop runs unchanged.
+async function runDeviceFlow(base, { log, idp = null, browser = false }) {
   const startUrl = idp ? `${idp.origin}/api/bongos/sso/device/start` : `${base}/api/bongos/auth/device/start`;
   const start = await fetchJson(startUrl, {
     method: 'POST',
     // Federated: the hub resolves + binds the client from the USER-TYPED origin
     // (`base`), never a client_id we supply — so this CLI can only ever mint an
     // assertion scoped to the instance the user actually typed (ADR 0141 §1).
-    ...(idp ? { body: JSON.stringify({ origin: base }) } : {}),
+    ...(idp ? { body: JSON.stringify({ origin: base }) }
+      : browser ? { body: JSON.stringify({ approve_in_browser: true }) } : {}),
   });
   // ADR 0116 nests the slug at error.code (task 1003658). This site was half-converted:
   // it read the nested shape for idp_signing_unconfigured but kept a FLAT comparison for
@@ -142,10 +147,16 @@ async function runDeviceFlow(base, { log, idp = null }) {
   const expires = Number(start.data.expires_in) || 900;
 
   log('');
+  // An approval-page link (it carries the code) is longer than the box: print it
+  // whole underneath rather than cut it, so a browser that didn't open can be
+  // pointed at it by hand.
+  const uri = String(verification_uri);
+  const fits = uri.length <= 36;
   log('  ┌────────────────────────────────────────────┐');
-  log(`  │  Open:  ${String(verification_uri).slice(0, 36).padEnd(36)}│`);
+  if (fits) log(`  │  Open:  ${uri.padEnd(36)}│`);
   log(`  │  Code:  ${String(user_code).slice(0, 36).padEnd(36)}│`);
   log('  └────────────────────────────────────────────┘');
+  if (!fits) log(`  Open:  ${uri}`);
   log('');
   openBrowser(verification_uri);
   log('  Waiting for you to approve in the browser…');

package/scripts/bongos/plain-cards.js

@@ -324,7 +324,7 @@ const CARDS = Object.freeze({
     'You, to sign in.', RULE),
   session_invalid: card(
     'Your sign-in to the project has ended.',
-    'I will walk you through signing in again — Settings, then one copy and paste.',
+    'I will open a page in your browser — you click Approve, and that is all.',
     'You, to sign in again.', RULE),
   instance_mismatch: card(
     'This computer is signed in to a different project than the one this folder belongs to.',