@bongos/core 1.21.34 → 1.21.36

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.21.34",
-  "core_contract": "1.21.34",
-  "source_commit": "d939d974306568b0ad522f60c604fbfcade76007",
+  "core_version": "1.21.36",
+  "core_contract": "1.21.36",
+  "source_commit": "933f741b57ce7ebb18ca7e3e5776347108a812bd",
   "source_ref": "HEAD",
-  "built_at": "2026-10-03T21:33:14.512Z",
+  "built_at": "2026-10-04T13:59:38.309Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 582,
     "agent_docs_stubbed": 27,
-    "functional_verbatim": 2908,
+    "functional_verbatim": 2911,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3518,
-  "tree_sha256": "04811e065d483036054f8d14fc95f12f28a8c4d07abac32b8fd41880b934f0ef",
+  "file_count": 3521,
+  "tree_sha256": "a38e97125c3f3cc9d4838ba6ebffb614c817864570f94a6fa1601a1b41c22093",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -337,7 +337,7 @@
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "8daa0216a1a98d91c1c5430f04a1801d3a5f44159de38c707ae929633f6ec27b"
+      "sha256": "e07a6b252459922dad017a3165d52b0068268509a2ac901f00b6aca6c6eab5e4"
     },
     {
       "path": "clients/bongos-client/index.mjs",
@@ -2292,12 +2292,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "12abe3c6207d5ea31ff769856aea0211f6285193a4fca9af56bb16214d05fd04"
+      "sha256": "73ebc308ec5a5995594da8e28c8866d94660121ab92930b377f35498064f02b9"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "8d3ffd1391e96fcaef1009476a3068d3eca0520bd0237130981ea037743c0d3a"
+      "sha256": "c5dc54ad280fecc902b089a95e43186bd8bcb538bb932683313903c5c1633643"
     },
     {
       "path": "docs/architecture.md",
@@ -2837,7 +2837,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "42ef101bab692519c3f3b26ac5e5f72ad1392448c2d5dd3a52ec502539338522"
+      "sha256": "b4934901fe1c8a2d378ffd799ede0ad0bbb98229a5b2de2e3f2131143da10d0c"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2922,12 +2922,12 @@
     {
       "path": "docs/page-inventory.json",
       "mode": "0000644",
-      "sha256": "b7466fc3fc72e057675f890bb65472f6e79fcb07d342aff486d1e7a2483db17d"
+      "sha256": "0a23e394310d31d7bd5ef94fcaf794075d3def04a7adc190033e582ef5808b20"
     },
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "ce39c79473cd4362cdb2298426a87df6b20e212e80fec05f15f61ed4a830d72b"
+      "sha256": "89973153e39a09b36f68cac4f37774571f4412ae789895431a6aad0a90e142f1"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4172,7 +4172,12 @@
     {
       "path": "modules/autonomy/governor-docket.js",
       "mode": "0000644",
-      "sha256": "8984acba516336f7b8813d37a4cb8c59c7f3157c012210095ad9362d91a6d521"
+      "sha256": "5064722b1ff2605992c4cc2fce7fe456dd536ae4bd973788d8f29ad0dafdf8d3"
+    },
+    {
+      "path": "modules/autonomy/matter-acts.js",
+      "mode": "0000644",
+      "sha256": "d946831aed2413bfa85e790145342e10e21df96dc9a992755c407ed3b2827ec1"
     },
     {
       "path": "modules/autonomy/migrations/autonomy_001_autobongos_fence.sql",
@@ -4212,7 +4217,7 @@
     {
       "path": "modules/autonomy/routes/autonomy.js",
       "mode": "0000644",
-      "sha256": "db671466b7d2bd6e45cf2928a4f1b80c7ad4fe5009c08b0b9e2dd14e4a73c45c"
+      "sha256": "872875e93429b0d7de6b322811a9a86e5698e8bb6717e89bcf769d5fde4ce82b"
     },
     {
       "path": "modules/autonomy/runner-health.js",
@@ -4852,7 +4857,7 @@
     {
       "path": "modules/government/board.js",
       "mode": "0000644",
-      "sha256": "60c586fbc4a7201784c8d10820bc7052aa7f77d43772485fbf8f6d34efedbdd4"
+      "sha256": "fbbc5a9ec8175619469885b6b8aeb4b6ef44b1b5d09550c815611e2e63e070dc"
     },
     {
       "path": "modules/government/catalog.js",
@@ -4872,12 +4877,12 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "33e8a44a1dabb0241d1e707cf4ba61f033d21720082462c2a81d4c16e878df24"
+      "sha256": "39e316a3a9fee74532e75b8c588d8934004a1f00fa61a90d8a3ffb73ae8a5f5d"
     },
     {
       "path": "modules/government/decision-board.js",
       "mode": "0000644",
-      "sha256": "9b4bc765641347db4a41d749185312896abe4c0c1628ccd647f1dd20f2a3afa7"
+      "sha256": "af3c46850f40b8119bc514c2289d697e9b7c4a6c9fc0c389721600dcfccb2968"
     },
     {
       "path": "modules/government/decision-rules.js",
@@ -4887,17 +4892,17 @@
     {
       "path": "modules/government/docket-floors.js",
       "mode": "0000644",
-      "sha256": "bdf710de9523c1221cf597fade1968cfae975f053c667eec802c8e3224cbee5b"
+      "sha256": "2c58e387c091a286d53fc90c11d4f50424c7c04401cdc11cc59ea97df7167e07"
     },
     {
       "path": "modules/government/docket-vocab.js",
       "mode": "0000644",
-      "sha256": "7d567d05fb76d3fdbf2d79864012e7b1d04c3bd755552c33918c5f9fd3613cd8"
+      "sha256": "2893da25d3c4f2c7702279d76cde5e6512b88ab873f226395025bebb62ab81d0"
     },
     {
       "path": "modules/government/docket.js",
       "mode": "0000644",
-      "sha256": "8e71ac202e0e4a40e5a0ffc17b6bd738133cb23d2368c01b883c7d458188efb7"
+      "sha256": "504b2f0a5a5b9c281a068c0f69e99e6afca0ea3d939901f38ffc54be5a2c35ed"
     },
     {
       "path": "modules/government/membership-predicate.js",
@@ -5102,7 +5107,7 @@
     {
       "path": "modules/government/routes/government.js",
       "mode": "0000644",
-      "sha256": "621e677481369bcd5ac9ded0c1c9a9c3d6ed9df8c19ec76c293cc28474adfeeb"
+      "sha256": "22d64cbaf6ecfd0b922a1552915be160974e9941d79192265d8033c537582827"
     },
     {
       "path": "modules/government/routes/rank-sync.js",
@@ -6187,7 +6192,7 @@
     {
       "path": "modules/hall-ui/public/street-card.js",
       "mode": "0000644",
-      "sha256": "3d3f9167fd0566f459111ff06d0d329f305b1f3d5a40ed7d713bad4f7aee08c2"
+      "sha256": "36e0df620d59a86d87b9c209a7a3d223119d656010f3f68b023a30ff75232f14"
     },
     {
       "path": "modules/hall-ui/public/street-card.states.json",
@@ -6197,7 +6202,7 @@
     {
       "path": "modules/hall-ui/public/street-desk.js",
       "mode": "0000644",
-      "sha256": "52180dc2730a83597836d1c44f58f660685f609fa921e202f11376b1850b290e"
+      "sha256": "b2e5226276d02ea495f22abfee7ea8e2de8865798d5c8e4916e7ad62be2a49e5"
     },
     {
       "path": "modules/hall-ui/public/street-draw.js",
@@ -6207,12 +6212,12 @@
     {
       "path": "modules/hall-ui/public/street-inside.js",
       "mode": "0000644",
-      "sha256": "958d265b46ec751cd7c82e828e5820c19784f4cd2683d620d28be8010407b478"
+      "sha256": "6280b350e6a63c9f8647e8cb431a3841ab3c54f5aee283c37d16f2c19f84f611"
     },
     {
       "path": "modules/hall-ui/public/street.css",
       "mode": "0000644",
-      "sha256": "274742582e70386c1dd875c63c8ae2f6856088b1952dfad4b99ef34cf885e940"
+      "sha256": "a15abb51a276582998c63017dd98a2b5210805581b15ebded5f4f94c26c75c5b"
     },
     {
       "path": "modules/hall-ui/public/street.html",
@@ -6222,12 +6227,12 @@
     {
       "path": "modules/hall-ui/public/street.js",
       "mode": "0000644",
-      "sha256": "c9525c383a58e11d3b9151f24c70a212664ceefef32871933d2d3a9c49311e31"
+      "sha256": "96b62eb3244b981203dbf8f6984be984dacd99dc2f1b6c3c3f09c8852a42227f"
     },
     {
       "path": "modules/hall-ui/public/street.states.json",
       "mode": "0000644",
-      "sha256": "d46e639801c06de9846c2748280e8660c98a80499dc9bf3f01108f6c19eaa7c9"
+      "sha256": "8cd197985a74f968c651e68bf07e6b81ea99bccd1573b926ca2c417f0c70e0d7"
     },
     {
       "path": "modules/hall-ui/public/studio-lib.js",
@@ -6532,7 +6537,7 @@
     {
       "path": "modules/ideas/governor-docket.js",
       "mode": "0000644",
-      "sha256": "24a79c7b79419ee1654025778d7661d537376e83a2995c310de3f27e16450593"
+      "sha256": "859f61203672b27ba359bb6f955661c9602c488e2347e311954d6bbe69426c71"
     },
     {
       "path": "modules/ideas/grades.js",
@@ -6962,7 +6967,7 @@
     {
       "path": "modules/lifecycle/governor-docket.js",
       "mode": "0000644",
-      "sha256": "93d428f487c38a7da31e7ac35cbd0254ae14d029b285d03de61b9d42fa812001"
+      "sha256": "2280655cf04add089c6ebc6f5a8a6c4f57540ff8079507c47812ca96ef5c3a9c"
     },
     {
       "path": "modules/lifecycle/help-requests.js",
@@ -6989,6 +6994,11 @@
       "mode": "0000644",
       "sha256": "69e9bf495dfdbc324e7f5664e09a5ad30e6eac896c12656b7d6ecb38d6be81f9"
     },
+    {
+      "path": "modules/lifecycle/matter-acts.js",
+      "mode": "0000644",
+      "sha256": "11d8fb0a4f586e1e84a827e53568b4b1b4edbb512c26ef4b37dee2c6b72ddc9c"
+    },
     {
       "path": "modules/lifecycle/merge-lock.js",
       "mode": "0000644",
@@ -7192,12 +7202,12 @@
     {
       "path": "modules/lifecycle/routes/done-when.js",
       "mode": "0000644",
-      "sha256": "a6adbf715fb5f2994a0f4603859e5047b321311b66e04d9fcb96ce9ce854c5b3"
+      "sha256": "7d4e83a96c0c4fc4e3c7cdd8abc0c46607ef7fde28201bad37de72970cf7e26c"
     },
     {
       "path": "modules/lifecycle/routes/gate-approvals.js",
       "mode": "0000644",
-      "sha256": "ebba11a0fe9aa9eb9894baabdde750aba2cc2a79f4f43153b5a394f684f2b44d"
+      "sha256": "b532f0cc111640d5b7b658b9a465969666129ac9b9144d37a4f2dd5459961b59"
     },
     {
       "path": "modules/lifecycle/routes/goal-move.js",
@@ -7232,7 +7242,7 @@
     {
       "path": "modules/lifecycle/routes/lifecycle.js",
       "mode": "0000644",
-      "sha256": "8bc5f1fa3ca7d1fe19fce3fe0b48da6e58274fd7020fe8da2c4b13fb6960c52a"
+      "sha256": "dcbfcc5f0a3d1cd56c97a5fa2102a08545bc540a8c73173dda806c2e4739b985"
     },
     {
       "path": "modules/lifecycle/routes/mingle.js",
@@ -7242,7 +7252,7 @@
     {
       "path": "modules/lifecycle/routes/project-settings.js",
       "mode": "0000644",
-      "sha256": "5a8271bed02a4e34e10444bf42fc3b43248219797726fe426ceb7bbe5cde01ad"
+      "sha256": "7880ef58ae740b61515ec436b5c68f1621263ab6c34e653a2e6bc9e754f681c3"
     },
     {
       "path": "modules/lifecycle/routes/recommendations.js",
@@ -7567,7 +7577,7 @@
     {
       "path": "modules/onboarding/routes/access-requests.js",
       "mode": "0000644",
-      "sha256": "b2c98487578464375d79e6b00d4e6c940ec43546cb443db55800e6ce62bf2b78"
+      "sha256": "9bfd9810f3f016661cdbc255e7df0f5cfcc3cf425f3713915ec1114cc5e4fadc"
     },
     {
       "path": "modules/onboarding/routes/onboarding.js",
@@ -8052,7 +8062,7 @@
     {
       "path": "modules/provisioning/core-upgrade.js",
       "mode": "0000644",
-      "sha256": "ad8cf6c7ea4d5b81f5f5f25ef0c19884e14d12c87925fa023777fb561dd1e5fd"
+      "sha256": "84fd59b7522f58e3dca5b841b08618d9d26ed7af046ac5305f7774f5ac79d6db"
     },
     {
       "path": "modules/provisioning/cost-ledger.js",
@@ -8377,7 +8387,7 @@
     {
       "path": "modules/provisioning/routes/core-upgrade.js",
       "mode": "0000644",
-      "sha256": "980f25a157dfde5bda6ed903c727fab944b922abdc34be05dc0ccdb5fb3650cc"
+      "sha256": "109ab7dc8f2662301b9216ed1778d1beaea19a1e2e6e73481f7ba0c6c6fb45ad"
     },
     {
       "path": "modules/provisioning/routes/demo.js",
@@ -9282,7 +9292,7 @@
     {
       "path": "modules/security/routes/reports.js",
       "mode": "0000644",
-      "sha256": "9913a2f3f663f778fac62d3e8d7885cf5fc5ee75f02bda91effcef270e4761cc"
+      "sha256": "b958d7bf95026d08c3f8af9327e51ddb4cf3a54df9dd694514f72747b23dcfda"
     },
     {
       "path": "modules/security/routes/scans.js",
@@ -9822,12 +9832,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "4f1f108f932da387171a2bacbb112a582e161c706f48e76a92b11c86a6ba074f"
+      "sha256": "69b5b587dffcb02dba475ed9bbc6cf9b5a97683247d15ab66ea80b093f1e7438"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "456bd96e3f424bb2ade59c4acfe5484c49ad0f469e4626e7de5edea5bdca6000"
+      "sha256": "f7ce3950596d8b85c83e666b8f5391323b0224a333f87b142086f04cf59b6896"
     },
     {
       "path": "public-docs/index.html",
@@ -9847,7 +9857,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "d6a8a34007ddc0a18d7548d46548f6b8e1349eeeafd7ef5bac4319c455d3c57e"
+      "sha256": "4664dd62614dfe646c6800d0199fc6a215017febadf8e57afaef8f11c0656f15"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -11912,7 +11922,7 @@
     {
       "path": "src/bongos/route-rank-check.js",
       "mode": "0000644",
-      "sha256": "a72e24f1cc5f4f27e7f8827de5b936e773d0e0e9ffe39e2de4da97e42b35e3af"
+      "sha256": "bbcf6353af5a63a1d0c496e7ccdd89184eeff4a51d070a890100561387eaaa07"
     },
     {
       "path": "src/bongos/routes.js",
@@ -11942,12 +11952,12 @@
     {
       "path": "src/bongos/routes/backup.js",
       "mode": "0000644",
-      "sha256": "45d25839b21d5a2a965f9119fd372fad01f8b07e24776480705490f5c0a73f11"
+      "sha256": "e1da896de1b128ad1bc57239b3373f563cdd480f3518d4713401a0ff498c8cba"
     },
     {
       "path": "src/bongos/routes/builders.js",
       "mode": "0000644",
-      "sha256": "8a6b26f85dc9743ce5197e5c2458d7e44db26c45d5a8a2ca01519ed503ac381e"
+      "sha256": "110b46f7cbb7921dd7144162cb372cb43f8d6c4959cd6c52fc38527995697f0f"
     },
     {
       "path": "src/bongos/routes/cli-commands.js",
@@ -11997,7 +12007,7 @@
     {
       "path": "src/bongos/routes/modules.js",
       "mode": "0000644",
-      "sha256": "88fdc1c7d0904c8a7dcea9f87a61848982f9db73a1b66a0dba81ac2220c34bfa"
+      "sha256": "fb935713e6d817c5b3ea16edd620ad50c7c0ff5992c4b70de5ccf14eac73192d"
     },
     {
       "path": "src/bongos/routes/my-sessions.js",
@@ -12072,7 +12082,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "324317d722ad7ecf0ab94d6f14cbabc18aa8629fcec113eb85b72606d926afbd"
+      "sha256": "4b303daa61b49c858d1623118536cf98432513a98468f02bc1e6def5ff81149e"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -14122,7 +14132,12 @@
     {
       "path": "tests/governor_docket.mjs",
       "mode": "0000644",
-      "sha256": "45ea0865c025e6d1c5dfd6e0cf0c897b62d5b5993899243e82aa73ed02b4bf2f"
+      "sha256": "d4cf369a2c87074468e4415f4cf97ce9843508b9bc19dca369756cfd2e32c1f5"
+    },
+    {
+      "path": "tests/governor_matter_acts.mjs",
+      "mode": "0000644",
+      "sha256": "acd2443df207071624d9c323e0dfd0b183107b7a8a26e256b2fb9a90ace413aa"
     },
     {
       "path": "tests/grade_aggregates_unavailable.mjs",
@@ -14357,7 +14372,7 @@
     {
       "path": "tests/hall_matter_card.mjs",
       "mode": "0000644",
-      "sha256": "b6322560371fa21eac463b6360ec70af0d68c5256ff1979337cf77deeedf246c"
+      "sha256": "89f314aae30ad50f02ca00ecca5048dd1022f4b42559d087e41c89e26295136a"
     },
     {
       "path": "tests/hall_mine_lens.mjs",
@@ -14462,12 +14477,12 @@
     {
       "path": "tests/hall_street_desk.mjs",
       "mode": "0000644",
-      "sha256": "2044841cb78fdbcbbb701b1530f6bfa90e4130fce2e2a7ab5a375f51a2d09a97"
+      "sha256": "f3131b0b6ed88f84b22621c43a4f78c99508e4e05f1e62a5e469c4e134d14233"
     },
     {
       "path": "tests/hall_street_inside.mjs",
       "mode": "0000644",
-      "sha256": "27988066ed09c4b85a53a81be5ca8b3e5a7e60f80f27ddc0c451f0bd8f8e8235"
+      "sha256": "68e6dc2cda80006101c6e1045093f102bc61ee994cc0e4b99480a8e5c606abca"
     },
     {
       "path": "tests/hall_studio_home.mjs",

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

@@ -303,10 +303,10 @@ export interface PostDoneWhenCriterionIdSatisfyRequest { satisfied_by_task_id?:
 export interface PostDoneWhenCriterionIdUatRecordingResponse { ok: boolean; recording: unknown; bytes: unknown }
 export interface PostDoneWhenCriterionIdUatRequest { kind: string; recording?: string; live_attested?: boolean; note?: string }
 export interface PostDoneWhenCriterionIdUatResponse { ok: boolean; signoff: unknown; criterion_closed: unknown; achieved_goals: unknown; closed_versions: unknown }
+export interface PostDoneWhenCriterionIdUnsatisfyRequest { reason?: string }
 export interface PostDoneWhenCriterionIdUnsatisfyResponse { criterion: unknown }
 export interface PostFeedbackRequest { message: string; kind?: "bug" | "idea"; context?: unknown }
 export interface PostFoundingPlanRequest { days?: Record<string, unknown>; passes?: number; advisors?: string; government?: string; expected_builders?: number; existing?: boolean }
-export interface PostGateApprovalsPrApproveResponse { ok: boolean; pr: unknown; already_clear?: boolean; message: unknown; head_sha?: unknown; status_set?: boolean; recheck?: unknown; held_for_artist?: unknown }
 export interface PostGithubRepoVisibilityRequest { repo: string; visibility: "public" | "private" }
 export interface PostGithubRepoVisibilityResponse { ok: boolean; repo: unknown; private_deployable: boolean }
 export interface PostGithubReposRequest { name: string }
@@ -849,7 +849,7 @@ export interface BongosClient {
     /** POST /done-when/{criterionId}/uat/recording — rank: metic+archon */
     postDoneWhenCriterionIdUatRecording(args?: RequestArgs): Promise<PostDoneWhenCriterionIdUatRecordingResponse>;
     /** POST /done-when/{criterionId}/unsatisfy — rank: metic+archon */
-    postDoneWhenCriterionIdUnsatisfy(args?: RequestArgs): Promise<PostDoneWhenCriterionIdUnsatisfyResponse>;
+    postDoneWhenCriterionIdUnsatisfy(args?: RequestArgs & { body?: PostDoneWhenCriterionIdUnsatisfyRequest }): Promise<PostDoneWhenCriterionIdUnsatisfyResponse>;
     /** GET /done-when/pending-review — rank: metic+archon */
     getDoneWhenPendingReview(args?: RequestArgs): Promise<GetDoneWhenPendingReviewResponse>;
   };
@@ -875,7 +875,7 @@ export interface BongosClient {
     /** GET /gate-approvals — rank: metic+archon */
     getGateApprovals(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /gate-approvals/{pr}/approve — rank: archon */
-    postGateApprovalsPrApprove(args?: RequestArgs): Promise<PostGateApprovalsPrApproveResponse>;
+    postGateApprovalsPrApprove(args?: RequestArgs): Promise<ApiResponse>;
   };
   "github": {
     /** GET /github/repo — rank: any-builder */

package/docs/api/openapi.json

@@ -5933,7 +5933,7 @@
           "done-when"
         ],
         "summary": "POST /done-when/:criterionId/unsatisfy",
-        "description": "Auth: flip a criterion back to unsatisfied (rare; for corrections). rank: archon — un-flip a criterion; same gate as satisfy.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `criterion.unsatisfy` (all required).",
+        "description": "Auth: flip a criterion back to unsatisfied (rare; for corrections). rank: archon — un-flip a criterion; same gate as satisfy. An optional `reason` (the Review desk's one-tap chip, task 1004561) is logged beside who undid it; the flip itself is unchanged.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `criterion.unsatisfy` (all required).",
         "x-rank": "metic+archon",
         "x-source": "modules/lifecycle/routes/done-when.js",
         "x-permissions": [
@@ -5950,6 +5950,17 @@
             "description": "Path parameter `criterionId`."
           }
         ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostDoneWhenCriterionIdUnsatisfyRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
         "responses": {
           "200": {
             "description": "Success.",
@@ -5962,7 +5973,7 @@
             }
           },
           "400": {
-            "$ref": "#/components/responses/BadRequest"
+            "$ref": "#/components/responses/ValidationFailed"
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
@@ -6294,14 +6305,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Success.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PostGateApprovalsPrApproveResponse"
-                }
-              }
-            }
+            "description": "Success."
           },
           "400": {
             "$ref": "#/components/responses/BadRequest"
@@ -27873,6 +27877,16 @@
           "closed_versions"
         ]
       },
+      "PostDoneWhenCriterionIdUnsatisfyRequest": {
+        "type": "object",
+        "properties": {
+          "reason": {
+            "type": "string",
+            "maxLength": 200
+          }
+        },
+        "additionalProperties": false
+      },
       "PostDoneWhenCriterionIdUnsatisfyResponse": {
         "type": "object",
         "properties": {
@@ -27933,30 +27947,6 @@
         },
         "additionalProperties": false
       },
-      "PostGateApprovalsPrApproveResponse": {
-        "type": "object",
-        "properties": {
-          "ok": {
-            "type": "boolean"
-          },
-          "pr": {},
-          "already_clear": {
-            "type": "boolean"
-          },
-          "message": {},
-          "head_sha": {},
-          "status_set": {
-            "type": "boolean"
-          },
-          "recheck": {},
-          "held_for_artist": {}
-        },
-        "required": [
-          "ok",
-          "pr",
-          "message"
-        ]
-      },
       "PostGithubRepoVisibilityRequest": {
         "type": "object",
         "properties": {
@@ -32173,6 +32163,6 @@
   "x-endpoint-count": 502,
   "x-schema-count": 536,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 356,
+  "x-response-schemas": 355,
   "x-generated-by": "scripts/gds/gen-api-docs.js"
 }

package/docs/api-reference.md

@@ -258,7 +258,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/done-when/:criterionId/uat` | `any-builder` | — | a criterion and its goal are readable by any builder. |
 | POST | `/api/bongos/done-when/:criterionId/uat` | `metic+archon` | `kind`, `recording`, `live_attested`, `note` | perm criterion.review; the non-shipper wall is in-handler. |
 | POST | `/api/bongos/done-when/:criterionId/uat/recording` | `metic+archon` | _undocumented_ | perm criterion.review: evidence for a UAT sign-off. |
-| POST | `/api/bongos/done-when/:criterionId/unsatisfy` | `metic+archon` | — | Auth: flip a criterion back to unsatisfied (rare; for corrections). |
+| POST | `/api/bongos/done-when/:criterionId/unsatisfy` | `metic+archon` | `reason` | Auth: flip a criterion back to unsatisfied (rare; for corrections). |
 | GET | `/api/bongos/done-when/pending-review` | `metic+archon` | — | Auth (Metic+): the criterion review queue — every criterion auto-flagged "met — pending review" (≥1 linked task, all shipped, not yet con… |
 
 ## `feedback` (1)

package/docs/module-api-changelog.md

@@ -2895,5 +2895,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.21.32 with no explicit bump. run 37152823234. (task 1002620)
   1.21.34 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.21.33 with no explicit bump. run 37155459630. (task 1002620)
+  1.21.35 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.21.34 with no explicit bump. run 37159056871. (task 1002620)
+  1.21.36 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.21.35 with no explicit bump. run 37207566188. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/page-inventory.json

@@ -13,7 +13,7 @@
     "pages": 42,
     "surfaces": 3,
     "with_states": 35,
-    "states": 246
+    "states": 255
   },
   "surfaces": [
     {
@@ -1030,6 +1030,15 @@
         "desk",
         "desk-facts",
         "desk-quiet",
+        "desk-people-builders",
+        "desk-people-tier",
+        "desk-disputes",
+        "desk-automation-goals",
+        "desk-release-core",
+        "desk-rules",
+        "desk-planning-priorities",
+        "desk-planning-ideas",
+        "desk-planning-blockers",
         "sitting",
         "object",
         "voted",