@bongos/core 1.19.234 → 1.19.235

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.235",
+  "core_contract": "1.19.235",
+  "source_commit": "b91cbff1532b00e3cdd2204e713b35cf093c9b02",
   "source_ref": "HEAD",
-  "built_at": "2026-08-18T16:39:12.790Z",
+  "built_at": "2026-08-18T16:46:17.722Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 311,
     "agent_docs_stubbed": 21,
-    "functional_verbatim": 1318,
+    "functional_verbatim": 1319,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1650,
-  "tree_sha256": "c706960c4712d454c74aca743c2612907744dcf50f641f8c9ee685e23db42f37",
+  "file_count": 1651,
+  "tree_sha256": "d20a6edcee7ad8a7e81eefec0b07689a820b194634cdb5350c8c4263127990ea",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -2902,7 +2902,7 @@
     {
       "path": "modules/government/board.js",
       "mode": "0000644",
-      "sha256": "34a041cb7d001b71109b8243cfd2d34dd4185da4656d6eb31ed8af113490fd6b"
+      "sha256": "9d3d9414ca1c1bafc901a7343cdccafc7261b0dba492134a9a1064e6b3d82b61"
     },
     {
       "path": "modules/government/catalog.js",
@@ -2917,7 +2917,7 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "11f06bb6eb105a7f52a5a6aeb94356a3cb975f82b1e4ed381bacef82463feba2"
+      "sha256": "ab75e3e0fd2b7eee747e525403f8a2ea863dbf1f4332cb3c6ec1b413ed7af7e3"
     },
     {
       "path": "modules/government/migrations/governance_001_tables.sql",
@@ -3272,12 +3272,12 @@
     {
       "path": "modules/hall-ui/public/government.html",
       "mode": "0000644",
-      "sha256": "a76e7263c87178427061ff6b02588e524ca885b3964e54f693e4fc88c9ef5c26"
+      "sha256": "87ec2d8c002edf0a440e658cb29e567a07544bc36bb535d4cb0fd5130629a92e"
     },
     {
       "path": "modules/hall-ui/public/government.js",
       "mode": "0000644",
-      "sha256": "7d6ce981e085a0a5d3fed711088720c412a82b54c4c2b9f436f1e112b453c2d3"
+      "sha256": "505003cd76eb3760459ed53555b5c0803e1efaffb2e17ee15c7ed032a1607289"
     },
     {
       "path": "modules/hall-ui/public/hall-kit.js",
@@ -4322,12 +4322,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "f08d3eab8dc3b1ef943b3ef19523e21c7676ba91e57f1791ce984b7847c27078"
+      "sha256": "7731f20b3114fe6a083c06fe6b92d0048e4d5d136ba4fcc49f9a10f66c9577e5"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "fe66476a7d77fe1f6ddaf04090e1af767696443fab948f0fc64713ed48c64b5d"
+      "sha256": "844c9c21b09d3d41cd8663a37d651ec717a5ba25d5fb24fda5e57930ca278cb2"
     },
     {
       "path": "public-docs/index.html",
@@ -5942,7 +5942,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "509de05d397e1c27f123e67e666147efa117ce28e98ef00f1386687ca15a4097"
+      "sha256": "c3a588bdcb0781e8f71dd492f26b09a2212ababebf52e511dccb9018ad84f89b"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -6904,6 +6904,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 +6922,7 @@
     {
       "path": "tests/government_constitution_view.mjs",
       "mode": "0000644",
-      "sha256": "daf26af68fcaa19a6de3793e0c9ab81b2981d8ed5e4d5ec5f860c686ac7610fb"
+      "sha256": "64fc8006d5b3a562b01a38bfd0ad00a1357969b0ac52ce270e77d4d93eddca80"
     },
     {
       "path": "tests/government_fold.mjs",

package/modules/government/board.js

@@ -530,9 +530,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 +567,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 +612,5 @@ module.exports = {
   proposeAmendment,
   boardRoomView,
   constitutionView,
+  recommendedCharter,
 };

package/modules/government/db.js

@@ -509,6 +509,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 +664,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-charter-library"></script>
 </body>
 </html>

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

@@ -470,6 +470,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 +552,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)}
     `;
   }
 

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.234",
+  "version": "1.19.235",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.234",
+      "version": "1.19.235",
       "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.235",
   "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,10 @@ 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)
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.234'; // CI auto-patch carrier (ADR 0161); see changelog above
+const CORE_VERSION = '1.19.235'; // 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_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 [