@bongos/core 1.19.876 → 1.19.878

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.876",
-  "core_contract": "1.19.876",
-  "source_commit": "faaa7283a4bba70f85f9eb8659db39b2a673e099",
+  "core_version": "1.19.878",
+  "core_contract": "1.19.878",
+  "source_commit": "2b2c4d57dea2fc815d5edf5a1fd9ddb076f49be9",
   "source_ref": "HEAD",
-  "built_at": "2026-09-19T04:18:45.980Z",
+  "built_at": "2026-09-19T11:02:46.880Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 500,
+    "docs_redacted": 501,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2306,
+    "functional_verbatim": 2319,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 2832,
-  "tree_sha256": "e510e319efe7ab6f5d4b1964953c53929d02edc31236f7c777c472eac1ed7d80",
+  "file_count": 2846,
+  "tree_sha256": "5cf258930712618621a4d89ca402aef67b76d4b0212318336edb63c4a4a0502b",
   "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": "d83c5188b30ecc313961e181bd2ec86ea94ab94ef30e995469669b1d4ed889dc"
+      "sha256": "2c1b16d4be5696489456b2c49d7fbef8b09d846d722860bd019968e20a88db02"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2704,6 +2704,11 @@
       "mode": "0000644",
       "sha256": "df362cf57fd748cca551a0c1a7048a678d5e833490dc5d2ab5d6ce1d33595f33"
     },
+    {
+      "path": "docs/recipes/autobongos-windows-host.md",
+      "mode": "0000644",
+      "sha256": "72f38de74c8cbfd1d44de916d19572dc705b1039a4270d53e3a9065a50d8faf7"
+    },
     {
       "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,20 @@
       "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/digest.js",
+      "mode": "0000644",
+      "sha256": "cfe22a887e5a69cf314a318f7b410c81f91cfba65f7643605e9f3ac1ebef8022"
     },
     {
       "path": "modules/autonomy/fence.js",
@@ -3804,6 +3819,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 +3837,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 +4197,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 +4977,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",
@@ -7947,12 +7972,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "45ea30974ab43d90bf7b88b4afab20d9bd2c8d8ba80c891e464eab1c1a882aff"
+      "sha256": "da57fd75ea411bf8a7ecad98041b7d38f6ce568bca460243b24b67bd2ddd60ba"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "e96760085687e6a0e6a1aa6caf9f011f54eddd43e6229f40140cee9c02332734"
+      "sha256": "ef72c5d5fd50006bbb62080ebf77339025a5979363d10c655e5db6f1b507850c"
     },
     {
       "path": "public-docs/index.html",
@@ -8109,6 +8134,11 @@
       "mode": "0000644",
       "sha256": "891e795c68d43d11958a2e68af0cfb1fcd5a1f3308c821f86ff37512326ef72d"
     },
+    {
+      "path": "scripts/gds/autobongos-digest.js",
+      "mode": "0000644",
+      "sha256": "b406f73bbc0f577a2a58ec99597fb92c7edc0d1628c0ca7729cd25b0a1270045"
+    },
     {
       "path": "scripts/gds/autobongos-loop.js",
       "mode": "0000644",
@@ -8117,7 +8147,17 @@
     {
       "path": "scripts/gds/autobongos-run.js",
       "mode": "0000644",
-      "sha256": "6b91b2f34173d0c8bf516f074a7d9f7197c2a69fafcae949f1f2d2e57e353df3"
+      "sha256": "24f0be946550a89f717278a418ebb68330fad3c7cdd45d3b79e85315564c7425"
+    },
+    {
+      "path": "scripts/gds/autobongos-service.cmd",
+      "mode": "0000644",
+      "sha256": "62ec55c715e3af35fd3394cabcfb638df59eb0562ae5da89a3ac02fd2d97f97f"
+    },
+    {
+      "path": "scripts/gds/autobongos-service.ps1",
+      "mode": "0000644",
+      "sha256": "3f3e44969809b3c22c9cf338af68695af6e835b861ac056d38408a4be1d202a7"
     },
     {
       "path": "scripts/gds/autobongos-verify.js",
@@ -8379,6 +8419,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 +8787,7 @@
     {
       "path": "scripts/gds/main-audit.js",
       "mode": "0000644",
-      "sha256": "df5385f3929161eab1d74657f5d916650b4c05e4737f0a5e906e7d66a9c06489"
+      "sha256": "abc4ee56e31c32e6b2d62dd41bc0b4c62ed44e362a6b9ed7090d9d8fd0e409b5"
     },
     {
       "path": "scripts/gds/me.js",
@@ -8882,7 +8927,7 @@
     {
       "path": "scripts/gds/provision-core-upgrade.js",
       "mode": "0000644",
-      "sha256": "fef10e02d3b1d605c1b30fd553b1cf8069159d8c2cbf6b0e4b48ec32359562a9"
+      "sha256": "5fad0beb0a3d4b322918a99765cb922fcce1de4196c19cb08a0d3bc91c3d149e"
     },
     {
       "path": "scripts/gds/provision-disconnect.js",
@@ -9037,7 +9082,7 @@
     {
       "path": "scripts/gds/run-unit-tests.js",
       "mode": "0000644",
-      "sha256": "a6881d4f2edeeb200da7ad5953ed790dc24993a46e66cbfc5aa67d48a4e02395"
+      "sha256": "8227fe5256b530d22192cd86f3624d52cc1dc34ac82099a8bb9e3d6a28482eb9"
     },
     {
       "path": "scripts/gds/runner-drift.js",
@@ -9937,7 +9982,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "106ce54796bb7d77e5438ef5848f8337927859114b48316ac151ca18f4f0c6be"
+      "sha256": "f38e0d4d6eeb707065f278ed386fec6a66d502553ac99d1e683b7216c0bb6a99"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -10339,6 +10384,11 @@
       "mode": "0000644",
       "sha256": "d7ac18d14e8e9e5e7b9e913a76953fe69bfefea4912e77ca30b285647bfcfca8"
     },
+    {
+      "path": "tests/autobongos_cadence.mjs",
+      "mode": "0000644",
+      "sha256": "5444f426f49da327087efbc85848c0a15812438341d3c9cb43d83dc424e2d869"
+    },
     {
       "path": "tests/autobongos_fence.mjs",
       "mode": "0000644",
@@ -10359,6 +10409,11 @@
       "mode": "0000644",
       "sha256": "1b5b6e5010c45a77015a1d0d63d49cb3286eca91a83f45cb94d145af01aab7dc"
     },
+    {
+      "path": "tests/autonomy_digest.mjs",
+      "mode": "0000644",
+      "sha256": "633ede3096916c1d5571def211fabac9ae934f48723d182c54f2fe27c2ead105"
+    },
     {
       "path": "tests/autonomy_gate.mjs",
       "mode": "0000644",
@@ -10369,6 +10424,11 @@
       "mode": "0000644",
       "sha256": "94927dcf8822d01504e57821e08b92fe28550056ddfd75f98db3985a5dab0805"
     },
+    {
+      "path": "tests/autonomy_runner_health.mjs",
+      "mode": "0000644",
+      "sha256": "e5dc6ec6261a18113876f4e362e8cb801d78f5266e077f0b8a27eeda70fe800b"
+    },
     {
       "path": "tests/backfill_sessions.mjs",
       "mode": "0000644",
@@ -10607,7 +10667,7 @@
     {
       "path": "tests/bump_version.mjs",
       "mode": "0000644",
-      "sha256": "6540646400fb4464ee823b841f908f8577d170f60c4b4928fbbfc2a3746b76d4"
+      "sha256": "5073519bc3ba0fdf68927dd3800572c7dc9f652d6855991787e846a932cf1a3d"
     },
     {
       "path": "tests/canonical_profile_url.mjs",
@@ -10727,7 +10787,7 @@
     {
       "path": "tests/cli_package.mjs",
       "mode": "0000644",
-      "sha256": "9c40324ec0faf739c6b78e428b43cd0c3f01a3f70bb9ded78b3cf33657098163"
+      "sha256": "e16f3fd835e440bad8a24ea1807663f08709bfe21b65cc25772b7d707bbba540"
     },
     {
       "path": "tests/cli_sessions.mjs",
@@ -10837,7 +10897,7 @@
     {
       "path": "tests/core_upgrade_runner.mjs",
       "mode": "0000644",
-      "sha256": "5f9ae4144ab85ee197f417003a71df1d78398ca11b6c8bd3dc96de9b4cd5e1fb"
+      "sha256": "a8fc77b7a32e4377b4b327bd485cbc17428421ef3fc871770fdaeee3e02e48f4"
     },
     {
       "path": "tests/cosmos_token_contrast.mjs",
@@ -10959,10 +11019,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 +11947,7 @@
     {
       "path": "tests/helpers.mjs",
       "mode": "0000644",
-      "sha256": "f84cb192bfa60bd86d925c56e67b6521bf0c67a19c8359dd02c3bf8ea8c83b0e"
+      "sha256": "d90ec6d640f3a9a389169180d4a852c85e7c3a5336900f93b871673681b8718a"
     },
     {
       "path": "tests/hierarchy-config.mjs",
@@ -12284,6 +12349,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 +13127,7 @@
     {
       "path": "tests/publish_watch.mjs",
       "mode": "0000644",
-      "sha256": "91ada5b4bf9b22ff8cefb0508be34f5d006bd223c825c73e5bbc9812411a4253"
+      "sha256": "5e2fb1f403e9a60fdcf037eca611296909a8e1c5f2ed404d7623f51266a4f174"
     },
     {
       "path": "tests/push_path_brief.mjs",
@@ -13472,7 +13542,7 @@
     {
       "path": "tests/setup_device_flow_fallback.mjs",
       "mode": "0000644",
-      "sha256": "bbb11a18a38eb7e4c697245928b0de0f34b2a6d36d45812fe0524ba8dc8bc7c2"
+      "sha256": "ec3b12b575cfa3aeae48fb5c9044fe2738e230b5a2007166a7fc24a3ca7fb775"
     },
     {
       "path": "tests/setup_smoke.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