@bongos/core 1.24.73 → 1.24.75

package/docs/page-readings.json

@@ -12,7 +12,7 @@
       "surface": "builders",
       "title": "Studio",
       "states_read": ["pick","describe","make","waiting","result","result-own","failed","balance","balance-all","out"],
-      "files_hash": "50e25bda4cc82a5a",
+      "files_hash": "4f71b6714f7e2d61",
       "reading_hash": "e381a3141dc6b9cb",
       "counts": {"lines":105,"placed":38,"shared":9,"unplaced":58},
       "omitted": {"data":15},
@@ -130,7 +130,7 @@
       "surface": "builders",
       "title": "Repo Atlas",
       "states_read": ["map","truth","detail","index","out"],
-      "files_hash": "63832faf57d99cf1",
+      "files_hash": "5c3b63261c77b636",
       "reading_hash": "94058beb635218ba",
       "counts": {"lines":24,"placed":11,"shared":9,"unplaced":4},
       "omitted": {"data":3},
@@ -167,7 +167,7 @@
       "surface": "builders",
       "title": "Blockers",
       "states_read": ["default"],
-      "files_hash": "92d9a0d9aa43e122",
+      "files_hash": "ab533cabec76122e",
       "reading_hash": "ab984bd8e91a5a9d",
       "counts": {"lines":35,"placed":14,"shared":9,"unplaced":12},
       "omitted": {"data":49},
@@ -215,7 +215,7 @@
       "surface": "builders",
       "title": "Board Room",
       "states_read": ["room","out","sitting-meta","objection-form"],
-      "files_hash": "8190cdce5bd59db4",
+      "files_hash": "0e6e17f03283a4a6",
       "reading_hash": "020553cb2a438d56",
       "counts": {"lines":51,"placed":18,"shared":9,"unplaced":24},
       "omitted": {"data":15},
@@ -238,7 +238,7 @@
         {"key":"L0015","section":"{…} Full Idea","text":"It counts toward passing","placement":"unplaced"},
         {"key":"L0016","section":"{…} Full Idea","text":"Object","placement":"unplaced"},
         {"key":"L0017","section":"{…} Full Idea","text":"It goes back with your reason","placement":"unplaced"},
-        {"key":"L0018","section":"{…} Full Idea","text":"Its author recommends this becomes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":310,"string_id":"680491549e47"},
+        {"key":"L0018","section":"{…} Full Idea","text":"Its author recommends this becomes","placement":"placed","file":"modules/hall-ui/public/board-room.js","line":311,"string_id":"680491549e47"},
         {"key":"L0019","section":"{…} Full Idea","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","occurrences":2},
         {"key":"L0020","section":"{…} Full Idea","text":". The {…} decides.","placement":"unplaced"},
         {"key":"L0021","section":"{…} Full Idea","text":"What made you have the idea","placement":"unplaced"},
@@ -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":484,"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":485,"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":484,"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":485,"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":484,"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":485,"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},
@@ -279,7 +279,7 @@
       "surface": "builders",
       "title": "The city",
       "states_read": ["city","fullscreen","switched","focus","pins","living","card","card-ask"],
-      "files_hash": "a5d54bcdf64345ee",
+      "files_hash": "9ed0417e2e4dfb92",
       "reading_hash": "11234462e18a0037",
       "counts": {"lines":44,"placed":10,"shared":9,"unplaced":25},
       "omitted": {"data":18},
@@ -336,7 +336,7 @@
       "surface": "builders",
       "title": "Collab",
       "states_read": ["board","out"],
-      "files_hash": "5cf57d56b9e9ecf7",
+      "files_hash": "887a503d80d5c0e2",
       "reading_hash": "2d5df14f73c44d86",
       "counts": {"lines":81,"placed":33,"shared":8,"unplaced":40},
       "omitted": {"data":21},
@@ -430,7 +430,7 @@
       "surface": "builders",
       "title": "Commands",
       "states_read": ["in","out"],
-      "files_hash": "2b04b74db0dafd12",
+      "files_hash": "687bb6af0eff6e0c",
       "reading_hash": "b7107deecbf6bf46",
       "counts": {"lines":70,"placed":46,"shared":9,"unplaced":15},
       "omitted": {"data":175},
@@ -513,7 +513,7 @@
       "surface": "builders",
       "title": "Copy desk",
       "states_read": ["queue","out","search","composer","closer","proposer"],
-      "files_hash": "f3e33781928f9834",
+      "files_hash": "6d4903527b0a1c30",
       "reading_hash": "4476deef6b37ffe5",
       "counts": {"lines":78,"placed":39,"shared":9,"unplaced":30},
       "omitted": {"data":119},
@@ -604,7 +604,7 @@
       "surface": "builders",
       "title": "Deploy",
       "states_read": ["work","out"],
-      "files_hash": "dfa284608a5cebe7",
+      "files_hash": "a0ab8445ee5bf294",
       "reading_hash": "76c11d0fbc739610",
       "counts": {"lines":19,"placed":5,"shared":9,"unplaced":5},
       "omitted": {"data":3},
@@ -636,7 +636,7 @@
       "surface": "builders",
       "title": "The sky",
       "states_read": ["tour","sky","wells","ledger","full","full-back","out"],
-      "files_hash": "adf0f533cc7d8e49",
+      "files_hash": "b47d4ef94ef6d2c5",
       "reading_hash": "2ae796b3e72c6d26",
       "counts": {"lines":49,"placed":22,"shared":8,"unplaced":19},
       "omitted": {"data":8},
@@ -698,7 +698,7 @@
       "surface": "builders",
       "title": "Goals",
       "states_read": ["list","filters","cards","detail","dependencies","out","uat","uat-panel","author"],
-      "files_hash": "b3b5b86934a95f45",
+      "files_hash": "ddc111d1819224ad",
       "reading_hash": "82f9b0ae157d2700",
       "counts": {"lines":186,"placed":58,"shared":9,"unplaced":119},
       "omitted": {"data":313},
@@ -897,7 +897,7 @@
       "surface": "builders",
       "title": "Government",
       "states_read": ["constitution","out","permissions","board","constitution-tab"],
-      "files_hash": "7de217569d7dee56",
+      "files_hash": "3a9b128ca492be07",
       "reading_hash": "0d1ee732e57189fb",
       "counts": {"lines":64,"placed":24,"shared":9,"unplaced":31},
       "omitted": {"data":274},
@@ -974,8 +974,8 @@
       "surface": "builders",
       "title": "Builders' Hall",
       "states_read": ["home","out","founding","genesis","decide","demo"],
-      "files_hash": "a7f35bfa83de9522",
-      "reading_hash": "4cc2e5e86483a66e",
+      "files_hash": "0680b2faae3f956f",
+      "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"},
@@ -1015,7 +1015,7 @@
       "surface": "builders",
       "title": "Idea",
       "states_read": ["record","missing"],
-      "files_hash": "fd3aca17029f8215",
+      "files_hash": "d31ed5e538fa57ac",
       "reading_hash": "1924057e1bb86631",
       "counts": {"lines":51,"placed":22,"shared":10,"unplaced":19},
       "omitted": {"data":23},
@@ -1079,7 +1079,7 @@
       "surface": "builders",
       "title": "Ideas",
       "states_read": ["compose","full","develop"],
-      "files_hash": "8f52a6b42f728cc5",
+      "files_hash": "59081864d4eabae8",
       "reading_hash": "9ed251f7cc60a885",
       "counts": {"lines":67,"placed":31,"shared":9,"unplaced":27},
       "omitted": {"data":116},
@@ -1159,7 +1159,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["desk","settings","out"],
-      "files_hash": "9140a587c36cb555",
+      "files_hash": "a46496a5cf19a695",
       "reading_hash": "de1a8fdf7ebcc959",
       "counts": {"lines":13,"placed":3,"shared":9,"unplaced":1},
       "omitted": {"data":2},
@@ -1185,7 +1185,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["dossier","out","propose","correct","filtered"],
-      "files_hash": "0043d2efb8ce3fae",
+      "files_hash": "f3b5b24581756454",
       "reading_hash": "12483255342bd007",
       "counts": {"lines":14,"placed":4,"shared":9,"unplaced":1},
       "omitted": {"data":2},
@@ -1212,7 +1212,7 @@
       "surface": "builders",
       "title": "Market Watch rules",
       "states_read": ["in","scoring","names","propose","out"],
-      "files_hash": "cb4364ca3a8fd6a4",
+      "files_hash": "d37cdb4cc97ae6a3",
       "reading_hash": "bf661622dd283b83",
       "counts": {"lines":48,"placed":13,"shared":9,"unplaced":26},
       "omitted": {"data":45},
@@ -1273,7 +1273,7 @@
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "94eba85cba4f0d69",
+      "files_hash": "85e1f48677ea96f7",
       "reading_hash": "cdf89441f9e9516e",
       "counts": {"lines":60,"placed":26,"shared":9,"unplaced":25},
       "omitted": {"data":105},
@@ -1346,7 +1346,7 @@
       "surface": "builders",
       "title": "Money",
       "states_read": ["money","hosting","out"],
-      "files_hash": "f9a4e0eac1b68a92",
+      "files_hash": "cbf3f8ed30ccfff6",
       "reading_hash": "285d714c7aba1fc9",
       "counts": {"lines":82,"placed":25,"shared":9,"unplaced":48},
       "omitted": {"data":25},
@@ -1441,7 +1441,7 @@
       "surface": "builders",
       "title": "My agents",
       "states_read": ["desk","factory","saved","what-it-knows","speciality-walk","speciality-forms","nobody"],
-      "files_hash": "6fc32880505c557d",
+      "files_hash": "25a31340d16b79d9",
       "reading_hash": "74d10b6c2a24ce2e",
       "counts": {"lines":138,"placed":60,"shared":9,"unplaced":69},
       "omitted": {"data":171},
@@ -1592,7 +1592,7 @@
       "surface": "builders",
       "title": "Primer",
       "states_read": ["in","toc-open","jump","out"],
-      "files_hash": "919ef5b8b427e8cf",
+      "files_hash": "93efc9b10054a26a",
       "reading_hash": "395c98d876001b5a",
       "counts": {"lines":486,"placed":54,"shared":9,"unplaced":423},
       "omitted": {"data":16},
@@ -2091,7 +2091,7 @@
       "surface": "builders",
       "title": "Profile",
       "states_read": ["own","works","activity","yours","activity-artist","activity-ideator","other","artist","ideator","out"],
-      "files_hash": "faab3fa3b6220357",
+      "files_hash": "fd066c9c1add890e",
       "reading_hash": "fe899712427882ff",
       "counts": {"lines":219,"placed":77,"shared":9,"unplaced":133},
       "omitted": {"data":250},
@@ -2323,7 +2323,7 @@
       "surface": "builders",
       "title": "Project settings",
       "states_read": ["default"],
-      "files_hash": "85c0c733104bd60e",
+      "files_hash": "2c0f365687004dda",
       "reading_hash": "849399ad428ae9c7",
       "counts": {"lines":42,"placed":22,"shared":9,"unplaced":11},
       "omitted": {"data":31},
@@ -2378,7 +2378,7 @@
       "surface": "builders",
       "title": "Builders",
       "states_read": ["roster","artists","search","out"],
-      "files_hash": "0aa74b38af3f3c52",
+      "files_hash": "562ab7294ed7994a",
       "reading_hash": "ab1f237b3ce6f134",
       "counts": {"lines":58,"placed":14,"shared":9,"unplaced":35},
       "omitted": {"data":135},
@@ -2449,7 +2449,7 @@
       "surface": "builders",
       "title": "Settings",
       "states_read": ["account","access","preferences","install-reports","sound","update"],
-      "files_hash": "da132b7d96a13735",
+      "files_hash": "685465c1780ddf1b",
       "reading_hash": "085bb32894909ee0",
       "counts": {"lines":137,"placed":90,"shared":9,"unplaced":38},
       "omitted": {"data":16},
@@ -2599,7 +2599,7 @@
       "surface": "builders",
       "title": "The street",
       "states_read": ["street","fullscreen","card","switched","focus","here","inside-rules","inside-disputes","inside-people","inside-planning","inside-automation","inside-review","inside-release","inside-treasury","floor","amend","district","desk","desk-facts","desk-quiet","desk-people-builders","desk-people-tier","desk-disputes","desk-automation-goals","desk-release-core","desk-rules","desk-rules-category","desk-planning-priorities","desk-planning-ideas","desk-planning-blockers","pins","pins-pager","living","deck","deck-treasury","sitting","object","voted","admission","settled","blocker","blocker-more","report","report-more","core","core-more","recheck","recheck-more","idea","idea-more","queue","queue-more","automation","automation-more"],
-      "files_hash": "6d4dbf9fec6f23e6",
+      "files_hash": "bcc43de9ec38fb26",
       "reading_hash": "8e9e3422f6b72884",
       "counts": {"lines":460,"placed":65,"shared":9,"unplaced":386},
       "omitted": {"data":433},
@@ -3072,7 +3072,7 @@
       "surface": "builders",
       "title": "Studio",
       "states_read": ["home","out","flow","flow-pick","status","words-offer","words-edit","reviews","full","full-back","approvals","approvals-before","approvals-phone","approvals-note","approved","sent-back","approvals-page"],
-      "files_hash": "70fed47103199ae9",
+      "files_hash": "6b37ea0de369e584",
       "reading_hash": "55463fb0c09b5d71",
       "counts": {"lines":50,"placed":26,"shared":9,"unplaced":15},
       "omitted": {"data":21},
@@ -3135,7 +3135,7 @@
       "surface": "builders",
       "title": "Task",
       "states_read": ["record","from-goal","missing"],
-      "files_hash": "b653ab7f5907351c",
+      "files_hash": "7f1c8fcc8e9f83d5",
       "reading_hash": "ecaa5fba5bc119a8",
       "counts": {"lines":150,"placed":43,"shared":11,"unplaced":96},
       "omitted": {"data":109},
@@ -3298,7 +3298,7 @@
       "surface": "builders",
       "title": "Your thinking",
       "states_read": ["tour","sky","list","simple","full-idea","full","full-list","full-back","out"],
-      "files_hash": "032c6af6a1ffbd68",
+      "files_hash": "ec5269e1f8585592",
       "reading_hash": "8113aa9e50ec5600",
       "counts": {"lines":49,"placed":22,"shared":8,"unplaced":19},
       "omitted": {"data":8},
@@ -3360,7 +3360,7 @@
       "surface": "builders",
       "title": "Tweak a page",
       "states_read": ["doc","typed","chrome","submitted","picking","out"],
-      "files_hash": "d23569d9061dd5b1",
+      "files_hash": "cbd96ef300b7e801",
       "reading_hash": "711c540ebc7ef977",
       "counts": {"lines":23,"placed":15,"shared":1,"unplaced":7},
       "omitted": {"data":35},
@@ -3396,7 +3396,7 @@
       "surface": "builders",
       "title": "Watch",
       "states_read": ["board","out","operations","security","sessions","autobongos"],
-      "files_hash": "a58bbb70d55ab295",
+      "files_hash": "08e46562439e6d7b",
       "reading_hash": "2e2e07eab2e3e772",
       "counts": {"lines":69,"placed":28,"shared":9,"unplaced":32},
       "omitted": {"data":50},
@@ -3478,7 +3478,7 @@
       "surface": "builders",
       "title": "Tasks",
       "states_read": ["ready","in-progress","backlog","completed","filters-open","out","founding"],
-      "files_hash": "fabac0ed9aaf82fb",
+      "files_hash": "469be6bdd4773fb7",
       "reading_hash": "f1d7a8ed45e60ffa",
       "counts": {"lines":122,"placed":46,"shared":9,"unplaced":67},
       "omitted": {"data":321},

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/ai-studio.html

@@ -87,9 +87,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-28-tw23"></script>

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

@@ -90,9 +90,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

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

@@ -59,9 +59,10 @@
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

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

@@ -61,9 +61,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

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/city.html

@@ -106,9 +106,10 @@
 </div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode" defer></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers" defer></script>
 <script src="/builders/craft-mode.js?v=2026-11-05-goals" defer></script>
-<script src="/builders/shell.js?v=2026-11-07-brand-mark" defer></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode" defer></script>
 <script src="/builders/hall-dialog.js" defer></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1" defer></script>

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

@@ -160,9 +160,10 @@
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
 <script src="/builders/dom-utils.js?v=2026-11-05-numbers"></script>
+<script src="/builders/shell-game.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-05-goals"></script>
-<script src="/builders/shell.js?v=2026-11-07-brand-mark"></script>
+<script src="/builders/shell.js?v=2026-11-09-game-mode"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>