@bongos/core 1.21.112 → 1.21.114

package/docs/api/openapi.json

@@ -2388,7 +2388,7 @@
           "blockers"
         ],
         "summary": "POST /blockers",
-        "description": "FILE a blocker (contribution, not resolution).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "description": "FILE a blocker (contribution, not resolution). Body: { title, body_md?, source?, source_ref?, ask? } — `ask` is the card a person answers (task 1004703, see THE ASK above); a slop ask files nothing (400 `ask_refused`). An AI session filing by hand (a CLI session, any `source` but a templated script's) must send one: without it, 400 `ask_required` (task 1004704). → 201 { blocker, ask } (ask: the stored card, or null).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
         "x-rank": "any-builder",
         "x-source": "modules/ideas/routes/blockers.js",
         "requestBody": {
@@ -8554,6 +8554,168 @@
         ]
       }
     },
+    "/government/asks/check": {
+      "post": {
+        "operationId": "post_government_asks_check",
+        "tags": [
+          "government"
+        ],
+        "summary": "POST /government/asks/check",
+        "description": "board.vote.cast — CHECK an ask without storing it (task 1004703): the agent's dry run before it files. Answers the same verdict a write would: { ok: true, ask } (the stored form), or 400 `ask_refused` whose message says in plain words what to fix and whose details list every broken rule. Writes nothing and reads nothing; the docket's own atom (xenos floor), like the write. Body: the ask — { question, options: [{ key, label, result, act? }], recommend: { key, why }, waits_on, if_nobody_answers, detail? } — bare, or as { ask }.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostGovernmentAsksCheckResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/asks/{matterId}": {
+      "put": {
+        "operationId": "put_government_asks_matterId",
+        "tags": [
+          "government"
+        ],
+        "summary": "PUT /government/asks/:matterId",
+        "description": "board.vote.cast — put an ASK on a docket matter (task 1004703): the one shape every request from an agent to a person takes. The matter is named by its docket id (`blockers:12`, `board:34`); the writer must hold the docket's atom AND see the matter, through the same per-source gate the docket applies (docket.findMatter), so an ask is never written onto a matter its writer cannot see. A slop ask is refused (400 `ask_refused`, every fix named) and nothing is stored. A second PUT replaces the ask whole. Body: the ask (as POST /government/asks/check). → 200 { ok, matter_id, ask }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "parameters": [
+          {
+            "name": "matterId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `matterId`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PutGovernmentAsksMatterIdResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/asks/{matterId}/pass": {
+      "post": {
+        "operationId": "post_government_asks_matterId_pass",
+        "tags": [
+          "government"
+        ],
+        "summary": "POST /government/asks/:matterId/pass",
+        "description": "board.vote.cast — PASS AN ASK ON to another seat (task 1004705, the direction desk). Only whoever the ask waits on today may hand it on (routing.passRefusal, from real seats: its Lead, the owner seat, a board's holders), and only an ask that is stored; a board sitting is its voters' and is never passed. The ask is kept word for word; only its seat changes, so it leaves the passer's \"to do\" and lands on the new seat's. Body: { seat } → 200 { ok, matter_id, ask, route }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "parameters": [
+          {
+            "name": "matterId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `matterId`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostGovernmentAsksMatterIdPassRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostGovernmentAsksMatterIdPassResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/government/assignments": {
       "get": {
         "operationId": "get_government_assignments",
@@ -9038,25 +9200,25 @@
         ]
       }
     },
-    "/government/board/matters": {
+    "/government/board/laws": {
       "post": {
-        "operationId": "post_government_board_matters",
+        "operationId": "post_government_board_laws",
         "tags": [
           "government"
         ],
-        "summary": "POST /government/board/matters",
-        "description": "board.item.open — put a MATTER to a building's sitting (task 1004529): the board's new subjects, one per building other than the charter. Refused unless the building's row names a sitting — under the default rows every building is decided as today and this route opens nothing. The sitting is snapshotted from the row (who and how). Body: { area, title, detail_md?, action? } action (People only): { type: 'assign_rank' | 'unassign_rank', builder_id, rank_key } — carried out when the sitting passes, under the same walls as the direct route.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `board.item.open` (all required).",
+        "summary": "POST /government/board/laws",
+        "description": "board.item.open — propose a change to the project's LAWS (task 1004706): laws to enact, laws in force to repeal, or both, filed as an amendment of kind 'laws' and sat under the constitution IN FORCE, like every amendment. Nothing here writes a law — only the sitting passing does, inside its closing transaction. The same atom as proposing any amendment. Body: { enact?: [{ text, effect_on_ai?, locks? }], repeal?: [law id], rationale_md? } text one line, 3-100 characters: what every agent obeys effect_on_ai one line, at most 200: what it means for an agent locks at most 8 of { setting, value } (fixes it) or { setting, max } (caps it)\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `board.item.open` (all required).",
         "x-rank": "metic+archon",
         "x-source": "modules/government/routes/government.js",
         "x-permissions": [
           "board.item.open"
         ],
         "requestBody": {
-          "required": true,
+          "required": false,
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/PostGovernmentBoardMattersRequest"
+                "$ref": "#/components/schemas/PostGovernmentBoardLawsRequest"
               }
             }
           },
@@ -9068,7 +9230,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/PostGovernmentBoardMattersResponse"
+                  "$ref": "#/components/schemas/PostGovernmentBoardLawsResponse"
                 }
               }
             }
@@ -9090,59 +9252,43 @@
         ]
       }
     },
-    "/government/constitution": {
-      "get": {
-        "operationId": "get_government_constitution",
+    "/government/board/matters": {
+      "post": {
+        "operationId": "post_government_board_matters",
         "tags": [
           "government"
         ],
-        "summary": "GET /government/constitution",
-        "description": "board.vote.cast — the Constitution view (R18 of goal 1000069): the live board block plus the full amendment history, passed and returned alike. Same atom as the room — reading the rule you vote under is part of casting, and the section teaches (criterion C5). The live value resolves fresh per request, so an amendment applied a moment ago reads back immediately (the same instant-effect posture as everything else here).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
-        "x-rank": "any-builder",
+        "summary": "POST /government/board/matters",
+        "description": "board.item.open — put a MATTER to a building's sitting (task 1004529): the board's new subjects, one per building other than the charter. Refused unless the building's row names a sitting — under the default rows every building is decided as today and this route opens nothing. The sitting is snapshotted from the row (who and how). Body: { area, title, detail_md?, action? } action (People only): { type: 'assign_rank' | 'unassign_rank', builder_id, rank_key } — carried out when the sitting passes, under the same walls as the direct route; or { type: 'appoint_lead', building, builder_id, charter? } | { type: 'remove_lead', building } (task 1004709) — the Lead of a building. Where People is decided as today this one matter sits under the board in force instead of refusing. Or, at any building, { type: 'build_out', building, capsule, name?, line? } (task 1004711) — a build-out put to a vote; POST /government/buildouts files it for the holder.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `board.item.open` (all required).",
+        "x-rank": "metic+archon",
         "x-source": "modules/government/routes/government.js",
         "x-permissions": [
-          "board.vote.cast"
+          "board.item.open"
         ],
-        "responses": {
-          "200": {
-            "description": "Success."
-          },
-          "400": {
-            "$ref": "#/components/responses/BadRequest"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostGovernmentBoardMattersRequest"
+              }
+            }
           },
-          "403": {
-            "$ref": "#/components/responses/Forbidden"
-          }
+          "x-validated": true
         },
-        "security": [
-          {
-            "builderSession": []
-          }
-        ]
-      }
-    },
-    "/government/docket": {
-      "get": {
-        "operationId": "get_government_docket",
-        "tags": [
-          "government"
-        ],
-        "summary": "GET /government/docket",
-        "description": "board.vote.cast — the governor's DOCKET (task 1004523, goal 1000125): ONE read of every matter waiting on, or moving for, a governor, which the Governor City screens all draw from. Same coarse atom as the room (xenos floor: whoever the constitution may enfranchise may open the city); the real scoping is PER SOURCE, inside docket.js — each source is shown only to a viewer holding the same atom its own list route requires, and a hidden source reports `not_yours` with no rows (ADR 0016, server-side, uncached). Response (docket.buildDocket): { viewer: { id }, generated_at, line, // \"3 matters wait on you · 2 moving\" counts: { needs, moving, settled }, matters: [{ id: '<source>:<id>', source, building, rule, state, title, short, where, opened_at, deadline, proposer: { id, login, name } | null, tally: { for, against, open, needs } | null, href, ref }], buildings: [{ key, name, group, counts, matter_ids }], // street order sources: [{ source, building, label, status, count, reason }], // status: live | not_yours | coming | off | unavailable readings: [{ key, label, building, status, value, figure, line, hot, reason }], vocabulary: { buildings, rules, states } } `building` ∈ charter rules disputes people planning automation review release treasury; `rule` ∈ decide first consent majority unanimous signoff rule (or null); `state` ∈ needs moving settled. Nothing is ever sample data: a source with nothing recorded yet is `coming`, never a placeholder row.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
-        "x-rank": "any-builder",
-        "x-source": "modules/government/routes/government.js",
-        "x-permissions": [
-          "board.vote.cast"
-        ],
         "responses": {
           "200": {
-            "description": "Success."
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostGovernmentBoardMattersResponse"
+                }
+              }
+            }
           },
           "400": {
-            "$ref": "#/components/responses/BadRequest"
+            "$ref": "#/components/responses/ValidationFailed"
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
@@ -9158,32 +9304,43 @@
         ]
       }
     },
-    "/government/permissions": {
-      "get": {
-        "operationId": "get_government_permissions",
+    "/government/board/presets": {
+      "post": {
+        "operationId": "post_government_board_presets",
         "tags": [
           "government"
         ],
-        "summary": "GET /government/permissions",
-        "description": "government.manage — the permission catalog + principals, straight from code (the catalog is CODE, not a table); no DB read. Principals are read-only by construction. Three flags the tab renders its locks from, and the tab must read all three rather than just `grantable`, because since ADR 0172 grantability depends on WHICH rank is selected: • `grantable` — the CUSTOM-rank answer (system:false). Unchanged meaning. • `system` — an in-app Archon power: locked on a custom rank, togglable on a sub-Archon rank. • `substrate` — locked EVERYWHERE, on every rank, forever (ADR 0043).\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",
+        "summary": "POST /government/board/presets",
+        "description": "board.item.open — SWITCH the project's strictness preset (task 1004715). A switch is a vote: ONE laws amendment (the same path as POST /government/board/laws) that enacts the preset's laws not in force and repeals the other presets' laws that are. Nothing here writes a law; only the sitting passing does. The same atom as proposing any law. Body: { preset: 'open' | 'guild' | 'factory' }\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `board.item.open` (all required).",
+        "x-rank": "metic+archon",
         "x-source": "modules/government/routes/government.js",
         "x-permissions": [
-          "government.manage"
+          "board.item.open"
         ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostGovernmentBoardPresetsRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
         "responses": {
           "200": {
             "description": "Success.",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetGovernmentPermissionsResponse"
+                  "$ref": "#/components/schemas/PostGovernmentBoardPresetsResponse"
                 }
               }
             }
           },
           "400": {
-            "$ref": "#/components/responses/BadRequest"
+            "$ref": "#/components/responses/ValidationFailed"
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
@@ -9199,25 +9356,25 @@
         ]
       }
     },
-    "/government/rank-sets/apply": {
+    "/government/buildouts": {
       "post": {
-        "operationId": "post_government_rank_sets_apply",
+        "operationId": "post_government_buildouts",
         "tags": [
           "government"
         ],
-        "summary": "POST /government/rank-sets/apply",
-        "description": "government.manage — add a RECOMMENDED RANK SET (task 1004400): the custom ranks recommendations.js names for a project type and size, each with its grants. It is the create form and the grant toggle run in a loop, under the same checks: a rank that already exists is LEFT ALONE (never re-granted, never relabelled — an owner may have edited it), and every grant is re-checked with catalog.isGrantableTo, so a set can never write what the toggle would refuse. Re-applying is safe; the reply says what was added.\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",
+        "summary": "POST /government/buildouts",
+        "description": "board.vote.cast — a Lead's BUILD-OUT (task 1004711, ADR 0378): a committee room, a new floor, an annex, or growing the building into a district. The coarse atom is the room's (every builder who reads the Leads); the wall is server-side and per request: only the building's HOLDER — its Lead in office, or the owner seat (every active Archon) when it is unseated — may ask (403 not_the_holder). build_rights (build-rights.js, the one rule) then decides: at once → 201 { path: 'at_once', buildout }, on the record now and drawn as a live site; otherwise → 201 { path: 'vote', matter, item }, filed as a build_out matter through the same openMatter the matters route runs, drawn as a ghost with the sitting's tally until it closes. Body: { building, capsule: committee|floor|annex|district, name?, line? }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
         "x-source": "modules/government/routes/government.js",
         "x-permissions": [
-          "government.manage"
+          "board.vote.cast"
         ],
         "requestBody": {
           "required": true,
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/PostGovernmentRankSetsApplyRequest"
+                "$ref": "#/components/schemas/PostGovernmentBuildoutsRequest"
               }
             }
           },
@@ -9229,7 +9386,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/PostGovernmentRankSetsApplyResponse"
+                  "$ref": "#/components/schemas/PostGovernmentBuildoutsResponse"
                 }
               }
             }
@@ -9251,15 +9408,312 @@
         ]
       }
     },
-    "/government/ranks": {
+    "/government/constitution": {
       "get": {
-        "operationId": "get_government_ranks",
+        "operationId": "get_government_constitution",
         "tags": [
           "government"
         ],
-        "summary": "GET /government/ranks",
-        "description": "government.manage — the full rank list with each rank's grants.\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",
+        "summary": "GET /government/constitution",
+        "description": "board.vote.cast — the Constitution view (R18 of goal 1000069): the live board block plus the full amendment history, passed and returned alike. Same atom as the room — reading the rule you vote under is part of casting, and the section teaches (criterion C5). The live value resolves fresh per request, so an amendment applied a moment ago reads back immediately (the same instant-effect posture as everything else here).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/counts": {
+      "get": {
+        "operationId": "get_government_counts",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/counts",
+        "description": "board.vote.cast — the government's COUNTS in one read (task 1004716): what is on the viewer (\"to do\"), what waits on others, what is to decide, how many agents are working and how much is moving. The docket's own atom and its own per-source gates (counts.countsFor reads the docket this viewer would), so a count never includes a matter the viewer could not see. Response: { viewer: { id }, generated_at, on_you, on_others, open, agents_at_work, moving, routed, yours: [matter id], others: [matter id] } (a figure that could not be read is null, never 0).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/docket": {
+      "get": {
+        "operationId": "get_government_docket",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/docket",
+        "description": "board.vote.cast — the governor's DOCKET (task 1004523, goal 1000125): ONE read of every matter waiting on, or moving for, a governor, which the Governor City screens all draw from. Same coarse atom as the room (xenos floor: whoever the constitution may enfranchise may open the city); the real scoping is PER SOURCE, inside docket.js — each source is shown only to a viewer holding the same atom its own list route requires, and a hidden source reports `not_yours` with no rows (ADR 0016, server-side, uncached). Response (docket.buildDocket): { viewer: { id }, generated_at, line, // \"3 matters wait on you · 2 moving\" counts: { needs, moving, settled }, matters: [{ id: '<source>:<id>', source, building, rule, state, title, short, where, opened_at, deadline, proposer: { id, login, name } | null, tally: { for, against, open, needs } | null, href, ref, ask?: { question, options, recommend, waits_on, // task 1004703: if_nobody_answers, detail, written_at } }], // the stored ask buildings: [{ key, name, group, counts, matter_ids }], // street order sources: [{ source, building, label, status, count, reason }], // status: live | not_yours | coming | off | unavailable readings: [{ key, label, building, status, value, figure, line, hot, reason }], vocabulary: { buildings, rules, states } } `building` ∈ charter rules disputes people planning automation review release treasury; `rule` ∈ decide first consent majority unanimous signoff rule (or null); `state` ∈ needs moving settled. Nothing is ever sample data: a source with nothing recorded yet is `coming`, never a placeholder row.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/laws": {
+      "get": {
+        "operationId": "get_government_laws",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/laws",
+        "description": "board.vote.cast — the law book (task 1004706): every law in force, oldest first, each with who passed it (the government it was decided under, its proposer, who said yes, the sitting) and when. ?include=repealed adds the laws repealed since, with when and by which sitting. Every builder's agents obey these, so the read floors where the room's does. A read; nothing here writes a law.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/leads": {
+      "get": {
+        "operationId": "get_government_leads",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/leads",
+        "description": "board.vote.cast — the Lead of each building (task 1004709): the nine buildings in street order, each with its Lead in office (who, their charter, since when, the sitting that appointed them) or null, and who answers for it — its Lead, or the owner (every active Archon, the founding one first) when it is unseated. ?include=past adds the appointments that have ended. A read; a Lead is appointed and removed only by a passed People matter (POST /government/board/matters, action appoint_lead or remove_lead).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/permissions": {
+      "get": {
+        "operationId": "get_government_permissions",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/permissions",
+        "description": "government.manage — the permission catalog + principals, straight from code (the catalog is CODE, not a table); no DB read. Principals are read-only by construction. Three flags the tab renders its locks from, and the tab must read all three rather than just `grantable`, because since ADR 0172 grantability depends on WHICH rank is selected: • `grantable` — the CUSTOM-rank answer (system:false). Unchanged meaning. • `system` — an in-app Archon power: locked on a custom rank, togglable on a sub-Archon rank. • `substrate` — locked EVERYWHERE, on every rank, forever (ADR 0043).\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"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetGovernmentPermissionsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/presets": {
+      "get": {
+        "operationId": "get_government_presets",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/presets",
+        "description": "board.vote.cast — HOW STRICT the project runs its agents (task 1004715): the three strictness presets (Open workshop, Guild, Factory), which one the laws in force amount to (read, never stored: null when none), and for each its laws and the locks a switch to it would leave in force. A read.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/rank-sets/apply": {
+      "post": {
+        "operationId": "post_government_rank_sets_apply",
+        "tags": [
+          "government"
+        ],
+        "summary": "POST /government/rank-sets/apply",
+        "description": "government.manage — add a RECOMMENDED RANK SET (task 1004400): the custom ranks recommendations.js names for a project type and size, each with its grants. It is the create form and the grant toggle run in a loop, under the same checks: a rank that already exists is LEFT ALONE (never re-granted, never relabelled — an owner may have edited it), and every grant is re-checked with catalog.isGrantableTo, so a set can never write what the toggle would refuse. Re-applying is safe; the reply says what was added.\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"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostGovernmentRankSetsApplyRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostGovernmentRankSetsApplyResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/ranks": {
+      "get": {
+        "operationId": "get_government_ranks",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/ranks",
+        "description": "government.manage — the full rank list with each rank's grants.\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"
@@ -9534,32 +9988,191 @@
         "x-rank": "archon",
         "x-source": "modules/government/routes/government.js",
         "x-permissions": [
-          "government.manage"
+          "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/PostGovernmentRanksRankKeyResetResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/treasury": {
+      "get": {
+        "operationId": "get_government_treasury",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/treasury",
+        "description": "board.vote.cast — THE TREASURY (task 1004712, ADR 0379): this month's real spend and last month's, the spend cap (a project setting, off by default: no limit), the reserve, and every open goal's pot — its budget, what the reserve lent it this month, its real spend this month (cost_log through the goal's tasks) and its borrow, if it asked. Plus who answers for the Treasury today. A read; the room's atom, as GET /government/leads.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/treasury/borrows/{borrowId}/answer": {
+      "post": {
+        "operationId": "post_government_treasury_borrows_borrowId_answer",
+        "tags": [
+          "government"
+        ],
+        "summary": "POST /government/treasury/borrows/:borrowId/answer",
+        "description": "board.vote.cast — ANSWER A BORROW: lend it all, lend half, or say no. The room's atom; the wall is the direction desk's: only whoever the borrow's ask waits on today may answer it (routing.routeMatter over real seats: the Treasury's Lead, or the owner seat while it is unseated, or the seat it was passed to). Answered once; a second answer is 409. Saying no stops nothing: with no spend limit, work runs on and the overspend is debt. Body: { key: 'lend' | 'half' | 'no' } → 200 { ok, borrow }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "parameters": [
+          {
+            "name": "borrowId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `borrowId`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostGovernmentTreasuryBorrowsBorrowIdAnswerRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostGovernmentTreasuryBorrowsBorrowIdAnswerResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/government/treasury/pots/{goalId}": {
+      "put": {
+        "operationId": "put_government_treasury_pots_goalId",
+        "tags": [
+          "government"
+        ],
+        "summary": "PUT /government/treasury/pots/:goalId",
+        "description": "board.vote.cast — GIVE A GOAL A POT, change its budget, or take it away (budget_usd: null). The room's atom; the wall is server-side and per request: only whoever answers for the Treasury today — its Lead, or the owner seat while it is unseated — may (403 not_the_holder). Only an open goal. Body: { budget_usd: number | null } → 200 { ok, pot | removed }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
         ],
         "parameters": [
           {
-            "name": "rankKey",
+            "name": "goalId",
             "in": "path",
             "required": true,
             "schema": {
               "type": "string"
             },
-            "description": "Path parameter `rankKey`."
+            "description": "Path parameter `goalId`."
           }
         ],
-        "responses": {
-          "200": {
-            "description": "Success.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PostGovernmentRanksRankKeyResetResponse"
-                }
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutGovernmentTreasuryPotsGoalIdRequest"
               }
             }
           },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
           "400": {
-            "$ref": "#/components/responses/BadRequest"
+            "$ref": "#/components/responses/ValidationFailed"
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
@@ -15957,6 +16570,58 @@
         ]
       }
     },
+    "/project-settings/spend-cap": {
+      "patch": {
+        "operationId": "patch_project_settings_spend_cap",
+        "tags": [
+          "project-settings"
+        ],
+        "summary": "PATCH /project-settings/spend-cap",
+        "description": "PATCH /project-settings/spend-cap — body { usd: number | null } (task 1004712, ADR 0379). The owner's ruling: NO spend limit by default; a cap is this optional setting, off until set. null turns it off (the row is deleted). rank: project.settings.manage (metic+, government_010), the same atom as the other writes on this page; who decides at the Treasury may put it to a sitting (requireActAlone). GET /government/treasury reads it back as `cap`.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `project.settings.manage` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "modules/lifecycle/routes/project-settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PatchProjectSettingsSpendCapRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PatchProjectSettingsSpendCapResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/project-settings/tweak-autopickup": {
       "get": {
         "operationId": "get_project_settings_tweak_autopickup",
@@ -28472,6 +29137,30 @@
           "sentence"
         ]
       },
+      "PatchProjectSettingsSpendCapRequest": {
+        "type": "object",
+        "properties": {
+          "usd": {}
+        },
+        "additionalProperties": false
+      },
+      "PatchProjectSettingsSpendCapResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "on": {},
+          "usd": {},
+          "sentence": {}
+        },
+        "required": [
+          "ok",
+          "on",
+          "usd",
+          "sentence"
+        ]
+      },
       "PatchProjectSettingsTweakAutopickupRequest": {
         "type": "object",
         "properties": {
@@ -29262,6 +29951,9 @@
           "source_ref": {
             "type": "string",
             "maxLength": 256
+          },
+          "ask": {
+            "type": "object"
           }
         },
         "required": [
@@ -29276,7 +29968,11 @@
             "type": "boolean"
           },
           "reason": {},
-          "blocker": {}
+          "blocker": {},
+          "ask": {},
+          "ask_saved": {
+            "type": "boolean"
+          }
         }
       },
       "PostClaimsBatchReleaseRequest": {
@@ -30640,6 +31336,54 @@
           "spec_task"
         ]
       },
+      "PostGovernmentAsksCheckResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "ask": {},
+          "question_words": {},
+          "rules": {}
+        },
+        "required": [
+          "ok",
+          "ask",
+          "question_words",
+          "rules"
+        ]
+      },
+      "PostGovernmentAsksMatterIdPassRequest": {
+        "type": "object",
+        "properties": {
+          "seat": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80
+          }
+        },
+        "required": [
+          "seat"
+        ],
+        "additionalProperties": false
+      },
+      "PostGovernmentAsksMatterIdPassResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "matter_id": {},
+          "ask": {},
+          "route": {}
+        },
+        "required": [
+          "ok",
+          "matter_id",
+          "ask",
+          "route"
+        ]
+      },
       "PostGovernmentAssignmentsRequest": {
         "type": "object",
         "properties": {
@@ -30818,6 +31562,39 @@
           "item"
         ]
       },
+      "PostGovernmentBoardLawsRequest": {
+        "type": "object",
+        "properties": {
+          "enact": {
+            "type": "array"
+          },
+          "repeal": {
+            "type": "array"
+          },
+          "rationale_md": {
+            "type": "string",
+            "maxLength": 5000
+          }
+        },
+        "additionalProperties": false
+      },
+      "PostGovernmentBoardLawsResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "amendment": {},
+          "item": {},
+          "proposal": {}
+        },
+        "required": [
+          "ok",
+          "amendment",
+          "item",
+          "proposal"
+        ]
+      },
       "PostGovernmentBoardMattersRequest": {
         "type": "object",
         "properties": {
@@ -30860,6 +31637,83 @@
           "decided"
         ]
       },
+      "PostGovernmentBoardPresetsRequest": {
+        "type": "object",
+        "properties": {
+          "preset": {
+            "type": "string",
+            "maxLength": 32
+          }
+        },
+        "required": [
+          "preset"
+        ],
+        "additionalProperties": false
+      },
+      "PostGovernmentBoardPresetsResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "preset": {},
+          "amendment": {},
+          "item": {},
+          "proposal": {}
+        },
+        "required": [
+          "ok",
+          "preset",
+          "amendment",
+          "item",
+          "proposal"
+        ]
+      },
+      "PostGovernmentBuildoutsRequest": {
+        "type": "object",
+        "properties": {
+          "building": {
+            "type": "string",
+            "maxLength": 32
+          },
+          "capsule": {
+            "type": "string",
+            "maxLength": 32
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 80
+          },
+          "line": {
+            "type": "string",
+            "maxLength": 280
+          }
+        },
+        "required": [
+          "building",
+          "capsule"
+        ],
+        "additionalProperties": false
+      },
+      "PostGovernmentBuildoutsResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "path": {},
+          "buildout": {},
+          "rights": {},
+          "matter": {},
+          "item": {},
+          "decided": {}
+        },
+        "required": [
+          "ok",
+          "path",
+          "rights"
+        ]
+      },
       "PostGovernmentRankSetsApplyRequest": {
         "type": "object",
         "properties": {
@@ -30947,6 +31801,32 @@
           "rank"
         ]
       },
+      "PostGovernmentTreasuryBorrowsBorrowIdAnswerRequest": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "maxLength": 16
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "additionalProperties": false
+      },
+      "PostGovernmentTreasuryBorrowsBorrowIdAnswerResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "borrow": {}
+        },
+        "required": [
+          "ok",
+          "borrow"
+        ]
+      },
       "PostGuildRequestsIdAcceptRequest": {
         "type": "object",
         "properties": {
@@ -34245,6 +35125,21 @@
           "backend_only"
         ]
       },
+      "PutGovernmentAsksMatterIdResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "matter_id": {},
+          "ask": {}
+        },
+        "required": [
+          "ok",
+          "matter_id",
+          "ask"
+        ]
+      },
       "PutGovernmentRanksRankKeyPermissionsPermissionKeyResponse": {
         "type": "object",
         "properties": {
@@ -34262,6 +35157,13 @@
           "granted"
         ]
       },
+      "PutGovernmentTreasuryPotsGoalIdRequest": {
+        "type": "object",
+        "properties": {
+          "budget_usd": {}
+        },
+        "additionalProperties": false
+      },
       "PutMingleOptInRequest": {
         "type": "object",
         "properties": {
@@ -34563,9 +35465,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 541,
-  "x-schema-count": 577,
+  "x-endpoint-count": 555,
+  "x-schema-count": 592,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 382,
+  "x-response-schemas": 390,
   "x-generated-by": "scripts/gds/gen-api-docs.js"
 }