@bongos/core 1.19.234 → 1.19.236

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.234",
-  "core_contract": "1.19.234",
-  "source_commit": "e80285bcecac511d018c7d39b58a2ca05e6fc5a2",
+  "core_version": "1.19.236",
+  "core_contract": "1.19.236",
+  "source_commit": "0a9c519e8b99e0d694e966d655d9b8a2a8f0eb3b",
   "source_ref": "HEAD",
-  "built_at": "2026-08-18T16:39:12.790Z",
+  "built_at": "2026-08-18T16:55:12.932Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 311,
     "agent_docs_stubbed": 21,
-    "functional_verbatim": 1318,
+    "functional_verbatim": 1320,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1650,
-  "tree_sha256": "c706960c4712d454c74aca743c2612907744dcf50f641f8c9ee685e23db42f37",
+  "file_count": 1652,
+  "tree_sha256": "7fe9b6616b232257cbe77dced905478c770425991cbc992686b266c61f984739",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -2902,7 +2902,7 @@
     {
       "path": "modules/government/board.js",
       "mode": "0000644",
-      "sha256": "34a041cb7d001b71109b8243cfd2d34dd4185da4656d6eb31ed8af113490fd6b"
+      "sha256": "d9f0a9fa68180b7aad47e68edcf0859598d03bf2688bbd64ab286b7facd4d8af"
     },
     {
       "path": "modules/government/catalog.js",
@@ -2917,7 +2917,7 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "11f06bb6eb105a7f52a5a6aeb94356a3cb975f82b1e4ed381bacef82463feba2"
+      "sha256": "d50b12547863df08cf32c606fe91187e1239f5b0d339f9d34ed9f3b5403b3d15"
     },
     {
       "path": "modules/government/migrations/governance_001_tables.sql",
@@ -3272,12 +3272,12 @@
     {
       "path": "modules/hall-ui/public/government.html",
       "mode": "0000644",
-      "sha256": "a76e7263c87178427061ff6b02588e524ca885b3964e54f693e4fc88c9ef5c26"
+      "sha256": "b21f881ddb943b46a82a2e613485f451b84dd763f73d3d4cedf7afcf66982d30"
     },
     {
       "path": "modules/hall-ui/public/government.js",
       "mode": "0000644",
-      "sha256": "7d6ce981e085a0a5d3fed711088720c412a82b54c4c2b9f436f1e112b453c2d3"
+      "sha256": "246a14606c8d7b2d58d4ecb7afb9ed0f8a9d543f8c40d85e321a169ef9750fcd"
     },
     {
       "path": "modules/hall-ui/public/hall-kit.js",
@@ -4322,12 +4322,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "f08d3eab8dc3b1ef943b3ef19523e21c7676ba91e57f1791ce984b7847c27078"
+      "sha256": "f5abc3db63111a1a16cbe3d1dab016100dd4fd2327c515bfca2aeecad46d4fe9"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "fe66476a7d77fe1f6ddaf04090e1af767696443fab948f0fc64713ed48c64b5d"
+      "sha256": "868413f24489f75a2b26faab9a4a60fb25f5348c514aa73895a074da1f15f0e4"
     },
     {
       "path": "public-docs/index.html",
@@ -5942,7 +5942,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "509de05d397e1c27f123e67e666147efa117ce28e98ef00f1386687ca15a4097"
+      "sha256": "052bbf66213891c419bee8571c5140474a9544fb3a21b8cc0aa12dacaf05a2b9"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -6887,13 +6887,18 @@
     {
       "path": "tests/government_board_view.mjs",
       "mode": "0000644",
-      "sha256": "104dbfd5510f4abf4580cf89f57e4be15667b4b6e6f171a2635786bfd4d65f9e"
+      "sha256": "827d743080201f11b2282aaa77d37149aaddaddc42b2b444c260a2696a7727ca"
     },
     {
       "path": "tests/government_board_vote.mjs",
       "mode": "0000644",
       "sha256": "c1b9b0963dde0c033bd0eb411b63032a51edaa3d91751100593b7e3b4999c017"
     },
+    {
+      "path": "tests/government_board_vote_ui.mjs",
+      "mode": "0000644",
+      "sha256": "a9e46b10cf9b6c17550f22463d13caa0d4b63d87d4fc63d087dd14e4b95b8312"
+    },
     {
       "path": "tests/government_board_window.mjs",
       "mode": "0000644",
@@ -6904,6 +6909,11 @@
       "mode": "0000644",
       "sha256": "74cfbd482b689df40348af3bdaf050f056e216ff18fdd6add4136d4589b7cd92"
     },
+    {
+      "path": "tests/government_charter_library.mjs",
+      "mode": "0000644",
+      "sha256": "9a52ac8fbbc9e7b0fc4b45841b9dbf831615e5d64eb1e3f0d9c446fc70552629"
+    },
     {
       "path": "tests/government_claim_eligibility.mjs",
       "mode": "0000644",
@@ -6917,7 +6927,7 @@
     {
       "path": "tests/government_constitution_view.mjs",
       "mode": "0000644",
-      "sha256": "daf26af68fcaa19a6de3793e0c9ab81b2981d8ed5e4d5ec5f860c686ac7610fb"
+      "sha256": "64fc8006d5b3a562b01a38bfd0ad00a1357969b0ac52ce270e77d4d93eddca80"
     },
     {
       "path": "tests/government_fold.mjs",

package/modules/government/board.js

@@ -499,7 +499,17 @@ async function boardRoomView({ closedLimit = 20 } = {}) {
   }
   const project = (item) => {
     const subject = item.subject_type === 'full_idea'
-      ? (() => { const r = ideaById.get(String(item.subject_id)); return r ? { title: r.title, author_id: String(r.captured_by) } : null; })()
+      ? (() => {
+          const r = ideaById.get(String(item.subject_id));
+          return r ? {
+            title: r.title,
+            author_id: String(r.captured_by),
+            // R17: the voter decides with the idea in front of them.
+            field_values: r.field_values || null,
+            template_key: r.template_key || null,
+            completeness_score: r.completeness_score ?? null,
+          } : null;
+        })()
       : (() => { const r = amendmentById.get(String(item.subject_id)); return r ? { proposed: r.proposed, rationale_md: r.rationale_md, author_id: r.proposed_by == null ? null : String(r.proposed_by) } : null; })();
     return {
       id: String(item.id),
@@ -530,9 +540,30 @@ async function boardRoomView({ closedLimit = 20 } = {}) {
 // row carries the rule it was DECIDED UNDER (the item's snapshot), so the
 // reader can verify every change was made legally by the constitution of its
 // day — the §7 chain, auditable end to end.
+// ── the charter ladder's recommendation (BV1.R19, criterion C5) ─────────────
+//
+// The developmental ladder from the Six Variables synthesis (Part III), as the
+// spec's task text records it: formality is adopted only where informal
+// coordination breaks. PURE and server-side so R26's proof can hold the
+// recommendation against the real headcount — the library's one live datum.
+// The bands deliberately track only the thresholds the synthesis NAMES
+// (~9 name an executive, ~50 written charter + council, ~150 adjudication
+// separates / federate beyond); everything else is reference prose, not code.
+function recommendedCharter(headcount) {
+  const n = Number(headcount) || 0;
+  if (n <= 2) return { key: 'monarchy', rung: 'solo/pair', why: 'informal coordination has nothing to break yet — the founding monarchy is the honest shape' };
+  if (n <= 8) return { key: 'direct-democracy', rung: 'circle (3–8)', why: 'a consent circle of all trusted members — the rung this ladder was written on' };
+  if (n <= 49) return { key: 'presidential', rung: '~9: name an executive', why: 'past ~9, naming an executive beats everyone coordinating with everyone' };
+  if (n <= 149) return { key: 'foundation', rung: '~50: written charter + council', why: 'past ~50, the charter must be written down and a council carries it' };
+  return { key: 'federation', rung: '~150: adjudication separates — federate beyond', why: 'past ~150, one body cannot both govern and adjudicate; federate' };
+}
+
 async function constitutionView({ historyLimit = 50 } = {}) {
   const { board: live } = loadGovernmentConfig();
-  const rows = await db.listAmendmentHistory(historyLimit);
+  const [rows, headcount] = await Promise.all([
+    db.listAmendmentHistory(historyLimit),
+    db.countActiveBuilders(),
+  ]);
   const history = rows.map((r) => ({
     item_id: String(r.item_id),
     amendment_id: String(r.amendment_id),
@@ -546,7 +577,7 @@ async function constitutionView({ historyLimit = 50 } = {}) {
     outcome: r.outcome,
     decided_under: r.decided_under || null,
   }));
-  return { board: live, history };
+  return { board: live, history, headcount, recommended: recommendedCharter(headcount) };
 }
 
 // ── R13's read: the feedback a returned idea carries back to its author ─────
@@ -591,4 +622,5 @@ module.exports = {
   proposeAmendment,
   boardRoomView,
   constitutionView,
+  recommendedCharter,
 };

package/modules/government/db.js

@@ -493,8 +493,15 @@ async function getVotesForItems(itemIds) {
 // an amendment its proposed block + rationale.
 async function getIdeaSubjects(ideaIds) {
   if (!ideaIds || !ideaIds.length) return [];
+  // The five sections ride along (R17): the full idea must be IN FRONT of the
+  // voter while they decide — that context is the entire reason voting happens
+  // in the hall rather than on a reaction. LEFT JOIN: an idea whose grade row
+  // is somehow gone still shows its title.
   const { rows } = await pool.query(
-    `SELECT id, title, captured_by FROM idea_inbox WHERE id = ANY($1::bigint[])`,
+    `SELECT i.id, i.title, i.captured_by, g.field_values, g.template_key, g.completeness_score
+       FROM idea_inbox i
+       LEFT JOIN ideas_grades g ON g.idea_id = i.id
+      WHERE i.id = ANY($1::bigint[])`,
     [ideaIds],
   );
   return rows;
@@ -509,6 +516,17 @@ async function getAmendmentSubjects(amendmentIds) {
   return rows;
 }
 
+// The live headcount (R19): active humans, the same two filters as board
+// membership — a machine principal is not a team member, and neither is a
+// departed builder. Feeds the charter library's "recommended at YOUR headcount"
+// line, which R26's proof holds against this exact number.
+async function countActiveBuilders() {
+  const { rows } = await pool.query(
+    `SELECT count(*)::int AS n FROM builders WHERE status = 'active' AND system_role IS NULL`,
+  );
+  return rows[0] ? rows[0].n : 0;
+}
+
 // The constitution's change HISTORY (R18): every CLOSED amendment sitting —
 // passed AND returned — joined to what was proposed, newest first. Returned
 // proposals are deliberately part of the record: "a switch can never be flipped
@@ -653,4 +671,5 @@ module.exports = {
   getIdeaSubjects,
   getAmendmentSubjects,
   listAmendmentHistory,
+  countActiveBuilders,
 };

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

@@ -99,6 +99,6 @@
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>
-<script src="/builders/government.js?v=2026-08-18-constitution"></script>
+<script src="/builders/government.js?v=2026-08-18-vote-form"></script>
 </body>
 </html>

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

@@ -80,6 +80,17 @@
     unknown_permission: 'The permission catalog does not define that key.',
     bad_rank_key: 'Rank keys are kebab-case: lowercase letters, digits, dashes.',
     validation_failed: 'Missing or invalid fields.',
+    // the vote refusals (R17 over R08's route)
+    not_board_member: 'Only members of this item\u2019s board may vote on it \u2014 membership follows the rules that were in force when the window opened.',
+    anti_self_vote: 'You can\u2019t vote on your own idea \u2014 that\u2019s the line that keeps ratification honest.',
+    item_closed: 'This sitting has closed \u2014 refreshing.',
+    vote_window_expired: 'This sitting\u2019s clock has run out \u2014 the sweep is closing it.',
+    objection_needs_reason: 'An objection must say why \u2014 write the reason.',
+    objection_needs_section: 'An objection must point at exactly one section of the idea.',
+    yes_carries_nothing: 'A yes carries no reason or section \u2014 those belong to objections.',
+    bad_direction: 'A vote is yes or no \u2014 nothing else.',
+    item_not_found: 'That item no longer exists \u2014 refreshing.',
+    bad_item_id: 'That item id isn\u2019t valid.',
   };
   const friendlyError = (code) => ERROR_COPY[code] || null;
 
@@ -470,6 +481,64 @@
     </div>`;
   }
 
+  // ---- the charter library (R19) ---------------------------------------------
+
+  // The REFERENCE half of the Charter Builder — the seven structures, the three
+  // trajectories, the ladder — and deliberately not the configuration machinery
+  // (the scale argument in ADR 0175: formality is adopted only where informal
+  // coordination breaks). `selectable` means EXPRESSIBLE TODAY through the real
+  // config — a rank-predicate membership plus first_ratifier|consent — so nobody
+  // is misled about what a settings change can and cannot reach. Source: the
+  // Six-Variables synthesis (Verro Labs, Aug 2026), Parts III–IV, via the spec.
+  const CHARTERS = [
+    { key: 'monarchy', name: 'Monarchy / BDFL', selectable: true,
+      how: "membership rank:archon · first ratifier · no clock — the shipped default",
+      blurb: 'One trusted executive decides. Fast, legible, and honest at founding scale; the shape every project actually starts in.' },
+    { key: 'timocratic-republic', name: 'Timocratic Republic', selectable: true,
+      how: 'membership by a trusted rank (e.g. rank:metic) · consent · a timed sitting',
+      blurb: 'Standing accrues to those actively building: the franchise follows earned rank, not headcount.' },
+    { key: 'direct-democracy', name: 'Direct Democracy', selectable: true,
+      how: 'membership rank:xenos (everyone) · consent · a timed sitting',
+      blurb: 'Every builder sits on the board. Consent keeps it unblockable: silence passes, one reasoned objection returns.' },
+    { key: 'presidential', name: 'Presidential', selectable: false,
+      blurb: 'An ELECTED executive with a fixed term. Needs election machinery this system does not have yet — documented for later.' },
+    { key: 'cooperative', name: 'Cooperative', selectable: false,
+      blurb: 'Formal one-member-one-vote with membership shares and exit rules. Needs the membership-share machinery — documented for later.' },
+    { key: 'federation', name: 'Federation', selectable: false,
+      blurb: 'Multiple chambers or sub-projects, each self-governing, coordinating through a compact. The >150 shape — documented for later.' },
+    { key: 'foundation', name: 'Foundation', selectable: true,
+      how: 'a CUSTOM rank as the trustee body (the Ranks tab creates it) · consent · a timed sitting',
+      blurb: 'A written charter carried by a small appointed council. Expressible today by governing through a custom rank.' },
+  ];
+  const TRAJECTORIES = [
+    { name: 'Locked', blurb: 'The constitution stays as founded until deliberately amended — no automatic movement.' },
+    { name: 'Laddered', blurb: 'Steps up the developmental ladder as the team crosses each headcount threshold.' },
+    { name: 'Scheduled', blurb: 'Pre-commits the dates or milestones at which each step happens, decided in advance.' },
+  ];
+  const LADDER = 'solo/pair → circle (3–8) → ~9 name an executive → ~25 → ~50 written charter + council → ~150 adjudication separates → beyond: federate';
+
+  function charterCard(c, recommendedKey) {
+    const pill = c.selectable
+      ? '<span class="gov-pill gov-pill--seeded">selectable today</span>'
+      : '<span class="gov-pill gov-pill--locked">documented for later</span>';
+    const rec = c.key === recommendedKey ? ' <span class="gov-pill gov-pill--custom">recommended at your headcount</span>' : '';
+    const how = c.how ? `<div class="gov-perm__guards">as configuration: ${escapeHtml(c.how)}</div>` : '';
+    return `<div class="gov-assign-row"><span class="gov-assign-row__who"><strong>${escapeHtml(c.name)}</strong> — ${escapeHtml(c.blurb)}${how}</span>${pill}${rec}</div>`;
+  }
+
+  function charterLibraryHtml(data) {
+    const rec = data.recommended || {};
+    return `
+      <h2 class="gov-h">Charter library</h2>
+      <p class="gov-grid-note">The seven government structures, for getting a team up to speed before deciding when to flip a switch. <strong>Selectable today</strong> means expressible through the real configuration — a rank-based membership plus a pass rule — with no new code. This project has <strong>${escapeHtml(String(data.headcount ?? '?'))}</strong> active builder${data.headcount === 1 ? '' : 's'}: ${escapeHtml(rec.why || '')} <em>(${escapeHtml(rec.rung || '')})</em>.</p>
+      <div class="gov-section">${CHARTERS.map((c) => charterCard(c, rec.key)).join('')}</div>
+      <h2 class="gov-h">Trajectories</h2>
+      <p class="gov-grid-note">How a project moves between structures over time — summarized from the synthesis:</p>
+      <div class="gov-section">${TRAJECTORIES.map((t) => `<div class="gov-assign-row"><span class="gov-assign-row__who"><strong>${escapeHtml(t.name)}</strong> — ${escapeHtml(t.blurb)}</span></div>`).join('')}</div>
+      <p class="gov-grid-note muted">The developmental ladder: ${escapeHtml(LADDER)}. Formality is adopted only where informal coordination breaks.</p>
+    `;
+  }
+
   async function loadConstitution() {
     const box = document.getElementById('gov-constitution');
     let data;
@@ -494,6 +563,7 @@
       ${history.length
         ? `<div class="gov-section">${history.map(historyRow).join('')}</div>`
         : `<p class="gov-empty">Never amended — this project still runs its founding constitution.</p>`}
+      ${charterLibraryHtml(data)}
     `;
   }
 
@@ -551,6 +621,76 @@
     return `<div class="gov-section">${rows}</div>`;
   }
 
+  // ---- the vote form (R17) -----------------------------------------------------
+
+  // The five section labels, mirrored from the base template declaration
+  // (modules/ideas/templates.js — the words the author saw when writing; a test
+  // holds the two equal, since browser code cannot import a server module).
+  const SECTION_LABELS = {
+    purpose: 'Purpose of Idea',
+    big_picture: 'What does the Big Picture look like',
+    why_had: 'Why did you have the Idea',
+    why_matters: 'Why does the Idea Matter',
+    fit: 'How does the Idea Fit into the big picture of the project',
+  };
+
+  // The idea's five sections, IN FRONT of the voter — the entire reason voting
+  // happens in the hall rather than on a reaction. Rendered in template order.
+  function ideaSectionsHtml(item) {
+    const fv = item.subject && item.subject.field_values;
+    if (!fv) return '';
+    const rows = Object.keys(SECTION_LABELS).map((key) => `
+      <div class="gov-perm">
+        <div class="gov-perm__main">
+          <code class="gov-perm__key">${escapeHtml(SECTION_LABELS[key])}</code>
+          <div class="gov-perm__guards">${escapeHtml(String(fv[key] ?? ''))}</div>
+        </div>
+      </div>`).join('');
+    const score = item.subject.completeness_score;
+    return `<details class="gov-section"><summary class="gov-section__head">The idea, in full${score != null ? ` \u00b7 completeness ${escapeHtml(String(score))}/100` : ''}</summary>${rows}</details>`;
+  }
+
+  function voteFormHtml(item, viewerId) {
+    if (item.closed_at) return '';
+    const mine = item.votes.find((v) => String(v.voter_id) === String(viewerId));
+    if (mine) return '';
+    if (item.subject_type === 'full_idea' && item.subject && String(item.subject.author_id) === String(viewerId)) {
+      return `<p class="gov-grid-note">This is your idea \u2014 its author does not vote on it. The board decides; a return comes back to you with its reason.</p>`;
+    }
+    const sections = Object.keys(SECTION_LABELS).map((key) => `
+      <label class="gov-perm" style="cursor:pointer"><input type="radio" name="vote-section-${escapeHtml(item.id)}" value="${escapeHtml(key)}"> <span>${escapeHtml(SECTION_LABELS[key])}</span></label>`).join('');
+    return `<div class="gov-vote" data-item="${escapeHtml(item.id)}">
+      <button type="button" class="gov-btn" data-vote="yes">Vote yes</button>
+      <details class="gov-vote__no">
+        <summary class="gov-btn gov-btn--ghost">Object\u2026</summary>
+        <p class="gov-grid-note">An objection returns the idea to its author with your reason and the section it faults \u2014 the feedback they revise against.</p>
+        <textarea class="gov-input" data-vote-reason placeholder="Why \u2014 the reason the author will act on" maxlength="5000" rows="3"></textarea>
+        <div class="gov-vote__sections">${sections}</div>
+        <button type="button" class="gov-btn" data-vote="no">Cast objection</button>
+      </details>
+    </div>`;
+  }
+
+  async function castVoteFromRoom(itemId, direction, container) {
+    const body = { direction };
+    if (direction === 'no') {
+      const reason = (container.querySelector('[data-vote-reason]') || {}).value || '';
+      const picked = container.querySelector(`input[name="vote-section-${itemId}"]:checked`);
+      body.reason_md = reason;
+      if (picked) body.section_key = picked.value;
+    }
+    try {
+      const out = await sendJson('POST', `/government/board/items/${encodeURIComponent(itemId)}/votes`, body);
+      toast(out.item_closed
+        ? `Vote cast \u2014 the sitting closed: ${out.outcome}.`
+        : 'Vote cast.');
+    } catch (err) {
+      if (err && err.kind === '401') return;
+      toast(`Could not vote: ${err.message || err}`);
+    }
+    loadBoard(); // re-render either way — the room shows what stands
+  }
+
   function itemCard(item, viewerId) {
     const yes = item.votes.filter((v) => v.direction === 'yes').length;
     const no = item.votes.filter((v) => v.direction === 'no').length;
@@ -569,7 +709,9 @@
       ${amendmentDetail}
       <p class="gov-grid-note">tally: ${yes} yes · ${no} no — sitting under <code>${escapeHtml((item.constitution && item.constitution.pass_rule) || '?')}</code>, membership <code>${escapeHtml((item.constitution && item.constitution.membership) || '?')}</code></p>
       ${myLine}
+      ${item.closed_at ? '' : ideaSectionsHtml(item)}
       ${ballotHtml(item, viewerId)}
+      ${voteFormHtml(item, viewerId)}
     </section>`;
   }
 
@@ -590,6 +732,16 @@
       (open || window.OTBKit.emptyStateHtml('Nothing is before the board. When a Full Idea clears the completeness grade, its window opens here.'))
       + `<h2 class="gov-h">Closed sittings</h2>`
       + (closed || `<p class="gov-empty">No sitting has closed yet.</p>`);
+    // R17: the cast buttons. One delegated listener; the SERVER refuses every
+    // illegitimate cast regardless (membership, anti-self, closed, expired) —
+    // the form is a courtesy, the route is the wall.
+    box.querySelectorAll('.gov-vote [data-vote]').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        const wrap = btn.closest('.gov-vote');
+        btn.disabled = true;
+        castVoteFromRoom(wrap.dataset.item, btn.dataset.vote, wrap);
+      });
+    });
   }
 
   // ---- init ----------------------------------------------------------------

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.234",
+  "version": "1.19.236",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.234",
+      "version": "1.19.236",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.234",
+  "version": "1.19.236",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/src/module-api.js

@@ -895,8 +895,12 @@ const { validateOrRespond, LIMITS, parseId, asyncHandler, corsPublicGet, parsePa
 //         landed since 1.19.232 with no explicit bump. run 32160823445. (task 1002620)
 //   1.19.234 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
 //         landed since 1.19.233 with no explicit bump. run 32161368847. (task 1002620)
+//   1.19.235 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+//         landed since 1.19.234 with no explicit bump. run 32161981393. (task 1002620)
+//   1.19.236 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+//         landed since 1.19.235 with no explicit bump. run 32162811851. (task 1002620)
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.234'; // CI auto-patch carrier (ADR 0161); see changelog above
+const CORE_VERSION = '1.19.236'; // CI auto-patch carrier (ADR 0161); see changelog above
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('dev-box'); log.info('mounted');

package/tests/government_board_view.mjs

@@ -56,7 +56,7 @@ test('the assembled view: enrichment, the open ballot, the snapshot, the databas
     },
     getIdeaSubjects: async (ids) => {
       assert.deepEqual(ids.map(String).sort(), ['6', '7']);
-      return [{ id: 7n, title: 'A big idea', captured_by: 9n }]; // idea 6 is GONE — deleted subject
+      return [{ id: 7n, title: 'A big idea', captured_by: 9n, field_values: { purpose: 'p' }, template_key: 'base-v1', completeness_score: 82 }]; // idea 6 is GONE — deleted subject
     },
     getAmendmentSubjects: async (ids) => {
       assert.deepEqual(ids.map(String), ['5']);
@@ -68,7 +68,9 @@ test('the assembled view: enrichment, the open ballot, the snapshot, the databas
   assert.equal(view.closed.length, 1);
 
   const idea = view.open[0];
-  assert.deepEqual(idea.subject, { title: 'A big idea', author_id: '9' }, 'an idea shows its title + author (R17 greys anti-self from this)');
+  assert.deepEqual(idea.subject,
+    { title: 'A big idea', author_id: '9', field_values: { purpose: 'p' }, template_key: 'base-v1', completeness_score: 82 },
+    'an idea shows its title, author, AND its five sections — the voter decides with the idea in front of them (R17)');
   assert.equal(idea.remaining_seconds, 540, 'the DATABASE clock, passed through — the client never does clock math');
   assert.deepEqual(idea.constitution, MONARCHY, 'the SNAPSHOT rides along — the room describes the rule the item runs under');
   assert.equal(idea.votes.length, 1);

package/tests/government_board_vote_ui.mjs

@@ -0,0 +1,70 @@
+// tests/government_board_vote_ui.mjs — the vote UI (BV1.R17 of goal 1000069,
+// criteria C2/C5): cast, reason box, five-section picker — with the full idea
+// in front of the voter, which is the entire reason voting happens in the hall
+// rather than on a Discord reaction.
+//
+// Browser code cannot be imported into node tests wholesale (it is an IIFE over
+// the DOM), so these are SOURCE PINS over the exact seams that must not drift —
+// the same technique the palette and hall audits use — plus one real cross-
+// module equality: the section labels against the template declaration.
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const CLIENT = fs.readFileSync(path.join(ROOT, 'modules', 'hall-ui', 'public', 'government.js'), 'utf8');
+const { BASE_TEMPLATE } = require(path.join(ROOT, 'modules', 'ideas', 'templates.js'));
+const board = require(path.join(ROOT, 'modules', 'government', 'board.js'));
+
+test('the five section labels ARE the template declaration — key and label, in order', () => {
+  const block = CLIENT.slice(CLIENT.indexOf('const SECTION_LABELS'), CLIENT.indexOf('function ideaSectionsHtml'));
+  const declared = [...block.matchAll(/(\w+): '([^']+)'/g)].map((m) => [m[1], m[2]]);
+  const template = BASE_TEMPLATE.fields.map((f) => [f.key, f.label]);
+  assert.deepEqual(declared, template,
+    'the voter reads the same five section names the author wrote under — held equal here because browser code cannot import the server module');
+});
+
+test('the idea is in front of the voter: sections render from the subject, in template order', () => {
+  assert.match(CLIENT, /item\.subject\.field_values|subject && item\.subject\.field_values/,
+    'the sections come from the board view payload, never a second fetch');
+  assert.match(CLIENT, /Object\.keys\(SECTION_LABELS\)\.map/,
+    'rendered in the declared order — jsonb key order is never trusted');
+  const card = CLIENT.slice(CLIENT.indexOf('function itemCard'), CLIENT.indexOf('async function loadBoard'));
+  assert.match(card, /ideaSectionsHtml\(item\)/, 'the sections sit ON the item card, above the ballot');
+});
+
+test('an objection needs the reason AND exactly one section; a yes sends neither', () => {
+  const cast = CLIENT.slice(CLIENT.indexOf('async function castVoteFromRoom'), CLIENT.indexOf('function itemCard'));
+  assert.match(cast, /if \(direction === 'no'\)/, 'reason + section are attached only to an objection');
+  assert.match(cast, /body\.reason_md = reason/, 'the reason box feeds reason_md');
+  assert.match(cast, /body\.section_key = picked\.value/, 'the picker feeds exactly one section_key');
+  assert.match(cast, /\/government\/board\/items\/.*\/votes/, 'casts into R08\'s route — the server is the wall');
+  assert.match(cast, /loadBoard\(\)/, 'the room re-renders either way — it shows what stands');
+  assert.match(cast, /item_closed/, 'a cast that CLOSED the sitting says so (first_ratifier / full turnout)');
+});
+
+test('the author of a full_idea sees the anti-self note instead of a form — amendments do not', () => {
+  const form = CLIENT.slice(CLIENT.indexOf('function voteFormHtml'), CLIENT.indexOf('async function castVoteFromRoom'));
+  assert.match(form, /subject_type === 'full_idea'[^]*author_id.*viewerId/,
+    'the grey-out is SUBJECT-TYPED, mirroring castVote\'s carve-out — an amendment proposer may vote (§7)');
+  assert.match(form, /does not vote on it/, 'the note says why, not just no');
+  assert.match(form, /if \(mine\) return ''/, 'one vote per member — a cast voter gets no second form');
+  assert.match(form, /if \(item\.closed_at\) return ''/, 'closed sittings take no votes');
+});
+
+test('every refusal castVote can return has friendly copy', () => {
+  // The route maps board.js's typed refusals to res.fail codes; the client's
+  // ERROR_COPY must name each one so a refused vote explains itself.
+  const source = fs.readFileSync(path.join(ROOT, 'modules', 'government', 'board.js'), 'utf8');
+  const castBlock = source.slice(source.indexOf('function validateVote'), source.indexOf('// ── close + tally'));
+  const reasons = [...new Set([...castBlock.matchAll(/reason: '([a-z_]+)'/g)].map((m) => m[1]))];
+  assert.ok(reasons.length >= 6, `sanity: found castVote's refusal set (${reasons})`);
+  const copyBlock = CLIENT.slice(CLIENT.indexOf('const ERROR_COPY'), CLIENT.indexOf('const friendlyError'));
+  for (const r of reasons) {
+    assert.ok(copyBlock.includes(`${r}:`), `ERROR_COPY must explain '${r}'`);
+  }
+});

package/tests/government_charter_library.mjs

@@ -0,0 +1,77 @@
+// tests/government_charter_library.mjs — the charter library (BV1.R19 of goal
+// 1000069, criterion C5): seven constitutions, three trajectories, the ladder —
+// and ONE live datum, the recommendation at this project's actual headcount.
+//
+// The recommendation is SERVER-SIDE and pure precisely so R26's proof can hold
+// it against the real number; the library prose is client reference content.
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const GOV = path.join(ROOT, 'modules', 'government');
+const board = require(path.join(GOV, 'board.js'));
+const db = require(path.join(GOV, 'db.js'));
+
+const { recommendedCharter } = board;
+
+test('the ladder bands track exactly the thresholds the synthesis names', () => {
+  assert.equal(recommendedCharter(1).key, 'monarchy');
+  assert.equal(recommendedCharter(2).key, 'monarchy', 'this project today: two builders → the founding monarchy');
+  assert.equal(recommendedCharter(3).key, 'direct-democracy', 'the circle rung starts at 3');
+  assert.equal(recommendedCharter(8).key, 'direct-democracy');
+  assert.equal(recommendedCharter(9).key, 'presidential', '~9: name an executive');
+  assert.equal(recommendedCharter(49).key, 'presidential');
+  assert.equal(recommendedCharter(50).key, 'foundation', '~50: written charter + council');
+  assert.equal(recommendedCharter(149).key, 'foundation');
+  assert.equal(recommendedCharter(150).key, 'federation', '~150: adjudication separates — federate');
+  assert.equal(recommendedCharter(0).key, 'monarchy', 'a zero/unknown headcount fails to the founding shape');
+  assert.equal(recommendedCharter('nonsense').key, 'monarchy');
+});
+
+test('constitutionView carries the live headcount and its recommendation', async () => {
+  const originals = { listAmendmentHistory: db.listAmendmentHistory, countActiveBuilders: db.countActiveBuilders };
+  db.listAmendmentHistory = async () => [];
+  db.countActiveBuilders = async () => 7;
+  try {
+    const view = await board.constitutionView();
+    assert.equal(view.headcount, 7);
+    assert.equal(view.recommended.key, 'direct-democracy');
+    assert.ok(view.recommended.rung.includes('circle'));
+  } finally { Object.assign(db, originals); }
+});
+
+test('the headcount counts the same population membership does (SQL pin)', () => {
+  const src = fs.readFileSync(path.join(GOV, 'db.js'), 'utf8');
+  const block = src.slice(src.indexOf('async function countActiveBuilders'), src.indexOf("// The constitution's change HISTORY"));
+  assert.match(block, /status = 'active'/);
+  assert.match(block, /system_role IS NULL/, 'a machine principal is not a team member');
+});
+
+test('the library presents all seven structures with honest selectable marks (client source pins)', () => {
+  const client = fs.readFileSync(path.join(ROOT, 'modules', 'hall-ui', 'public', 'government.js'), 'utf8');
+  const lib = client.slice(client.indexOf('const CHARTERS'), client.indexOf('function charterCard'));
+  for (const name of ['Monarchy / BDFL', 'Timocratic Republic', 'Direct Democracy', 'Presidential', 'Cooperative', 'Federation', 'Foundation']) {
+    assert.ok(lib.includes(`name: '${name}'`), `the library must present ${name}`);
+  }
+  // Selectable ⇔ expressible through the REAL config (a rank predicate + a
+  // shipped pass rule). Every selectable entry must SAY HOW; every
+  // documented-for-later entry must not pretend.
+  const selectableTrue = (lib.match(/selectable: true/g) || []).length;
+  const selectableFalse = (lib.match(/selectable: false/g) || []).length;
+  assert.equal(selectableTrue + selectableFalse, 7, 'every structure is marked, none left ambiguous');
+  assert.equal(selectableTrue, 4, 'monarchy, timocratic republic, direct democracy, foundation — the config-expressible four');
+  const trueBlocks = lib.split('selectable: true').slice(1);
+  for (const b of trueBlocks) {
+    assert.ok(b.slice(0, 200).includes('how:'), 'a selectable structure names its configuration');
+  }
+  assert.match(client, /recommended at your headcount/, 'the one live datum is rendered');
+  assert.match(client, /c\.key === recommendedKey/, "the pill is driven by the SERVER's recommendation, never re-derived client-side");
+  for (const t of ['Locked', 'Laddered', 'Scheduled']) {
+    assert.ok(client.includes(`name: '${t}'`), `trajectory ${t} present`);
+  }
+});

package/tests/government_constitution_view.mjs

@@ -33,7 +33,7 @@ async function withDb(stubs, fn) {
 }
 
 test('the live board block is RESOLVED per request — this vanilla checkout reads monarchy', async () => {
-  const view = await withDb({ listAmendmentHistory: async () => [] }, () => board.constitutionView());
+  const view = await withDb({ listAmendmentHistory: async () => [], countActiveBuilders: async () => 2 }, () => board.constitutionView());
   assert.deepEqual(view.board, BOARD_DEFAULTS,
     'no instance pack here, so the resolved value IS the neutral monarchy — never a hardcoded copy');
   assert.deepEqual(view.history, []);
@@ -42,6 +42,7 @@ test('the live board block is RESOLVED per request — this vanilla checkout rea
 test('the history projects passed AND returned, with proposer identity and the decided-under snapshot', async () => {
   const MONARCHY = { membership: 'rank:archon', pass_rule: 'first_ratifier', window_minutes: null, close_early_on_full_turnout: true };
   const view = await withDb({
+    countActiveBuilders: async () => 2,
     listAmendmentHistory: async (limit) => {
       assert.equal(limit, 50);
       return [