@bongos/core 1.19.185 → 1.19.186

package/.bongos-core.json

@@ -2,11 +2,11 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.185",
-  "core_contract": "1.19.185",
-  "source_commit": "c725667c9921ff8e8dce9113f3f11a230ca9ce15",
+  "core_version": "1.19.186",
+  "core_contract": "1.19.186",
+  "source_commit": "6cbbcc0e845fce8a100732deadbed810ed8b7a0c",
   "source_ref": "HEAD",
-  "built_at": "2026-08-16T22:31:52.623Z",
+  "built_at": "2026-08-16T22:45:57.773Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 308,
@@ -17,7 +17,7 @@
     "gate": "passed"
   },
   "file_count": 1610,
-  "tree_sha256": "076b2c5942c82770787a176f2f500059304f8ddc297dc8fe580d0f3e035a4f67",
+  "tree_sha256": "18131419ad0fd9f0d498fad1bd304caefa22719a484a3e7c92d50ad798a5dfb4",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -367,7 +367,7 @@
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "1efedc7f78c88bcc7ce8ca5523915258273063a575481504bd046ed905d9e41a"
+      "sha256": "b37e4a561554ec579b525ff660246d350a70c4acdda9a16d8e6521c38180bae6"
     },
     {
       "path": "clients/bongos-client/index.mjs",
@@ -1367,7 +1367,7 @@
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "3a3fd517cd4aff7e29f8c298d9099af7fe7b3282f74e437a2fbbce300da8b46d"
+      "sha256": "051c79468a982cd07b8a398b81346aed6c366b3d35347243891a2cebe79805fb"
     },
     {
       "path": "docs/architecture.md",
@@ -2887,7 +2887,7 @@
     {
       "path": "modules/government/catalog.js",
       "mode": "0000644",
-      "sha256": "4ebb584351a14dc849be7e06a92a3f9056cca4347e6b1b9e3d041ad8b407d7ee"
+      "sha256": "461a836f14eef90c2e1fcb2f6a3641e952a5904ef95fd0adc64bbf24d2bdc908"
     },
     {
       "path": "modules/government/config.js",
@@ -2897,7 +2897,7 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "e7c4d26ed0b5efe6426426d486170f5a1de106fe16071a050c77d45a25c66233"
+      "sha256": "250edf5a95aadb06b6b4229bb202ae138c13585caa09f5d8cfeff4c1a982bcc9"
     },
     {
       "path": "modules/government/migrations/governance_001_tables.sql",
@@ -2972,12 +2972,12 @@
     {
       "path": "modules/government/routes/government.js",
       "mode": "0000644",
-      "sha256": "d29087432cdb8f5c42f756924d326246517c81bb59065bddfce1e8c95794339f"
+      "sha256": "8fd54465c050cd1e648e419df89ed4c39a853068fd792c5321e10f2ae691bf1d"
     },
     {
       "path": "modules/government/routes/rank-sync.js",
       "mode": "0000644",
-      "sha256": "7934d1d1db163b20403c98afc4670e44ab926cf21123c8be1764172df4eb3290"
+      "sha256": "55b6e1c2c5d02c71b319b40f19676f2e780c58fba5e4767a9b335919bfa13ff0"
     },
     {
       "path": "modules/government/session-scopes.js",
@@ -3182,7 +3182,7 @@
     {
       "path": "modules/hall-ui/public/gate.js",
       "mode": "0000644",
-      "sha256": "16cdabe86d1deef19de5604aeeab69037c67fae0e92ffa7c93a3c0892242581e"
+      "sha256": "0d3c92f77b90bce0d8e44045aedd8673ba2516bf4a0512c3a5abfa5c4f73375c"
     },
     {
       "path": "modules/hall-ui/public/goal-inbox.js",
@@ -3210,19 +3210,19 @@
       "sha256": "9cdbc14c1709dcc26fe9b8c85b2bfd08685a2925c9855758ca8e758455d1bc5c"
     },
     {
-      "path": "modules/hall-ui/public/governance.css",
+      "path": "modules/hall-ui/public/government.css",
       "mode": "0000644",
-      "sha256": "f51e53cba5b1e1853de2682ca4909530925547691af93ccc772aa2e3c3598833"
+      "sha256": "0b59d6379cb7c61f270676db628c738aadfb24141ee7fdc29d194fae4e63637e"
     },
     {
-      "path": "modules/hall-ui/public/governance.html",
+      "path": "modules/hall-ui/public/government.html",
       "mode": "0000644",
-      "sha256": "605a6456c163cbff579d3f742a7da6f54e487b4764e33890c216f65dbd3be92b"
+      "sha256": "7c923d794a0c69e5e4ed48eeae326ce9ae070c896a693264de2882a99583ca52"
     },
     {
-      "path": "modules/hall-ui/public/governance.js",
+      "path": "modules/hall-ui/public/government.js",
       "mode": "0000644",
-      "sha256": "68a9b5f21246c2b476f78793e60056341ad15699bb56d3a3ff9a72d0661ba7a1"
+      "sha256": "98e28a3a54fddc29481645223e5f15bd295899cdbdc557c20a3b37f56335f978"
     },
     {
       "path": "modules/hall-ui/public/hall-kit.js",
@@ -3247,7 +3247,7 @@
     {
       "path": "modules/hall-ui/public/harbor.js",
       "mode": "0000644",
-      "sha256": "43377715522a948d23d1f07a1062bc73bc0f96342e165eb42591baa54df6c4d9"
+      "sha256": "7a102f4fd675910b0c80416c3ed05397d38f977e647fffb00c593732d05a3712"
     },
     {
       "path": "modules/hall-ui/public/index.html",
@@ -3417,7 +3417,7 @@
     {
       "path": "modules/hall-ui/public/shell.js",
       "mode": "0000644",
-      "sha256": "2b393108bd61a33dea9dc590c8acd346922e84ba1582ecf1a5ae220def1f2d29"
+      "sha256": "f9b6d2ddd7b27e37a4be64dea8e767de43ad89a2d9999a566245a42d1d6196e1"
     },
     {
       "path": "modules/hall-ui/public/style.css",
@@ -3452,7 +3452,7 @@
     {
       "path": "modules/hall-ui/public/watch.js",
       "mode": "0000644",
-      "sha256": "0c9fa898f0dcf34ed92c3b096c72fb41d88bec871f36b19b954a71b672a932ed"
+      "sha256": "9fbaee78276658ca61631e2849d8c8b34e708d3074c2739f1c0ae0cd8a048c78"
     },
     {
       "path": "modules/hall-ui/public/work.css",
@@ -4257,12 +4257,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "285a39e688ff084805cf3cc403ffc2affbf3efd85eccefa1661e932c912db9a9"
+      "sha256": "169da149860df789f1900e847fa5f87394e13bddd9399eddd6e015d8b0290a26"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "699b38fd120a85262b8040961b95881039b6050263f8e9a72e61ad7c2f72fa6b"
+      "sha256": "f42ff0f356c3390d07015cc5c3fdebc8352e62f329f891ea25027739f0178bb2"
     },
     {
       "path": "public-docs/index.html",
@@ -5522,7 +5522,7 @@
     {
       "path": "scripts/hall-preview/server.js",
       "mode": "0000644",
-      "sha256": "1cd66475d610b107b0f3b7f19688133e7c482b41b034e2cef6009d552df31cb2"
+      "sha256": "384b6ee204f1ca1bb0f352d6a879f7674c9e7741999e584b72dfe4bf1983d0d1"
     },
     {
       "path": "scripts/migrate.sh",
@@ -5627,7 +5627,7 @@
     {
       "path": "src/bongos/auth.js",
       "mode": "0000644",
-      "sha256": "acabbb5f2586adbb3b3bd25eca0a258ab16095669f298f71e4a7c5e64d9c02a2"
+      "sha256": "0d173ce76410884480e5545aad4201da26ff661516e6096de7a2ff2bd2a4015c"
     },
     {
       "path": "src/bongos/cascade-dispatch.js",
@@ -5832,7 +5832,7 @@
     {
       "path": "src/bongos/serve-internal.js",
       "mode": "0000644",
-      "sha256": "473f4d8021f6996eac64e5d2e5c712eeaf8a6de561864d98c9d777e0a71868ed"
+      "sha256": "94af8e061c690b6fb979cd95ec3a65e21b0f830898a05ab868c5a9f34d9dee72"
     },
     {
       "path": "src/bongos/stealth-gate.js",
@@ -5867,7 +5867,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "ae7d472a89aace19a9544a330a8c1859680a3fd88f29358c6d4c1e905305aae7"
+      "sha256": "8381e5e0b51bce1387c53e9518d693e74ac93f640d29dee0daa35931cdf2d4f5"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -6067,7 +6067,7 @@
     {
       "path": "tests/auth_resolve_failure.mjs",
       "mode": "0000644",
-      "sha256": "8d40fbb16a8b6256551eb014ba3a209b577548fe1e61ccd965227422ac238d90"
+      "sha256": "25271ff1abef5600fab6b9d768c0f94965ffdea4d926b6a60344676f5392f9f1"
     },
     {
       "path": "tests/auth_session_ttl.mjs",
@@ -6772,7 +6772,7 @@
     {
       "path": "tests/governance_abuse_matrix.mjs",
       "mode": "0000644",
-      "sha256": "9950499be79588f6b0f2fd34e7fedd534c5ac69e66890e81e80c3e486be073f8"
+      "sha256": "ddec9f958d49c45e140006d97f91ff9ffdcd0cf49b6041cc5098f6f46ee27597"
     },
     {
       "path": "tests/governance_catalog.mjs",
@@ -6812,7 +6812,7 @@
     {
       "path": "tests/governance_page_gates.mjs",
       "mode": "0000644",
-      "sha256": "b0df520ae8492533e660052fd4da8895c378de63fe90122f1b01790e7bad537e"
+      "sha256": "a1ef5da5f04e3bd82584e618b5be830c470d3c7f319de81d6ed41bddd954c8c0"
     },
     {
       "path": "tests/governance_parity.mjs",
@@ -6847,7 +6847,7 @@
     {
       "path": "tests/governance_routes.mjs",
       "mode": "0000644",
-      "sha256": "14788e7c215ea8fda120ca6138073d728ec9ac8271420b47b6d13fb1b5672a80"
+      "sha256": "efc7bfe423db45280ae2ccdfccec2ab1e15e29b604052f1a36b732ac8edf9a73"
     },
     {
       "path": "tests/governance_seed.mjs",
@@ -6932,12 +6932,12 @@
     {
       "path": "tests/hall_nav.mjs",
       "mode": "0000644",
-      "sha256": "b0da8fb0e46c57419821dbf8cb5ddeda3c98da76d1b2918c3ce77798ee2768fb"
+      "sha256": "1a8d9bffb258d8338fd5367796bd19d4a31265f591b6d0e941bc1bcf5e2dc4cc"
     },
     {
       "path": "tests/hall_page_gate_map.mjs",
       "mode": "0000644",
-      "sha256": "667f291c94e5770c703bae8566e3eb73e86b40baef0e5e9474d92410623b123a"
+      "sha256": "9488c26f674a3e76ea3e7d4319f9c20ad392d1b7376dfb60dba18183c2d04e3e"
     },
     {
       "path": "tests/hall_palette.mjs",

package/clients/bongos-client/index.d.ts

@@ -43,7 +43,7 @@ export interface GetGoalsIdSuggestCriteriaResponse { goal_id: unknown; suggestio
 export interface GetGoalsResponse { goals: unknown }
 export interface GetGovernmentAssignmentsResponse { assignments: unknown }
 export interface GetGovernmentPermissionsResponse { permissions: unknown; principals: unknown }
-export interface GetGovernmentRanksResponse { roles: unknown }
+export interface GetGovernmentRanksResponse { ranks: unknown }
 export interface GetGradesByBuilderResponse { window_days: unknown; builders: unknown }
 export interface GetHealthzResponse { ok: boolean; auth_configured: unknown }
 export interface GetInboxIdResponse { idea: unknown }
@@ -228,7 +228,7 @@ export interface PostGoalsResponse { ok: boolean; goal: unknown; succeeds_goal_i
 export interface PostGovernmentAssignmentsRequest { builder_id: number; rank_key: string }
 export interface PostGovernmentRanksRankKeyResetResponse { ok: boolean; rank_key: unknown; seeded_rank: unknown; permission_count: unknown }
 export interface PostGovernmentRanksRequest { rank_key: string; label: string; description?: string }
-export interface PostGovernmentRanksResponse { role: unknown }
+export interface PostGovernmentRanksResponse { rank: unknown }
 export interface PostInboxIdRatifyRequest { notes_md?: string }
 export interface PostInboxRequest { title: string; body_md?: string; kind?: string; suggested_version?: string; suggested_priority?: number; grade?: string; template_key?: string; field_values?: Record<string, unknown> }
 export interface PostLearningsRequest { title: string; body_md: string; tags?: string[]; related_files?: string[]; source?: string; source_ref?: string; task_id?: number }

package/docs/api/openapi.json

@@ -13000,10 +13000,10 @@
       "GetGovernmentRanksResponse": {
         "type": "object",
         "properties": {
-          "roles": {}
+          "ranks": {}
         },
         "required": [
-          "roles"
+          "ranks"
         ]
       },
       "GetGradesByBuilderResponse": {
@@ -15709,10 +15709,10 @@
       "PostGovernmentRanksResponse": {
         "type": "object",
         "properties": {
-          "role": {}
+          "rank": {}
         },
         "required": [
-          "role"
+          "rank"
         ]
       },
       "PostInboxIdRatifyRequest": {

package/modules/government/catalog.js

@@ -104,12 +104,12 @@ const PERMISSIONS = [
   { key: 'task.confirm.grade_bypass', system: true, floor: 'archon', guards: 'POST /tasks/:id/confirm — ratify past a failed grade (env-relaxable, ADR 0041)' },
   { key: 'dependency.cross_tier.manage', system: true, floor: 'archon', guards: 'POST|DELETE /dependencies — cross-tier structural edges (ADR 0086)' },
   { key: 'goal.scope.manage', system: true, floor: 'archon', guards: 'cross-tier goal-scope edges + protected-scope admission (ADR 0086)' },
-  { key: 'government.manage', system: true, floor: 'archon', guards: 'the governance tab routes (roles/perms/assignments CRUD, reads included — R110) — meta-escalation' },
+  { key: 'government.manage', system: true, floor: 'archon', guards: 'the Government tab routes (ranks/perms/assignments CRUD, reads included — R110) — meta-escalation' },
   { key: 'gate_approval.decide', system: true, floor: 'archon', guards: 'POST /gate-approvals/:pr/approve — CI deploy-gate override' },
   { key: 'deploy.push_main', system: true, substrate: true, floor: 'archon', guards: 'git push origin main / the deploy — substrate-enforced (pre-push, main-audit)' },
   { key: 'path.protected.modify', system: true, substrate: true, floor: 'archon', guards: 'modifying a PROTECTED_GLOBS path below the Metic floor — substrate (ADR 0043)' },
   { key: 'infra.ssh', system: true, substrate: true, floor: 'archon', guards: 'ssh to the droplet / operator surface — substrate (credential placement)' },
-  { key: 'principal.bfg', system: true, floor: null, principal: 'bfg', guards: '/memory/bfg/* — requireBfgPrincipal (exact system_role=bfg; NO rank-role holds it)' },
+  { key: 'principal.bfg', system: true, floor: null, principal: 'bfg', guards: '/memory/bfg/* — requireBfgPrincipal (exact system_role=bfg; NO rank holds it)' },
   { key: 'principal.discord_bot', system: true, floor: null, principal: 'discord_bot', guards: 'Discord bot routes — requireDiscordBot (exact system_role; dormant)' },
 
   // ── operational — floor archon (admin ops; grantable to a custom role) ────────
@@ -235,10 +235,10 @@ const PERMISSIONS = [
   { key: 'page.view.public', system: false, floor: 'xenos', guards: 'public read surfaces (incl. xenos)' },
   // ADR 0157: floor archon→metic, which is what opens /watch, /harbor and /gate to the
   // working rank. The gate FUNCTION was renamed to match (`requireArchonPage` →
-  // `requireGovernancePage`) once the floor moved. Viewing is all this grants: every
+  // `requireGovernmentPage`) once the floor moved. Viewing is all this grants: every
   // write those pages reach is its own atom, and `government.manage` (the
   // roles/permissions tab) stayed archon.
-  { key: 'page.view.government', system: false, floor: 'metic', guards: 'the governance/monitoring pages — /watch, /harbor, /gate (requireGovernancePage; write = government.manage, archon)' },
+  { key: 'page.view.government', system: false, floor: 'metic', guards: 'the government/monitoring pages — /watch, /harbor, /gate (requireGovernmentPage; write = government.manage, archon)' },
 ];
 
 // ── invariants asserted at module load (fail loud on an authoring typo) ─────────

package/modules/government/db.js

@@ -120,7 +120,7 @@ async function syncRank(client, { builderId, rank } = {}) {
 //
 // The db half of the governance API routes. Deliberately DUMB writes: the
 // authority invariants (system perms non-grantable, seeded rank-roles immutable
-// through the API) are enforced in routes/governance.js against the catalog —
+// through the API) are enforced in routes/government.js against the catalog —
 // the same split governance_001 documents (permission_key is validated app-side,
 // not a FK). Grant/assign are ON CONFLICT DO NOTHING so the tab's toggle is
 // idempotent; each returns whether a row actually changed.

package/modules/government/routes/government.js

@@ -213,8 +213,8 @@ module.exports = function buildGovernanceRouter() {
   // rank: perm government.manage — the full role list with each role's grants.
   router.get('/government/ranks', api.requireBuilder, api.requirePermission('government.manage'), async (req, res) => {
     try {
-      const roles = await db.listRolesWithGrants();
-      res.json({ roles });
+      const ranks = await db.listRolesWithGrants();
+      res.json({ ranks });
     } catch (err) {
       console.error('[gds] GET /government/ranks', err);
       res.fail('roles_list_failed', { status: 500, message: 'internal error' });
@@ -269,13 +269,13 @@ module.exports = function buildGovernanceRouter() {
       return res.fail('bad_rank_key', 400, { rank_key: rankKey, expected: 'a kebab-case slug (^[a-z][a-z0-9-]*$)' });
     }
     try {
-      const role = await db.createRole({
+      const rank = await db.createRole({
         rankKey,
         label: req.body.label,
         description: req.body.description ?? null,
         createdBy: req.builder.id,
       });
-      res.status(201).json({ role: { ...role, permissions: [] } });
+      res.status(201).json({ rank: { ...rank, permissions: [] } });
     } catch (err) {
       if (err && err.code === '23505') {
         return res.fail('rank_exists', 409, { rank_key: rankKey });

package/modules/government/routes/rank-sync.js

@@ -2,7 +2,7 @@
 
 // The governance module's rank-role SYNC port (ADR 0151, BV1.R95b).
 //
-// A second, deliberately tiny kernel port beside `governance` (routes/governance.js).
+// A second, deliberately tiny kernel port beside `government` (routes/government.js).
 // `governance` is the READ surface every gate resolves on every request; this is the
 // single WRITE core needs — "this builder's rank is now X, make their seeded
 // rank-role match". They are kept apart on purpose:
@@ -14,7 +14,7 @@
 // The port name is namespaced (`government.rankSync`) like the `ideas.capture` /
 // `art.getBuilderGeminiKeyRow` / `grade.builderRollingAvgGrade` ports.
 //
-// Registered from a route factory for the same reason routes/governance.js is:
+// Registered from a route factory for the same reason routes/government.js is:
 // mountModuleRoutes is the one boot hook that runs BOTH in the live server and
 // whenever a test rebuilds the router, and registration is hasProvider-guarded so a
 // rebuild never trips the seam's single-provider duplicate guard.

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

@@ -10,7 +10,7 @@
 // Like The Watch + The Harbor, this reads /api/bongos/me to show a Sealed notice for
 // non-Archons — DEFENCE IN DEPTH only. GET /gate-approvals + POST
 // /gate-approvals/:pr/approve are ALSO archon-gated server-side (ADR 0016), and
-// the page itself is gated by server.js requireGovernancePage. On 401 → web sign-in.
+// the page itself is gated by server.js requireGovernmentPage. On 401 → web sign-in.
 
 (() => {
   'use strict';
@@ -218,7 +218,7 @@
     }
     const rank = (me && (me.builder || me).rank || '').toLowerCase();
     // ADR 0157: the Gate page sits at the `page.view.government` floor (metic). The
-    // server's requireGovernancePage is the wall — this only decides whether to render the
+    // server's requireGovernmentPage is the wall — this only decides whether to render the
     // body or the sealed notice, so it must agree or a Metic sees "sealed" on a page
     // they were just admitted to.
     if (rank !== 'metic' && rank !== 'archon') { showSealed(); return; }

package/modules/hall-ui/public/{governance.css → government.css}

@@ -6,28 +6,28 @@
 .gov-h { color: var(--ink); font-size: 16px; font-weight: 600; margin: 22px 0 8px; }
 .gov-h--minor { font-size: 13px; margin: 18px 0 6px; }
 .gov-grid-note { color: var(--ink-soft); font-size: 12.5px; margin: 0 0 12px; }
-/* Holds the rank-role reset button. Empty for every other role, so it collapses
+/* Holds the ladder-rank reset button. Empty for every other rank, so it collapses
    rather than reserving a gap — hence no margin on the empty box itself. */
 .gov-grid-actions:not(:empty) { margin: 0 0 14px; }
 .gov-sealed, .gov-empty { color: var(--ink-soft); padding: 16px 0; }
 
-/* Two columns on wide screens: role rail left, permission grid right. */
+/* Two columns on wide screens: rank rail left, permission grid right. */
 .gov-layout { display: grid; grid-template-columns: 260px 1fr; gap: 22px; align-items: start; }
 @media (max-width: 760px) { .gov-layout { grid-template-columns: 1fr; } }
 
-/* ---- role list ---------------------------------------------------------- */
-.gov-role-list { display: flex; flex-direction: column; gap: 8px; }
-.gov-role {
+/* ---- rank list ---------------------------------------------------------- */
+.gov-rank-list { display: flex; flex-direction: column; gap: 8px; }
+.gov-rank {
   text-align: left; font: inherit; cursor: pointer;
   border: 1px solid var(--border); border-radius: var(--radius-sm);
   background: var(--surface); padding: 10px 12px;
   display: flex; flex-direction: column; gap: 4px;
 }
-.gov-role:hover { background: var(--surface-2); }
-.gov-role[aria-pressed="true"] { border-color: var(--accent); box-shadow: inset 2px 0 0 var(--accent); }
-.gov-role__head { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }
-.gov-role__label { font-weight: 600; color: var(--ink); font-size: 13.5px; }
-.gov-role__meta { color: var(--ink-faint); font-size: 11.5px; }
+.gov-rank:hover { background: var(--surface-2); }
+.gov-rank[aria-pressed="true"] { border-color: var(--accent); box-shadow: inset 2px 0 0 var(--accent); }
+.gov-rank__head { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }
+.gov-rank__label { font-weight: 600; color: var(--ink); font-size: 13.5px; }
+.gov-rank__meta { color: var(--ink-faint); font-size: 11.5px; }
 
 .gov-pill {
   font-size: 10.5px; font-weight: 600;

package/modules/hall-ui/public/{governance.html → government.html}

@@ -3,16 +3,16 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Governance — {{worldName}}</title>
-  <meta name="description" content="Roles and permissions — create a custom role, grant everyday permissions, assign it to a builder. Trust-boundary powers stay locked.">
+  <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.">
   <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>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/governance.css">
+  <link rel="stylesheet" href="/builders/government.css">
 </head>
-<body data-page="governance" data-page-title="Governance">
+<body data-page="government" data-page-title="Government">
 
 <div class="app">
   <aside class="app-sidebar" id="app-sidebar" aria-label="Primary"></aside>
@@ -27,15 +27,15 @@
 
         <section id="gov-body" hidden>
           <div class="gov-layout">
-            <div class="gov-roles-col">
-              <h2 class="gov-h">Roles</h2>
-              <div class="gov-role-list" id="gov-role-list"></div>
+            <div class="gov-ranks-col">
+              <h2 class="gov-h">Ranks</h2>
+              <div class="gov-rank-list" id="gov-rank-list"></div>
               <form class="gov-create" id="gov-create-form" autocomplete="off">
-                <h3 class="gov-h gov-h--minor">New custom role</h3>
-                <input class="gov-input" id="gov-create-key" placeholder="role-key (kebab-case)" maxlength="64" required>
+                <h3 class="gov-h gov-h--minor">New custom rank</h3>
+                <input class="gov-input" id="gov-create-key" placeholder="rank-key (kebab-case)" maxlength="64" required>
                 <input class="gov-input" id="gov-create-label" placeholder="Label" maxlength="200" required>
                 <input class="gov-input" id="gov-create-desc" placeholder="Description (optional)" maxlength="2000">
-                <button class="gov-btn" type="submit">Create role</button>
+                <button class="gov-btn" type="submit">Create rank</button>
               </form>
             </div>
 
@@ -48,16 +48,16 @@
           </div>
 
           <h2 class="gov-h">Assignments</h2>
-          <p class="gov-grid-note">Hand a custom role to a builder. Rank roles are assigned by rank itself and cannot be granted here.</p>
+          <p class="gov-grid-note">Hand a custom rank to a builder. The four ladder ranks are assigned by rank itself and cannot be granted here.</p>
           <form class="gov-assign" id="gov-assign-form" autocomplete="off">
             <input class="gov-input gov-input--id" id="gov-assign-builder" type="number" min="1" placeholder="Builder id" required>
-            <select class="gov-input" id="gov-assign-role" required></select>
+            <select class="gov-input" id="gov-assign-rank" required></select>
             <button class="gov-btn" type="submit">Assign</button>
           </form>
           <div id="gov-assignments"></div>
 
           <h2 class="gov-h">Machine principals</h2>
-          <p class="gov-grid-note">Capabilities held by a machine identity, never by a person or a role. Shown for completeness — nothing here can be granted.</p>
+          <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>
       </main>
@@ -73,6 +73,6 @@
 <!-- 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/governance.js?v=2026-08-06-governance"></script>
+<script src="/builders/government.js?v=2026-08-06-governance"></script>
 </body>
 </html>