@bongos/core 1.24.74 → 1.24.76

package/docs/page-readings.json

@@ -215,7 +215,7 @@
       "surface": "builders",
       "title": "Board Room",
       "states_read": ["room","out","sitting-meta","objection-form"],
-      "files_hash": "9461cd6cbc270ae2",
+      "files_hash": "0e6e17f03283a4a6",
       "reading_hash": "020553cb2a438d56",
       "counts": {"lines":51,"placed":18,"shared":9,"unplaced":24},
       "omitted": {"data":15},
@@ -246,18 +246,18 @@
         {"key":"L0023","section":"{…} Full Idea","text":"Scope it as best as you can here","placement":"unplaced"},
         {"key":"L0024","section":"{…} Full Idea","text":"What should an {…} or {…} know prior to building","placement":"unplaced"},
         {"key":"L0025","section":"{…} Full Idea","text":"How is this long term justified in the project","placement":"unplaced"},
-        {"key":"L0026","section":"{…} Full Idea","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":480,"string_id":"d73256fbc395","occurrences":9},
+        {"key":"L0026","section":"{…} Full Idea","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":484,"string_id":"d73256fbc395","occurrences":9},
         {"key":"L0027","section":"Constitutional amendment amendment","text":"Constitutional amendment","placement":"unplaced","occurrences":3},
         {"key":"L0028","section":"Constitutional amendment amendment","text":"amendment","placement":"unplaced","occurrences":3},
         {"key":"L0029","section":"Constitutional amendment amendment","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":173,"string_id":"9a803563c948"},
         {"key":"L0030","section":"Constitutional amendment amendment","text":"no clock — waits for a {…} yes","placement":"unplaced"},
         {"key":"L0031","section":"Constitutional amendment amendment","text":"Proposes","placement":"unplaced","occurrences":3},
-        {"key":"L0032","section":"Constitutional amendment amendment","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":480,"string_id":"d73256fbc395","occurrences":3},
+        {"key":"L0032","section":"Constitutional amendment amendment","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":484,"string_id":"d73256fbc395","occurrences":3},
         {"key":"L0033","section":"Constitutional amendment amendment","text":"Closed sittings","placement":"unplaced"},
         {"key":"L0034","section":"{…} Full Idea","text":"passed","placement":"placed","file":"modules/hall-ui/public/government.js","line":679,"string_id":"da5368d10f85","occurrences":8},
         {"key":"L0035","section":"{…} and {…}","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":5},
         {"key":"L0036","section":"{…} and {…}","text":"Full Idea","placement":"unplaced","occurrences":5},
-        {"key":"L0037","section":"{…} and {…}","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":480,"string_id":"d73256fbc395","occurrences":5},
+        {"key":"L0037","section":"{…} and {…}","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":484,"string_id":"d73256fbc395","occurrences":5},
         {"key":"L0038","section":"Constitutional amendment amendment","text":"passed","placement":"placed","file":"modules/hall-ui/public/government.js","line":679,"string_id":"da5368d10f85","occurrences":2},
         {"key":"L0039","section":"Constitutional amendment amendment","text":"{\"{…}_{…}\":\"{…}\",\"membership\":\"{…}\",\"window_minutes\":1440,\"close_early_on_{…}_turnout\":true}","placement":"unplaced","occurrences":2},
         {"key":"L0040","section":"Constitutional amendment amendment","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":2},
@@ -604,7 +604,7 @@
       "surface": "builders",
       "title": "Deploy",
       "states_read": ["work","out"],
-      "files_hash": "a0ab8445ee5bf294",
+      "files_hash": "5fa46643d448b50c",
       "reading_hash": "76c11d0fbc739610",
       "counts": {"lines":19,"placed":5,"shared":9,"unplaced":5},
       "omitted": {"data":3},
@@ -974,8 +974,8 @@
       "surface": "builders",
       "title": "Builders' Hall",
       "states_read": ["home","out","founding","genesis","decide","demo"],
-      "files_hash": "5c8e267006cb62e1",
-      "reading_hash": "4cc2e5e86483a66e",
+      "files_hash": "fc8a81cb746dba23",
+      "reading_hash": "ae7a0c466a3aee85",
       "counts": {"lines":28,"placed":9,"shared":10,"unplaced":9},
       "omitted": {"data":4},
       "notes": ["founding: an action failed (page.focus: Timeout 6000ms exceeded.); read as it stood"],
@@ -999,7 +999,7 @@
         {"key":"L0017","section":"Needs your attention13","text":"Ideas awaiting triage","placement":"placed","file":"modules/hall-ui/public/builders.js","line":320,"string_id":"e181637c5a5e"},
         {"key":"L0018","section":"Needs your attention13","text":"Requires project {…} fix","placement":"unplaced"},
         {"key":"L0019","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":533,"string_id":"1883ad7f07fc"},
-        {"key":"L0020","section":"Needs your attention13","text":"core 1.24.71","placement":"unplaced"},
+        {"key":"L0020","section":"Needs your attention13","text":"core 1.24.74","placement":"unplaced"},
         {"key":"L0021","section":"Needs your attention13","text":"Skip","placement":"unplaced"},
         {"key":"L0022","section":"Needs your attention13","text":"Built on","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":181,"string_id":"fef59346ffee"},
         {"key":"L0023","section":"Needs your attention13","text":"cloudbongos.com","placement":"unplaced"},
@@ -1346,7 +1346,7 @@
       "surface": "builders",
       "title": "Money",
       "states_read": ["money","hosting","out"],
-      "files_hash": "cbf3f8ed30ccfff6",
+      "files_hash": "282ef6a957569657",
       "reading_hash": "285d714c7aba1fc9",
       "counts": {"lines":82,"placed":25,"shared":9,"unplaced":48},
       "omitted": {"data":25},
@@ -2323,7 +2323,7 @@
       "surface": "builders",
       "title": "Project settings",
       "states_read": ["default"],
-      "files_hash": "2c0f365687004dda",
+      "files_hash": "f56e2084906369f2",
       "reading_hash": "849399ad428ae9c7",
       "counts": {"lines":42,"placed":22,"shared":9,"unplaced":11},
       "omitted": {"data":31},

package/modules/government/board.js

@@ -255,18 +255,21 @@ function validateVote({ direction, reasonMd, sectionKey } = {}) {
 //   { ok: true,  vote, fresh: true, karma_delta, self_cast }  — recorded now
 //   { ok: true,  vote, fresh: false, self_cast }               — idempotent re-cast
 //   { ok: false, reason: 'item_not_found' | 'item_closed' | 'vote_window_expired'
-//               | 'not_board_member' | <validateVote reason> }
+//               | 'not_board_member' | 'bad_cast_via' | <validateVote reason> }
+// `castVia` (task 1005121, government_038) is internal — never read from a request: 'ballot', or 'stage_close' (genesis-close.js: a founder's confirm given by closing a genesis stage — genesis_stage + yes only, no vote karma).
 // 'anti_self_vote' is GONE as of task 1003273 — an author may cast; what they
 // cannot do is decide alone, which shouldCloseAfterVote and tallyOutcome enforce.
 // A self-cast is recorded and visible but earns no karma (karma_delta: 0).
-async function castVote({ itemId, voterId, direction, reasonMd = null, sectionKey = null } = {}) {
+async function castVote({ itemId, voterId, direction, reasonMd = null, sectionKey = null, castVia = 'ballot' } = {}) {
   const id = Number(itemId);
   if (!Number.isFinite(id) || id <= 0) return { ok: false, reason: 'item_not_found' };
+  if (castVia !== 'ballot' && castVia !== 'stage_close') return { ok: false, reason: 'bad_cast_via' };
   const v = validateVote({ direction, reasonMd, sectionKey });
   if (!v.ok) return v;
 
   const item = await db.getBoardItemForVote(id);
   if (!item) return { ok: false, reason: 'item_not_found' };
+  if (castVia === 'stage_close' && (item.subject_type !== 'genesis_stage' || v.direction !== 'yes')) return { ok: false, reason: 'bad_cast_via' };
   if (item.closed_at) return { ok: false, reason: 'item_closed' };
   // The clock is checked here as well as by the R11 poller: a vote landing in
   // the gap between expiry and the sweep would be a vote after time. The
@@ -309,6 +312,7 @@ async function castVote({ itemId, voterId, direction, reasonMd = null, sectionKe
 
   const inserted = await db.insertBoardVote({
     itemId: id, voterId, direction: v.direction, reasonMd: v.reasonMd, sectionKey: v.sectionKey,
+    ...(castVia === 'ballot' ? {} : { castVia }), // db defaults a ballot
   });
   if (!inserted) {
     // UNIQUE(item_id, voter_id) — the idempotent path. Return what stands.
@@ -317,8 +321,8 @@ async function castVote({ itemId, voterId, direction, reasonMd = null, sectionKe
   }
   // Karma rides the FRESH insert only, and the whole route refused a closed or
   // expired item above, so every paid vote is by construction in-window.
-  if (isSelfCast) {
-    return { ok: true, vote: inserted, fresh: true, karma_delta: 0, self_cast: true };
+  if (isSelfCast || castVia === 'stage_close') {
+    return { ok: true, vote: inserted, fresh: true, karma_delta: 0, self_cast: isSelfCast };
   }
   await db.insertVoteKarma({ voterId, itemId: id, delta: VOTE_KARMA_DELTA });
   return { ok: true, vote: inserted, fresh: true, karma_delta: VOTE_KARMA_DELTA, self_cast: false };
@@ -1103,6 +1107,7 @@ async function genesisStageStatus() {
       remaining_seconds: item.remaining_seconds ?? null,
       voted: cast.map((v) => ({
         builder_id: String(v.voter_id), github_login: v.github_login, display_name: v.display_name, direction: v.direction,
+        cast_via: v.cast_via || 'ballot',
       })),
       waiting_on: members.filter((m) => !castBy.has(String(m.builder_id))).map((m) => ({
         builder_id: m.builder_id, github_login: m.github_login, display_name: m.display_name,
@@ -1155,6 +1160,7 @@ async function boardRoomView({ closedLimit = 20, viewerId = null } = {}) {
       reason_md: v.reason_md,
       section_key: v.section_key,
       cast_at: v.cast_at,
+      cast_via: v.cast_via || 'ballot', // task 1005121: a ballot, or a confirm given by closing a genesis stage
     });
   }
   const project = (item) => {

package/modules/government/db.js

@@ -494,13 +494,15 @@ async function getBoardItemAuthor(item) {
 // The open ballot's one write. Idempotency is STRUCTURAL — UNIQUE(item_id,
 // voter_id); the loser of a double-cast gets null and the caller reads the
 // standing vote back.
-async function insertBoardVote({ itemId, voterId, direction, reasonMd = null, sectionKey = null }) {
+// cast_via (government_038, task 1005121): 'ballot', or 'stage_close' for the
+// confirm a founder gives by closing a genesis stage. board.js decides which.
+async function insertBoardVote({ itemId, voterId, direction, reasonMd = null, sectionKey = null, castVia = 'ballot' }) {
   const { rows } = await pool.query(
-    `INSERT INTO government_board_votes (item_id, voter_id, direction, reason_md, section_key)
-     VALUES ($1, $2, $3, $4, $5)
+    `INSERT INTO government_board_votes (item_id, voter_id, direction, reason_md, section_key, cast_via)
+     VALUES ($1, $2, $3, $4, $5, $6)
      ON CONFLICT (item_id, voter_id) DO NOTHING
      RETURNING *`,
-    [itemId, voterId, direction, reasonMd, sectionKey],
+    [itemId, voterId, direction, reasonMd, sectionKey, castVia],
   );
   return rows[0] || null;
 }
@@ -1321,7 +1323,7 @@ async function insertVoteKarma({ voterId, itemId, delta }) {
 }
 
 // ── the constitution in force (task 1005140) ─────────────────────────────────
-// ONE row (government_037). The board block is stored exactly as sanitizeBoard
+// ONE row (government_038). The board block is stored exactly as sanitizeBoard
 // returns it; constitution.js owns the rules for when it is written and how the
 // running process is brought in step with it. `q` is a client or the pool.
 async function getConstitutionRow(q = pool) {

package/modules/government/genesis-close.js

@@ -0,0 +1,45 @@
+'use strict';
+// modules/government/genesis-close.js — closing a genesis stage is ONE call
+// (task 1005121). Its own file so board.js stays under the size ratchet; it is
+// composed only from board.js's exported functions (looked up at call time, so a
+// test's stubs on board's db bite exactly as they do for board itself).
+const board = require('./board.js');
+
+// Close a genesis stage in ONE call (task 1005121; owner ruling 2026-11-07:
+// "closing a stage shouldn't be such a big thing"). Opens the sitting (or reads
+// the one already open) and, where the item's constitution says one person
+// decides (first_ratifier) and the caller is a member under its snapshot, casts
+// the caller's yes in the same breath — recorded cast_via 'stage_close', so the
+// ledger tells a confirm given by closing the stage from a clicked ballot — and
+// closes it. The same rule at every stage: nothing here forks on which stage.
+// Returns, never throws for a refusal:
+//   { closed: true,  item, stage, cast }                    — the sitting passed
+//   { closed: false, item, stage, opened, status }          — a real sitting waits;
+//       `status` is genesisStageStatus' entry for this stage (who has voted, who
+//       it waits on, the rule in words, the clock)
+//   { closed: false, reason, unfinished? }                  — openGenesisStageClose refused
+async function closeGenesisStage({ stageKey, taskIds, closedBy = null } = {}) {
+  const r = await board.openGenesisStageClose({ stageKey, taskIds, openedBy: closedBy });
+  if (!r.opened && r.reason !== 'already_open') return { closed: false, reason: r.reason, unfinished: r.unfinished || [] };
+  const item = r.item;
+  const stage = r.stage || board.GENESIS_STAGES.find((s) => s.key === stageKey);
+  if (!item) return { closed: false, reason: 'already_open' };
+  const constitution = item.constitution || {};
+  let cast = null;
+  if (constitution.pass_rule === 'first_ratifier' && closedBy != null && closedBy !== '') {
+    const v = await board.castVote({ itemId: item.id, voterId: closedBy, direction: 'yes', castVia: 'stage_close' });
+    if (v.ok) {
+      cast = { cast_via: v.vote ? v.vote.cast_via || 'stage_close' : 'stage_close', fresh: v.fresh };
+      const c = await board.maybeCloseAfterVote(item.id);
+      if (c && c.closed && c.outcome === 'passed') return { closed: true, item: c.item || item, stage, cast };
+    }
+  }
+  let status = null;
+  try {
+    const all = await board.genesisStageStatus();
+    status = (all.stages || []).find((s) => s.key === stage.key) || null;
+  } catch (_) { /* the answer still says a sitting is open, and its id */ }
+  return { closed: false, item, stage, opened: !!r.opened, status, cast };
+}
+
+module.exports = { closeGenesisStage };

package/modules/government/migrations/government_038_vote_cast_via.sql

@@ -0,0 +1,23 @@
+-- government_038_vote_cast_via.sql — HOW a vote was cast (task 1005121).
+--
+-- Closing a genesis stage is one call: where the constitution says one person
+-- decides (first_ratifier) and that person is the founder asking to close it, the
+-- close casts their confirming yes in the same breath (board.js closeGenesisStage).
+-- The owner's condition (2026-11-07): a ratification carries a person's name, so
+-- the record must say HOW it was cast — a confirm given by closing the stage — not
+-- merely that the founder voted. Every vote before this column is a ballot.
+--
+--   cast_via  'ballot'       a vote cast in the Board Room (the vote route)
+--             'stage_close'  the confirm given by closing a genesis stage; only
+--                            board.js writes it, only on a genesis_stage item, only yes
+
+BEGIN;
+
+ALTER TABLE government_board_votes
+  ADD COLUMN IF NOT EXISTS cast_via text NOT NULL DEFAULT 'ballot';
+
+ALTER TABLE government_board_votes DROP CONSTRAINT IF EXISTS government_board_votes_cast_via_check;
+ALTER TABLE government_board_votes ADD CONSTRAINT government_board_votes_cast_via_check
+  CHECK (cast_via IN ('ballot', 'stage_close') AND (cast_via = 'ballot' OR direction = 'yes'));
+
+COMMIT;

package/modules/government/routes/government.js

@@ -126,12 +126,11 @@ const governmentPort = {
   // outcome is written by a close, never by the module reading it.
   boardPassForIdea: board.boardPassForIdea,
   boardPassedIdeaIds: board.boardPassedIdeaIds,
-  // task 1004429 (BV2.PS04): a finished genesis stage is put to the board — the
-  // genesis home (task 1004423) calls this when a stage's tasks are done. The
-  // finished-tasks gate lives inside board.js; the item is an ordinary one under
-  // the constitution in force. And the founding band's read: per stage, what it
-  // is waiting on. A pass is announced as `board.genesis_stage.passed`.
+  // task 1004429 (BV2.PS04): a finished genesis stage is put to the board (the gate
+  // lives in board.js; an ordinary item under the constitution in force), and the
+  // founding band's read. task 1005121: closeGenesisStage closes it in one call.
   openGenesisStageClose: board.openGenesisStageClose,
+  closeGenesisStage: require('../genesis-close').closeGenesisStage, // task 1005121: one call closes a stage
   // task 1004941: POST /government/board/matters' own openMatter, for a module's proposal (callers gate on board.item.open)
   openMatter: board.openMatter,
   // task 1004427 (BV2.PS13): the genesis charter + legislation choice, filed as

package/modules/hall-ui/public/board-room.js

@@ -100,6 +100,7 @@
   // rank/permission-CRUD refusals stayed with the Permissions surface — this page
   // cannot provoke them.
   const ERROR_COPY = {
+    bad_cast_via: 'That vote could not be recorded that way — cast it from the ballot.',
     not_board_member: 'Only members of this item’s board may vote on it — membership follows the rules that were in force when the window opened.',
     item_closed: 'This sitting has closed — refreshing.',
     vote_window_expired: 'This sitting’s clock has run out — the sweep is closing it.',

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

@@ -90,6 +90,6 @@
 <script src="/builders/hall-ask.js"></script>
 <!-- the in-place update window a hosted project's hall opens (task 1005041) -->
 <script src="/builders/deploy-handoff.js?v=2026-11-03-handoff"></script>
-<script src="/builders/deploy.js?v=2026-11-03-handoff"></script>
+<script src="/builders/deploy.js?v=2026-11-09-status"></script>
 </body>
 </html>

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

@@ -426,12 +426,63 @@
         Reconnecting sets up <strong>lasting</strong> access: the hub keeps a key of its own for this repository, so this change and every later upgrade are saved to GitHub without asking you again.</p>`;
   }
 
+  // ---- the plain status line (task 1005012) ----------------------------------
+  //
+  // The owner opened this page to put merged work live and found neither a button nor a
+  // sentence: the box was already on the newest version — it had moved there by itself on
+  // its update rule — and the page said only "nothing to deploy". So the box LEADS with one
+  // line in words, up to date or not, and says how the next version reaches it. Every
+  // fact in it is the server's: `behind`, the served version and the update rule. The page
+  // still compares no versions; it only words what it was told.
+  //
+  // How the next version arrives depends on the rule alone. On "Stay put" nothing arrives
+  // by itself, so saying it would is the one sentence here that could be false.
+  const AUTO_RULES = new Set(['patch', 'minor']);
+  function nextVersionWords(p) {
+    if (AUTO_RULES.has(p.update_channel)) {
+      return 'When a newer version is published, it arrives on its own under the update rule below — nothing needs pressing.';
+    }
+    if (p.update_channel === 'pinned') {
+      return 'The update rule below is Stay put, so a newer version waits until you change the update rule.';
+    }
+    return 'When a newer version is published, a deploy button appears here.';
+  }
+
+  // Merged is not live: a merge reaches this project only inside a published version. On
+  // the hall's own view the npm-release module lists where each piece of work has got to,
+  // so the line points at it when it is there, and says nothing about a list that is not.
+  function waitingWorkWords() {
+    const mods = window.__MODULES__;
+    const listed = view.isSelf && !!(mods && mods.enabled && mods.enabled['npm-release']);
+    return `Work merged after that is not live until a published version carries it${
+      listed ? ' — “Where is the work” on this page shows where each piece has got to' : ''}.`;
+  }
+
+  function upToDateHtml(p) {
+    const v = escapeHtml(String(p.served_version));
+    return `
+      <div class="dp-status dp-status--ok" role="status">
+        <p class="ov-row__sub"><strong>Up to date.</strong> This project runs core ${v}, the newest version
+          it can take. Every piece of merged work inside core ${v} is live. There is nothing to deploy.</p>
+        <p class="ov-row__sub">${escapeHtml(nextVersionWords(p))} ${escapeHtml(waitingWorkWords())}</p>
+      </div>`;
+  }
+
+  // Behind: the one primary action on the page. It is a PERSON'S button and stays one —
+  // the project's law is that going live waits for a person, so pressing it opens the
+  // check and the confirm (ADR 0293 D4), and nothing restarts until "Move to …" is pressed.
+  // The id is the step-one id it always was, so the two-step wiring is unchanged.
   function stepOneHtml(p) {
+    const to = escapeHtml(String(p.recommended_version));
+    const auto = AUTO_RULES.has(p.update_channel)
+      ? ' It would also arrive on its own under the update rule below; this does it now.' : '';
     return `
-      <p class="ov-row__sub">Core <strong>${escapeHtml(String(p.recommended_version))}</strong> is published and
-        this box is not on it yet.</p>
-      <div class="ps-controls">
-        <button type="button" class="btn" id="dp-preview-${escapeHtml(String(p.instance_id))}">See what would change</button>
+      <div class="dp-status dp-status--behind" role="status">
+        <p class="ov-row__sub"><strong>Not up to date.</strong> Core <strong>${to}</strong> is published; this project still runs ${escapeHtml(String(p.served_version))}.${auto}</p>
+        <div class="ps-controls">
+          <button type="button" class="btn btn--primary" id="dp-preview-${escapeHtml(String(p.instance_id))}">Deploy core ${to} now</button>
+        </div>
+        <p class="ov-row__sub dp-status__note">You see what it brings in and confirm before anything restarts.</p>
       </div>`;
   }
 
@@ -613,7 +664,7 @@
     if (moving.has(p.instance_id)) action = movingHtml(p);
     else if (p.open_intent) action = busyHtml(p);
     else if (p.reading === 'no_answer') action = '';
-    else if (!p.behind) action = `<p class="ov-row__sub">Nothing newer is published that this box can take. There is nothing to deploy.</p>`;
+    else if (!p.behind) action = upToDateHtml(p);
     else action = step === 'confirm' ? stepTwoHtml(p, isSelf) : stepOneHtml(p);
     if (!moving.has(p.instance_id)) action += settledHtml(p);
     return `

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

@@ -334,19 +334,14 @@
           return window.OTB.sleep(3500);
         }).then(function () { window.location.reload(); }));
       } else if (t.hasAttribute('data-genesis-close')) {
-        // The solo fast-track (spec D4): when the founder's one yes decides the sitting
-        // and nobody else is asked, the close and the confirm are one click.
+        // One call (task 1005121): where the founder's one yes decides, the server
+        // closes the stage with it; otherwise it answers 202 with what the sitting
+        // waits on, and that sentence is shown.
         act(send('POST', '/founding/stages/' + encodeURIComponent(t.getAttribute('data-genesis-close')) + '/close', {})
-          .then(function () { return send('GET', '/founding/genesis'); })
-          .then(function (d) {
-            var g = d && d.genesis;
-            var s = g && g.stages.find(function (x) { return x.state === 'now'; });
-            var b = s && s.board;
-            var solo = b && b.state === 'sitting' && b.one_vote_decides && b.item_id
-              && (b.waiting_on || []).length === 1 && String(b.waiting_on[0].builder_id) === String(d.viewer_id);
-            return solo ? send('POST', '/government/board/items/' + encodeURIComponent(b.item_id) + '/votes', { direction: 'yes' }) : null;
-          })
-          .then(function () { return load(host, state); }));
+          .then(function (out) {
+            if (out && out.closed === false && out.next) toast(out.next);
+            return load(host, state);
+          }));
       } 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); }));

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

@@ -57,7 +57,7 @@
   const SKY_LABEL = 'The project\'s ideas as a night sky over the city\'s real skyline, with this week\'s ideators ranked beside it';
   const CITY_LABEL = 'The project as a city: one tower per working area, as tall as what has shipped there, with the builders of the week beside it';
 
-  let host = null, model = null, viewerId = null, t = 0, target = 0, raf = null, run = null, lastWeek = -1, shown = false, gallery = null;
+  let host = null, model = null, viewerId = null, t = 0, target = 0, raf = null, run = null, lastWeek = -1, shown = false, gallery = null, ideaBox = null;
   const rungs = new Map();
 
   function mode() {
@@ -292,11 +292,15 @@
 
   // ---- the artist's Home (task 1005060): in Artistry the same section is the gallery,
   // home-gallery.js, the bench in the museum the city's art district opens onto ----
+  // In Ideating, the idea box (home-idea-box.js) opens Home above the sky, and shows even
+  // when the sky could not be read: filing an idea needs no picture of the others.
   function craftHome() {
     const art = !!gallery && document.documentElement.dataset.craft === 'artistry';
+    const idea = !!ideaBox && craft() === 'ideating';
     host.classList.toggle('hc--gallery', art);
     if (gallery) gallery.show(art);
-    host.hidden = !(art || shown);
+    if (ideaBox) ideaBox.show(idea);
+    host.hidden = !(art || idea || shown);
   }
 
   // ---- the governor's Home is the street; tests swap the hop for a recorder ----
@@ -338,6 +342,7 @@
     wireTip();
     wireDoors();
     if (window.OTBHomeGallery) gallery = window.OTBHomeGallery.attach(host);
+    if (window.OTBHomeIdeaBox) ideaBox = window.OTBHomeIdeaBox.attach(host);
     document.addEventListener('otb:craft', craftHome);
     craftHome();
     new MutationObserver(() => { if (model) drawScene(); }).observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });

package/modules/hall-ui/public/home-idea-box.css

@@ -0,0 +1,33 @@
+/* modules/hall-ui/public/home-idea-box.css — the idea box that opens the ideator's Home
+   (home-idea-box.js; record modules/hall-ui/records/home-city.md § "The idea box").
+   It sits at the top of the city's section, over the sky. Every colour is a hall token
+   or a mix of one; the tokens carry both modes, so no rule here is written per mode.
+   Every type size and radius is a --ds-* scale token (DESIGN.md, the Fifteen Rule), and
+   the narrow layout comes from wrapping rather than a breakpoint, so the sheet adds no
+   typed-in value to the design counts. No :root, no motion. */
+
+.hib { padding: clamp(16px, 4vw, 28px) clamp(16px, 4vw, 28px) clamp(14px, 3vw, 20px); display: grid; gap: 10px; }
+.hib[hidden] { display: none; }
+.hib-h { margin: 0; font: 600 var(--ds-text-4xl)/1.25 var(--font-display); color: var(--ink); }
+.hib-h label { cursor: text; }
+/* The box takes the row; on a narrow screen the button wraps under it */
+.hib-row { display: flex; flex-wrap: wrap; gap: 10px; align-items: flex-start; }
+.hib .hib-title {
+  width: 100%; min-width: 0; box-sizing: border-box;
+  font: 400 var(--ds-text-xl)/1.4 var(--font-body); color: var(--ink);
+  background: var(--bg-card); border: var(--line) solid var(--rule-soft); border-radius: var(--radius-sm);
+}
+.hib textarea.hib-title {
+  flex: 1 1 16rem; width: auto; min-height: 48px; max-height: 40vh; padding: 12px 20px;
+  font-size: var(--ds-text-2xl); line-height: 22px;
+  border-radius: var(--ds-radius-panel); resize: none; overflow-y: auto;
+}
+.hib .hib-title::placeholder { color: var(--ink-faint); }
+.hib .hib-title:focus-visible { outline: 2px solid var(--focus); outline-offset: 1px; border-color: transparent; }
+.hib-file { min-height: 48px; padding: 0 22px; font-size: var(--ds-text-lg); flex-shrink: 0; }
+.hib-said { margin: 0; min-height: 1.4em; font: 400 var(--ds-text-md)/1.4 var(--font-body); color: var(--ink-soft); }
+.hib-said--err { color: var(--danger); }
+.hib-said a { color: var(--ink); }
+
+/* The setup guide is about building on your own machine; in Ideating, Home opens on the box */
+html[data-craft="ideating"] #welcome-scroll { display: none; }

package/modules/hall-ui/public/home-idea-box.js

@@ -0,0 +1,106 @@
+// modules/hall-ui/public/home-idea-box.js — the ideator's Home opens on the idea box
+// (goal 1000095, the owner's "work-first hall", 2026-11-04; record
+// modules/hall-ui/records/home-city.md § "The idea box").
+//
+// In Ideating, the first thing on Home is a place to type an idea and file it; the sky
+// and the ladder of ideators stay under it, secondary. It is ONE box and a button
+// (owner, 2026-11-05: "only one box"): Enter files, Shift+Enter starts a new line, and
+// the box grows with what is typed. The first line is the idea's title, any lines after
+// it its details. Filing is POST /inbox as the sky's quick composer files
+// (sky-composer.js): { title, body_md, kind: 'feature' }. A failed filing keeps the
+// words where they were and says why; a filed one says where it went and links to
+// Your thinking, where every thought the builder filed is listed.
+//
+// It is not a hall widget of its own (Home's stats zone holds one): home-city.js
+// attaches it at the top of its section and shows it when the craft is Ideating, the
+// way it shows the gallery in Artistry. It reads nothing; it writes one thing.
+(function () {
+  'use strict';
+
+  var API = '/api/bongos';
+
+  // ---- pure: what the line under the box says (node-testable) ----
+  function explain(res) {
+    var err = res && res.data && res.data.error;
+    var code = err && (typeof err === 'object' ? err.code : err);
+    var details = (err && typeof err === 'object' && err.details) || {};
+    if (details.reason) return 'Not filed: ' + details.reason + '. Your idea is still here.';
+    if (res && (res.status === 401 || res.status === 403)) return 'Not filed: your session may have expired. Reload and try again.';
+    if (code) return 'Not filed: ' + String(code).replace(/_/g, ' ') + '. Your idea is still here.';
+    return 'Not filed' + (res && res.status ? ' (' + res.status + ')' : '') + '. Nothing was saved; your idea is still here.';
+  }
+  // the first non-empty line is the title; whatever follows it is the details
+  function body(text) {
+    var lines = String(text || '').replace(/\r\n?/g, '\n').split('\n');
+    while (lines.length && !lines[0].trim()) lines.shift();
+    return { title: (lines.shift() || '').trim(), body_md: lines.join('\n').trim(), kind: 'feature' };
+  }
+  var Lib = { explain: explain, body: body };
+  if (typeof module !== 'undefined' && module.exports) module.exports = Lib;
+  if (typeof document === 'undefined') return;
+
+  function attach(host) {
+    var api = null, filing = false;
+    var root = document.createElement('form');
+    root.className = 'hib';
+    root.setAttribute('novalidate', '');
+    root.setAttribute('aria-labelledby', 'hib-h');
+    root.hidden = true;
+    root.innerHTML =
+      '<h2 class="hib-h" id="hib-h"><label for="hib-title">What is your idea?</label></h2>' +
+      '<div class="hib-row">' +
+        '<textarea id="hib-title" class="hib-title" rows="1" placeholder="One line is enough" aria-describedby="hib-keys"></textarea>' +
+        '<button type="submit" class="btn hib-file">File idea</button>' +
+      '</div>' +
+      '<p class="sr-only" id="hib-keys">Enter files the idea. Shift and Enter starts a new line.</p>' +
+      '<p class="hib-said" role="status" aria-live="polite"></p>';
+    host.insertBefore(root, host.firstChild);
+    var title = root.querySelector('.hib-title');
+    var said = root.querySelector('.hib-said'), btn = root.querySelector('.hib-file');
+
+    // the box is as tall as what is in it
+    function fit() { title.style.height = 'auto'; title.style.height = title.scrollHeight + 'px'; }
+    title.addEventListener('input', fit);
+    // Enter files, Shift+Enter is a new line; a key that is still composing a character is left alone
+    title.addEventListener('keydown', function (e) {
+      if (e.key !== 'Enter' || e.shiftKey || e.isComposing) return;
+      e.preventDefault();
+      if (typeof root.requestSubmit === 'function') root.requestSubmit(); else root.dispatchEvent(new Event('submit', { cancelable: true }));
+    });
+
+    function say(text, link) {
+      said.textContent = text;
+      said.classList.toggle('hib-said--err', !link && !!text);
+      if (link) {
+        var a = document.createElement('a');
+        a.href = '/thinking';
+        a.textContent = 'See it in Your thinking';
+        said.append(' ', a);
+      }
+    }
+
+    root.addEventListener('submit', function (e) {
+      e.preventDefault();
+      if (filing) return;
+      var b = body(title.value);
+      if (!b.title) { say('Type your idea first.'); title.focus(); return; }
+      api = api || (window.BongosClient && window.BongosClient.createClient({ baseUrl: '', credentials: 'same-origin', throwOnError: false }));
+      if (!api) { say(explain(null)); return; }
+      filing = true; btn.disabled = true; say('');
+      api.request('POST', API + '/inbox', { body: b }).catch(function () { return null; }).then(function (res) {
+        filing = false; btn.disabled = false;
+        if (!res || !res.ok || !res.data || !res.data.idea) { say(explain(res)); return; }
+        title.value = ''; fit();
+        say(res.data.routed_task ? 'Filed, and it is already a task.' : 'Filed. It waits for the next triage.', true);
+        title.focus();
+      });
+    });
+
+    return {
+      // shown in Ideating
+      show: function (on) { root.hidden = !on; },
+    };
+  }
+
+  window.OTBHomeIdeaBox = { attach: attach, lib: Lib };
+})();

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

@@ -23,6 +23,7 @@
   <link rel="stylesheet" href="/builders/hall-ask.css">
   <link rel="stylesheet" href="/builders/home-city.css">
   <link rel="stylesheet" href="/builders/home-gallery.css">
+  <link rel="stylesheet" href="/builders/home-idea-box.css">
 </head>
 <body data-page="home">
 
@@ -133,6 +134,7 @@
 <script src="/builders/city-draw.js" defer></script>
 <script src="/builders/home-city-draw.js" defer></script>
 <script src="/builders/home-gallery.js" defer></script>
+<script src="/builders/home-idea-box.js" defer></script>
 <script src="/builders/home-city.js" defer></script>
 <!-- task 1003455: the shared blocker-row renderer (window.OTBBlockersLib), read by
      both goal-inbox.js's attention-inbox slice below and the /blockers page.

package/modules/hall-ui/public/project-settings.css

@@ -212,6 +212,21 @@
 }
 .dp-settled .ps-controls { margin: 0.4rem 0 0.2rem; }
 
+/* The box's plain status line (task 1005012): up to date, or not and here is the button.
+   The same left-mark grammar as the settled states — ok when nothing waits, the accent
+   when a published version is waiting for a person's press. */
+.dp-status { margin: 0.4rem 0 0; }
+.dp-status--ok {
+  border-left: 3px solid var(--ok);
+  padding-left: 0.7rem;
+}
+.dp-status--behind {
+  border-left: 3px solid var(--accent);
+  padding-left: 0.7rem;
+}
+.dp-status .ps-controls { margin: 0.5rem 0 0.3rem; }
+.dp-status__note { color: var(--ink-soft); }
+
 /* The project's update rule (task 1004445) — a quiet setting under the move, set apart by
    a hairline so it does not read as part of whichever state sits above it. */
 .dp-rule {