@bongos/core 1.21.81 → 1.21.82

package/.bongos-core.json

@@ -2,11 +2,11 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.21.81",
-  "core_contract": "1.21.81",
-  "source_commit": "cf13896f2510e85aa87ab7ad8fbe400a57f37d54",
+  "core_version": "1.21.82",
+  "core_contract": "1.21.82",
+  "source_commit": "5157c0502abba58054792a039d6be72b3a26509d",
   "source_ref": "HEAD",
-  "built_at": "2026-10-09T00:28:08.709Z",
+  "built_at": "2026-10-09T00:55:45.104Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 590,
@@ -17,7 +17,7 @@
     "gate": "passed"
   },
   "file_count": 3611,
-  "tree_sha256": "ae8df2494a02571e7e6cdc50e626b98cf07fbb4e76b8c8d9f7f851518dc121e8",
+  "tree_sha256": "d817c1d18f0e8dac8f8058d1eccb31dc74a02ba8b5a9568eea2d1643fa69102a",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -312,12 +312,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "504c4b1a758ed260348029186c42d6a3b418c5ba77ab1e79f26752a78382d639"
+      "sha256": "dca89d0b6d666660f3f20e46c6c6bf23359ed4ab66c6ab2f0a0cf4531b95dc4c"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "ec5ebd7ec8d1789fd600bda1975f2e47c70c0015a4c95726743cfbc3c923755f"
+      "sha256": "f13d2ab747d8335f0549f975572f9f2f52d9448ebf98e9b8f65099e41d9eb6da"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -327,17 +327,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "741c8c61726bdd503113fb2d2b64bbf02ad2abb6a1b7fbe0a8ddc632b6aaabef"
+      "sha256": "637d70956978dbdfdae95d2b60a42a57fa6f873545479e385924ac496d8afcd6"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "b3401e4ba2ef41a422e226c913a7a2d1c919d69091d44694b5935dc98b8e3451"
+      "sha256": "0460f90122f6c8af003d124a2a78fe10048b550450fa3c2cdd6ad3a6823a2734"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "19e6cc103355748ffba25649109b1d7275d2088bedada6006373a3be9a307960"
+      "sha256": "8ec801758d45dfe71cae6dfbb021254dc2be805ad8cce05db488ab0ea57e61d2"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2317,12 +2317,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "a07ae00ebfdd58dd280d94bf6a4961274e11c0de59b3f0e48e5485445b5b7534"
+      "sha256": "4baff611262776013e0750a094dc5f6b8c1b4307d6bd91e5a083ce58f8e6722e"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "e60da6160e7cce0526896f04dad35493c5e27b81df3fa437f1419e284da57fae"
+      "sha256": "c1fcc16388d0127f15a92071d9376e6d52d64f4af08554647bc9919af92bc5a1"
     },
     {
       "path": "docs/architecture.md",
@@ -2347,12 +2347,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "28408a7426fa0bdb7b01b17b47ce5f96ba0d7c3362f2059273405357d674370c"
+      "sha256": "edcb2fbe84fd5dad82e6cb2f881caec590d83dbe3afa1374529778d847073378"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "857a6a515ddfe47e441636556714d8bc527ceab06ffefe06a368a8ead96d190d"
+      "sha256": "fa89d7183576b29739b7f2c8dfbb3479d26e0e5823683200ea7fc85d07c0a939"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2862,7 +2862,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "b32998694f39731350f5e5eff315a2732e48be195f458ccc3de891de9c2442a7"
+      "sha256": "fab60a91e6cd3d7fde02965523e4ad03af1ea9c4391ea66fd82a407446d6f796"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2952,7 +2952,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "1c91405fcccab79ce2b67c9c74ca7114d9c2c1f282e2547e2366f20a5acd417f"
+      "sha256": "522c8f039f00163d8b0733ea5d7383d486b602d5fd168f0b17af7a8b9555f7c6"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4922,7 +4922,7 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "bc95bf1e21ee2c2dc5444a8fdd056893a2883fd8e55e01c7c765e2d69bee2c7b"
+      "sha256": "007879cf473c54146f08e94cc46819645a96df46fd81c8a9016507c661a62a8d"
     },
     {
       "path": "modules/government/decision-board.js",
@@ -5157,7 +5157,7 @@
     {
       "path": "modules/government/routes/government.js",
       "mode": "0000644",
-      "sha256": "6bc11f4cff85844a8060d3ec688d3d608165d741f7da055d63fe8bf59c65a519"
+      "sha256": "52bd577d606e072982545d91e4a05a94160cfedcf9e07ffdc90f06b75f0aeee1"
     },
     {
       "path": "modules/government/routes/rank-sync.js",
@@ -5802,7 +5802,7 @@
     {
       "path": "modules/hall-ui/public/government.js",
       "mode": "0000644",
-      "sha256": "48416dc959b5e332cc38b5802cfc5e516ac10be760b68ee41b68037b4b3756ec"
+      "sha256": "42f8f87beb364c4bd69e0ff00bd98bbdc055fac8b24cd2aa499831d69c66c16c"
     },
     {
       "path": "modules/hall-ui/public/government.states.json",
@@ -10087,12 +10087,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "f8c13471f23a50668aa5ec8c79f68f3e039be8e38ec84510551b69637b16f699"
+      "sha256": "8779f587531930440d4848e41db4cb441050b0f20555aa3e2d941183d0e728e6"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "257169d46b1ec312f90e5062c1dc92d85f865608a14f06173cf2110b6b3abe79"
+      "sha256": "b5d732d5c5ec5ff93462030a889b988d56241a6fc1662a686ed07e5768c6611b"
     },
     {
       "path": "public-docs/index.html",
@@ -10112,7 +10112,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "4aca4ff0ed7bb607cde50892af1d128ac444fe5e8f823b8587f559414f14da01"
+      "sha256": "ac161212dd9e3a62494e433c42a6ce9852b34fda18e4bc22fe5ea5acc872a22c"
     },
     {
       "path": "scripts/cron/style_guide_audit.sh",
@@ -12197,7 +12197,7 @@
     {
       "path": "src/bongos/route-rank-check.js",
       "mode": "0000644",
-      "sha256": "bfe24c17a7f63f0d0dc59f3d50b298e0f09b86eabf79e74140b56b67f157a684"
+      "sha256": "7e72321c1485cd071f4d82cae5263443a529af27becf413c60a61c090d2862b9"
     },
     {
       "path": "src/bongos/routes.js",
@@ -12362,7 +12362,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "02c4342378ad3dd61bd2bb44b0c2e8077a45d1388cbe16cabce84038ac188f56"
+      "sha256": "b0db033bc19ccd98809d084e7aa15c262f1848eeaef26f654dd44c65fab5d361"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -14432,7 +14432,7 @@
     {
       "path": "tests/government_routes.mjs",
       "mode": "0000644",
-      "sha256": "c5bc4a05509f2dc26064f9d8fa2c2e0ab156f269c340a9623ebed5e96c935142"
+      "sha256": "5ad02edb432d636f8d02a79e75447199278d169ffe5587db905fe557ecfdd3fd"
     },
     {
       "path": "tests/government_seed.mjs",

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`)
-- 531 operations across 75 resource groups
+- 532 operations across 75 resource groups
 
 ## Use it from your project
 

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

@@ -531,6 +531,8 @@ function createClient(opts = {}) {
       getGovernmentRanks: (args) => request("GET", "/government/ranks", { hasBody: false }, args),
       // POST /government/ranks — rank: archon — POST /government/ranks
       postGovernmentRanks: (args) => request("POST", "/government/ranks", { hasBody: true }, args),
+      // DELETE /government/ranks/{rankKey} — rank: archon — DELETE /government/ranks/:rankKey
+      deleteGovernmentRanksRankKey: (args) => request("DELETE", "/government/ranks/{rankKey}", { hasBody: false }, args),
       // DELETE /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon — DELETE /government/ranks/:rankKey/permissions/:permissionKey
       deleteGovernmentRanksRankKeyPermissionsPermissionKey: (args) => request("DELETE", "/government/ranks/{rankKey}/permissions/{permissionKey}", { hasBody: false }, args),
       // PUT /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon — PUT /government/ranks/:rankKey/permissions/:permissionKey

package/clients/bongos-client/index.cjs

@@ -530,6 +530,8 @@ function createClient(opts = {}) {
       getGovernmentRanks: (args) => request("GET", "/government/ranks", { hasBody: false }, args),
       // POST /government/ranks — rank: archon — POST /government/ranks
       postGovernmentRanks: (args) => request("POST", "/government/ranks", { hasBody: true }, args),
+      // DELETE /government/ranks/{rankKey} — rank: archon — DELETE /government/ranks/:rankKey
+      deleteGovernmentRanksRankKey: (args) => request("DELETE", "/government/ranks/{rankKey}", { hasBody: false }, args),
       // DELETE /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon — DELETE /government/ranks/:rankKey/permissions/:permissionKey
       deleteGovernmentRanksRankKeyPermissionsPermissionKey: (args) => request("DELETE", "/government/ranks/{rankKey}/permissions/{permissionKey}", { hasBody: false }, args),
       // PUT /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon — PUT /government/ranks/:rankKey/permissions/:permissionKey

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

@@ -11,6 +11,7 @@ export interface DeleteConnectionsIdResponse { outcome: unknown }
 export interface DeleteDependenciesResponse { ok: boolean }
 export interface DeleteGovernmentAssignmentsBuilderIdRankKeyResponse { ok: boolean; builder_id: unknown; rank_key: unknown; removed: unknown }
 export interface DeleteGovernmentRanksRankKeyPermissionsPermissionKeyResponse { ok: boolean; rank_key: unknown; permission_key: unknown; removed: unknown }
+export interface DeleteGovernmentRanksRankKeyResponse { ok: boolean; rank_key: unknown; deleted: boolean }
 export interface DeleteGuildRequestsIdResponse { outcome: unknown }
 export interface DeleteGuildsSlugMembersHandleResponse { outcome: unknown }
 export interface DeleteGuildsSlugMembershipResponse { outcome: unknown }
@@ -1037,6 +1038,8 @@ export interface BongosClient {
     getGovernmentRanks(args?: RequestArgs): Promise<GetGovernmentRanksResponse>;
     /** POST /government/ranks — rank: archon */
     postGovernmentRanks(args: RequestArgs & { body: PostGovernmentRanksRequest }): Promise<PostGovernmentRanksResponse>;
+    /** DELETE /government/ranks/{rankKey} — rank: archon */
+    deleteGovernmentRanksRankKey(args?: RequestArgs): Promise<DeleteGovernmentRanksRankKeyResponse>;
     /** DELETE /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon */
     deleteGovernmentRanksRankKeyPermissionsPermissionKey(args?: RequestArgs): Promise<DeleteGovernmentRanksRankKeyPermissionsPermissionKeyResponse>;
     /** PUT /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon */

package/clients/bongos-client/index.mjs

@@ -527,6 +527,8 @@ export function createClient(opts = {}) {
       getGovernmentRanks: (args) => request("GET", "/government/ranks", { hasBody: false }, args),
       // POST /government/ranks — rank: archon — POST /government/ranks
       postGovernmentRanks: (args) => request("POST", "/government/ranks", { hasBody: true }, args),
+      // DELETE /government/ranks/{rankKey} — rank: archon — DELETE /government/ranks/:rankKey
+      deleteGovernmentRanksRankKey: (args) => request("DELETE", "/government/ranks/{rankKey}", { hasBody: false }, args),
       // DELETE /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon — DELETE /government/ranks/:rankKey/permissions/:permissionKey
       deleteGovernmentRanksRankKeyPermissionsPermissionKey: (args) => request("DELETE", "/government/ranks/{rankKey}/permissions/{permissionKey}", { hasBody: false }, args),
       // PUT /government/ranks/{rankKey}/permissions/{permissionKey} — rank: archon — PUT /government/ranks/:rankKey/permissions/:permissionKey

package/docs/api/openapi.json

@@ -9255,6 +9255,61 @@
         ]
       }
     },
+    "/government/ranks/{rankKey}": {
+      "delete": {
+        "operationId": "delete_government_ranks_rankKey",
+        "tags": [
+          "government"
+        ],
+        "summary": "DELETE /government/ranks/:rankKey",
+        "description": "government.manage — delete a CUSTOM rank (task 1004481). Ranks added from a recommended set used to be permanent; the owner hesitated to try one for exactly that reason. Three refusals, each naming what to do: - a seeded rank, never (`seeded_rank_immutable`) — the ladder is the system; - a rank someone still holds (`rank_still_held`, with the holders) — owner decision 2026-10-08: no auto-unassign, so nobody loses a rank as a side effect of a cleanup; - a rank the constitution or the who-decides table seats (`rank_in_use_by_government`) — deleting it would leave that seat empty, and only an amendment may change who decides.\n\n**Rank:** `archon` — Archon only (rank and identity management + the escalation keys — the trust boundary).\n\n**Permissions:** `government.manage` (all required).",
+        "x-rank": "archon",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "government.manage"
+        ],
+        "parameters": [
+          {
+            "name": "rankKey",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `rankKey`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteGovernmentRanksRankKeyResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/government/ranks/{rankKey}/permissions/{permissionKey}": {
       "put": {
         "operationId": "put_government_ranks_rankKey_permissions_permissionKey",
@@ -25060,6 +25115,23 @@
           "removed"
         ]
       },
+      "DeleteGovernmentRanksRankKeyResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "rank_key": {},
+          "deleted": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "ok",
+          "rank_key",
+          "deleted"
+        ]
+      },
       "DeleteGuildRequestsIdResponse": {
         "type": "object",
         "properties": {
@@ -34107,9 +34179,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 531,
-  "x-schema-count": 573,
+  "x-endpoint-count": 532,
+  "x-schema-count": 574,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 379,
+  "x-response-schemas": 380,
   "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. 531 endpoints across 93 route files.
+> **Generated from the live route files** — the route file is authoritative. 532 endpoints across 93 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`.
@@ -341,7 +341,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/goals/rollups` | `any-builder` | — | GET /goals/rollups?version= — one small row per goal: readiness counters, the last-activity timestamp, the craft set, and the next claima… |
 | GET | `/api/bongos/goals/suggestions` | `any-builder` | — | GET /goals/suggestions — "which goal should this draft live in?", answered before anything is created (task 1003062 / R07). |
 
-## `government` (20)
+## `government` (21)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -362,6 +362,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/government/rank-sets/apply` | `archon` | `type`, `headcount` | government.manage — add a RECOMMENDED RANK SET (task 1004400): the custom ranks recommendations.js names for a project type and size, eac… |
 | GET | `/api/bongos/government/ranks` | `archon` | — | government.manage — the full rank list with each rank's grants. |
 | POST | `/api/bongos/government/ranks` | `archon` | `rank_key`, `label`, `description` | government.manage — create a CUSTOM rank (is_system false, no seeded_rank — the seeded four exist only via governance_002). |
+| DELETE | `/api/bongos/government/ranks/:rankKey` | `archon` | — | government.manage — delete a CUSTOM rank (task 1004481). |
 | PUT | `/api/bongos/government/ranks/:rankKey/permissions/:permissionKey` | `archon` | — | government.manage — grant one permission to a rank (the toggle's ON half). |
 | DELETE | `/api/bongos/government/ranks/:rankKey/permissions/:permissionKey` | `archon` | — | government.manage — revoke a grant (the toggle's OFF half). |
 | POST | `/api/bongos/government/ranks/:rankKey/reset` | `archon` | — | government.manage — restore a SEEDED rank to its catalog default (ADR 0172). |