@bongos/core 1.19.223 → 1.19.224

package/.bongos-core.json

@@ -2,11 +2,11 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.223",
-  "core_contract": "1.19.223",
-  "source_commit": "f9d11234723ed42c73cf2eff487deabe34464ab5",
+  "core_version": "1.19.224",
+  "core_contract": "1.19.224",
+  "source_commit": "cddd2aa1a006cc4524db36eb319d3813a35c5e57",
   "source_ref": "HEAD",
-  "built_at": "2026-08-18T04:00:41.918Z",
+  "built_at": "2026-08-18T04:10:09.443Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 311,
@@ -17,7 +17,7 @@
     "gate": "passed"
   },
   "file_count": 1637,
-  "tree_sha256": "149332598cd294f2de39adf373feaa298158120232a1dfebbd58e5ee56207689",
+  "tree_sha256": "88a20aaa26450db245b3da0aa9685b344fb4c9c2a53618fb5242e79dfe8ec9fb",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -3247,12 +3247,12 @@
     {
       "path": "modules/hall-ui/public/government.html",
       "mode": "0000644",
-      "sha256": "91c14637adc59dde39f47e51cfd243ddc1796b0a4108491f46aa64e68eea4a0d"
+      "sha256": "23ceb462eddfb0f66ba3030231ae1394d72eb0b6689a7f127c1ba52554c874bf"
     },
     {
       "path": "modules/hall-ui/public/government.js",
       "mode": "0000644",
-      "sha256": "b7504f63fc1086c4367dbd76da7ac96ac4297a23f74456f90c5aebe5e974e034"
+      "sha256": "4778f9a83d63900aca6969a85e7cb67850ffb591a6cbae1fb4be270393741cd1"
     },
     {
       "path": "modules/hall-ui/public/hall-kit.js",
@@ -3342,7 +3342,7 @@
     {
       "path": "modules/hall-ui/public/palette.js",
       "mode": "0000644",
-      "sha256": "f01a585277f24dafb12caa39d4b475cd65e61cda50ba918c66941a20916fd8b1"
+      "sha256": "f6b2dc3a7ee452ff7121fbc0245bd554c692f6d8be1dc6285d0fa0eab2d6aed6"
     },
     {
       "path": "modules/hall-ui/public/people.html",
@@ -4297,12 +4297,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "886be125dcb957387fea954c943d27f852347b7f38662905d59e2146cbb17e0b"
+      "sha256": "c0b226a7cd5289673d7a88f416d410c5855a7094e8cd0bcff12e063b705baf82"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "7e5374d7ead5886cd5b376a95724500196a0e9dc748617a99af436b2863a235c"
+      "sha256": "49b050b03e108d8f8be6aef3ed472dfd699496a1101e7bd286793e17351db3b5"
     },
     {
       "path": "public-docs/index.html",
@@ -5917,7 +5917,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "ea7ae52689115222eeafffffbcf8fb1f9fcf13b6e01f90f1153e133928d52dea"
+      "sha256": "ff93015b043ae508d50b88b8de3fe512221a9906479d36e28bc418d837455fd4"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -7017,7 +7017,7 @@
     {
       "path": "tests/hall_palette.mjs",
       "mode": "0000644",
-      "sha256": "6a37c64bce418e7669c43b9225dffd50687e450937285b2a556287a302970a7c"
+      "sha256": "7cb75511b1b09bc2ff542aa7d85849ad800d18624646e40f23483ae86127fa28"
     },
     {
       "path": "tests/hall_signout.mjs",

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

@@ -4,7 +4,7 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Government — {{worldName}}</title>
-  <meta name="description" content="Ranks and permissions — create a custom rank, grant everyday permissions, assign it to a builder. Trust-boundary powers stay locked.">
+  <meta name="description" content="How this project is governed — the constitution it runs, the Board Room where Full Ideas are ratified, and the ranks &amp; permissions that administer it.">
   <link rel="icon" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><text x='16' y='24' font-size='24' text-anchor='middle' font-family='sans-serif'>⌂</text></svg>">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -26,6 +26,30 @@
         <p class="gov-sealed" id="gov-sealed" hidden>Archons only.</p>
 
         <section id="gov-body" hidden>
+          <!-- The three-section IA (R15 of goal 1000069, ADR 0175): the page that
+               answers "how is this project governed". Tabs are OTBKit.makeTabs
+               (the work.js idiom) with hash deep links — #constitution,
+               #board-room, #ranks. -->
+          <div id="gov-tabs"></div>
+
+          <!-- §1 Constitution — what this project runs. The live view (today's
+               values + the change history) and the charter library land with
+               R18/R19; until then the section frames the model honestly. -->
+          <section id="gov-panel-constitution" hidden>
+            <h2 class="gov-h">Constitution</h2>
+            <p class="gov-grid-note">Three dials decide how this project is governed: <strong>who sits on the board</strong> (a rank — everyone holding it is a member), <strong>what counts as passing</strong> (a first ratifier, or the consent of the sitting), and <strong>how long a vote stays open</strong> (a timed sitting, or no clock at all). They are configuration on the same machinery at every setting — a project starts with the founder ratifying alone and opens up by changing numbers, not code.</p>
+            <div id="gov-constitution"></div>
+          </section>
+
+          <!-- §2 Board Room — open items, the clock, your vote (R16/R17). -->
+          <section id="gov-panel-board" hidden>
+            <h2 class="gov-h">Board Room</h2>
+            <p class="gov-grid-note">Where a Full Idea that cleared the completeness grade comes to be ratified — and where the constitution itself is amended. Open items appear here with their clock and a live tally; an objection must carry a reason and name the section it faults, which is why votes are cast here and only mirrored to chat.</p>
+            <div id="gov-board"></div>
+          </section>
+
+          <!-- §3 Ranks & Permissions — the administration surface, unchanged. -->
+          <section id="gov-panel-ranks" hidden>
           <div class="gov-layout">
             <div class="gov-ranks-col">
               <h2 class="gov-h">Ranks</h2>
@@ -59,6 +83,7 @@
           <h2 class="gov-h">Machine principals</h2>
           <p class="gov-grid-note">Capabilities held by a machine identity, never by a person or a rank. Shown for completeness — nothing here can be granted.</p>
           <div id="gov-principals"></div>
+          </section>
         </section>
       </main>
 
@@ -73,6 +98,7 @@
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
-<script src="/builders/government.js?v=2026-08-16-government"></script>
+<script src="/builders/hall-kit.js"></script>
+<script src="/builders/government.js?v=2026-08-18-government-ia"></script>
 </body>
 </html>

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

@@ -25,9 +25,16 @@
 // gated server-side on the `government.manage` atom (archon floor). On 401 →
 // web sign-in.
 //
-// DELIBERATELY NOT IN THE SIDEBAR YET: the nav entry + the server page gate are
-// R113 (the next slice) — tests/hall_nav.mjs pins the Government nav group and
-// grows with that slice, not this one. Until then the page is reached by URL.
+// SINCE R15 (goal 1000069, ADR 0175) this page carries the three-section IA —
+// Constitution · Board Room · Ranks & Permissions — because Government is the
+// page that answers "how is this project governed", and administration is only
+// the third part of that answer. Tabs are OTBKit.makeTabs with hash deep links
+// (#constitution / #board-room / #ranks). The first two sections are FRAMES
+// until their build-out lands: R18 fills Constitution with the live values +
+// change history, R19 adds the charter library, R16/R17 fill the Board Room
+// with open items and the vote. Until then each frame states what belongs there
+// and shows an honest kit empty state — never a fake or a hardcoded value that
+// could drift from the real config.
 
 (() => {
   'use strict';
@@ -392,6 +399,34 @@
     });
   }
 
+  // ---- the three-section IA (R15) -------------------------------------------
+
+  // Tab order is the spec's — Constitution · Board Room · Ranks & Permissions —
+  // but the INITIAL tab is Ranks until R16/R18 fill the other two: landing the
+  // Archon on a frame when the working surface is one tab over would be IA
+  // winning over usefulness. Flip `initial` to 'constitution' when R18 lands.
+  function wireTabs() {
+    window.OTBKit.makeTabs({
+      mount: document.getElementById('gov-tabs'),
+      hash: true,
+      initial: 'ranks',
+      tabs: [
+        { id: 'constitution', label: 'Constitution', panel: 'gov-panel-constitution' },
+        { id: 'board-room', label: 'Board Room', panel: 'gov-panel-board' },
+        { id: 'ranks', label: 'Ranks & Permissions', panel: 'gov-panel-ranks' },
+      ],
+    });
+    // The frames' empty states — kit-standard, one line, no fake data. What this
+    // project actually RUNS is config the server owns; rendering it here before
+    // the R18 read exists would mean hardcoding a value that drifts.
+    document.getElementById('gov-constitution').innerHTML = window.OTBKit.emptyStateHtml(
+      'The live constitution — what this project runs today, and how it has changed — appears here when the Board Room opens.',
+    );
+    document.getElementById('gov-board').innerHTML = window.OTBKit.emptyStateHtml(
+      'Nothing is before the board. When a Full Idea clears the completeness grade, its window opens here.',
+    );
+  }
+
   // ---- init ----------------------------------------------------------------
 
   function showSealed() {
@@ -416,8 +451,9 @@
     const rank = (me && (me.builder || me).rank || '').toLowerCase();
     if (rank !== 'archon') { showSealed(); return; }
 
-    document.getElementById('gov-sub').textContent = 'Ranks, permissions, and who holds them. Ranks below Archon are yours to shape; what the substrate enforces stays locked.';
+    document.getElementById('gov-sub').textContent = 'How this project is governed — the constitution it runs, the Board Room, and the ranks & permissions that administer it.';
     document.getElementById('gov-body').hidden = false;
+    wireTabs();
     wireForms();
     try {
       await load();

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

@@ -13,7 +13,7 @@
 //   1. Pages — read live from the sidebar shell.js rendered, so rank + module
 //      gating come for free and can never drift from the nav. A hidden nav item
 //      is a hidden destination. (Cosmetic only; the server still gates each page.)
-//   2. Sections — the sub-destinations of the three pages that have them. These
+//   2. Sections — the sub-destinations of the four pages that have them. These
 //      cannot be read from another page's DOM, so they are declared below and
 //      held to the real ids by tests/hall_palette.mjs.
 //   3. Records — id syntax: `1234`, `g 12`, `b 7`, `i 42`.
@@ -28,9 +28,10 @@
   // element whose visibility decides whether the group is offered — the nav item
   // itself for pages, the profile chip for Settings (which is not a nav item).
   // Anchors must stay in step with their source of truth; the test asserts it:
-  //   standing → builders.js STANDING_GROUPS (+ shell.js VIEW_ALIASES)
-  //   work     → work.js makeTabs ids
-  //   settings → settings.js RAIL_GROUPS
+  //   standing   → builders.js STANDING_GROUPS (+ shell.js VIEW_ALIASES)
+  //   work       → work.js makeTabs ids
+  //   government → government.js makeTabs ids (the R15 three-section IA)
+  //   settings   → settings.js RAIL_GROUPS
   var SECTIONS = [
     { parent: 'Standing', gate: 'nav-standing', items: [
       { label: 'Work', href: '/#standing-work' },
@@ -44,6 +45,11 @@
       { label: 'Backlog', href: '/work#backlog' },
       { label: 'Completed', href: '/work#completed' },
     ] },
+    { parent: 'Government', gate: 'nav-government', items: [
+      { label: 'Constitution', href: '/government#constitution' },
+      { label: 'Board Room', href: '/government#board-room' },
+      { label: 'Ranks & Permissions', href: '/government#ranks' },
+    ] },
     { parent: 'Settings', gate: 'shell-user', items: [
       { label: 'Account', href: '/settings#account' },
       { label: 'Access', href: '/settings#access' },

package/package-lock.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.223",
+  "version": "1.19.224",
   "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

@@ -873,8 +873,10 @@ const { validateOrRespond, LIMITS, parseId, asyncHandler, corsPublicGet, parsePa
 //         landed since 1.19.221 with no explicit bump. run 32096034408. (task 1002620)
 //   1.19.223 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
 //         landed since 1.19.222 with no explicit bump. run 32097491676. (task 1002620)
+//   1.19.224 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+//         landed since 1.19.223 with no explicit bump. run 32098083321. (task 1002620)
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.223'; // CI auto-patch carrier (ADR 0161); see changelog above
+const CORE_VERSION = '1.19.224'; // 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/hall_palette.mjs

@@ -111,6 +111,16 @@ test('Tasks tab anchors exist in work.js makeTabs', () => {
   }
 });
 
+test('Government section anchors exist in government.js makeTabs (the R15 three-section IA)', () => {
+  const ids = [...read('government.js').matchAll(/\{ id: '([a-z-]+)', label: '[^']*', panel:/g)].map((m) => m[1]);
+  assert.ok(ids.length === 3, `sanity: found the three government tabs (${ids})`);
+  const declared = declaredHrefs((x) => x.startsWith('/government#'));
+  assert.ok(declared.length === 3, 'palette declares the three Government sections');
+  for (const h of declared) {
+    assert.ok(ids.includes(h.split('#')[1]), `${h} must be a real government.js tab id`);
+  }
+});
+
 test('Settings panel anchors exist in settings.js RAIL_GROUPS', () => {
   // RAIL_GROUPS is derived: RAIL_ITEMS.map(i => i.id).concat('extensions').
   const src = read('settings.js');