@bongos/core 1.25.20 → 1.25.22

package/modules/government/board.js

@@ -256,20 +256,20 @@ function validateVote({ direction, reasonMd, sectionKey } = {}) {
 //   { ok: true,  vote, fresh: false, self_cast }               — idempotent re-cast
 //   { ok: false, reason: 'item_not_found' | 'item_closed' | 'vote_window_expired'
 //               | '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).
+// `castVia` (task 1005121, government_038) is internal — never read from a request: 'ballot', 'stage_close' (genesis-close.js: a founder's confirm given by closing a genesis stage — genesis_stage + yes only, no vote karma), or 'filed' (sole-member.js, task 1005130 / government_039: a board of one's confirm given by filing — constitutional_amendment + 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, 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' };
+  if (!['ballot', 'stage_close', 'filed'].includes(castVia)) 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 (castVia !== 'ballot' && (item.subject_type !== (castVia === 'filed' ? 'constitutional_amendment' : '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
@@ -321,7 +321,7 @@ 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 || castVia === 'stage_close') {
+  if (isSelfCast || castVia !== 'ballot') {
     return { ok: true, vote: inserted, fresh: true, karma_delta: 0, self_cast: isSelfCast };
   }
   await db.insertVoteKarma({ voterId, itemId: id, delta: VOTE_KARMA_DELTA });
@@ -906,9 +906,10 @@ async function proposeCharter({
   }
   const unchanged = ['membership', 'pass_rule', 'window_minutes', 'close_early_on_full_turnout']
     .every((k) => v.proposal[k] === live[k]);
-  if (unchanged) return { ok: false, reason: 'no_change' };
-
+  // task 1005130: a choice that changes nothing SAYS so, and counts as done.
+  if (unchanged) return { ok: false, reason: 'no_change', in_force: charter.readCharter(live).name, complete: true, message: charter.alreadyLine(live) };
   const readsAs = charter.readCharter(v.proposal);
+  const next = `${readsAs.form === 'custom' ? 'These settings' : `Choosing ${readsAs.name}`} ${charter.whatHappensNext(live)}`;
   const out = await proposeAmendment({
     proposal: v.proposal,
     // The record says in words what was chosen, so the amendment history reads
@@ -917,7 +918,7 @@ async function proposeCharter({
     proposedBy,
     acknowledgeSelfRemoval,
   });
-  return out.ok ? { ...out, reads_as: readsAs } : out;
+  return out.ok ? { ...out, reads_as: readsAs, what_happens_next: next } : out;
 }
 
 // ── who decides what (task 1004529, ADR 0363) ───────────────────────────────

package/modules/government/charter-advice.js

@@ -67,12 +67,18 @@ function draftBylaws({ charter: rec, preset, prose = {} }) {
 // buildAdvice({ answers, prose, headcount, type, laws }) — PURE. `answers` holds only
 // the closed answers the founder actually gave (not "not sure yet", not skipped);
 // `laws` is db.listLaws() rows, so the preset view says which is in force now.
-function buildAdvice({ answers = {}, prose = {}, headcount = 0, type = null, laws = [] } = {}) {
+function buildAdvice({ answers = {}, prose = {}, headcount = 0, type = null, laws = [], board = null } = {}) {
   const rec = recommendedCharter(headcount, type, answers);
   const preset = presets.recommendedPreset(answers);
   const view = presets.presetsView(laws);
+  // task 1005130: what is true NOW, before the founder chooses — the form in force,
+  // every form saying who decides and what closing takes, and what choosing the
+  // recommended one would do (nothing, when it is already in force).
+  const forms = board ? charter.charterView(board) : null;
   return {
-    charter: rec,
+    in_force: forms ? forms.in_force : null,
+    forms: forms ? forms.forms : null,
+    charter: board ? { ...rec, on_choose: charter.choiceOutcome(board, rec.key) } : rec,
     // null when the founder's principles do not point at one — no preset is fine
     preset: preset ? { ...preset, locks: (view.presets.find((p) => p.key === preset.key) || {}).locks || [] } : null,
     preset_in_force: view.current,
@@ -91,13 +97,14 @@ function recommendedCharter(headcount, type, answers) {
 // otherwise the live count of active builders.
 async function charterAdvice({ answers, prose, headcount = null, type = null } = {}, deps = {}) {
   const db = deps.db || require('./db');
+  const board = deps.board !== undefined ? deps.board : require('./config').loadGovernmentConfig().board;
   const [count, laws] = await Promise.all([
     headcount != null && Number(headcount) > 0 ? Number(headcount) : db.countActiveBuilders(),
     db.listLaws(),
   ]);
   const p = {};
   for (const k of PROSE) if (prose && text(prose[k])) p[k] = text(prose[k]);
-  return buildAdvice({ answers, prose: p, headcount: count, type, laws });
+  return buildAdvice({ answers, prose: p, headcount: count, type, laws, board });
 }
 
 module.exports = { buildAdvice, charterAdvice };

package/modules/government/charter.js

@@ -123,6 +123,41 @@ const FORMS = freezeAll([
     explanation: 'Self-governing teams coordinate under one shared pact. Coming later, for projects with many teams.' },
 ]);
 
+// ── what a form asks of the founder day to day (task 1005130) ───────────────
+// Owner, 2026-11-07: "I am the monarch" read as "nothing is asked of me", and the
+// project still asked for a vote to close a stage. Monarchy means ONE yes decides,
+// not NO yes is needed. So every form says, beside its name, who decides and what
+// closing something takes — DERIVED from its franchise and pass rule, never written
+// by hand, so it can never disagree with what the board actually runs.
+const WHO_DECIDES = Object.freeze({
+  founder: 'You decide.',
+  trusted: 'You and the builders who have earned the trusted rank decide together.',
+  everyone: 'Every builder on the project decides.',
+  council: 'The council you appoint decides.',
+  custom: 'The members these settings seat decide.',
+});
+const TO_CLOSE = Object.freeze({
+  first_ratifier: 'Each decision takes one yes from one of them.',
+  consent: 'Each decision passes unless one of them objects, once they have all voted (or its clock runs out, if one is set).',
+  majority: 'Each decision needs a yes from more than half of them.',
+  unanimous: 'Each decision needs everyone who votes to agree, and at least one yes.',
+});
+// A board of one: every rule comes down to that one person's vote.
+const TO_CLOSE_FOUNDER = Object.freeze({
+  first_ratifier: 'Each decision takes one yes from you.',
+  consent: 'Each decision takes your vote: it passes unless you object.',
+  majority: 'Each decision takes one yes from you.',
+  unanimous: 'Each decision takes one yes from you.',
+});
+
+// dutyOf(franchise, passRule) → { who_decides, to_close } in plain words.
+function dutyOf(franchise, passRule) {
+  const who = WHO_DECIDES[franchise] || WHO_DECIDES.custom;
+  const close = (franchise === 'founder' ? TO_CLOSE_FOUNDER : TO_CLOSE)[passRule]
+    || 'This pass rule is not one this version knows; only its clock can close a decision.';
+  return { who_decides: who, to_close: close };
+}
+
 const CUSTOM_EXPLANATION = 'These settings match no named form of government. They are still the real rules the board runs under.';
 
 const byKey = (list, key) => list.find((x) => x.key === key) || null;
@@ -152,8 +187,8 @@ function readCharter(board) {
   const passRule = byKey(PASS_RULE_OPTIONS, b.pass_rule) ? b.pass_rule : 'custom';
   const form = FORMS.find((f) => f.available && f.franchise === franchise && f.pass_rule === passRule);
   return Object.freeze(form
-    ? { form: form.key, name: form.name, explanation: form.explanation, franchise, pass_rule: passRule }
-    : { form: 'custom', name: 'Custom', explanation: CUSTOM_EXPLANATION, franchise, pass_rule: passRule });
+    ? { form: form.key, name: form.name, explanation: form.explanation, franchise, pass_rule: passRule, ...dutyOf(franchise, passRule) }
+    : { form: 'custom', name: 'Custom', explanation: CUSTOM_EXPLANATION, franchise, pass_rule: passRule, ...dutyOf(franchise, passRule) });
 }
 
 // Build the WHOLE constitution a charter choice makes, on top of the live one.
@@ -209,17 +244,62 @@ function buildCharterProposal(liveBoard, { form, franchise, councilRank, passRul
 // The whole vocabulary plus what the constitution in force reads as — the
 // payload the genesis charter and legislation stages render from.
 function charterView(liveBoard) {
+  const readsAs = readCharter(liveBoard);
   return {
-    forms: FORMS,
+    // Every form, each saying what it asks day to day, and the one in force marked.
+    forms: FORMS.map((f) => (f.available
+      ? { ...f, ...dutyOf(f.franchise, f.pass_rule), current: f.key === readsAs.form }
+      : { ...f, current: false })),
+    in_force: inForce(readsAs),
     variables: VARIABLES.map((v) => (
       v.key === 'franchise' ? { ...v, options: FRANCHISE_OPTIONS }
         : v.key === 'pass_rule' ? { ...v, options: PASS_RULE_OPTIONS }
           : v.key === 'trajectory' ? { ...v, options: TRAJECTORIES }
             : v)),
-    reads_as: readCharter(liveBoard),
+    reads_as: readsAs,
   };
 }
 
+// inForce(readsAs) → what is true NOW, said before the founder chooses (task 1005130):
+// every project opens as Monarchy / BDFL, and a founder should learn that from the
+// platform rather than infer it from a choice that does nothing.
+function inForce(readsAs) {
+  const opening = readsAs.form === 'monarchy'
+    ? ' Every project opens as one, so choosing Monarchy / BDFL changes nothing.'
+    : '';
+  return Object.freeze({
+    form: readsAs.form,
+    name: readsAs.name,
+    who_decides: readsAs.who_decides,
+    to_close: readsAs.to_close,
+    line: `This project runs as ${readsAs.name} now.${opening} ${readsAs.who_decides} ${readsAs.to_close}`,
+  });
+}
+
+// choiceOutcome(liveBoard, formKey) → what choosing a form would DO, in words: nothing
+// (it is already in force, so this part of the stage is done), or an amendment
+// decided under the government in force — and, when one yes carries it, whose.
+function choiceOutcome(liveBoard, formKey) {
+  const now = readCharter(liveBoard);
+  const f = byKey(FORMS, formKey);
+  if (!f) return null;
+  if (now.form === f.key) return Object.freeze({ changes: false, complete: true, line: alreadyLine(liveBoard) });
+  return Object.freeze({ changes: true, complete: false, line: `Choosing ${f.name} ${whatHappensNext(liveBoard)}` });
+}
+
+// whatHappensNext(liveBoard) → the rest of the sentence "Choosing X …": a change is
+// filed as an amendment and decided under the government in force, and who carries it.
+function whatHappensNext(liveBoard) {
+  const now = readCharter(liveBoard);
+  const oneYes = now.pass_rule === 'first_ratifier';
+  const whose = now.franchise === 'founder' ? 'your own one yes applies it' : 'one yes from a member applies it';
+  return `is filed as a change to the rules and decided under the government in force (${now.name}). ${oneYes ? `Under it, ${whose}.` : now.to_close}`;
+}
+// alreadyLine(liveBoard) → "You are already a Monarchy / BDFL. Nothing to change…"
+function alreadyLine(liveBoard) {
+  return `You are already a ${readCharter(liveBoard).name}. Nothing to change, and this choice is done.`;
+}
+
 module.exports = {
   FORMS,
   VARIABLES,
@@ -227,6 +307,10 @@ module.exports = {
   PASS_RULE_OPTIONS,
   TRAJECTORIES,
   readCharter,
+  dutyOf,
+  choiceOutcome,
+  alreadyLine,
+  whatHappensNext,
   buildCharterProposal,
   charterView,
 };

package/modules/government/migrations/government_039_vote_cast_via_filed.sql

@@ -0,0 +1,22 @@
+-- government_039_vote_cast_via_filed.sql — a third way a vote is cast (task 1005130).
+--
+-- A board of ONE under first_ratifier: the board exists only to collect that one
+-- person's yes, so asking them to vote on their own instruction is ceremony, not
+-- governance (owner feedback 2026-11-07; the same ruling task 1005121 shipped for
+-- closing a genesis stage). When that sole member FILES an amendment, their yes is
+-- cast in the same call (sole-member.js) — and, as with a stage close, the record
+-- says HOW it was cast rather than looking like a clicked ballot.
+--
+--   cast_via  'ballot'       a vote cast in the Board Room (the vote route)
+--             'stage_close'  the confirm given by closing a genesis stage
+--             'filed'        the sole member's confirm given by filing an amendment;
+--                            only board.js writes it, only on a
+--                            constitutional_amendment item, only yes
+
+BEGIN;
+
+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', 'filed') AND (cast_via = 'ballot' OR direction = 'yes'));
+
+COMMIT;

package/modules/government/routes/government.js

@@ -137,7 +137,7 @@ const governmentPort = {
   // an ordinary amendment under the constitution in force — for the genesis
   // home, which renders the stages from GET /government/constitution's
   // `charter` block. Opening a sitting decides nothing; the vote does.
-  proposeCharter: board.proposeCharter,
+  proposeCharter: (a) => require('../sole-member').proposeCharter(a), // task 1005130: a board of one decides by filing (sole-member.js), here and on every amendment route
   charterAdvice: (input) => require('../charter-advice').charterAdvice(input), // task 1005119: advice only, never a write
   genesisStageStatus: board.genesisStageStatus,
   // task 1004529 — who decides what. The table, resolved, and the check a
@@ -972,7 +972,7 @@ module.exports = function buildGovernmentRouter() {
       });
     }
     try {
-      const out = await board.proposeAmendment({
+      const out = await require('../sole-member').proposeAmendment({
         proposal: req.body.proposal,
         rationaleMd: req.body.rationale_md ?? null,
         proposedBy: req.builder.id,
@@ -1002,7 +1002,7 @@ module.exports = function buildGovernmentRouter() {
       if (wording && typeof wording.flagInvestmentWording === 'function' && typeof req.body.rationale_md === 'string') {
         wording.flagInvestmentWording(req.body.rationale_md, { where: 'board item', ref: out.item && out.item.id });
       }
-      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item });
+      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item , decided: out.decided });
     } catch (err) {
       log.error('[gds] POST /government/board/items', err);
       res.fail('propose_failed', { status: 500, message: 'internal error' });
@@ -1033,7 +1033,7 @@ module.exports = function buildGovernmentRouter() {
       return res.fail('invalid_proposal', 400, { reason: 'bad_window_minutes', expected: 'null (no clock) or a whole number of minutes' });
     }
     try {
-      const out = await board.proposeCharter({
+      const out = await require('../sole-member').proposeCharter({
         form: body.form ?? undefined,
         franchise: body.franchise ?? undefined,
         councilRank: body.council_rank ?? undefined,
@@ -1054,7 +1054,7 @@ module.exports = function buildGovernmentRouter() {
           });
         }
         if (out.reason === 'no_change') {
-          return res.fail('no_change', 409, { reason: 'the constitution in force already has these settings' });
+          return res.fail('no_change', 409, { reason: 'the constitution in force already has these settings', in_force: out.in_force, complete: true, message: out.message });
         }
         return res.fail('invalid_charter', 400, {
           reason: out.reason,
@@ -1063,7 +1063,7 @@ module.exports = function buildGovernmentRouter() {
           ...(out.rank_key ? { rank_key: out.rank_key } : {}),
         });
       }
-      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item, reads_as: out.reads_as });
+      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item, reads_as: out.reads_as, what_happens_next: out.what_happens_next , decided: out.decided });
     } catch (err) {
       log.error('[gds] POST /government/board/charter', err);
       res.fail('charter_failed', { status: 500, message: 'internal error' });
@@ -1090,7 +1090,7 @@ module.exports = function buildGovernmentRouter() {
       rationale_md: { type: 'string', maxLength: 5000 },
     })) return;
     try {
-      const out = await board.proposeDecisionRules({
+      const out = await require('../sole-member').proposeDecisionRules({
         rules: req.body.rules,
         rationaleMd: req.body.rationale_md ?? null,
         proposedBy: req.builder.id,
@@ -1105,7 +1105,7 @@ module.exports = function buildGovernmentRouter() {
           ...(out.rank_key ? { rank_key: out.rank_key } : {}),
         });
       }
-      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item, rules: out.rules });
+      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item, rules: out.rules , decided: out.decided });
     } catch (err) {
       log.error('[gds] POST /government/board/decision-rules', err);
       res.fail('propose_failed', { status: 500, message: 'internal error' });
@@ -1129,7 +1129,7 @@ module.exports = function buildGovernmentRouter() {
       rationale_md: { type: 'string', maxLength: 5000 },
     })) return;
     try {
-      const out = await board.proposeLaws({
+      const out = await require('../sole-member').proposeLaws({
         enact: req.body.enact,
         repeal: req.body.repeal,
         rationaleMd: req.body.rationale_md ?? null,
@@ -1150,7 +1150,7 @@ module.exports = function buildGovernmentRouter() {
           ...(out.setting ? { setting: out.setting } : {}),
         });
       }
-      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item, proposal: out.proposal });
+      res.status(201).json({ ok: true, amendment: out.amendment, item: out.item, proposal: out.proposal , decided: out.decided });
     } catch (err) {
       log.error('[gds] POST /government/board/laws', err);
       res.fail('propose_failed', { status: 500, message: 'internal error' });
@@ -1200,14 +1200,14 @@ module.exports = function buildGovernmentRouter() {
         if (sw.reason === 'preset_in_force') return res.fail('preset_in_force', 409, { preset: req.body.preset });
         return res.fail('invalid_preset', 400, { reason: sw.reason, ...(sw.expected ? { expected: sw.expected } : {}) });
       }
-      const out = await board.proposeLaws({ ...sw.proposal, rationaleMd: sw.rationale, proposedBy: req.builder.id });
+      const out = await require('../sole-member').proposeLaws({ ...sw.proposal, rationaleMd: sw.rationale, proposedBy: req.builder.id });
       if (!out.ok) {
         if (out.reason === 'already_in_force' || out.reason === 'setting_already_locked' || out.reason === 'not_in_force') {
           return res.fail(out.reason, 409, { ...(out.law_id ? { law_id: out.law_id } : {}), ...(out.setting ? { setting: out.setting } : {}) });
         }
         return res.fail('invalid_preset', 400, { reason: out.reason });
       }
-      res.status(201).json({ ok: true, preset: req.body.preset, amendment: out.amendment, item: out.item, proposal: out.proposal });
+      res.status(201).json({ ok: true, preset: req.body.preset, amendment: out.amendment, item: out.item, proposal: out.proposal , decided: out.decided });
     } catch (err) {
       log.error('[gds] POST /government/board/presets', err);
       res.fail('propose_failed', { status: 500, message: 'internal error' });

package/modules/government/sole-member.js

@@ -0,0 +1,75 @@
+'use strict';
+// modules/government/sole-member.js — a board of ONE decides by filing (task 1005130,
+// part C; owner feedback 2026-11-07, the ruling task 1005121 shipped for closing a
+// genesis stage, applied wherever it holds).
+//
+// WHY. Under monarchy the board is one person, and a sitting it opens exists only to
+// collect that person's yes. Asking them to vote on their own instruction is a second
+// step that decides nothing: "the government is in place after it is defined, but it
+// still asked me to cast a vote". So when the SOLE member files an amendment, their
+// yes is cast in the same call and the sitting closes.
+//
+// EXACTLY THREE CONDITIONS, read on the server from the item's own snapshot — the
+// constitution in force at the moment of filing — never from the request:
+//   1. the pass rule is first_ratifier (one yes decides);
+//   2. the board that snapshot seats has exactly one member (live rows, uncached);
+//   3. the person filing IS that member.
+// Anything else — two or more members, any other rule, a caller who is not the sole
+// member — returns the filing untouched, byte for byte what it was before. Under
+// first_ratifier the first yes closes regardless of a window or early-close setting,
+// so neither changes the outcome here.
+//
+// NOTHING IS SKIPPED. The filing ran its own permission gate, strict validation and
+// self-removal guard before this is reached; the yes goes through board.castVote,
+// which re-checks membership under the snapshot, the window and the clock; the close
+// goes through board.maybeCloseAfterVote → closeItem, so a passed amendment is applied
+// and recorded exactly as a clicked ballot's would be. The vote is that member's,
+// attributed and timestamped, marked cast_via 'filed' (government_039) so the record
+// tells it from a ballot — the stage-close precedent — and it earns no vote karma.
+//
+// FAIL-OPEN. The filing already stands; if the confirm or the close fails, the
+// sitting is simply left open for an ordinary vote, as before this existed.
+//
+// Composed only from board.js's exports, looked up at call time (genesis-close.js's
+// pattern), so a test's stubs on board's db bite exactly as they do for board itself.
+const board = require('./board.js');
+const { resolveBoardMembers } = require('./board-membership.js');
+const log = require('../../src/module-api').logger('government');
+
+// confirmIfSoleMember(out, filedBy) → the filing's answer, plus `decided` when the
+// sole member's filing decided it: { closed, outcome, cast_via, constitution_not_applied? }.
+async function confirmIfSoleMember(out, filedBy) {
+  if (!out || !out.ok || !out.item || filedBy == null || filedBy === '') return out;
+  const item = out.item;
+  const constitution = item.constitution || {};
+  if (constitution.pass_rule !== 'first_ratifier') return out;
+  try {
+    const members = await resolveBoardMembers(constitution);
+    if (members.length !== 1 || String(members[0].builder_id) !== String(filedBy)) return out;
+    const v = await board.castVote({ itemId: item.id, voterId: filedBy, direction: 'yes', castVia: 'filed' });
+    if (!v.ok || !v.fresh) return out;
+    const c = await board.maybeCloseAfterVote(item.id);
+    return {
+      ...out,
+      decided: {
+        closed: !!(c && c.closed),
+        outcome: (c && c.outcome) || null,
+        cast_via: 'filed',
+        ...(c && c.constitution_not_applied ? { constitution_not_applied: c.constitution_not_applied } : {}),
+      },
+    };
+  } catch (err) {
+    log.error('[government] sole-member confirm failed (the filing stands; the sitting is left open):', err);
+    return out;
+  }
+}
+
+// The amendment filers, each followed by the confirm. Same arguments, same answer,
+// plus `decided` when a board of one decided it.
+const wrap = (name) => async (args = {}) => confirmIfSoleMember(await board[name](args), args.proposedBy);
+const proposeAmendment = wrap('proposeAmendment');
+const proposeCharter = wrap('proposeCharter');
+const proposeLaws = wrap('proposeLaws');
+const proposeDecisionRules = wrap('proposeDecisionRules');
+
+module.exports = { proposeAmendment, proposeCharter, proposeLaws, proposeDecisionRules };

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

@@ -35,9 +35,11 @@
 
   // What saving the plan did to the government, when it was not settled in the same
   // click. The server's charter outcome (modules/onboarding/genesis-home.js
-  // applyGovernmentChoice); in_force and none need no sentence.
+  // applyGovernmentChoice). The server's own words come first (task 1005130): an
+  // already-in-force choice is said plainly, never silently; none needs no sentence.
   function charterNote(c) {
     if (!c) return '';
+    if ((c.state === 'in_force' || c.state === 'sitting' || c.state === 'adopted') && c.message) return c.message;
     if (c.state === 'sitting') return 'Your starting government is in the Board Room for a vote.';
     if (c.state === 'needs_council') return 'A Foundation needs a council first. Add a council rank, then choose Foundation on the Charter.';
     if (c.state === 'not_filed') return 'The plan is saved, but the government could not be changed just now. You can change it on the Charter.';
@@ -133,7 +135,9 @@
 
   // The starting government: the real academic names, each with its plain sentence
   // (spec D10), the recommended one picked. Read from the government module's own
-  // constitution view so the names and explanations are never typed twice.
+  // constitution view so the names and explanations are never typed twice. Task
+  // 1005130: what is in force is said first and its form is marked, and each form says
+  // who decides and what closing something takes, in the server's own words.
   function governmentHtml(gov) {
     if (!gov || !gov.forms || !gov.forms.length) return '';
     var rec = gov.recommended && gov.recommended.key;
@@ -142,9 +146,12 @@
     return '<fieldset class="genesis__pick genesis__pick--gov"><legend>Starting government</legend>'
       + '<label class="genesis__expected">Builders you expect in the first year '
       + '<input type="number" min="1" max="100000" value="' + esc(String(gov.headcount || 1)) + '" data-expected></label>'
+      + (gov.in_force && gov.in_force.line ? '<p class="genesis__later">' + esc(gov.in_force.line) + '</p>' : '')
       + avail.map(function (f) {
-        var hint = f.explanation + (f.key === rec && gov.recommended.why ? ' Recommended: ' + gov.recommended.why : '');
-        return radio('gov', f.key, f.name + (f.key === rec ? ' · recommended' : ''), hint, f.key === rec);
+        var duty = f.who_decides ? ' ' + f.who_decides + ' ' + (f.to_close || '') : '';
+        var hint = f.explanation + duty + (f.key === rec && gov.recommended.why ? ' Recommended: ' + gov.recommended.why : '');
+        var tags = (f.current ? ' · in force now' : '') + (f.key === rec ? ' · recommended' : '');
+        return radio('gov', f.key, f.name + tags, hint, f.key === rec);
       }).join('')
       + (later.length ? '<p class="genesis__later">Coming later: ' + later.map(function (f) { return esc(f.name); }).join(', ') + '.</p>' : '')
       + '</fieldset>';
@@ -385,7 +392,7 @@
     var q = expected ? '?headcount=' + encodeURIComponent(expected) : '';
     return send('GET', '/government/constitution' + q).then(function (c) {
       var ch = c && c.charter;
-      return ch ? { forms: ch.forms || [], recommended: c.recommended || null, headcount: expected || c.headcount || 1 } : null;
+      return ch ? { forms: ch.forms || [], in_force: ch.in_force || null, recommended: c.recommended || null, headcount: expected || c.headcount || 1 } : null;
     }).catch(function () { return null; });
   }
 

package/modules/lifecycle/kickoff-checklist.js

@@ -159,7 +159,7 @@ const GENESIS_STEPS = Object.freeze({
   ],
   legalize: [
     { title: 'Decide how contributors are rewarded and who can be paid',
-      description: 'Genesis stage 4 (legalize). Whether builders earn credits, money or nothing, and the limits that apply (age, country, the entity behind the project). When it is done, the Economy wakes.' },
+      description: 'Genesis stage 4 (legalize). Whether builders earn credits, money or nothing, and the limits that apply (age, country, the entity behind the project). Run `npx bongos genesis options` first: it lists every reward option with what the server enforces and the facts about this project beside it (`npx bongos genesis facts` shows and changes those facts). Explain those rules to the founder; never write a rule of your own into a document. If a rule seems missing, say so and leave the line to the founder. When it is done, the Economy wakes.' },
   ],
   legislation: [
     { title: 'Set the voting rules: who votes and how many must agree',

package/modules/lifecycle/routes/pay-type-gates.js

@@ -24,9 +24,14 @@ module.exports = function buildPayTypeGatesRouter() {
   // The `lifecycle.payTypeGates` port (task 1004910): core's module-sale payouts ask it
   // whether module_share is cleared (licence, takedown contact, payee onboarding) before
   // a rule, a sale or a share moves. hasProvider-guarded so a rebuilt router never
-  // registers it twice.
+  // registers it twice. Genesis's legalize stage (task 1005129) reads every gate through
+  // it too, met/missing only, so the founder sees what a pay type needs as they choose.
   if (!api.hasProvider('lifecycle.payTypeGates')) {
-    api.registerProvider('lifecycle.payTypeGates', { refuseUnclearedGates: gates.refuseUnclearedGates });
+    api.registerProvider('lifecycle.payTypeGates', {
+      refuseUnclearedGates: gates.refuseUnclearedGates,
+      readGates: async () => (await gates.readGates()).map(gates.withoutEvidence),
+      labels: require('../pay-terms').PAY_TYPE_LABELS,
+    });
   }
 
   // rank: any-builder for met/missing (the same pay information `GET /pay-terms` shows, no person's

package/modules/onboarding/genesis-home.js

@@ -395,7 +395,10 @@ async function savePlan(body, builderId, deps = {}) {
 // Never refuses the plan — the plan is saved first, and a choice that cannot be filed
 // says why in `state`:
 //   none          no government was picked
-//   in_force      the constitution already reads as that form (Monarchy at birth)
+//   in_force      the constitution already reads as that form (Monarchy at birth):
+//                 nothing is filed, `message` says so and `complete` is true
+//   adopted       filed AND decided in the same call: the founder is the board's only
+//                 member under first_ratifier (task 1005130), so it is in force now
 //   sitting       filed; `item_id`, and `one_vote_decides` when one yes carries it
 //   needs_council Foundation, which needs a council rank before it can seat anyone
 //   not_filed     anything else (`reason`), or no government module to file it with
@@ -411,16 +414,25 @@ async function applyGovernmentChoice(form, builderId, s) {
   }
   if (out && out.ok) {
     const snap = (out.item && out.item.constitution) || {};
+    // task 1005130: the founder is the board's only member, so choosing it WAS their
+    // one yes — it is in force now, and saying "in the Board Room" would be untrue.
+    if (out.decided && out.decided.closed && out.decided.outcome === 'passed') {
+      const name = out.reads_as ? out.reads_as.name : form;
+      return { state: 'adopted', form, item_id: out.item ? String(out.item.id) : null, complete: true,
+        message: `${name} is in force now. As the board's only member, choosing it was your one yes.` };
+    }
     return {
       state: 'sitting',
       form,
       item_id: out.item ? String(out.item.id) : null,
       one_vote_decides: snap.pass_rule === 'first_ratifier',
       reads_as: out.reads_as ? out.reads_as.name : null,
+      message: out.what_happens_next || null, // task 1005130: what happens next, in words
     };
   }
   const reason = (out && out.reason) || 'charter_failed';
-  if (reason === 'no_change') return { state: 'in_force', form };
+  // task 1005130: already in force is said plainly and counts as done, never silent.
+  if (reason === 'no_change') return { state: 'in_force', form, complete: true, message: out.message || null };
   if (reason === 'council_needs_a_rank') return { state: 'needs_council', form };
   return { state: 'not_filed', form, reason };
 }