@bongos/core 1.20.25 → 1.20.26

package/docs/copy-registry.json

@@ -265,7 +265,7 @@
       "text": "Restricted.",
       "occurrences": 4,
       "at": [
-        "modules/hall-ui/public/board-room.js:521",
+        "modules/hall-ui/public/board-room.js:526",
         "modules/hall-ui/public/gate.js:234",
         "modules/hall-ui/public/government.js:879",
         "modules/hall-ui/public/watch.js:1294"
@@ -1087,7 +1087,7 @@
       "text": "Its author gave no scope recommendation.",
       "occurrences": 2,
       "at": [
-        "modules/hall-ui/public/board-room.js:295",
+        "modules/hall-ui/public/board-room.js:300",
         "modules/hall-ui/public/idea.js:162"
       ]
     },
@@ -1097,7 +1097,7 @@
       "text": "Its author recommends this becomes",
       "occurrences": 2,
       "at": [
-        "modules/hall-ui/public/board-room.js:294",
+        "modules/hall-ui/public/board-room.js:299",
         "modules/hall-ui/public/idea.js:166"
       ]
     },
@@ -2343,7 +2343,7 @@
       "surface": "builders-hall",
       "text": ", // membership",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 300,
+      "line": 305,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -3603,7 +3603,7 @@
       "surface": "builders-hall",
       "text": "Cast objection",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 363,
+      "line": 368,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -4863,7 +4863,7 @@
       "surface": "builders-hall",
       "text": "Could not vote: {…}",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 391,
+      "line": 396,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -6663,7 +6663,7 @@
       "surface": "builders-hall",
       "text": "It cleared the completeness grade at {…}/100.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 326,
+      "line": 331,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6708,7 +6708,7 @@
       "surface": "builders-hall",
       "text": "Its author gave no scope recommendation.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 295,
+      "line": 300,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6735,7 +6735,7 @@
       "surface": "builders-hall",
       "text": "Its author recommends this becomes",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 294,
+      "line": 299,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -7095,7 +7095,7 @@
       "surface": "builders-hall",
       "text": "Loading sittings…",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 539,
+      "line": 544,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -9687,7 +9687,7 @@
       "surface": "builders-hall",
       "text": "Restricted.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 521,
+      "line": 526,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -11001,7 +11001,7 @@
       "surface": "builders-hall",
       "text": "The Board Room is open to the builders this project’s constitution seats on its board.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 524,
+      "line": 529,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -12063,7 +12063,7 @@
       "surface": "builders-hall",
       "text": "This sends the idea back to its author. Say why, and which section.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 363,
+      "line": 368,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -12423,7 +12423,7 @@
       "surface": "builders-hall",
       "text": "Vote yes",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 363,
+      "line": 368,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -12927,7 +12927,7 @@
       "surface": "builders-hall",
       "text": "Why — the reason the author will act on",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 363,
+      "line": 368,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -13116,7 +13116,7 @@
       "surface": "builders-hall",
       "text": "You {…}. One vote per member.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 435,
+      "line": 440,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -13278,7 +13278,7 @@
       "surface": "builders-hall",
       "text": "Your own idea. You may vote, but it can’t be decided by your vote alone, and a vote on your own idea earns no karma.",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 361,
+      "line": 366,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -14592,7 +14592,7 @@
       "surface": "builders-hall",
       "text": "objected to",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 168,
+      "line": 173,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -15744,7 +15744,7 @@
       "surface": "builders-hall",
       "text": "your vote",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 163,
+      "line": 168,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -16212,7 +16212,7 @@
       "surface": "builders-hall",
       "text": "{…} · who votes, and how it {…}",
       "file": "modules/hall-ui/public/board-room.js",
-      "line": 444,
+      "line": 449,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/module-api-changelog.md

@@ -2707,5 +2707,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.20.23 with no explicit bump. run 36759918201. (task 1002620)
   1.20.25 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.20.24 with no explicit bump. run 36762454104. (task 1002620)
+  1.20.26 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.20.25 with no explicit bump. run 36764011836. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/page-readings.json

@@ -67,7 +67,7 @@
       "surface": "builders",
       "title": "Board Room",
       "states_read": ["room","out","sitting-meta","objection-form"],
-      "files_hash": "7e203a1e5dfd2520",
+      "files_hash": "c1978638f2ef9558",
       "reading_hash": "202a0cbb6bc54aac",
       "counts": {"lines":56,"placed":26,"shared":5,"unplaced":25},
       "omitted": {"data":9},
@@ -83,32 +83,32 @@
         {"key":"L0008","section":"{…} Full Idea","text":"Full Idea","placement":"unplaced","occurrences":3},
         {"key":"L0009","section":"{…} Full Idea","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":163,"string_id":"9a803563c948"},
         {"key":"L0010","section":"{…} Full Idea","text":"closes in 73m","placement":"unplaced"},
-        {"key":"L0011","section":"{…} Full Idea","text":"Vote yes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":363,"string_id":"b2937e14ee9b"},
+        {"key":"L0011","section":"{…} Full Idea","text":"Vote yes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":368,"string_id":"b2937e14ee9b"},
         {"key":"L0012","section":"{…} Full Idea","text":"Object…","placement":"unplaced"},
-        {"key":"L0013","section":"{…} Full Idea","text":"This sends the idea back to its author. Say why, and which section.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":363,"string_id":"69e8beced2ff","state":"objection-form"},
-        {"key":"L0014","section":"{…} Full Idea","text":"Why — the reason the author will act on","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":363,"string_id":"fbd8a815b808","attr":"placeholder","state":"objection-form"},
-        {"key":"L0015","section":"{…} Full Idea","text":"Its author gave no scope recommendation.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":295,"string_id":"a21788f84e29"},
+        {"key":"L0013","section":"{…} Full Idea","text":"This sends the idea back to its author. Say why, and which section.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":368,"string_id":"69e8beced2ff","state":"objection-form"},
+        {"key":"L0014","section":"{…} Full Idea","text":"Why — the reason the author will act on","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":368,"string_id":"fbd8a815b808","attr":"placeholder","state":"objection-form"},
+        {"key":"L0015","section":"{…} Full Idea","text":"Its author gave no scope recommendation.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":300,"string_id":"a21788f84e29"},
         {"key":"L0016","section":"{…} Full Idea","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","occurrences":2},
         {"key":"L0017","section":"{…} Full Idea","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":4},
         {"key":"L0018","section":"{…} Full Idea","text":"What does the Big Picture look like","placement":"unplaced","occurrences":2},
         {"key":"L0019","section":"{…} Full Idea","text":"Why did you have the Idea","placement":"unplaced","occurrences":2},
         {"key":"L0020","section":"{…} Full Idea","text":"Why does the Idea Matter","placement":"unplaced","occurrences":2},
         {"key":"L0021","section":"{…} Full Idea","text":"{…} project{…}","placement":"placed","file":"modules/hall-ui/public/fleet.js","line":39,"string_id":"771bef3d31b5","occurrences":3},
-        {"key":"L0022","section":"{…} Full Idea","text":"Cast objection","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":363,"string_id":"bdca1f219e6f","state":"objection-form"},
-        {"key":"L0023","section":"{…} Full Idea","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":444,"string_id":"d73256fbc395","occurrences":3},
+        {"key":"L0022","section":"{…} Full Idea","text":"Cast objection","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":368,"string_id":"bdca1f219e6f","state":"objection-form"},
+        {"key":"L0023","section":"{…} Full Idea","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":449,"string_id":"d73256fbc395","occurrences":3},
         {"key":"L0024","section":"{…} Full Idea","text":"Every {…}","placement":"unplaced","state":"sitting-meta"},
         {"key":"L0025","section":"{…} Full Idea","text":"{…} or {…}","placement":"unplaced","state":"sitting-meta"},
         {"key":"L0026","section":"{…} Full Idea","text":"may vote on this.","placement":"unplaced","state":"sitting-meta"},
         {"key":"L0027","section":"{…} Full Idea","text":"The sitting runs 1 day, closing early once every member has voted.","placement":"unplaced","state":"sitting-meta"},
-        {"key":"L0028","section":"{…} Full Idea","text":"It cleared the completeness grade at {…}/100.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":326,"string_id":"bd8d04eb265c","state":"sitting-meta"},
+        {"key":"L0028","section":"{…} Full Idea","text":"It cleared the completeness grade at {…}/100.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":331,"string_id":"bd8d04eb265c","state":"sitting-meta"},
         {"key":"L0029","section":"{…} and {…}","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":4},
         {"key":"L0030","section":"{…} and {…}","text":"Full Idea","placement":"unplaced"},
         {"key":"L0031","section":"{…} and {…}","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":163,"string_id":"9a803563c948"},
         {"key":"L0032","section":"{…} and {…}","text":"no clock","placement":"placed","file":"modules/hall-ui/public/government.js","line":607,"string_id":"b9f2e0d43c94"},
-        {"key":"L0033","section":"{…} and {…}","text":"Your own idea. You may vote, but it can’t be decided by your vote alone, and a vote on your own idea earns no karma.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":361,"string_id":"c0a01a95e97e"},
-        {"key":"L0034","section":"{…} and {…}","text":"Vote yes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":363,"string_id":"b2937e14ee9b"},
+        {"key":"L0033","section":"{…} and {…}","text":"Your own idea. You may vote, but it can’t be decided by your vote alone, and a vote on your own idea earns no karma.","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":366,"string_id":"c0a01a95e97e"},
+        {"key":"L0034","section":"{…} and {…}","text":"Vote yes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":368,"string_id":"b2937e14ee9b"},
         {"key":"L0035","section":"{…} and {…}","text":"Object…","placement":"unplaced"},
-        {"key":"L0036","section":"{…} and {…}","text":"Its author recommends this becomes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":294,"string_id":"680491549e47"},
+        {"key":"L0036","section":"{…} and {…}","text":"Its author recommends this becomes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":299,"string_id":"680491549e47"},
         {"key":"L0037","section":"{…} and {…}","text":"a {…} inside an existing goal","placement":"unplaced"},
         {"key":"L0038","section":"{…} and {…}","text":". The board decides.","placement":"unplaced"},
         {"key":"L0039","section":"{…} and {…}","text":"What made you have the idea","placement":"unplaced"},
@@ -116,16 +116,16 @@
         {"key":"L0041","section":"{…} and {…}","text":"What should an {…} or artist know prior to building","placement":"unplaced"},
         {"key":"L0042","section":"{…} and {…}","text":"{…} project{…}","placement":"placed","file":"modules/hall-ui/public/fleet.js","line":39,"string_id":"771bef3d31b5","occurrences":2},
         {"key":"L0043","section":"{…} and {…}","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","occurrences":2},
-        {"key":"L0044","section":"{…} and {…}","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":444,"string_id":"d73256fbc395"},
+        {"key":"L0044","section":"{…} and {…}","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":449,"string_id":"d73256fbc395"},
         {"key":"L0045","section":"Constitutional amendment amendment","text":"Constitutional amendment","placement":"unplaced"},
         {"key":"L0046","section":"Constitutional amendment amendment","text":"amendment","placement":"unplaced"},
         {"key":"L0047","section":"Constitutional amendment amendment","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":163,"string_id":"9a803563c948"},
         {"key":"L0048","section":"Constitutional amendment amendment","text":"closes in 15m","placement":"unplaced"},
         {"key":"L0049","section":"Constitutional amendment amendment","text":"Proposes","placement":"unplaced"},
         {"key":"L0050","section":"Constitutional amendment amendment","text":"{\"pass_rule\":\"{…}\",\"window_minutes\":2880}","placement":"unplaced"},
-        {"key":"L0051","section":"Constitutional amendment amendment","text":"Vote yes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":363,"string_id":"b2937e14ee9b"},
+        {"key":"L0051","section":"Constitutional amendment amendment","text":"Vote yes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":368,"string_id":"b2937e14ee9b"},
         {"key":"L0052","section":"Constitutional amendment amendment","text":"Object…","placement":"unplaced"},
-        {"key":"L0053","section":"Constitutional amendment amendment","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":444,"string_id":"d73256fbc395"},
+        {"key":"L0053","section":"Constitutional amendment amendment","text":"{…} · who votes, and how it {…}","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":449,"string_id":"d73256fbc395"},
         {"key":"L0054","section":"Constitutional amendment amendment","text":"Closed sittings","placement":"unplaced"},
         {"key":"L0055","section":"{…} Full Idea","text":"passed","placement":"placed","file":"modules/hall-ui/public/government.js","line":633,"string_id":"da5368d10f85"},
         {"key":"L0056","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":464,"string_id":"1883ad7f07fc"}

package/modules/discord/board-broadcast.js

@@ -148,6 +148,7 @@ async function postBoardAnnouncement(payload, deps = {}) {
 const CHANNEL = 'board_room';
 
 function subjectLabel(subjectType) {
+  if (subjectType === 'genesis_stage') return 'A genesis stage'; // task 1004429
   return subjectType === 'constitutional_amendment' ? 'A constitutional amendment' : 'A Full Idea';
 }
 

package/modules/government/board.js

@@ -627,7 +627,12 @@ async function closeItem(item, { cause = 'vote' } = {}) {
   });
   if (!closed) return { closed: false, reason: 'already_closed' };
 
-  const authorKarma = outcome === 'passed' ? await awardAuthorRatifyKarma(closed) : null;
+  // A genesis stage ratifies no authored work — closing it is the project's
+  // decision that a stage is done, not a reward for the founder who put it up
+  // (task 1004429). Ideas and amendments pay exactly as before.
+  const authorKarma = outcome === 'passed' && closed.subject_type !== 'genesis_stage'
+    ? await awardAuthorRatifyKarma(closed)
+    : null;
 
   // R14: a PASSED amendment becomes the live constitution — applied AFTER the
   // close commits (the board's decision is the durable record), loudly on
@@ -652,6 +657,7 @@ async function closeItem(item, { cause = 'vote' } = {}) {
     try {
       if (api.emitAsync) await api.emitAsync('board.item.passed', payload);
     } catch (_) { /* emitAsync isolates listener errors; nothing that moves credits subscribes */ }
+    if (closed.subject_type === 'genesis_stage') await emitGenesisStagePassed(closed);
   }
 
   // R22's mirror event: BOTH outcomes, after commit, emitAsync. Separate from
@@ -806,6 +812,188 @@ async function proposeAmendment({
   return { ok: true, amendment, item };
 }
 
+// ── the board's third subject: closing a genesis stage (task 1004429) ───────
+//
+// Spec decision D7 (docs/specs/bongos-v2-project-startup.md): a new project is
+// founded through five stages, and when a stage's tasks are all finished its
+// close is put to the constitution IN FORCE. It is an ordinary board item, and
+// that is the whole design — the stage borrows every rule the board already
+// has rather than bringing one of its own:
+//
+//   • THE CONSTITUTION IS SNAPSHOTTED, like every item, so a charter adopted
+//     mid-sitting does not change how an already-open stage closes.
+//   • NO NEW PASS RULE, NO GENESIS BYPASS. Under the monarchy default
+//     (first_ratifier) the founder's single confirm closes the stage because
+//     the founder is the first ratifier — not because anything special-cases
+//     genesis. Under consent, majority or unanimous it is a real sitting, with
+//     the clock and turnout rules unchanged.
+//   • THE AUTHOR RULE IS UNCHANGED — which means it does not reach a stage. It
+//     is full_idea-scoped (authorRuleApplies, ADR 0191): it guards an author
+//     who GAINS from ratification, and closing a stage pays nobody. A stage is
+//     in the amendment's position, where §7 already says the one member of a
+//     monarchy must be able to decide their own item.
+//   • IT PAYS NOTHING. No credit (the reward port is only reached for a
+//     full_idea) and no ratify karma (closeItem skips it for a stage).
+//
+// The subject_id is the stage NUMBER. An instance is one project, so the
+// number names a stage uniquely, and government_003's one-open-per-subject
+// index then keeps at most one sitting per stage STRUCTURALLY — the same
+// idempotency a Full Idea gets. A passed stage may be sat again later (the
+// design's "second pass once your builders join"); the index is partial on
+// open items only. government_020 widens the subject CHECK and bounds the range.
+const GENESIS_STAGES = Object.freeze([
+  Object.freeze({ key: 'scope', number: 1, label: 'Scope' }),
+  Object.freeze({ key: 'strategize', number: 2, label: 'Strategize' }),
+  Object.freeze({ key: 'charter', number: 3, label: 'Charter' }),
+  Object.freeze({ key: 'legalize', number: 4, label: 'Legalize' }),
+  Object.freeze({ key: 'legislation', number: 5, label: 'Legislation' }),
+]);
+
+// "Finished" is the task's terminal states: shipped, or dropped — which the
+// tasks table spells `abandoned` (migration 012; a merged-away task lands
+// there too). `confirmed` is NOT finished: the work is graded but not landed.
+const STAGE_TASK_FINISHED_STATUSES = Object.freeze(['shipped', 'abandoned']);
+
+const stageByKey = (key) => GENESIS_STAGES.find((s) => s.key === key) || null;
+const stageByNumber = (n) => GENESIS_STAGES.find((s) => s.number === Number(n)) || null;
+
+// The pass rules, said in words for the founding band. Keyed by exactly
+// config.js PASS_RULES (held equal by tests/government_board_genesis_stage.mjs,
+// so a fifth rule cannot land without its words); an unknown rule in an old
+// snapshot says so rather than guessing.
+const PASS_RULE_WORDS = Object.freeze({
+  first_ratifier: 'One yes from any member decides it.',
+  consent: 'It passes unless a member objects, once everyone has voted or the clock runs out.',
+  majority: 'More than half of all members must say yes.',
+  unanimous: 'Everyone who votes must agree, and at least one member must say yes.',
+});
+
+// Put a finished stage to the board. Returns, never throws for a refusal:
+//   { opened: true,  item, stage }
+//   { opened: false, reason: 'unknown_stage' | 'no_stage_tasks' }
+//   { opened: false, reason: 'stage_tasks_unfinished', unfinished: [{ task_id, status }] }
+//   { opened: false, reason: 'already_open', item, stage }
+//
+// THE FINISHED-TASKS GATE LIVES HERE, not in the caller — the same posture as
+// the Full Idea bar: the genesis home says which tasks make up the stage, and
+// this module checks them against the tasks table before anything is written.
+// An empty list is refused rather than read as "nothing left to do", because a
+// stage close with no tasks behind it would be exactly the bypass D7 rules out.
+// `openedBy` is the founder (or whoever put it up); it may be null for an
+// automatic open, the same as a grade-opened idea.
+//
+// WHO MAY CALL THIS is the caller's gate, by design, exactly as for
+// openWindowForFullIdea: this is a port method with no HTTP route, and opening
+// a sitting decides nothing — it only asks the board. Whoever exposes it to a
+// person (the genesis home) must gate that route itself. The deciding wall is
+// unchanged either way: only a member under the snapshot can vote it closed.
+async function openGenesisStageClose({ stageKey, taskIds, openedBy = null } = {}) {
+  const stage = stageByKey(stageKey);
+  if (!stage) return { opened: false, reason: 'unknown_stage' };
+  const ids = Array.isArray(taskIds) ? taskIds.map(Number) : [];
+  if (!ids.length || !ids.every((n) => Number.isInteger(n) && n > 0)) {
+    return { opened: false, reason: 'no_stage_tasks' };
+  }
+  const unique = [...new Set(ids)];
+  const rows = await db.getTaskStatuses(unique);
+  const statusById = new Map(rows.map((r) => [String(r.id), r.status]));
+  const unfinished = unique
+    .filter((id) => !STAGE_TASK_FINISHED_STATUSES.includes(statusById.get(String(id))))
+    .map((id) => ({ task_id: String(id), status: statusById.get(String(id)) ?? null }));
+  if (unfinished.length) return { opened: false, reason: 'stage_tasks_unfinished', unfinished };
+
+  const { board } = loadGovernmentConfig();
+  const item = await db.openBoardItem({
+    subjectType: 'genesis_stage',
+    subjectId: stage.number,
+    openedBy: openedBy == null || openedBy === '' ? null : openedBy,
+    constitution: board,
+    windowMinutes: board.window_minutes,
+  });
+  if (!item) {
+    return { opened: false, reason: 'already_open', item: await db.getOpenBoardItem('genesis_stage', stage.number), stage };
+  }
+  await emitWindowOpened(item);
+  return { opened: true, item, stage };
+}
+
+// The genesis home's cue (spec D7 / task 1004423): a stage's sitting PASSED,
+// so mark it done and wake its room. Emitted after the close commits, beside
+// the general `board.item.passed`, carrying what that contract deliberately
+// does not — which stage. Best-effort by construction, like every board event:
+// the durable fact is the `outcome = 'passed'` row, which genesisStageStatus
+// reads, so a listener that missed the nudge can always recover the state.
+async function emitGenesisStagePassed(closed) {
+  const stage = stageByNumber(closed.subject_id);
+  if (!stage) return;
+  try {
+    if (api.emitAsync) {
+      await api.emitAsync('board.genesis_stage.passed', {
+        item_id: String(closed.id),
+        stage_key: stage.key,
+        stage_number: stage.number,
+        passed_at: closed.closed_at || null,
+      });
+    }
+  } catch (_) { /* a nudge that fails is recoverable from the passed row */ }
+}
+
+// "Who is this stage waiting on" — for the founding band. One entry per stage,
+// from the LATEST sitting on it:
+//   state: 'not_put' (never put to the board) | 'sitting' | 'passed' | 'returned'
+// and for a sitting, the members under the item's OWN snapshot (not the live
+// config), split into who has voted and who is still to — per request,
+// uncached, the ADR 0016 posture of every membership read here. Under monarchy
+// `one_vote_decides` is true and `waiting_on` names everyone who could give
+// that vote. The countdown is the database's (`remaining_seconds`); the client
+// never does clock math. Membership is resolved once per distinct predicate.
+async function genesisStageStatus() {
+  const items = await db.listLatestGenesisStageItems();
+  const open = items.filter((i) => !i.closed_at);
+  const votes = open.length ? await db.getVotesForItems(open.map((i) => i.id)) : [];
+  const membersByPredicate = new Map();
+  const stages = [];
+  for (const stage of GENESIS_STAGES) {
+    const item = items.find((i) => Number(i.subject_id) === stage.number);
+    const base = { key: stage.key, number: stage.number, label: stage.label };
+    if (!item) {
+      stages.push({ ...base, state: 'not_put', item_id: null, voted: [], waiting_on: [] });
+      continue;
+    }
+    const constitution = item.constitution || {};
+    const common = {
+      ...base,
+      item_id: String(item.id),
+      opened_at: item.opened_at || null,
+      pass_rule: constitution.pass_rule || null,
+      needs: PASS_RULE_WORDS[constitution.pass_rule] || 'The rule this sitting runs under is not one this version knows; only its clock can close it.',
+      one_vote_decides: constitution.pass_rule === 'first_ratifier',
+    };
+    if (item.closed_at) {
+      stages.push({ ...common, state: item.outcome, closed_at: item.closed_at, voted: [], waiting_on: [] });
+      continue;
+    }
+    const key = String(constitution.membership || '');
+    if (!membersByPredicate.has(key)) membersByPredicate.set(key, await resolveBoardMembers(constitution));
+    const members = membersByPredicate.get(key);
+    const cast = votes.filter((v) => String(v.item_id) === String(item.id));
+    const castBy = new Map(cast.map((v) => [String(v.voter_id), v]));
+    stages.push({
+      ...common,
+      state: 'sitting',
+      closes_at: item.closes_at || null,
+      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,
+      })),
+      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,
+      })),
+    });
+  }
+  return { stages };
+}
+
 // ── the Board Room view (BV1.R16 of goal 1000069, ADR 0175 §9) ──────────────
 //
 // One assembled read for the room: open items with their clock, the OPEN
@@ -851,7 +1039,17 @@ async function boardRoomView({ closedLimit = 20 } = {}) {
     });
   }
   const project = (item) => {
-    const subject = item.subject_type === 'full_idea'
+    // A genesis stage's subject is the stage itself — named from the one list,
+    // so the room never mistakes it for an amendment (task 1004429).
+    const subject = item.subject_type === 'genesis_stage'
+      ? (() => {
+          const s = stageByNumber(item.subject_id);
+          return s ? {
+            stage_key: s.key, stage_number: s.number, label: s.label,
+            author_id: item.opened_by == null ? null : String(item.opened_by),
+          } : null;
+        })()
+      : item.subject_type === 'full_idea'
       ? (() => {
           const r = ideaById.get(String(item.subject_id));
           return r ? {
@@ -1138,6 +1336,10 @@ async function pendingVotesFor(builderId) {
 }
 
 module.exports = {
+  GENESIS_STAGES,
+  PASS_RULE_WORDS,
+  openGenesisStageClose,
+  genesisStageStatus,
   pendingVotesFor,
   hasMajority,
   majorityDecided,

package/modules/government/db.js

@@ -688,7 +688,12 @@ async function getExpiredOpenBoardItems(limit = 100) {
 async function openBoardItemsAwaitingVoter(voterId) {
   const { rows } = await pool.query(
     `SELECT i.id, i.subject_type, i.subject_id, i.constitution, i.opened_at, i.closes_at,
-            CASE WHEN i.subject_type = 'full_idea' THEN idea.captured_by ELSE i.opened_by END AS author_id,
+            -- A genesis stage has no author to hold back (task 1004429): the
+            -- founder who put it up IS the confirm monarchy waits on, so they
+            -- must be summoned, not skipped.
+            CASE WHEN i.subject_type = 'full_idea' THEN idea.captured_by
+                 WHEN i.subject_type = 'genesis_stage' THEN NULL
+                 ELSE i.opened_by END AS author_id,
             (v.id IS NOT NULL) AS already_voted
        FROM government_board_items i
        LEFT JOIN idea_inbox idea
@@ -703,6 +708,40 @@ async function openBoardItemsAwaitingVoter(voterId) {
   return rows;
 }
 
+// --- genesis stages (task 1004429 / BV2.PS04) --------------------------------
+
+// The status of each task a stage names, for the "are this stage's tasks all
+// finished" gate. `tasks` is a core table; READING it is the sanctioned pattern
+// (the boundary is code imports, not table access). An id with no row comes
+// back absent, and the caller counts that as unfinished — a stage cannot close
+// on a task nobody can find.
+async function getTaskStatuses(taskIds) {
+  if (!taskIds || !taskIds.length) return [];
+  const { rows } = await pool.query(
+    `SELECT id, status FROM tasks WHERE id = ANY($1::bigint[])`,
+    [taskIds],
+  );
+  return rows;
+}
+
+// The latest sitting for each genesis stage (one row per stage number, newest
+// first within it), with the same database-clock fields the room reads. Served
+// by government_020's partial index, keyed to exactly this ORDER BY — the table
+// holds every idea and amendment sitting forever, and without it this read
+// would scan all of that history to find a handful of stage rows.
+async function listLatestGenesisStageItems() {
+  const { rows } = await pool.query(
+    `SELECT DISTINCT ON (subject_id) *,
+            (closes_at IS NOT NULL AND closes_at < now()) AS expired,
+            CASE WHEN closes_at IS NULL THEN NULL
+                 ELSE GREATEST(0, EXTRACT(EPOCH FROM (closes_at - now()))::int) END AS remaining_seconds
+       FROM government_board_items
+      WHERE subject_type = 'genesis_stage'
+      ORDER BY subject_id, opened_at DESC, id DESC`,
+  );
+  return rows;
+}
+
 // Author-ratification karma (+3, board.js AUTHOR_RATIFY_KARMA_DELTA) — fired by
 // the R10 close on a passed item. IDEMPOTENT: the reason key is unique per item
 // and the INSERT is one atomic WHERE-NOT-EXISTS statement (the economy
@@ -731,6 +770,8 @@ async function insertVoteKarma({ voterId, itemId, delta }) {
 
 module.exports = {
   openBoardItemsAwaitingVoter,
+  getTaskStatuses,
+  listLatestGenesisStageItems,
   getPermissionKeysForBuilder,
   getRankKeysForBuilder,
   getSeededRanks,

package/modules/government/migrations/government_020_genesis_stage_subject.sql

@@ -0,0 +1,55 @@
+-- government_020_genesis_stage_subject.sql — the board's third subject: closing
+-- a genesis stage (task 1004429 / BV2.PS04, spec docs/specs/bongos-v2-project-
+-- startup.md decision D7).
+--
+-- government_003 built `subject_type` so that a third subject would be "a row,
+-- not a migration". That held for the ROWS — no new table, no new column — but
+-- the column carries a CHECK naming the two subjects it knew about, so the
+-- vocabulary itself still has to widen here. That is the whole of this file.
+--
+-- A genesis stage's subject_id is its STAGE NUMBER (1 scope · 2 strategize ·
+-- 3 charter · 4 legalize · 5 legislation — board.js GENESIS_STAGES is the one
+-- list). An instance is one project, so the number names the stage uniquely,
+-- and that is what lets government_003's partial unique index keep AT MOST ONE
+-- OPEN SITTING PER STAGE structurally, the same way it keeps one per idea: a
+-- double-fired "the stage's tasks are done" opens exactly one item. A stage
+-- that passed can be sat again later (the "second pass once your builders
+-- join" in the design of record) — the index is partial on open items only.
+--
+-- Nothing about deciding changes. The item snapshots the constitution in force
+-- like every other item, the pass rules are the same four, and the author and
+-- clock rules are the ones every item runs under.
+--
+-- Additive, idempotent: dropping and re-adding a CHECK that only WIDENS admits
+-- every row already in the table.
+
+BEGIN;
+
+ALTER TABLE government_board_items
+  DROP CONSTRAINT IF EXISTS government_board_items_subject_type_check;
+
+ALTER TABLE government_board_items
+  ADD CONSTRAINT government_board_items_subject_type_check
+  CHECK (subject_type IN ('full_idea', 'constitutional_amendment', 'genesis_stage'));
+
+-- The stage number is a small closed range; a stray id would be a sitting on a
+-- stage that does not exist. Scoped to genesis_stage so the other subjects'
+-- ids (idea and amendment row ids) are untouched.
+ALTER TABLE government_board_items
+  DROP CONSTRAINT IF EXISTS government_board_items_genesis_stage_number;
+
+ALTER TABLE government_board_items
+  ADD CONSTRAINT government_board_items_genesis_stage_number
+  CHECK (subject_type <> 'genesis_stage' OR subject_id BETWEEN 1 AND 5);
+
+-- Serves the founding band's read (db.js listLatestGenesisStageItems: the latest
+-- sitting per stage, DISTINCT ON subject_id ORDER BY subject_id, opened_at DESC,
+-- id DESC). The table only grows — every Full Idea and amendment sitting stays
+-- forever — so a read that filters by subject_type alone would scan that whole
+-- history to find at most a handful of stage rows. Partial on the one subject it
+-- asks for and keyed to its ORDER BY exactly, the government_006/018 shape.
+CREATE INDEX IF NOT EXISTS government_board_items_genesis_stage_latest
+  ON government_board_items (subject_id, opened_at DESC, id DESC)
+  WHERE subject_type = 'genesis_stage';
+
+COMMIT;