@bongos/core 1.24.88 → 1.24.89

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

@@ -878,7 +878,7 @@ html[data-theme="dark"] .brand-mark__mark { --mark-ink: #e2e1e4; }
      with the count over its word, the one accent button (its name may take two lines; its key is in the sheet), and of
      the key hints only Actions, as its dots (every other hint is a row in its sheet). */
   html[data-game="on"] #visor { --visor-inset-bottom: 52px; }
-  html[data-game="on"] .visor__place, html[data-game="on"] .visor__notch, html[data-game="on"] .visor__frame--top, html[data-game="on"] .visor__name { display: none; }
+  html[data-game="on"] .visor__place, html[data-game="on"] .visor__progress, html[data-game="on"] .visor__notch, html[data-game="on"] .visor__frame--top, html[data-game="on"] .visor__name { display: none; }
   html[data-game="on"] .visor__foot { grid-template-columns: auto minmax(0, 1fr) auto; column-gap: var(--ds-space-hair); }
   html[data-game="on"] .visor__me, html[data-game="on"] .visor__hints { transform: none; }
   html[data-game="on"] .visor__me { gap: var(--ds-space-hair); }

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

@@ -308,9 +308,10 @@ html[data-fullscreen="on"] .sky-stage .top { padding-right: 184px; }
 /* 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)); }
+   the tour rise above the visor's corner pills. Task 1005203 put the version's progress under
+   the place, so the top offsets grew by its 24px. Outside game mode nothing here applies. */
+html.visor-on .top { padding-top: calc(84px + env(safe-area-inset-top, 0px)); }
+html.visor-on .composer, html.visor-on .jump { top: calc(140px + env(safe-area-inset-top, 0px)); }
+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)); }

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

@@ -13,7 +13,7 @@
 html[data-game="on"] .visor:not([hidden]) {
   display: block; position: fixed; inset: 0; z-index: 4; pointer-events: none;
   /* where the glass sits, so a scene's pop-up can keep clear of it (ADR 0399 §2.3) */
-  --visor-inset-top: 64px; --visor-inset-bottom: 76px;
+  --visor-arc: 64px; --visor-inset-top: 88px; --visor-inset-bottom: 76px;
   --visor-inset-right: max(var(--ds-space-gutter-narrow), var(--helm-inset)); --visor-inset-left: var(--visor-inset-right);
   color: var(--ink); font-family: var(--font-body);
 }
@@ -22,14 +22,14 @@ html[data-game="on"] .visor:not([hidden]) {
    top arc, its notch and the place all sit inside the top inset, above where a scene starts its
    own top row; the foot arc runs under the foot row. */
 .visor__frame { position: absolute; left: 0; width: 100%; overflow: visible; }
-.visor__frame--top { top: calc(var(--visor-inset-top) - 50px); height: 42px; }
+.visor__frame--top { top: calc(var(--visor-arc) - 50px); height: 42px; }
 .visor__frame--foot { bottom: calc(var(--visor-inset-bottom) - 44px); height: 18px; }
 .visor__frame path { vector-effect: non-scaling-stroke; }
 .visor__line { fill: none; stroke: var(--ink-soft); stroke-opacity: .6; stroke-width: var(--line-strong); }
 .visor__line--under { stroke: var(--bg); stroke-opacity: 1; stroke-width: 5px; }
 .visor__dot { fill: var(--ink-soft); stroke: var(--bg); stroke-width: var(--line-strong); }
 .visor__notch, .visor__sight { position: absolute; left: 50%; transform: translate(-50%, -50%); overflow: visible; }
-.visor__notch { top: calc(var(--visor-inset-top) - 36px); width: 12px; height: 9px; }
+.visor__notch { top: calc(var(--visor-arc) - 36px); width: 12px; height: 9px; }
 .visor__sight { top: 50%; width: 24px; height: 24px; }
 
 /* type over the scene stands on a small plate of the night, cut like everything pressable and
@@ -42,11 +42,29 @@ html[data-game="on"] .visor:not([hidden]) {
 
 /* the place, under the top arc */
 .visor__place {
-  position: absolute; left: 50%; top: calc(var(--visor-inset-top) - 26px); transform: translateX(-50%); margin: 0;
+  position: absolute; left: 50%; top: calc(var(--visor-arc) - 26px); transform: translateX(-50%); margin: 0;
   font-size: var(--ds-text-2xl); letter-spacing: var(--name-space-wide); line-height: 1.2;
   color: var(--ink-soft); white-space: nowrap; padding: 0 var(--ds-space-xs);
 }
 
+/* the version's progress under the place (task 1005203): the kit's four segments, then the same
+   reading in words (a row of bars is never the only reading). Done quarters are ice, the quarter
+   being built is the accent, the rest are outlines; each segment wears an outline of the night so it
+   reads over a midday sky. It sits under the arc band, inside the top inset (--visor-inset-top). */
+.visor__progress {
+  position: absolute; left: 50%; top: calc(var(--visor-arc) + 6px); transform: translateX(-50%);
+  display: flex; align-items: center; gap: var(--ds-space-xs); white-space: nowrap;
+}
+.visor__segs { flex-wrap: nowrap; }
+.visor__segs .seg { border-color: var(--ink-soft); outline: var(--line-strong) solid var(--night-plate); }
+.visor__segs .seg--done { background: var(--ink-soft); border-color: transparent; }
+.visor__segs .seg--now { background: var(--accent); border-color: transparent; }
+.visor__progress-words {
+  margin: 0; font-family: var(--name-face); font-weight: var(--name-weight); text-transform: var(--name-case);
+  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);
+}
+
 /* 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. */
 .visor__foot {

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

@@ -90,6 +90,39 @@
     var s = String(Math.abs(v)).replace(/\B(?=(\d{3})+(?!\d))/g, ',');
     return (v < 0 ? '−' : '') + s + (Math.abs(v) === 1 ? ' credit' : ' credits');
   }
+  // ---------- the version's progress (task 1005203) ----------
+  // Four segments under the place: the version the project is building, in quarters. The
+  // owner chose it (2026-11-11): the same number /status reports, never an invented one. The
+  // version is the starred focus while it is still open, else the first one building; with
+  // neither (or the read failing) there are no segments, never empty ones.
+  var progress = null; // { id, name, pct } once read
+  function pickVersion(rows, focusId) {
+    if (!Array.isArray(rows)) return null;
+    var open = function (r) { return r && r.status !== 'shipped' && r.status !== 'frozen'; };
+    var hit = null;
+    for (var i = 0; i < rows.length && !hit; i++) if (focusId && rows[i] && rows[i].version_id === focusId && open(rows[i])) hit = rows[i];
+    for (var j = 0; j < rows.length && !hit; j++) if (rows[j] && rows[j].status === 'building') hit = rows[j];
+    if (!hit) return null;
+    var pct = Number(hit.percent_complete);
+    if (!isFinite(pct)) return null;
+    return { id: String(hit.version_id || ''), name: String(hit.name || ''), pct: Math.max(0, Math.min(100, Math.round(pct))) };
+  }
+  // Each segment is a quarter: a quarter wholly built is done; the quarter being built now is
+  // the accent (it is where a claim lands); the rest are outlines. Pure, for the tests.
+  function segStates(pct) {
+    var out = [], full = Math.floor(Math.max(0, Math.min(100, pct)) / 25);
+    for (var i = 0; i < 4; i++) out.push(i < full ? 'done' : (i === full ? 'now' : 'todo'));
+    return out;
+  }
+  function readProgress() {
+    if (typeof fetch !== 'function') return;
+    var get = function (u) { return fetch(u, { credentials: 'same-origin' }).then(function (r) { return r.ok ? r.json() : null; }, function () { return null; }); };
+    Promise.all([get('/api/bongos/versions/progress'), get('/api/bongos/versions/focus')]).then(function (res) {
+      progress = pickVersion(res[0] && res[0].progress, res[1] && res[1].focus_version_id);
+      if (progress) render();
+    });
+  }
+
   // A link on the hall's own host: '/work' on the builders host, '/builders/work' on the apex.
   function hallHref(p) {
     var here = String((window.location && window.location.pathname) || '');
@@ -150,6 +183,7 @@
     var n = credits();
     return frameSvg() +
       (scene.place ? '<p class="visor__place">' + esc(scene.place) + '</p>' : '') +
+      progressHtml() +
       '<div class="visor__foot">' +
         '<div class="visor__me">' +
           (sprite ? '<img class="visor__sprite" src="' + esc(sprite) + '" alt="" width="250" height="290" decoding="async">' : '') +
@@ -165,6 +199,16 @@
         '</div>' +
       '</div>';
   }
+  // The kit's segments (controls.css .seg), always beside the words that say the same thing.
+  function progressHtml() {
+    if (!progress) return '';
+    var segs = segStates(progress.pct).map(function (s) { return '<li class="seg' + (s === 'todo' ? '' : ' seg--' + s) + '"></li>'; }).join('');
+    var said = progress.id + (progress.name ? ', ' + progress.name : '') + ': ' + progress.pct + '% built';
+    return '<div class="visor__progress" data-visor-progress title="' + esc(said) + '">' +
+      '<ol class="segs visor__segs" aria-hidden="true">' + segs + '</ol>' +
+      '<p class="visor__progress-words"><span class="sr-only">' + esc(said) + '</span>' +
+      '<span aria-hidden="true">' + esc(progress.id) + ' · ' + progress.pct + '%</span></p></div>';
+  }
   function sheetHtml(id) {
     var rows = actionsFor(id).map(function (a) {
       return '<li><a class="visor__row" data-visor-act="' + esc(a.id) + '" ' + actionAttrs(a) + '><span>' + esc(a.label) + '</span>' + keyHtml(a.key) + '</a></li>';
@@ -319,6 +363,7 @@
     document.addEventListener('otbcraft:me', render);
     document.addEventListener('otb:craft', render);
     render();
+    readProgress();
   }
   if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', start);
   else start();
@@ -335,5 +380,7 @@
     keyFor: keyFor,
     creditsText: creditsText,
     character: character,
+    pickVersion: pickVersion,
+    segStates: segStates,
   };
 })();

package/modules/hall-ui/records/game-mode.md

@@ -4,6 +4,7 @@ Covers: every shelled hall page (`shell-game.js`, `shell.js`). Spec: `docs/specs
 
 ## What it settled
 
+- **The visor is the control, the scene is the view ([ADR 0403](../../../docs/adr/0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md), owner 2026-11-11).** Every main call to action in game mode is on the visor; a game place's scene shows the project and can be moved through, but carries no buttons of its own. A scene hands its actions to the visor (`OTBVisor.scene`). A button in a scene is a defect.
 - **Game mode is the existing full-screen switch, made hall-wide. There is no second full-screen mode.** The switch was already on every page (task 1004430) but remembered per page, so a reader had to turn it on 33 times. Game mode is one `localStorage` key, `hall-game`; while it is `on`, `shell.js` `storedFullscreen()` answers yes for every page, whatever that page remembers. What hides, the corner button and the Escape hand-off are the shell's, unchanged.
 - **`shell-game.js` holds the mode and nothing else**: `window.OTBShellGame` = `on()`, `set(bool)`, `hint()`. It stamps `html[data-game="on"]` for a sheet or script that wants to read the mode. `shell.js` reads it through a fallback object, so a page without the file is never in game mode. It is its own file because `shell.js` sits on the 1,500-line ratchet; the start screen and options menu (R03, R04) are expected to grow here, not in `shell.js`.
 - **Load order**: `shell-game.js` before `shell-trail.js` / `craft-mode.js` / `shell.js`, loaded the same way (deferred or not) as the shell on that page. Test-pinned.

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

@@ -2,16 +2,21 @@
 
 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`.
 
+## 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 minimal visor (Helm look 3, task 1005195)
 
 The glass was redrawn to the owner's mock-up "Cloud city: in the visor, minimal". Look and layout only: every action, key, id, aria attribute, copy string and data source in `visor.js` is as task 1005148 left it. Where this section and the older bullets below disagree about the look or where a part sits, this section is current.
 
 - **What is on the glass.** Two thin arcs (one along the top, one under the foot row), a notch under the top arc, a ring-and-dot sight at the centre, the place in the name voice under the top arc, and one foot row: the sprite in a cut box with the character's name and the credits (white count, ice word); the one accent button, cut corner, with its key; the quiet key hints (a key in a small box and a name, no box round the pair). The compass cells, the side lines, the centre cross and the round pills are gone.
 - **Where each control went.** The main action is the accent button, centred. The character's other actions (after the game-places filter) are key hints on the right; they were rows in the sheet only. **Actions (A)** is demoted from a top-right pill to a key hint and still opens the same sheet, which now stands over the hints. **Options (Esc)** is the last hint, the same link the sheet's last row is. Nothing was removed.
-- **In the mock-up, not built, because the visor has no data for it:** the four progress segments, the marker and name on the building in view (the visor owns no camera, ADR 0399 §2.2), and the party bars with a speaker's name and a Voice key. Each is a scene or a later task handing the visor real data; none is drawn empty.
+- **The four progress segments (task 1005203).** Under the place: the version the project is building, in quarters, then the same reading in words (`BONGOS-V2 · 89%`; the screen reader hears the version's name too). The owner chose the measure (2026-11-11): the version's `percent_complete` from the public `GET /versions/progress`, the number /status reports. The version is the starred focus (`GET /versions/focus`) while it is still open, else the first one `building`; with neither, or a failed read, no segments. A quarter wholly built is the soft ink, the quarter being built is the accent, the rest are outlines; each wears an outline of the night, and the words stand on a night plate (`--night-plate`, the rule task 1005196 set), for a midday sky. The arc band is `--visor-arc` (64px) and the scene inset grew to 88px (`--visor-inset-top`), so the sky's top offsets in `thinking.css` grew by 24px. Hidden on a phone, with the place. Harness fixture: `versions__progress.json`.
+- **In the mock-up, not built, because the visor has no data for it:** the marker and name on the building in view (the visor owns no camera, ADR 0399 §2.2), and the party bars with a speaker's name and a Voice key. Each is a scene or a later task handing the visor real data; none is drawn empty.
 - **It reads over any sky, with no per-hour style, and it darkens none of it** (task 1005196, owner 2026-11-11: "I don't like how dark the edges of the view are"). The glass paints nothing of its own: the bands of `--night-glass` at its top and bottom edge are gone, and so is the dark halo round its type. The marks carry themselves. The place, each key hint and your name and credits stand on a small cut plate of the night (`--night-plate`, the ground at 88%), sized to the words; every line is drawn twice (a wider solid stroke of the night under the ice hairline, `.visor__line--under`), so an arc is ice on night and a dark line on cream cloud; a key sits on a chip of the night. One new token, `--night-plate`. Tried first and dropped: a 4px night stroke round each letter with no plate, which filled the condensed capitals in.
 - **A phone.** The shared phone block in `style.css` (no breakpoint of the visor's own): the top arc, its notch and the place step aside (the top of a phone is the scene's and the shell's); the foot row stays one line with nothing leaning (the sprite, the count over its word, the accent button whose name may wrap and whose key is left to the sheet, and of the hints only Actions, as three dots on a night chip). Between a phone and a wide desk the hints wrap onto a second line, right-aligned, rather than run into the button.
-- **Scenes.** The top arc, the notch and the place sit inside the top 64px (`--visor-inset-top`), the band the sky already leaves free, so no scene's top row is struck through. Home no longer shifts its greeting row left (there is no pill top-right to clear). The city's door rises above the foot row at every width, because the accent button is centred where the door stood. The sky's `visor-on` offsets are unchanged.
+- **Scenes.** The top arc, the notch and the place sit inside the top 64px (`--visor-arc`; the segments under them take the inset to 88px, `--visor-inset-top`), so no scene's top row is struck through. Home no longer shifts its greeting row left (there is no pill top-right to clear). The city's door rises above the foot row at every width, because the accent button is centred where the door stood. The sky's `visor-on` offsets are unchanged.
 - **Looking at it.** The stand-in scene in `tests/hall_visor.mjs` over the hall's real sheets; put a bright gradient behind it to check midday.
 
 ## What it settled (task 1005148)

package/package-lock.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.88",
+  "version": "1.24.89",
   "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

@@ -11631,5 +11631,11 @@
       "id": "1005188",
       "text": "Pressing Escape to close a building card on the city page no longer also brings the sidebar back."
     }
+  ],
+  "1.24.89": [
+    {
+      "id": "1005203",
+      "text": "In the game, the visor now shows four small bars for how much of the current version is built, and every main button in the game now belongs on the visor."
+    }
   ]
 }

package/src/module-api.js

@@ -81,7 +81,7 @@ const { sleep } = require('./sleep');
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.24.88'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.24.89'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('discord'); log.info('mounted');

package/tests/hall_visor.mjs

@@ -66,6 +66,33 @@ test('a key means an action only when nothing else spent it', () => {
   assert.equal(V.keyFor('artisan', ev('Escape')), null, 'the ambient glass never takes Escape (ADR 0399 §2.4)');
 });
 
+// task 1005203: the four segments are the version the project is building, in quarters.
+test('progress: the starred version while open, else the one building, else none', () => {
+  const V = loadPure();
+  const plain = (x) => JSON.parse(JSON.stringify(x));
+  const rows = [
+    { version_id: 'V1', name: 'One', status: 'shipped', percent_complete: 100 },
+    { version_id: 'V2', name: 'Two', status: 'building', percent_complete: 89 },
+    { version_id: 'V3', name: 'Three', status: 'planning', percent_complete: 39 },
+  ];
+  assert.deepEqual(plain(V.pickVersion(rows, 'V3')), { id: 'V3', name: 'Three', pct: 39 }, 'the starred version wins while it is open');
+  assert.equal(V.pickVersion(rows, 'V1').id, 'V2', 'a starred version that shipped falls back to the one building');
+  assert.equal(V.pickVersion(rows, null).id, 'V2');
+  assert.equal(V.pickVersion(rows.filter((r) => r.status !== 'building'), null), null, 'nothing building: no segments, never empty ones');
+  assert.equal(V.pickVersion(null, 'V2'), null, 'a failed read draws nothing');
+  assert.equal(V.pickVersion([{ version_id: 'V9', status: 'building' }], null), null, 'no percent: no invented one');
+});
+
+test('progress: each segment is a quarter, and only the quarter being built is the accent', () => {
+  const V = loadPure();
+  const s = (p) => JSON.parse(JSON.stringify(V.segStates(p)));
+  assert.deepEqual(s(0), ['now', 'todo', 'todo', 'todo']);
+  assert.deepEqual(s(24), ['now', 'todo', 'todo', 'todo']);
+  assert.deepEqual(s(25), ['done', 'now', 'todo', 'todo']);
+  assert.deepEqual(s(89), ['done', 'done', 'done', 'now']);
+  assert.deepEqual(s(100), ['done', 'done', 'done', 'done'], 'a finished version has nothing left to build');
+});
+
 test('credits, never a payout: the count reads as credits, with thousands grouped', () => {
   const V = loadPure();
   assert.equal(V.creditsText(56021), '56,021 credits');