@bongos/core 1.19.875 → 1.19.877

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.875",
-  "core_contract": "1.19.875",
-  "source_commit": "d1782be0c7671dd7dd82c4f354a77d231fb274be",
+  "core_version": "1.19.877",
+  "core_contract": "1.19.877",
+  "source_commit": "7cc46fa08c1a00e2194ab40bddea2dce575e2d38",
   "source_ref": "HEAD",
-  "built_at": "2026-09-19T04:13:30.837Z",
+  "built_at": "2026-09-19T10:46:37.399Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 500,
+    "docs_redacted": 501,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2305,
+    "functional_verbatim": 2316,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 2831,
-  "tree_sha256": "1217f7ece32a73d51483fbdd8aabfd37cb8021c9506bca34d253378aedbdd9b3",
+  "file_count": 2843,
+  "tree_sha256": "f1b43ea830cc3e9e55d49cdfc2da4528c9388b558fca838b1e54002de9e00f9d",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -302,7 +302,7 @@
     {
       "path": ".gitattributes",
       "mode": "0000644",
-      "sha256": "dace360d1e995ce2a7401a275a7ed68f6ebb877da948f7cf5ff710a9ce8c8bfc"
+      "sha256": "9277b2605ca5cc80b31f25702eef9b23e9d9a8a26f0de3693b88f18f5660a229"
     },
     {
       "path": "CLAUDE.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "54cdd993cbae28a4dbd1aab84d565905f672b4e1095cfde9212de02ae30e367a"
+      "sha256": "b77c75902ed2aaa437f92d23849154fc61b4e4a6c9c3536466b6c54b5da6f396"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "b344141a606defff7530f0546e3fc741c5f9685cd6a8d20f6c64f8de1633bc87"
+      "sha256": "146b0f072159cc2307fb0ea855e49664bec120f0a181a54253941cacd1beea7d"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "46c9fb18c486f413cda2d73a4dee92c73d6ca15be08109b8dd5986ede3b23a4b"
+      "sha256": "885e0606f436873e274f6ec51e93697f3854115874c982299ef8275621629f8e"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "cc54c6e360985bfbcf4a00206f16989affd706177cfe3715c77ccd91c3c9d1d9"
+      "sha256": "b96f7c4b0cebc844c5fab5aa61420f85d9681afd98824aeda0179de871d5d3b9"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "5bec4eae4564aba7087341014a4690d0717252300cd297ae97b9108102aaabd3"
+      "sha256": "156a725169e5e310e69ec6a7df1bd0d9dec768d693cb8aa581710f59def69a78"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2027,7 +2027,7 @@
     {
       "path": "docs/adr/0307-autobongos-a-deterministic-supervisor-and-agentic-workers.md",
       "mode": "0000644",
-      "sha256": "c3509e08e96fc65e2e2eb0e6306d79c06d2302652efad47b60107bcf4c0078a8"
+      "sha256": "d99ddd1b8197dffed75669f82bcbae93d7ea81d4a8a73bf78c1472e7f9cd5e50"
     },
     {
       "path": "docs/adr/0308-an-eleventh-working-area.md",
@@ -2042,12 +2042,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "505ce889291a3dddbe66c2d375b7f0a631531b741ebe6fdf5d960af3b42173b3"
+      "sha256": "eb881abdd3d46576e6e2ca2993130c897812497b70788449fbfef78ceed51d23"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "0b47552a99357a93cb13ea0f546a61b3850c3a8e8a324d243cced32813dfa619"
+      "sha256": "93e072990ee62849e1b8a05e7e006a6327bc749cc5a42b873f6fa339c85297d5"
     },
     {
       "path": "docs/architecture.md",
@@ -2072,12 +2072,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "c923e66a5b77c20784cfb0e50d8bba2bb41ec38895a029c2bbb69a829c3e6eb3"
+      "sha256": "4f2a818e2c3ad45867e473acda56f0f32eb5932f30c657f75bea80e5c39435a1"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "864bbc41a5c93bf63aa529dd396d8784a56d65975d6ebd7e15edab51e3c5093f"
+      "sha256": "1b075508f88381d932d2eb9d4fb1e394ea20b590071b11b4f24e4b313c411aef"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2602,7 +2602,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "0d33c3fc850860d87fcb70790d850de2a2be38635fb152dd7d021c6176f67292"
+      "sha256": "d7e2217a982356c43047a8f416106e885a22862d1bc125ea59545fc995f9b318"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2704,6 +2704,11 @@
       "mode": "0000644",
       "sha256": "df362cf57fd748cca551a0c1a7048a678d5e833490dc5d2ab5d6ce1d33595f33"
     },
+    {
+      "path": "docs/recipes/autobongos-windows-host.md",
+      "mode": "0000644",
+      "sha256": "94b0b2442708fec6f62fe98b41dc5131c114833b66c487a0056974265cc13db6"
+    },
     {
       "path": "docs/recipes/bongos-cli-release.md",
       "mode": "0000644",
@@ -2752,7 +2757,7 @@
     {
       "path": "docs/recipes/instance-deploy.md",
       "mode": "0000644",
-      "sha256": "40241530c2c054753ab0bbc9f49b66dece309e06dd552ae2313accce848b5e36"
+      "sha256": "78c600567a08af14b8c0fd9b3d803f81daa95d2fd5dfb39fcd02c9bd40cdec93"
     },
     {
       "path": "docs/recipes/instance-first-run.md",
@@ -3784,10 +3789,15 @@
       "mode": "0000644",
       "sha256": "7cb9dac9cb87b679e1ae50e4112b3a7928a38ebb9902c8947a74d17bec4d9009"
     },
+    {
+      "path": "modules/autonomy/cadence.js",
+      "mode": "0000644",
+      "sha256": "7fed6c42e312e3a8d0254699954c2a1af483d2abf9a1baeceea6f8e61a9560ab"
+    },
     {
       "path": "modules/autonomy/db.js",
       "mode": "0000644",
-      "sha256": "147b12a8b268a62456d8d8f685f067ba36884d28e72aa9d97e096aba4dd58584"
+      "sha256": "722b9f3ddbd59fda3e92ae6c6fb0400eb3eadc343f0a3f84369d69bea72b7d65"
     },
     {
       "path": "modules/autonomy/fence.js",
@@ -3804,6 +3814,11 @@
       "mode": "0000644",
       "sha256": "23d98c938efdeb221bdcaef1c1ed3f09ac0f389ad6fb38fc221450b34158b5ad"
     },
+    {
+      "path": "modules/autonomy/migrations/autonomy_002_runner_heartbeat.sql",
+      "mode": "0000644",
+      "sha256": "ea1224fcf94aa10e5ee1c77df409e52210c145f71913853b72e7f142d943ff55"
+    },
     {
       "path": "modules/autonomy/module.json",
       "mode": "0000644",
@@ -3817,7 +3832,12 @@
     {
       "path": "modules/autonomy/routes/autonomy.js",
       "mode": "0000644",
-      "sha256": "abb70f760ab019c4ad8f1962a2700f3801c71e3dd86b5124b02900e1812d1e04"
+      "sha256": "e119e149565972008d42e986f82b4fcbff22d74301222e8772d63de16e936abf"
+    },
+    {
+      "path": "modules/autonomy/runner-health.js",
+      "mode": "0000644",
+      "sha256": "3752cff6742e0d72b83697948e14547afb2b7b158e5fef57bfa75cf68ce525cf"
     },
     {
       "path": "modules/builder-settings/CLAUDE.md",
@@ -4172,7 +4192,7 @@
     {
       "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
       "mode": "0000644",
-      "sha256": "46c9fb18c486f413cda2d73a4dee92c73d6ca15be08109b8dd5986ede3b23a4b"
+      "sha256": "885e0606f436873e274f6ec51e93697f3854115874c982299ef8275621629f8e"
     },
     {
       "path": "modules/dev-box/app/test/unit.mjs",
@@ -4952,12 +4972,12 @@
     {
       "path": "modules/hall-ui/public/gate.html",
       "mode": "0000644",
-      "sha256": "88f8a79743e7fc40651ab64306c5dec5d52c8a0886d4fd4515227ad89ca837e4"
+      "sha256": "0b07c5a358d50b8537e303fc8fc84a2ae5100c09df7af1e15b96caa5a677aa76"
     },
     {
       "path": "modules/hall-ui/public/gate.js",
       "mode": "0000644",
-      "sha256": "1445bece8bebdcc43174ee7873729a843d4f60fdd617226d936783e243763754"
+      "sha256": "0a5f030cce0d8820a4c3eb943b7a6237dab3be8800b50a30d4059b235f9f851b"
     },
     {
       "path": "modules/hall-ui/public/gate.states.json",
@@ -7352,7 +7372,7 @@
     {
       "path": "modules/security/tests/artifact_scan.mjs",
       "mode": "0000644",
-      "sha256": "dbdc9f017a2a6dff3379c1a0acb08e023278cfb382d91b20a4ec0b5e5f8229b0"
+      "sha256": "ee957538ecc1b0639d631d74bfee043a6c7b8f169bb90f807d99038e84943cb3"
     },
     {
       "path": "modules/security/tests/floor.mjs",
@@ -7362,12 +7382,12 @@
     {
       "path": "modules/security/tests/mirror.mjs",
       "mode": "0000644",
-      "sha256": "fbded0d3f137a62c9f6255297b2aa5752e0dc2a6175ce0e344d461cf59bc53b1"
+      "sha256": "88415123848cc3f9a856104ca4a53db2fd73cdecaa98f8456e3e8369a050f194"
     },
     {
       "path": "modules/security/tests/sanitize_rebuild.mjs",
       "mode": "0000644",
-      "sha256": "4af88247bed3dcb3c12370e48380625871a9b50a0b430a6da34db0ce6d6c8aca"
+      "sha256": "2cec1a9277878d2973838a4ae5dccbd3927a1bd8cfe227227aec01ea29b2ca5e"
     },
     {
       "path": "modules/security/tests/scan_route_schema.mjs",
@@ -7947,12 +7967,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "f5357bd73be9ea55bd37f72b3510637906159d36638a1ba23366fda56d93da6e"
+      "sha256": "4e8f5415cb5201d24ca7114d11e21d15b7042e7c6a846fed8cf10e35971305ad"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "c4516d41236cc62820827c5fed694403aaf255e0e8ad566041ee6397e9eff429"
+      "sha256": "c616356037d3d48c3d6a49a28c89b8e7e38e13be5c9ea8a38899f51efc55a4b9"
     },
     {
       "path": "public-docs/index.html",
@@ -8117,7 +8137,17 @@
     {
       "path": "scripts/gds/autobongos-run.js",
       "mode": "0000644",
-      "sha256": "6b91b2f34173d0c8bf516f074a7d9f7197c2a69fafcae949f1f2d2e57e353df3"
+      "sha256": "da0047f65186ea6d049799b62aaf60acc2ec1a3d4fe15875dadbdc493512d205"
+    },
+    {
+      "path": "scripts/gds/autobongos-service.cmd",
+      "mode": "0000644",
+      "sha256": "62ec55c715e3af35fd3394cabcfb638df59eb0562ae5da89a3ac02fd2d97f97f"
+    },
+    {
+      "path": "scripts/gds/autobongos-service.ps1",
+      "mode": "0000644",
+      "sha256": "60af163d90c3f30d6723678eb64d6ed259be5575230ee43adaebce9537a4fe9a"
     },
     {
       "path": "scripts/gds/autobongos-verify.js",
@@ -8379,6 +8409,11 @@
       "mode": "0000644",
       "sha256": "39879d5d26a325529620ab4fd180f133643d0e4c2a5a9ef92f8ee347ad0ba0d7"
     },
+    {
+      "path": "scripts/gds/deploy-main-audit-gate.sh",
+      "mode": "0000755",
+      "sha256": "245ba28478a3480b1039bab35921bedd86c44152fbd36612998dc4eb78642ccf"
+    },
     {
       "path": "scripts/gds/design-sync.js",
       "mode": "0000644",
@@ -8742,7 +8777,7 @@
     {
       "path": "scripts/gds/main-audit.js",
       "mode": "0000644",
-      "sha256": "df5385f3929161eab1d74657f5d916650b4c05e4737f0a5e906e7d66a9c06489"
+      "sha256": "abc4ee56e31c32e6b2d62dd41bc0b4c62ed44e362a6b9ed7090d9d8fd0e409b5"
     },
     {
       "path": "scripts/gds/me.js",
@@ -9037,7 +9072,7 @@
     {
       "path": "scripts/gds/run-unit-tests.js",
       "mode": "0000644",
-      "sha256": "f55da8bbc3fef912cfa99935d35e4c6da1c65a0db52aa81a64c77c520ab60e47"
+      "sha256": "8227fe5256b530d22192cd86f3624d52cc1dc34ac82099a8bb9e3d6a28482eb9"
     },
     {
       "path": "scripts/gds/runner-drift.js",
@@ -9937,7 +9972,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "30eab36a9a6432777dcf0df87512a6d06b40eb03ded24b3119a8ceb231e0cc52"
+      "sha256": "7dbc21b0402be4d9acc429c0cd1f9fc5ba33ea4f7ab0650d89dd078d7ffb82bb"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -10339,6 +10374,11 @@
       "mode": "0000644",
       "sha256": "d7ac18d14e8e9e5e7b9e913a76953fe69bfefea4912e77ca30b285647bfcfca8"
     },
+    {
+      "path": "tests/autobongos_cadence.mjs",
+      "mode": "0000644",
+      "sha256": "5444f426f49da327087efbc85848c0a15812438341d3c9cb43d83dc424e2d869"
+    },
     {
       "path": "tests/autobongos_fence.mjs",
       "mode": "0000644",
@@ -10369,6 +10409,11 @@
       "mode": "0000644",
       "sha256": "94927dcf8822d01504e57821e08b92fe28550056ddfd75f98db3985a5dab0805"
     },
+    {
+      "path": "tests/autonomy_runner_health.mjs",
+      "mode": "0000644",
+      "sha256": "e5dc6ec6261a18113876f4e362e8cb801d78f5266e077f0b8a27eeda70fe800b"
+    },
     {
       "path": "tests/backfill_sessions.mjs",
       "mode": "0000644",
@@ -10607,7 +10652,7 @@
     {
       "path": "tests/bump_version.mjs",
       "mode": "0000644",
-      "sha256": "6540646400fb4464ee823b841f908f8577d170f60c4b4928fbbfc2a3746b76d4"
+      "sha256": "5073519bc3ba0fdf68927dd3800572c7dc9f652d6855991787e846a932cf1a3d"
     },
     {
       "path": "tests/canonical_profile_url.mjs",
@@ -10727,7 +10772,7 @@
     {
       "path": "tests/cli_package.mjs",
       "mode": "0000644",
-      "sha256": "9c40324ec0faf739c6b78e428b43cd0c3f01a3f70bb9ded78b3cf33657098163"
+      "sha256": "e16f3fd835e440bad8a24ea1807663f08709bfe21b65cc25772b7d707bbba540"
     },
     {
       "path": "tests/cli_sessions.mjs",
@@ -10959,10 +11004,15 @@
       "mode": "0000644",
       "sha256": "9d16748bfadb1b13969613bd7a43bed42ea3e1bdcc7254ab26fba14ea8b4c036"
     },
+    {
+      "path": "tests/deploy_audit_gate.mjs",
+      "mode": "0000644",
+      "sha256": "183a355d451ec850c481dc5b17674e78b81ad9a2e009298a801fde7f4be231ab"
+    },
     {
       "path": "tests/deploy_divergence_line.mjs",
       "mode": "0000644",
-      "sha256": "c79be1df93ccfb420451ee7d55b58e9f4bcb1d08903824e62ed776d4ed058ac7"
+      "sha256": "a14fe18d1041a3b3f4b2c302225329aab4dedeecee359572fd62655cca9daac6"
     },
     {
       "path": "tests/deploy_instance.mjs",
@@ -11882,7 +11932,7 @@
     {
       "path": "tests/helpers.mjs",
       "mode": "0000644",
-      "sha256": "f84cb192bfa60bd86d925c56e67b6521bf0c67a19c8359dd02c3bf8ea8c83b0e"
+      "sha256": "d90ec6d640f3a9a389169180d4a852c85e7c3a5336900f93b871673681b8718a"
     },
     {
       "path": "tests/hierarchy-config.mjs",
@@ -12284,6 +12334,11 @@
       "mode": "0000644",
       "sha256": "eff2ce96889306f4898686c3648d302f54fff5f137ee41ddf543866fdf2f807d"
     },
+    {
+      "path": "tests/main_audit_db_roster.mjs",
+      "mode": "0000644",
+      "sha256": "e7d7420279a2c2264268544552423406006a0e1ed3accf680ba814161cdb0e41"
+    },
     {
       "path": "tests/main_worktree_busy_reason.mjs",
       "mode": "0000644",
@@ -13057,7 +13112,7 @@
     {
       "path": "tests/publish_watch.mjs",
       "mode": "0000644",
-      "sha256": "91ada5b4bf9b22ff8cefb0508be34f5d006bd223c825c73e5bbc9812411a4253"
+      "sha256": "5e2fb1f403e9a60fdcf037eca611296909a8e1c5f2ed404d7623f51266a4f174"
     },
     {
       "path": "tests/push_path_brief.mjs",
@@ -13472,7 +13527,7 @@
     {
       "path": "tests/setup_device_flow_fallback.mjs",
       "mode": "0000644",
-      "sha256": "bbb11a18a38eb7e4c697245928b0de0f34b2a6d36d45812fe0524ba8dc8bc7c2"
+      "sha256": "ec3b12b575cfa3aeae48fb5c9044fe2738e230b5a2007166a7fc24a3ca7fb775"
     },
     {
       "path": "tests/setup_smoke.mjs",
@@ -13659,6 +13714,11 @@
       "mode": "0000644",
       "sha256": "b86d0d1e0ffeefa07ebda360b129389a02bbcf05296661d56a610c225098d451"
     },
+    {
+      "path": "tests/skip_is_not_pass.mjs",
+      "mode": "0000644",
+      "sha256": "6258b4a3ad76a1d9139b053535c173760c5b42aa82510541501b6fef5ddd1fe1"
+    },
     {
       "path": "tests/smoke_preflight.mjs",
       "mode": "0000644",
@@ -13957,7 +14017,7 @@
     {
       "path": "tests/tool_scan_engine.mjs",
       "mode": "0000644",
-      "sha256": "10a6a41cafcba32406be1aa79e0be1ace1cde2c4163bf0b1a0efd1e5e8f8c403"
+      "sha256": "a0d6e1921069e406071498949c792159cfaefabecddff11ea0eda5359cee549f"
     },
     {
       "path": "tests/touches_overlap.mjs",
@@ -14002,7 +14062,7 @@
     {
       "path": "tests/unit_runner_teardown_abort.mjs",
       "mode": "0000644",
-      "sha256": "b10a938bb1b229ba03e9e8ba80b04e6d8f8686d25a2b71e2cafa50eba63a2b21"
+      "sha256": "d7e9a8e184cf17e889dac7a48f96b5e45f00ab787e79414ebf53bff731bd126d"
     },
     {
       "path": "tests/update_channel.mjs",

package/.gitattributes

@@ -57,8 +57,12 @@
 # checkout in place: `git rm --cached -r . && git reset --hard`.
 *.md           text eol=lf
 
-# Future Windows-only wrappers (none today) must be CRLF — cmd.exe/PowerShell
-# expect it. Declared up front so a later setup-builder.cmd lands correct.
+# Windows-only wrappers must be CRLF — cmd.exe/PowerShell expect it. Declared up
+# front before there were any; the first two arrived with task 1003905
+# (scripts/gds/autobongos-service.{cmd,ps1}), and they are also kept pure ASCII:
+# Windows PowerShell 5.1 reads a BOM-less file as ANSI rather than UTF-8, and
+# cmd.exe reads a batch file in the OEM codepage, so a stray em-dash renders as
+# mojibake in text the owner is meant to read.
 *.bat          text eol=crlf
 *.cmd          text eol=crlf
 *.ps1          text eol=crlf

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`)
-- 398 operations across 60 resource groups
+- 400 operations across 60 resource groups
 
 ## Use it from your project
 

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

@@ -181,8 +181,12 @@ function createClient(opts = {}) {
       postAutonomyFenceGoals: (args) => request("POST", "/autonomy/fence/goals", { hasBody: true }, args),
       // DELETE /autonomy/fence/goals/{goalId} — rank: archon — DELETE /autonomy/fence/goals/:goalId
       deleteAutonomyFenceGoalsGoalId: (args) => request("DELETE", "/autonomy/fence/goals/{goalId}", { hasBody: false }, args),
+      // POST /autonomy/heartbeat — rank: any-builder — POST /autonomy/heartbeat
+      postAutonomyHeartbeat: (args) => request("POST", "/autonomy/heartbeat", { hasBody: true }, args),
       // GET /autonomy/precheck — rank: metic+archon — GET /autonomy/precheck
       getAutonomyPrecheck: (args) => request("GET", "/autonomy/precheck", { hasBody: false }, args),
+      // GET /autonomy/runners — rank: any-builder — GET /autonomy/runners
+      getAutonomyRunners: (args) => request("GET", "/autonomy/runners", { hasBody: false }, args),
     },
     "backup": {
       // GET /backup/status — rank: metic+archon — GET /backup/status

package/clients/bongos-client/index.cjs

@@ -180,8 +180,12 @@ function createClient(opts = {}) {
       postAutonomyFenceGoals: (args) => request("POST", "/autonomy/fence/goals", { hasBody: true }, args),
       // DELETE /autonomy/fence/goals/{goalId} — rank: archon — DELETE /autonomy/fence/goals/:goalId
       deleteAutonomyFenceGoalsGoalId: (args) => request("DELETE", "/autonomy/fence/goals/{goalId}", { hasBody: false }, args),
+      // POST /autonomy/heartbeat — rank: any-builder — POST /autonomy/heartbeat
+      postAutonomyHeartbeat: (args) => request("POST", "/autonomy/heartbeat", { hasBody: true }, args),
       // GET /autonomy/precheck — rank: metic+archon — GET /autonomy/precheck
       getAutonomyPrecheck: (args) => request("GET", "/autonomy/precheck", { hasBody: false }, args),
+      // GET /autonomy/runners — rank: any-builder — GET /autonomy/runners
+      getAutonomyRunners: (args) => request("GET", "/autonomy/runners", { hasBody: false }, args),
     },
     "backup": {
       // GET /backup/status — rank: metic+archon — GET /backup/status

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

@@ -28,6 +28,7 @@ export interface GetArtistGateResponse { ok: boolean; mode: unknown; since: unkn
 export interface GetAuditLogResponse { rows: unknown; page: unknown }
 export interface GetAuthAppPairInfoResponse { pair_code: unknown; device_name: unknown; platform: unknown; status: unknown }
 export interface GetAuthWebAdmissionStatusResponse { admitted: boolean }
+export interface GetAutonomyRunnersResponse { runners: unknown; none: unknown }
 export interface GetBackupStatusResponse { backup_dir: unknown; db_name: unknown; latest_dump: unknown; stale: unknown; age_hours: unknown; trigger_running: unknown }
 export interface GetBlockersIdResponse { blocker: unknown }
 export interface GetBlockersResponse { blockers: unknown; page: unknown }
@@ -230,6 +231,8 @@ export interface PostAuthRevokeResponse { ok: boolean; revoked: unknown }
 export interface PostAutonomyFenceGoalsRequest { goal_id: StringifiableId; note?: string }
 export interface PostAutonomyFenceGoalsResponse { goal: unknown }
 export interface PostAutonomyFenceRequest { enabled: boolean; reason?: string }
+export interface PostAutonomyHeartbeatRequest { host: string; pid?: number; started_at?: string; mode?: string; consecutive_failures?: number; last_event?: string; working_task_id?: number }
+export interface PostAutonomyHeartbeatResponse { ok: boolean; heartbeat: unknown }
 export interface PostBackupTriggerResponse { ok: boolean; message: unknown; started_at: unknown }
 export interface PostBlockersIdLinkRequest { task_id: StringifiableId }
 export interface PostBlockersIdLinkResponse { ok: boolean; blocked: unknown }
@@ -550,8 +553,12 @@ export interface BongosClient {
     postAutonomyFenceGoals(args: RequestArgs & { body: PostAutonomyFenceGoalsRequest }): Promise<PostAutonomyFenceGoalsResponse>;
     /** DELETE /autonomy/fence/goals/{goalId} — rank: archon */
     deleteAutonomyFenceGoalsGoalId(args?: RequestArgs): Promise<ApiResponse>;
+    /** POST /autonomy/heartbeat — rank: any-builder */
+    postAutonomyHeartbeat(args: RequestArgs & { body: PostAutonomyHeartbeatRequest }): Promise<PostAutonomyHeartbeatResponse>;
     /** GET /autonomy/precheck — rank: metic+archon */
     getAutonomyPrecheck(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /autonomy/runners — rank: any-builder */
+    getAutonomyRunners(args?: RequestArgs): Promise<GetAutonomyRunnersResponse>;
   };
   "backup": {
     /** GET /backup/status — rank: metic+archon */

package/clients/bongos-client/index.mjs

@@ -177,8 +177,12 @@ export function createClient(opts = {}) {
       postAutonomyFenceGoals: (args) => request("POST", "/autonomy/fence/goals", { hasBody: true }, args),
       // DELETE /autonomy/fence/goals/{goalId} — rank: archon — DELETE /autonomy/fence/goals/:goalId
       deleteAutonomyFenceGoalsGoalId: (args) => request("DELETE", "/autonomy/fence/goals/{goalId}", { hasBody: false }, args),
+      // POST /autonomy/heartbeat — rank: any-builder — POST /autonomy/heartbeat
+      postAutonomyHeartbeat: (args) => request("POST", "/autonomy/heartbeat", { hasBody: true }, args),
       // GET /autonomy/precheck — rank: metic+archon — GET /autonomy/precheck
       getAutonomyPrecheck: (args) => request("GET", "/autonomy/precheck", { hasBody: false }, args),
+      // GET /autonomy/runners — rank: any-builder — GET /autonomy/runners
+      getAutonomyRunners: (args) => request("GET", "/autonomy/runners", { hasBody: false }, args),
     },
     "backup": {
       // GET /backup/status — rank: metic+archon — GET /backup/status

package/docs/adr/0307-autobongos-a-deterministic-supervisor-and-agentic-workers.md

@@ -99,7 +99,18 @@ fixes the cause; and a queue where *every* task halts is not a runner failure at
 all, and is reported as an unworkable queue. A new signal — main moved, a blocker
 resolved, the allowlist changed — jumps the remaining wait.
 
-The only true stop is the **server-side** kill switch.
+The only true stop is the **server-side** kill switch — and even that is a speed:
+the runner keeps asking, cheaply, so flipping the switch back on is enough to
+start it without touching the machine.
+
+Two things the implementation settled (`modules/autonomy/cadence.js` and the
+`--forever` loop, task 1003904), both learned by running it rather than reading
+it. Boot reconciliation needs a **heartbeat**: the ledger cannot tell a live run
+from a dead one — both are a held claim — and releasing one a worker is building
+against strands its work exactly as badly as leaving one locked. And it must
+match the **exact worktree name the runner generates**, not an `autobongos-`
+prefix: the loose form matched a human's hand-named tree and released their live
+claim out from under them, twice, during the task that added it.
 
 ### 6. The fence, and where it is enforced