@bongos/core 1.25.1 → 1.25.3

package/modules/hall-ui/public/genesis-home.js

@@ -28,7 +28,7 @@
   var DAY_CHOICES = [1, 2, 3, 4, 5, 7, 10, 14, 21, 30];
   var REFUSED = {
     stage_tasks_unfinished: 'This stage still has unfinished tasks.',
-    not_current_stage: 'That stage is not the one in progress.',
+    not_current_stage: 'That stage is already behind you.',
     legislation_not_passed: 'Legislation has to pass the Board Room first.',
     not_deciding: 'The plan is already settled.',
   };
@@ -159,9 +159,15 @@
     }).join('') + '</ol>';
   }
 
+  // task 1005199: a later stage can already be in the Board Room, or passed and
+  // waiting for the stages before it, so its line says so instead of just "later".
   function stateText(s) {
     if (s.state === 'done') return 'done';
-    if (s.state === 'later') return 'later';
+    var b = s.board && s.board.state;
+    if (b === 'sitting') return 'in the Board Room';
+    if (b === 'passed') return s.state === 'later' ? 'passed, waits its turn' : 'passed';
+    if (b === 'returned') return 'sent back';
+    if (s.state === 'later') return s.total && s.finished === s.total ? 'ready for the board' : 'later';
     return s.total ? s.finished + ' of ' + s.total + ' done' : 'in progress';
   }
 
@@ -175,7 +181,9 @@
       return '<li class="genesis__stage is-' + s.state + '">'
         + '<span class="genesis__stage-n">0' + s.number + '</span>'
         + '<span class="genesis__stage-t"><b>' + esc(s.label) + '</b>'
-        + '<span>' + esc(wakes.length ? 'Wakes ' + wakes.join(', ') : '') + esc(due) + '</span></span>'
+        + '<span>' + esc(wakes.length ? 'Wakes ' + wakes.join(', ') : '') + esc(due) + '</span>'
+        + (s.state === 'later' && s.can_close ? '<span><button type="button" class="btn-ghost" data-genesis-close="' + esc(s.key) + '">Put to the board</button></span>' : '')
+        + '</span>'
         + '<span class="genesis__stage-st">' + esc(stateText(s)) + '</span></li>';
     }).join('') + '</ol>';
   }
@@ -222,6 +230,37 @@
     return '<p class="genesis__note">Finish every task above, then put this stage to the board.</p>';
   }
 
+  // ── every stage vote waiting on the viewer, in one place (task 1005199) ──────
+  // Each finished stage sits in the Board Room at once; this lists the ones still
+  // waiting on THIS viewer's vote, in stage order, and one button votes yes on all of
+  // them in that order. They still pass in order: the project only moves past a
+  // stage whose own sitting passed.
+  function votesWaiting(g, viewerId) {
+    return g.stages.filter(function (s) {
+      var b = s.board;
+      return b && b.state === 'sitting' && b.item_id && (b.waiting_on || []).some(function (m) {
+        return String(m.builder_id) === String(viewerId);
+      });
+    });
+  }
+
+  function votesHtml(g, viewerId) {
+    var list = votesWaiting(g, viewerId);
+    // The current stage's own Confirm button already covers a lone vote on it.
+    if (!list.length || (list.length === 1 && list[0].state === 'now')) return '';
+    var many = list.length > 1;
+    return '<section class="genesis__now" aria-labelledby="genesis-votes-h">'
+      + '<h3 id="genesis-votes-h" class="genesis__now-h">Waiting for your vote · ' + list.length + (many ? ' stages' : ' stage') + '</h3>'
+      + '<ul class="genesis__tasks">' + list.map(function (s) {
+        return '<li class="genesis__task"><span class="genesis__task-t">0' + s.number + ' ' + esc(s.label) + '</span></li>';
+      }).join('') + '</ul>'
+      // The rule is said once: every stage put up under one constitution reads the same.
+      + '<p class="genesis__note">' + esc(list[0].board.needs ? list[0].board.needs + ' ' : '')
+      + 'They pass in order: a later stage waits for the ones before it.</p>'
+      + '<div class="genesis__doors"><button type="button" class="btn-accent" data-genesis-vote-all>' + (many ? 'Vote yes on all ' + list.length : 'Vote yes') + '</button>'
+      + '<a class="btn-ghost" href="/board-room">Open the Board Room</a></div></section>';
+  }
+
   function aliveHtml() {
     var name = projectName();
     return '<div class="genesis__alive">'
@@ -254,7 +293,7 @@
     if (!g) { host.hidden = true; return; }
     host.innerHTML = headHtml(g) + (g.deciding
       ? decideHtml(g, state.gov)
-      : demoHtml(g) + lifeHtml(g) + '<div class="genesis__grid">' + stagesHtml(g) + nowHtml(g, state.viewer) + '</div>');
+      : demoHtml(g) + lifeHtml(g) + votesHtml(g, state.viewer) + '<div class="genesis__grid">' + stagesHtml(g) + nowHtml(g, state.viewer) + '</div>');
     host.hidden = false;
   }
 
@@ -345,6 +384,17 @@
       } else if (t.hasAttribute('data-genesis-confirm')) {
         act(send('POST', '/government/board/items/' + encodeURIComponent(t.getAttribute('data-genesis-confirm')) + '/votes', { direction: 'yes' })
           .then(function () { return load(host, state); }));
+      } else if (t.hasAttribute('data-genesis-vote-all')) {
+        // One yes per stage, earliest first, each after the last has landed (task
+        // 1005199). A refusal on one stage stops the run and says why; the rest stay.
+        var ids = votesWaiting(state.genesis, state.viewer).map(function (s) { return s.board.item_id; });
+        act(ids.reduce(function (p, id) {
+          return p.then(function () {
+            return send('POST', '/government/board/items/' + encodeURIComponent(id) + '/votes', { direction: 'yes' });
+          });
+        }, Promise.resolve()).then(function () { return load(host, state); }, function (err) {
+          return load(host, state).then(function () { throw err; });
+        }));
       } else if (t.hasAttribute('data-genesis-alive')) {
         act(send('POST', '/founding/alive', {}).then(function () { host.innerHTML = aliveHtml(); }));
       } else if (t.hasAttribute('data-genesis-enter')) {

package/modules/hall-ui/public/index-genesis-votes.states.json

@@ -0,0 +1,61 @@
+{
+  "_": "Several genesis stages sitting in the Board Room at once, with the vote-on-all panel (task 1005199). Same shell as index-genesis.states.json; /founding/genesis answers founding-genesis-votes.json, built from the real server shaper.",
+  "page": "/builders/",
+  "_storage": "The hall asks a first-visit question (the session mode picker, craft-mode.js) over every page; seeding \"already asked\" renders the page a returning builder sees (task 1005080).",
+  "storage": {
+    "session": {
+      "hall-craft-asked": "1"
+    }
+  },
+  "surface": "hall-ui",
+  "stub": {
+    "prefix": "/builders/",
+    "fixtures": {
+      "me": "me-founding",
+      "founding-genesis": "founding-genesis-votes"
+    }
+  },
+  "modeQuery": false,
+  "ignoreRequests": [
+    "/api/(gds|bongos)/me$",
+    "/api/(gds|bongos)/me/",
+    "/api/(gds|bongos)/tasks",
+    "/api/(gds|bongos)/claims",
+    "/api/(gds|bongos)/goals",
+    "/api/(gds|bongos)/inbox",
+    "/api/(gds|bongos)/live",
+    "/api/(gds|bongos)/analytics/",
+    "/api/(gds|bongos)/achievements",
+    "/api/(gds|bongos)/versions",
+    "/api/(gds|bongos)/leaderboard",
+    "/api/(gds|bongos)/removal-proposals",
+    "/api/(gds|bongos)/blockers"
+  ],
+  "_ignored": "removal-proposals and blockers are fixtures the kit stub does not carry; index.states.json's home render reports the same two 404s.",
+  "ignoreConsole": [
+    "/api/(gds|bongos)/",
+    "\\b401\\b",
+    "\\b404\\b",
+    "Unauthorized",
+    "Not Found",
+    "load failed"
+  ],
+  "states": {
+    "votes": {
+      "auth": true,
+      "actions": [
+        [
+          "wait",
+          800
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#genesis-home",
+          "#founding-band",
+          "#genesis-votes-h"
+        ]
+      }
+    }
+  }
+}

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

@@ -11,9 +11,10 @@
 //     the character's colour; task 1005218), your character's name and your credits
 //     (builders.total_credits — credits only, never a payout; the spec's "does not exist").
 //     Centre: your character's main action, the one accent button, with its key. Right: the
-//     quiet key hints, no boxes: your other actions, "Actions" (key A), which opens the
-//     sheet (your character's actions, then the keys of the place you are in, then Options
-//     on Escape), and Options itself.
+//     quiet key hints, no boxes: your other actions and "Actions" (key A), which opens the
+//     sheet (your character's actions, then the keys of the place you are in, then Options on
+//     a key of its own; Escape closes it). Options is only in the sheet (task 1005248).
+//   - every key comes from resolveKeys: one owner per key, never two (task 1005248).
 //
 // The rules it keeps (ADR 0399):
 //   - one overlay, #visor, with pointer-events: none; only its controls take a pointer, so a
@@ -59,6 +60,11 @@
     ],
   };
   var SHEET_KEY = 'a';
+  var CLOSE_KEY = 'esc';   // shown once: the sheet's Close (Escape)
+  var OPTIONS = { id: 'options', label: 'Options', key: 'o', href: '/settings' };
+  // Keys a scene binds on its own page (the sky's L 0 / ?, the gallery's F, the palette's K).
+  // A moved key never lands on one of them; a scene that declares one keeps it.
+  var AVOID = ['l', '0', '/', '?', 'f', 'k', '+', '-', '='];
   var NAMES = { artisan: 'Artisan', artist: 'Artist', patron: 'Patron' };
 
   function esc(v) { return window.OTB && window.OTB.escapeHtml ? window.OTB.escapeHtml(v) : String(v == null ? '' : v).replace(/[^\w .,:'-]/g, ''); }
@@ -151,6 +157,42 @@
     render();
   }
 
+  // ---------- the keys: one resolver, so no key ever means two things (task 1005248) ----------
+  // Every key the visor shows or binds comes from here, and here hands each key out once.
+  // A key in ACTIONS or a scene's registration is a RECOMMENDATION: when it is already taken
+  // the action moves to the next free letter of its own name, then of the alphabet, and with
+  // none free it shows and binds no key at all. Never two owners. In order of who keeps a key:
+  //   1. the visor's own: A (Actions) and Escape (Close, while the sheet is open);
+  //   2. the keys a scene binds itself (an action without `bind`, and the `keys` lines): the
+  //      visor cannot move a key it does not bind, so a second claim on one shows no key;
+  //   3. the character's actions, in order; 4. the scene's `bind` actions; 5. Options.
+  function norm(k) { return k ? String(k).toLowerCase() : ''; }
+  function resolveKeys(id) {
+    var taken = {};
+    function claim(k, who) { if (!k || taken[k]) return ''; taken[k] = who; return k; }
+    function free(pref, label, who) {
+      var got = claim(norm(pref), who);
+      if (got || !pref) return got;
+      var pool = String(label || '').toLowerCase().replace(/[^a-z]/g, '') + 'abcdefghijklmnopqrstuvwxyz';
+      for (var i = 0; i < pool.length; i++) if (AVOID.indexOf(pool[i]) < 0 && claim(pool[i], who)) return pool[i];
+      return '';
+    }
+    claim(SHEET_KEY, 'sheet');
+    claim(CLOSE_KEY, 'close');
+    var sa = scene ? scene.actions : [], sk = scene ? scene.keys : [];
+    var place = sa.map(function () { return ''; });
+    sa.forEach(function (a, i) { if (!a.bind) place[i] = claim(norm(a.key), 'place:' + i); });
+    var lines = sk.map(function (k, i) { return claim(norm(k.key), 'line:' + i); });
+    var acts = actionsFor(id).map(function (a) {
+      var c = {}; for (var p in a) c[p] = a[p];
+      c.key = free(a.key, a.label, a.id);
+      return c;
+    });
+    sa.forEach(function (a, i) { if (a.bind) place[i] = free(a.key, a.label, 'place:' + i); });
+    var opts = { id: OPTIONS.id, label: OPTIONS.label, href: OPTIONS.href, key: free(OPTIONS.key, OPTIONS.label, OPTIONS.id) };
+    return { actions: acts, place: place, lines: lines, options: opts, taken: taken };
+  }
+
   // ---------- what the scene has picked (task 1005243) ----------
   // A scene that picks something (Home's tower) hands the visor a small card about it:
   // a title, one status, a few lines, and at most one action. The action becomes the
@@ -227,7 +269,7 @@
       svgOpen('visor__notch', '0 0 12 9') + twice('<path class="visor__line" d="M0 0l6 9l6 -9"/>') + '</svg>' +
       svgOpen('visor__sight', '0 0 24 24') + twice('<circle class="visor__line" cx="12" cy="12" r="11"/>') + '<circle class="visor__dot" cx="12" cy="12" r="2"/></svg>';
   }
-  function keyHtml(k) { k = String(k); return '<kbd class="visor__key">' + esc(k.length === 1 ? k.toUpperCase() : k) + '</kbd>'; }
+  function keyHtml(k) { k = String(k || ''); if (!k) return ''; if (k === CLOSE_KEY) k = 'Esc'; return '<kbd class="visor__key">' + esc(k.length === 1 ? k.toUpperCase() : k) + '</kbd>'; }
   // The count and its unit are two spans, so the number can be white and the word ice; the
   // text between them is still creditsText's, word for word.
   function creditsHtml(n) {
@@ -240,14 +282,14 @@
     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 placeHintHtml(a, i, key) {
+    return '<button class="visor__hint visor__hint--place" type="button" data-visor-scene="' + i + '">' + keyHtml(key) + '<span>' + esc(a.label) + '</span></button>';
   }
   function actionAttrs(a) {
     return a.href ? 'href="' + esc(hallHref(a.href)) + '"' : 'href="#" role="button"';
   }
   function glassHtml(id) {
-    var acts = actionsFor(id), main = acts[0], C = craft();
+    var keys = resolveKeys(id), acts = keys.actions, main = acts[0], C = craft();
     // Your picture on the glass is you wearing the visor (task 1005218); an older craft-mode
     // without that picture still hands over the whole figure.
     var sprite = C && typeof C.portraitSrc === 'function' ? C.portraitSrc(id) : (C && typeof C.spriteSrc === 'function' ? C.spriteSrc(id) : '');
@@ -263,10 +305,9 @@
           '<span class="visor__credits" data-visor-credits>' + creditsHtml(n) + '</span></span>' +
         '</div>' +
         mainHtml(main) +
-        '<div class="visor__hints">' + scene.actions.map(function (a, i) { return a.lead ? placeHintHtml(a, i) : ''; }).join('') + acts.slice(1).map(hintHtml).join('') +
+        '<div class="visor__hints">' + scene.actions.map(function (a, i) { return a.lead ? placeHintHtml(a, i, keys.place[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>' +
         '</div>' +
       '</div>';
   }
@@ -280,20 +321,22 @@
       '<p class="visor__progress-words"><span class="sr-only">' + esc(said) + '</span>' +
       '<span aria-hidden="true">' + esc(progress.id) + ' · ' + progress.pct + '%</span></p></div>';
   }
+  // Options lives only in here (the owner, 2026-11-12), on a key of its own: Escape is Close.
   function sheetHtml(id) {
-    var rows = actionsFor(id).map(function (a) {
+    var keys = resolveKeys(id);
+    var rows = keys.actions.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>';
     }).join('');
     var place = scene.actions.map(function (a, i) {
-      return '<li><button class="visor__row" type="button" data-visor-scene="' + i + '"><span>' + esc(a.label) + '</span>' + (a.key ? keyHtml(a.key) : '') + '</button></li>';
-    }).concat(scene.keys.map(function (k) {
-      return '<li><span class="visor__row visor__row--hint"><span>' + esc(k.label) + '</span>' + keyHtml(k.key) + '</span></li>';
+      return '<li><button class="visor__row" type="button" data-visor-scene="' + i + '"><span>' + esc(a.label) + '</span>' + keyHtml(keys.place[i]) + '</button></li>';
+    }).concat(scene.keys.map(function (k, i) {
+      return '<li><span class="visor__row visor__row--hint"><span>' + esc(k.label) + '</span>' + keyHtml(keys.lines[i]) + '</span></li>';
     })).join('');
     return '<div class="visor__sheet-head"><h2 class="visor__sheet-title" id="visor-sheet-title">Actions</h2>' +
-        '<button class="visor__close" type="button" data-visor-close aria-label="Close actions">' + keyHtml('Esc') + '</button></div>' +
+        '<button class="visor__close" type="button" data-visor-close aria-label="Close actions">' + keyHtml(CLOSE_KEY) + '</button></div>' +
       '<p class="visor__cap">' + esc(NAMES[id]) + '</p><ul class="visor__rows">' + rows + '</ul>' +
       (place ? '<p class="visor__cap">This place</p><ul class="visor__rows">' + place + '</ul>' : '') +
-      '<ul class="visor__rows"><li><a class="visor__row" href="' + esc(hallHref('/settings')) + '"><span>Options</span>' + keyHtml('Esc') + '</a></li></ul>';
+      '<ul class="visor__rows"><li><a class="visor__row" data-visor-act="options" href="' + esc(hallHref(keys.options.href)) + '"><span>' + esc(keys.options.label) + '</span>' + keyHtml(keys.options.key) + '</a></li></ul>';
   }
   function shown() { return !!(root && !root.hidden); }
   function render() {
@@ -375,10 +418,12 @@
       if (C && typeof C.openTool === 'function') C.openTool(a.tool);
       return;
     }
+    // Options opens the game's options window over the place when it can (shell-game.js)
+    if (a.id === OPTIONS.id && window.OTBOptionsOverlay && typeof window.OTBOptionsOverlay.open === 'function') { window.OTBOptionsOverlay.open(); return; }
     if (a.href) window.location.assign(hallHref(a.href));
   }
   function find(id) {
-    var acts = actionsFor(character());
+    var acts = resolveKeys(character()).actions;
     for (var i = 0; i < acts.length; i++) if (acts[i].id === id) return acts[i];
     return null;
   }
@@ -415,11 +460,12 @@
     if (!e || e.defaultPrevented || e.ctrlKey || e.metaKey || e.altKey || typeof e.key !== 'string' || e.key.length !== 1) return null;
     var k = e.key.toLowerCase();
     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
+    // the resolver gave each key one owner, so the first match is the only one
+    var keys = resolveKeys(id);
+    for (var i = 0; i < keys.actions.length; i++) if (keys.actions[i].key === k) return keys.actions[i];
     var own = scene ? scene.actions : [];
-    for (var j = 0; j < own.length; j++) if (own[j].bind && own[j].key === k) return own[j];
+    for (var j = 0; j < own.length; j++) if (own[j].bind && keys.place[j] === k) return own[j];
+    if (keys.options.key === k) return keys.options;
     return null;
   }
   // Bubble, on window: a scene or pop-up that used the key has called preventDefault by now.
@@ -460,6 +506,7 @@
     ACTIONS: ACTIONS,
     actionsFor: actionsFor,
     keyFor: keyFor,
+    resolveKeys: resolveKeys,
     creditsText: creditsText,
     character: character,
     pickVersion: pickVersion,

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

@@ -6,6 +6,13 @@ Covers: `visor.js` + `visor.css`, loaded on Home, `/city`, `/goal-map` and `/thi
 
 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 the sky since task 1005210, and Home's gallery since task 1005211 (below).
 
+## One owner per key (task 1005248, owner 2026-11-12)
+
+- **The bug.** The Artist saw Esc twice: "Options" on the glass, then in the Actions sheet both Close and the Options row said Esc.
+- **The rule.** A key in `ACTIONS` or a scene's registration is a recommendation. `resolveKeys(id)` in `visor.js` hands every key out once, and the glass, the sheet and `keyFor` all read it; nothing else names a key. Who keeps a key, in order: the visor's own (A Actions, Escape Close); the keys a scene binds itself (an action without `bind`, the `keys` lines), because the visor cannot move a key it does not bind, so a second claim on one shows no key; the character's actions; the scene's `bind` actions; Options. A later claimant moves to the next free letter of its own name, then of the alphabet, never onto a key a scene binds on its page (`AVOID`: L 0 / ? F K + - =); with none free it has no key.
+- **Options is only in the sheet** (the owner likes it there), on O, or its next free letter (the Patron's O is the Board room, so P). Pressing it opens the options window over the place, like a click. Escape on the glass is the sheet's Close only. The shell's "last Escape opens the options menu" (`shell-game.js`, ADR 0399 §2.4) is not a visor key and is unchanged.
+- **Tests:** `tests/hall_visor.mjs` proves no shared key for every character over the sky, the city and Home, and over a hostile scene that claims A, Escape, a character key and one key twice.
+
 ## 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.

package/modules/onboarding/founding-mode.js

@@ -37,7 +37,10 @@ const WAKES = Object.freeze({
   // task 1005051: Roadmap folded into Goals, so scope wakes Goals and its map.
   scope: Object.freeze(['goals', 'goal-map']),
   strategize: Object.freeze(['work']),
-  charter: Object.freeze(['board-room']),
+  // task 1005199: charter woke the Board Room, but scope and strategize are already
+  // closed by a vote there, so the room read as locked while the founder had a ballot
+  // in it. The Board Room is awake for the whole of genesis; charter wakes no room.
+  charter: Object.freeze([]),
   // task 1005046: legalize woke Economy and legislation woke Ranks. Both pages
   // are Primer chapters now (one reading room), and the Primer never sleeps —
   // it is the newcomer's first read — so these two stages wake no sidebar room.

package/modules/onboarding/genesis-home.js

@@ -156,6 +156,8 @@ function shapeGenesis({ mode, plan, tasks = {}, board = {}, stageAt = {} }) {
     const idx = fm.STAGES.indexOf(key);
     const list = (tasks[key] || []).map((t) => ({ ...t, finished: FINISHED.includes(t.status) }));
     const b = board[key] || null;
+    const allFinished = list.length > 0 && list.every((t) => t.finished);
+    const onBoard = !!(b && (b.state === 'sitting' || b.state === 'passed'));
     const days = plan && plan.days && plan.days[key] ? plan.days[key] : info.days;
     // A demo's stage is minutes long (task 1004506); its due time is counted in them.
     const minutes = plan && plan.minutes && plan.minutes[key] ? plan.minutes[key] : null;
@@ -177,6 +179,9 @@ function shapeGenesis({ mode, plan, tasks = {}, board = {}, stageAt = {} }) {
       tasks: list,
       finished: list.filter((t) => t.finished).length,
       total: list.length,
+      // task 1005199: this stage (the current one or any later one) can be put to
+      // the Board Room now — its tasks are all finished and it is not already there.
+      can_close: at >= 1 && idx >= at && allFinished && !onBoard,
       board: b ? {
         state: b.state, item_id: b.item_id || null, needs: b.needs || null,
         one_vote_decides: !!b.one_vote_decides, waiting_on: b.waiting_on || [],
@@ -349,7 +354,15 @@ async function closeStage(stageKey, builderId, deps = {}) {
   const s = seams(deps);
   const mode = await reconcile(s);
   if (!mode) return { ok: false, reason: 'not_founding' };
-  if (mode.stage !== stageKey) return { ok: false, reason: 'not_current_stage', stage: mode.stage };
+  // task 1005199: any stage at or AFTER the current one may be put up, so every
+  // finished stage can sit in the Board Room at once. Order is kept by reconcile, not
+  // here: the project only moves past a stage whose own sitting passed, so a later
+  // stage's pass waits for the earlier ones. A stage already behind, or the decide
+  // pre-stage, is still refused.
+  if (!PROPER.includes(stageKey)) return { ok: false, reason: 'unknown_stage' };
+  if (!PROPER.includes(mode.stage) || fm.STAGES.indexOf(stageKey) < fm.STAGES.indexOf(mode.stage)) {
+    return { ok: false, reason: 'not_current_stage', stage: mode.stage };
+  }
   const all = s.lifecycle && typeof s.lifecycle.genesisTasks === 'function' ? await s.lifecycle.genesisTasks() : {};
   const list = all[stageKey] || [];
   const taskIds = list.map((t) => t.id);
@@ -357,9 +370,13 @@ async function closeStage(stageKey, builderId, deps = {}) {
   const nextOf = (key) => (key === 'legislation' ? null : fm.STAGES[fm.STAGES.indexOf(key) + 1]);
   const closedAnswer = async (itemId, confirm) => {
     const after = await reconcile(s);
+    const at = after && after.stage;
     return {
       ok: true, closed: true, stage: stageKey,
-      next_stage: stageKey === 'legislation' ? null : (after && after.stage) || nextOf(stageKey),
+      next_stage: stageKey === 'legislation' && at === 'legislation' ? null : at || nextOf(stageKey),
+      // task 1005199: a later stage passed while an earlier one is still open, so
+      // the project stays at the earlier stage until that one passes too.
+      waits_for_earlier: !!(at && fm.STAGES.indexOf(at) < fm.STAGES.indexOf(stageKey)),
       item_id: itemId, confirm,
     };
   };
@@ -379,6 +396,9 @@ async function closeStage(stageKey, builderId, deps = {}) {
     return sittingOpen(stageKey, r.item ? String(r.item.id) : null, !r.opened, board[stageKey] || null, builderId);
   }
   if (!list.length || !list.every((t) => FINISHED.includes(t.status))) return { ok: false, reason: 'stage_tasks_unfinished' };
+  // With no Board Room there is no sitting to hold a later stage, so only the
+  // current one can be closed here; a later one waits its turn.
+  if (stageKey !== mode.stage) return { ok: false, reason: 'not_current_stage', stage: mode.stage };
   if (stageKey !== 'legislation') {
     await fm.setFoundingMode({ stage: nextOf(stageKey) }, builderId, modeDeps(s));
   }
@@ -452,9 +472,44 @@ async function onStagePassed(deps = {}) {
   try { await reconcile(seams(deps)); } catch (_) { /* recovered on the next read */ }
 }
 
+// putFinishedStages — shipping a stage puts it in the Board Room by itself (task
+// 1005199). Every stage at or after the current one whose tasks are all finished and
+// that has NEVER been put to the board is opened as a sitting, with nobody's vote cast:
+// the founder still says yes, but no longer has to press "close" first. A stage the
+// board sent back is left for the founder to put up again on purpose. Opening is the
+// government port's own gate (finished tasks, one sitting per stage), so a race with a
+// manual close opens one sitting, not two. Returns the stage keys it put up.
+async function putFinishedStages(deps = {}) {
+  const s = seams(deps);
+  const gov = s.government;
+  if (!gov || typeof gov.openGenesisStageClose !== 'function') return [];
+  const mode = await reconcile(s);
+  if (!mode || !PROPER.includes(mode.stage)) return [];
+  const all = s.lifecycle && typeof s.lifecycle.genesisTasks === 'function' ? await s.lifecycle.genesisTasks() : {};
+  const board = await boardByStage(gov);
+  const put = [];
+  for (const key of PROPER.slice(PROPER.indexOf(mode.stage))) {
+    const list = all[key] || [];
+    if (!list.length || !list.every((t) => FINISHED.includes(t.status))) continue;
+    const st = board[key] && board[key].state;
+    if (st && st !== 'not_put') continue;
+    const r = await gov.openGenesisStageClose({ stageKey: key, taskIds: list.map((t) => t.id), openedBy: null });
+    if (r && r.opened) put.push(key);
+  }
+  return put;
+}
+
+// onTaskShipped — the `task.shipped` listener. Any ship may be the last task of a
+// stage; on a project that is not founding this costs the one genesis.enabled read.
+// Best-effort: the founder's own close button is still there if this misses.
+async function onTaskShipped(deps = {}) {
+  try { return await putFinishedStages(deps); } catch (_) { return []; }
+}
+
 module.exports = {
   PLAN_KEY, STAGE_INFO, PROPER, DEMO_PEOPLE, DEMO_HOURS, intIn, parsePlan, shapeGenesis, demoMinutes, demoPlan,
   readGenesis, startFounding, savePlan, applyGovernmentChoice, closeStage, comeAlive, skipGenesis, onStagePassed,
+  putFinishedStages, onTaskShipped,
   // the founding-mode deps this file reads the mode with, for founding-birth.js (task 1004506)
   modeDepsFor: (deps) => modeDeps(seams(deps)),
 };

package/modules/onboarding/routes/onboarding.js

@@ -134,6 +134,8 @@ function mountGenesisRoutes(router) {
   if (!genesisListening && typeof api.on === 'function') {
     genesisListening = true;
     api.on('board.genesis_stage.passed', () => genesis.onStagePassed());
+    // task 1005199: a ship that finishes a stage puts that stage in the Board Room.
+    api.on('task.shipped', () => genesis.onTaskShipped());
   }
   const owns = api.requirePermission('project.settings.manage');
   const refuse = (res, r) => res.status(GENESIS_REFUSALS[r.reason] || 409).json({