@bongos/core 1.21.31 → 1.21.32

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.21.31",
-  "core_contract": "1.21.31",
-  "source_commit": "420a0600d983580f569292a84785356f3df3f039",
+  "core_version": "1.21.32",
+  "core_contract": "1.21.32",
+  "source_commit": "dc621db8394a42d17e812d259ae034b2d9ff2e49",
   "source_ref": "HEAD",
-  "built_at": "2026-10-03T13:05:22.192Z",
+  "built_at": "2026-10-03T20:09:59.517Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 581,
     "agent_docs_stubbed": 27,
-    "functional_verbatim": 2902,
+    "functional_verbatim": 2904,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3511,
-  "tree_sha256": "e167a836d4a72c03cf4282938fce24179be13959361af809c0a340b24e4599d2",
+  "file_count": 3513,
+  "tree_sha256": "90d84e8130f69ebcd5a15d34b53ac41e6728ff754955ee11a4a9c62dda2dd54b",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -317,12 +317,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "9a17378c114f0459f7e10ea00630b8e28a681c00f7167d42e6c4f2753250ac9d"
+      "sha256": "69d42ead01d9c96a8728c306701ade8dc9f1682cfa82513c2411a9d3a265c48d"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "89925473105a2efe1cc3113eb01bb781e340b495125552769562e22c1c43e1f4"
+      "sha256": "134bfb4b226537fdeaf31519c764926dc250b713e4eb3968e65068d0fc460740"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -332,17 +332,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "f6ef7ef830a1bc6c806e523a5c1e86cdc43b48b73f5d66f7235e9ed23837ac82"
+      "sha256": "319671c677ec2bbcadbb8b054b47acf4e943e823720edba32416b6a23c46c90b"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "96670d9a3abbf2d4bdd3eb3f63f179210493a822d07bbdfc9dc98d4e93cd866a"
+      "sha256": "07246b400a63caa5586a45ec1af6b60c04e616f06515015653d6e7dc48b3fe4f"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "3611b6a0d1425b44300c80828e90ae324e566639f2bc4a6f5792902c8805b31c"
+      "sha256": "1a8057d83c6ab453ce6251991f30b8502edb0cd9cebd90d427f706187073f3c2"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2292,12 +2292,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "f7a74e0d63a68d2e806d9f24288f2a15549819baafcd041aa472ecd0f604b7d4"
+      "sha256": "0d8593234a315be3d3e03f23612ee7248ee742bca086e24c6b835d28f137c443"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "7f94594aed0457b0adb4c1812602aa59199f61540653d378c2e326a1a50fd9a5"
+      "sha256": "0b0b87bbe13d992d896a7145f86d1ef09d7f80c2922d968ea45bcbff38479e11"
     },
     {
       "path": "docs/architecture.md",
@@ -2322,12 +2322,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "ed778bfe2ae98c220dbedfd760b4a9c237f00bb87d4d64e5586db10c9aee8464"
+      "sha256": "48ed28854a75411af0098e31dd92f99b1cceff4e969dc1d1811a5e1bf9ccf696"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "daa76534767164c10b7c9fe69b835b17434551180c53c7f4138d3b86a00b55d0"
+      "sha256": "13b018cc4a49c755c7f6b598079fdd0f028008e2c63b1e1bb18c14871b786d1f"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2832,7 +2832,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "f3e68aad9ee24560d93e154ac36542eb2eb74da83df0aab7e5cd62e45f4767bd"
+      "sha256": "c0f0ecb9abea0a0d26109fbdc1022b7496ef6e9bdbfe84f1d2555bde8400149e"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2922,7 +2922,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "3687073b5014216bf3d9c555a63ded681c1125d388218d98e23ccaedd43221db"
+      "sha256": "8ba0324ffe4260864ca53f1e42198491c42e60dd328e9886380e3ffb2e3087be"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4852,7 +4852,7 @@
     {
       "path": "modules/government/catalog.js",
       "mode": "0000644",
-      "sha256": "9544ad82b54da74a8c9e9074222a649a1a6e16927d66fde8b4b7db75ff1639e5"
+      "sha256": "300d99ff9a8c8c59f70179367e0b262c774f2cfa91376347d13e62296dbf132a"
     },
     {
       "path": "modules/government/charter.js",
@@ -5049,6 +5049,11 @@
       "mode": "0000644",
       "sha256": "2c2d27c50016287ecba7ccbd2491895a7edc7b2b100887d6f76ffdc2a1617fcc"
     },
+    {
+      "path": "modules/government/migrations/government_024_version_focus_set.sql",
+      "mode": "0000644",
+      "sha256": "e839988918bee95e0a5f11bbfe71bd6d3304ad6d8a00a6b78593a34c3e36a6c4"
+    },
     {
       "path": "modules/government/module.json",
       "mode": "0000644",
@@ -5997,7 +6002,7 @@
     {
       "path": "modules/hall-ui/public/roadmap.css",
       "mode": "0000644",
-      "sha256": "ea64e6904225470e20d8bb4a0d18f39f7a1e70406ecdec67ed9abaaf2880fc85"
+      "sha256": "fccf31699d5f0a01d2f733f97eb50e5eea55ed2c4c8859cf1b59b6c09809b5b4"
     },
     {
       "path": "modules/hall-ui/public/roadmap.html",
@@ -6007,7 +6012,7 @@
     {
       "path": "modules/hall-ui/public/roadmap.js",
       "mode": "0000644",
-      "sha256": "cddeb1d315e7222724199fef9a3045f2c7def92a63c56d0151c5e45a38ff7b3d"
+      "sha256": "d48cbc473110568a145127fa0c7cc22e07a32b835d3c40e0412c31a91ca3a217"
     },
     {
       "path": "modules/hall-ui/public/roadmap.states.json",
@@ -7267,7 +7272,7 @@
     {
       "path": "modules/lifecycle/routes/versions.js",
       "mode": "0000644",
-      "sha256": "f26de67bbb2bc311e3c258cb8946402006c8705653edbb020435a9e7653945d7"
+      "sha256": "882403ac8a51cd660b8251c1be7aabefa26688fa78882e71567df1e6e136e365"
     },
     {
       "path": "modules/lifecycle/routes/visuals.js",
@@ -9802,12 +9807,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "6465549449f685ca54f3bc931158e2d9db65eb9928f6eff8a62b029ba6a23090"
+      "sha256": "98c7377fe080c344a720b0ec5e306d6229bd9c330fb051838c1d9e6f653dbbe6"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "c674f1e75b2375308ce73b76d12e6feae99f563776c6cca414685979f0816e14"
+      "sha256": "6bb8d1ab2b6db8876f1e38077a19483cb12ebe4c8a9971e4964f563298a0866c"
     },
     {
       "path": "public-docs/index.html",
@@ -9827,7 +9832,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "24ad77c91494da27e79240ca6fcdfd801363bfa44f941b038ea422c0452a5d51"
+      "sha256": "71b4fa8ec2f99c846ba0ee0d7f3451613e624841fcf4fc6790b40f5f086a3a4c"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -11877,7 +11882,7 @@
     {
       "path": "src/bongos/project-settings.js",
       "mode": "0000644",
-      "sha256": "a33925c65c1c9e909eceaf57e17834506d923b34a39aa751418dfaedc095fc65"
+      "sha256": "314c81c0837fcb79c15bb9e2761f902e7216c0411582c006123cc9014d883f16"
     },
     {
       "path": "src/bongos/repo-info.js",
@@ -12052,7 +12057,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "4a1a5a417c91bfa2df5df2fa356b5e016191549af19e19d182a48e1f4282af14"
+      "sha256": "3b1ea1c35af115635ef7cacc489bf5ba30bbc7aa205cec47e38602934574393d"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -13579,6 +13584,11 @@
       "mode": "0000644",
       "sha256": "9bbd9e2977105beeb98e52f0cb0d7e57c5dd20d3254710adcc937a15b327d292"
     },
+    {
+      "path": "tests/focus_version.mjs",
+      "mode": "0000644",
+      "sha256": "537ebc7aaa324f6cd3af8b2289714472de811361453d7f463017a653118b0518"
+    },
     {
       "path": "tests/founding_birth.mjs",
       "mode": "0000644",

package/clients/bongos-client/README.md

@@ -5,7 +5,7 @@ A **generated**, zero-dependency typed client for the Bongos API — produced fr
 by hand; it regenerates when the spec changes, so it can never drift from the routes.
 
 - API version: **v1** (served at `/api/bongos/v1`)
-- 499 operations across 73 resource groups
+- 501 operations across 73 resource groups
 
 ## Use it from your project
 

package/clients/bongos-client/bongos-client.global.js

@@ -1217,6 +1217,10 @@ function createClient(opts = {}) {
       getVersionsIdProgress: (args) => request("GET", "/versions/{id}/progress", { hasBody: false }, args),
       // GET /versions/close-suggestions — rank: public — GET /versions/close-suggestions
       getVersionsCloseSuggestions: (args) => request("GET", "/versions/close-suggestions", { hasBody: false }, args),
+      // GET /versions/focus — rank: any-builder — GET /versions/focus
+      getVersionsFocus: (args) => request("GET", "/versions/focus", { hasBody: false }, args),
+      // PUT /versions/focus — rank: archon — PUT /versions/focus
+      putVersionsFocus: (args) => request("PUT", "/versions/focus", { hasBody: true }, args),
       // GET /versions/progress — rank: public — GET /versions/progress
       getVersionsProgress: (args) => request("GET", "/versions/progress", { hasBody: false }, args),
     },

package/clients/bongos-client/index.cjs

@@ -1216,6 +1216,10 @@ function createClient(opts = {}) {
       getVersionsIdProgress: (args) => request("GET", "/versions/{id}/progress", { hasBody: false }, args),
       // GET /versions/close-suggestions — rank: public — GET /versions/close-suggestions
       getVersionsCloseSuggestions: (args) => request("GET", "/versions/close-suggestions", { hasBody: false }, args),
+      // GET /versions/focus — rank: any-builder — GET /versions/focus
+      getVersionsFocus: (args) => request("GET", "/versions/focus", { hasBody: false }, args),
+      // PUT /versions/focus — rank: archon — PUT /versions/focus
+      putVersionsFocus: (args) => request("PUT", "/versions/focus", { hasBody: true }, args),
       // GET /versions/progress — rank: public — GET /versions/progress
       getVersionsProgress: (args) => request("GET", "/versions/progress", { hasBody: false }, args),
     },

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

@@ -182,6 +182,7 @@ export interface GetTasksNewcomerFloorResponse { disciplines: unknown }
 export interface GetTasksPeerVotesFeedResponse { tasks: unknown; can_vote: unknown }
 export interface GetTasksResponse { tasks: unknown }
 export interface GetVersionsCloseSuggestionsResponse { suggestions: unknown }
+export interface GetVersionsFocusResponse { focus_version_id: unknown; can_set: unknown }
 export interface GetVersionsIdDoneWhenResponse { version_id: unknown; criteria: unknown; goals: unknown }
 export interface GetVersionsProgressResponse { progress: unknown }
 export interface GetVersionsResponse { versions: unknown; page: unknown }
@@ -534,6 +535,8 @@ export interface PutSpecialitiesIdSkillsRequest { enabled_skills: string[] }
 export interface PutSpecialitiesIdSkillsResponse { adoption: unknown }
 export interface PutTasksIdDependenciesRequest { depends_on_task_ids: unknown[] }
 export interface PutTasksIdDependenciesResponse { ok: boolean; written: unknown; dependencies: unknown }
+export interface PutVersionsFocusRequest { version_id?: string }
+export interface PutVersionsFocusResponse { ok: boolean; focus_version_id: unknown }
 export type StringifiableId = number | string;
 
 // The fallback response type: a route whose res.json({…}) shape could not be
@@ -1681,6 +1684,10 @@ export interface BongosClient {
     getVersionsIdProgress(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /versions/close-suggestions — rank: public */
     getVersionsCloseSuggestions(args?: RequestArgs): Promise<GetVersionsCloseSuggestionsResponse>;
+    /** GET /versions/focus — rank: any-builder */
+    getVersionsFocus(args?: RequestArgs): Promise<GetVersionsFocusResponse>;
+    /** PUT /versions/focus — rank: archon */
+    putVersionsFocus(args?: RequestArgs & { body?: PutVersionsFocusRequest }): Promise<PutVersionsFocusResponse>;
     /** GET /versions/progress — rank: public */
     getVersionsProgress(args?: RequestArgs): Promise<GetVersionsProgressResponse>;
   };

package/clients/bongos-client/index.mjs

@@ -1213,6 +1213,10 @@ export function createClient(opts = {}) {
       getVersionsIdProgress: (args) => request("GET", "/versions/{id}/progress", { hasBody: false }, args),
       // GET /versions/close-suggestions — rank: public — GET /versions/close-suggestions
       getVersionsCloseSuggestions: (args) => request("GET", "/versions/close-suggestions", { hasBody: false }, args),
+      // GET /versions/focus — rank: any-builder — GET /versions/focus
+      getVersionsFocus: (args) => request("GET", "/versions/focus", { hasBody: false }, args),
+      // PUT /versions/focus — rank: archon — PUT /versions/focus
+      putVersionsFocus: (args) => request("PUT", "/versions/focus", { hasBody: true }, args),
       // GET /versions/progress — rank: public — GET /versions/progress
       getVersionsProgress: (args) => request("GET", "/versions/progress", { hasBody: false }, args),
     },

package/docs/api/openapi.json

@@ -23058,6 +23058,94 @@
         "security": []
       }
     },
+    "/versions/focus": {
+      "get": {
+        "operationId": "get_versions_focus",
+        "tags": [
+          "versions"
+        ],
+        "summary": "GET /versions/focus",
+        "description": "The project's focus version (task 1004551) — the one the Roadmap stars. Read: any signed-in builder. Write: Archon only, enforced here on the server, not just by the button hiding. No row = no focus. rank: any-builder — read-only; returns { focus_version_id: string|null, can_set }. can_set tells the page whether to draw a button — a hint only; PUT is the gate.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/versions.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetVersionsFocusResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
+      "put": {
+        "operationId": "put_versions_focus",
+        "tags": [
+          "versions"
+        ],
+        "summary": "PUT /versions/focus",
+        "description": "(atom version.focus.set, system) — body { version_id } sets the focus; { version_id: null } clears it. An unknown version id is refused rather than stored.\n\n**Rank:** `archon` — Archon only (rank and identity management + the escalation keys — the trust boundary).\n\n**Permissions:** `version.focus.set` (all required).",
+        "x-rank": "archon",
+        "x-source": "modules/lifecycle/routes/versions.js",
+        "x-permissions": [
+          "version.focus.set"
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutVersionsFocusRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PutVersionsFocusResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/versions/progress": {
       "get": {
         "operationId": "get_versions_progress",
@@ -25721,6 +25809,17 @@
           "suggestions"
         ]
       },
+      "GetVersionsFocusResponse": {
+        "type": "object",
+        "properties": {
+          "focus_version_id": {},
+          "can_set": {}
+        },
+        "required": [
+          "focus_version_id",
+          "can_set"
+        ]
+      },
       "GetVersionsIdDoneWhenResponse": {
         "type": "object",
         "properties": {
@@ -31832,6 +31931,29 @@
           "dependencies"
         ]
       },
+      "PutVersionsFocusRequest": {
+        "type": "object",
+        "properties": {
+          "version_id": {
+            "type": "string",
+            "maxLength": 64
+          }
+        },
+        "additionalProperties": false
+      },
+      "PutVersionsFocusResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "focus_version_id": {}
+        },
+        "required": [
+          "ok",
+          "focus_version_id"
+        ]
+      },
       "StringifiableId": {
         "type": [
           "integer",
@@ -31955,9 +32077,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 499,
-  "x-schema-count": 531,
+  "x-endpoint-count": 501,
+  "x-schema-count": 534,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 353,
+  "x-response-schemas": 355,
   "x-generated-by": "scripts/gds/gen-api-docs.js"
 }

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 499 endpoints across 92 route files.
+> **Generated from the live route files** — the route file is authoritative. 501 endpoints across 92 route files.
 > Machine-readable spec: [`docs/api/openapi.json`](api/openapi.json) (OpenAPI 3.1). Rendered docs site: **`/docs`** (e.g. `cloudbongos.com/docs`).
 
 Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust-boundary-server-enforced-permissions.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -850,7 +850,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/tasks/peer-votes/feed` | `any-builder` | — | GET /tasks/peer-votes/feed — recent confirmed/shipped work by OTHER builders, each with its net vote total and the caller's own current v… |
 | POST | `/api/bongos/tasks/peer-votes/tally` | `metic+archon` | — | POST /tasks/peer-votes/tally — fold matured votes (≥7 days old, not yet counted) into karma_log, one net row per shipping builder, then m… |
 
-## `versions` (8)
+## `versions` (10)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -861,6 +861,8 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/versions/:id/done-when` | `metic+archon` | `criterion_id`, `criterion_md`, `goal_id`, `sort_order` | Auth (Metic+, then the goal's own authority): create a done-when criterion at RUNTIME. |
 | GET | `/api/bongos/versions/:id/progress` | `public` | — | Per-criterion progress rollup: each done-when criterion → the tasks that gate it (task_criteria, migration 055) → live statuses → what re… |
 | GET | `/api/bongos/versions/close-suggestions` | `public` | — | Close-flow gate suggestions for every version still 'building'. |
+| GET | `/api/bongos/versions/focus` | `any-builder` | — | The project's focus version (task 1004551) — the one the Roadmap stars. |
+| PUT | `/api/bongos/versions/focus` | `archon` | `version_id` | (atom version.focus.set, system) — body { version_id } sets the focus; { version_id: null } clears it. |
 | GET | `/api/bongos/versions/progress` | `public` | — | read-only progress aggregate; mirrors /public/progress. |
 
 ## `work-categories` (3)