@chankov/agent-fleet 0.0.6 → 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (419) hide show
  1. package/.claude/commands/set-hermes-watchdog.md +6 -0
  2. package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  3. package/.pi/harnesses/agent-hub/README.md +75 -16
  4. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  5. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  6. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  7. package/.pi/harnesses/agent-hub/delegate.ts +58 -9
  8. package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
  9. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  10. package/.pi/harnesses/agent-hub/index.ts +723 -159
  11. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  12. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  13. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  14. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  15. package/.pi/harnesses/agent-hub/package.json +1 -1
  16. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  17. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  18. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  19. package/.pi/harnesses/agent-hub/run-budget.js +29 -3
  20. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  21. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  22. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  23. package/.pi/harnesses/coms/README.md +4 -3
  24. package/.pi/harnesses/coms/index.ts +80 -58
  25. package/.pi/harnesses/coms/package.json +1 -1
  26. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  27. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  28. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  29. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  30. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  31. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  32. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  33. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  34. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  35. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  36. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  37. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  38. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  39. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  40. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  41. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  42. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  43. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  44. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  45. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  46. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  47. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  48. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  49. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  50. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  51. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  52. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  53. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  54. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  55. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  56. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  57. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  58. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  59. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  60. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  61. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  62. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  63. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  64. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  65. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  66. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  67. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  68. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  69. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  70. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  71. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  72. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  73. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  74. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  75. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  76. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  77. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  78. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  79. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  80. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  81. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  82. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  83. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  84. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  85. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  86. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  87. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  88. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  89. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  90. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  91. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  92. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  93. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  94. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  95. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  96. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  97. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  98. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  99. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  100. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  101. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  102. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  103. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  104. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  105. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  106. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  107. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  108. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  109. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  110. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  111. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  112. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  113. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  114. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  115. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  116. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  117. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  118. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  119. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  120. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  121. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  122. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  123. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  124. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  125. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  126. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  127. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  128. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  129. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  130. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  131. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  132. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  133. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  134. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  135. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  136. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  137. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  138. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  139. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  140. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  141. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  142. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  143. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  144. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  145. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  146. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  147. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  148. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  149. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  150. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  151. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  152. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  153. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  154. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  155. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  156. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  157. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  158. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  159. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  160. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  161. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.7/.version +1 -0
  167. package/.versions/0.0.7/agents/architect.md +23 -0
  168. package/.versions/0.0.7/agents/bowser.md +26 -0
  169. package/.versions/0.0.7/agents/builder.md +53 -0
  170. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.7/agents/documenter.md +18 -0
  173. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  174. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.7/agents/planner.md +69 -0
  176. package/.versions/0.0.7/agents/releaser.md +24 -0
  177. package/.versions/0.0.7/agents/researcher.md +28 -0
  178. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  184. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  186. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  188. package/.versions/0.0.7/docs/getting-started.md +231 -0
  189. package/.versions/0.0.7/docs/npm-install.md +337 -0
  190. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.7/hermes/README.md +347 -0
  195. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  196. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  197. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  198. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  199. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  200. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  201. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  202. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  203. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  204. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  205. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  206. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  207. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  208. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  209. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  210. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  211. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  212. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  213. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  214. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  215. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  216. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  217. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  218. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  219. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  220. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  221. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  222. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  223. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  224. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  225. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  226. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  227. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  228. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  229. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  230. package/.versions/0.0.7/hooks/hooks.json +14 -0
  231. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  232. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  233. package/.versions/0.0.7/justfile +245 -0
  234. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  235. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  236. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  237. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  238. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  239. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  240. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  241. package/.versions/0.0.7/references/security-checklist.md +179 -0
  242. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  243. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  244. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  245. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  246. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  247. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  248. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  249. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  250. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  251. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  252. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  253. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  254. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  255. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  256. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  257. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  258. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  259. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  260. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  261. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  262. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  263. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  264. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  265. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  266. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  267. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  268. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  269. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  270. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  271. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  272. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  273. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  274. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  275. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  276. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  277. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  278. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  279. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  280. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  281. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  282. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  283. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  284. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  285. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  286. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  287. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  288. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  289. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  290. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  291. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  292. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  293. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  294. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  295. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  296. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  297. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  298. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  299. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  300. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  301. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  302. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  303. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  304. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  305. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  306. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  307. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  308. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  309. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  310. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  311. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  312. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  313. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  314. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  315. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  316. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  317. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  318. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  319. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  320. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  321. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  322. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  323. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  324. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  325. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  326. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  327. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  328. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  329. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  330. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  331. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  332. package/CHANGELOG.md +134 -0
  333. package/README.md +175 -18
  334. package/agents/code-reviewer.md +2 -2
  335. package/agents/orchestrator.md +11 -0
  336. package/agents/plan-reviewer.md +1 -1
  337. package/agents/planner.md +1 -1
  338. package/agents/security-auditor.md +1 -1
  339. package/bin/cli.js +40 -1
  340. package/bin/lib/hermes-profile-artifact.js +144 -0
  341. package/bin/lib/set-hermes-watchdog.js +173 -0
  342. package/bin/set-hermes-watchdog.js +26 -0
  343. package/docs/ARCHITECTURE.md +64 -12
  344. package/docs/agent-fleet-setup.md +2 -2
  345. package/docs/claude-code-coms-bridge.md +7 -1
  346. package/docs/coms-hermes-bridge.md +10 -0
  347. package/docs/getting-started.md +48 -0
  348. package/docs/hermes-watchdog-supervisor.md +140 -0
  349. package/hermes/README.md +135 -19
  350. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  351. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  352. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  353. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  354. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  355. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  356. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  357. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  358. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  359. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  360. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  361. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  362. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  363. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  364. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  365. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  366. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  367. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  368. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  369. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  370. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  371. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  372. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  373. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  374. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  375. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  376. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  377. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  378. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  379. package/hooks/coms-stop-hook.mjs +12 -1
  380. package/package.json +11 -2
  381. package/scripts/coms-claude-bridge.ts +154 -39
  382. package/scripts/fleet.ts +9 -1
  383. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  384. package/scripts/lib/claude-bridge-core.ts +65 -0
  385. package/scripts/lib/coms-envelope.ts +44 -1
  386. package/scripts/lib/hermes-monitor-events.ts +1 -0
  387. package/scripts/lib/monitor-env.ts +120 -0
  388. package/scripts/team-snapshot.ts +1 -1
  389. package/scripts/team-up.ts +10 -1
  390. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  391. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  392. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  393. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  394. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  395. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  396. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  397. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  398. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  399. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  400. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  401. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  402. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  403. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  404. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  405. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  406. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  407. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  408. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  409. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  410. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  411. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  412. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  413. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  414. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  415. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  416. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  417. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  418. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  419. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
@@ -20,10 +20,10 @@ subagents:
20
20
  model: openai-codex/gpt-5.6-luna
21
21
  tools: read,grep,find,ls
22
22
  quality:
23
- model: openai-codex/gpt-5.6-terra
23
+ model: openai-codex/gpt-5.6-luna
24
24
  tools: read,grep,find,ls
25
25
  perf:
26
- model: openai-codex/gpt-5.6-terra
26
+ model: openai-codex/gpt-5.6-luna
27
27
  tools: read,grep,find,ls
28
28
  docs:
29
29
  model: openai-codex/gpt-5.6-luna
@@ -20,6 +20,8 @@ Before any non-trivial work, read `skills/orchestration-verification/SKILL.md`
20
20
  ## The Verification Contract
21
21
 
22
22
  - **Build the assertion list first.** Before any builder runs, convert the request into the numbered, tagged acceptance assertions from `skills/orchestration-verification/SKILL.md` (`test` | `runtime-ui` | `code-grep` | `manual`, each one checkable pass condition). Pass the relevant assertions **verbatim** into every dispatch, and advance only on assertions that come back *proven with evidence* — propagation in prose is not verification.
23
+ - **Every assertion names its source.** Each entry carries the origin of the requirement it encodes — `A9 ⇐ PLAN-hub-reliability-hardening.md:585-595`, `A3 ⇐ user request`, `A7 ⇐ review finding F3`. You already paste these citations into dispatch prose; record them in the ledger instead, so a specialist told to prove A9 reads its origin rather than spending a dispatch and an ASK_USER cycle asking you where A9 came from. Never synthesise an id you cannot cite — if a requirement has no source, it is your inference, and it belongs in the dispatch as an open question, not in the ledger as an assertion. In pi the hub refuses a sourceless `set_assertions` batch and names the offending ids.
24
+ - **Cap the open ledger at 8.** Declare only the assertions the next batch actually proves; defer the rest and `set_assertions` them when their batch starts. A 30-assertion ledger declared up front is not thoroughness — it is 22 ids nobody is verifying, and it turns every status line into noise. Example: a 46-task plan opens with A1–A6 for batch 1 (each `⇐ PLAN.md:<lines>`); when batch 1 is proven, the next call declares A7–A13 for batch 2. Over the cap the hub warns rather than blocks — treat the warning as a signal to split, not as permission.
23
25
  - **Inventory parity for "behave like" requests.** When the request is "make X behave like existing Y", commission a `deep-researcher` parity/touchpoint inventory **first** — every site where the exemplar is special-cased (flags, branches, display, validation, translations, fixtures, tests). Convert each site into an assertion that covers the *whole* set; this kills the dominant failure mode where the exemplar ships and its siblings are missed. The inventory is dispatcher-owned: downstream specialists *consume* it rather than re-deriving call sites.
24
26
  - **Batch slices; gate batches.** Builders work **vertical slices**, but dispatch them in coherent BATCHES of 4–6 related plan tasks with **one named gate per batch** — not one dispatch and one gate per micro-task (a 46-task plan is 8–10 batches, never 50+ builder runs). No advancement while a batch's assertions are unproven. Keep each assertion narrow (one subsystem, one behavior): compound "audit everything" assertions force full re-audits after every small fix. After a fix, re-verify only the assertions the fix touched.
25
27
  - **Require runtime proof for UI assertions.** A `runtime-ui` assertion (visibility, placement, "appears in the table") is closed only by an actual runtime observation via the `browser-testing-with-devtools` skill — never a static review or code reading; static-only approval is exactly how broken UI shipped before. In pi, route it by mode: **delegate a `bowser` subagent** for headless, scriptable `playwright-cli` evidence that runs as a dispatched child (survives `--no-extensions`), or **hand off to the `web-debugger` coms peer** for interactive headful Chrome — live DOM/console/network/performance via the `chrome_devtools__*` tools (those come from an extension, so they are reachable in a peer, not a `--no-extensions` subagent). Either path must save DOM/screenshot/network evidence under `.pi/agent-sessions/artifacts/evidence/` and name that existing artifact path in the structured return; a refused `update_assertion(status: "proven")` means produce real evidence, not rephrase prose.
@@ -52,3 +54,12 @@ user — never retry the refused call in the same turn.
52
54
  - **Surface trade-offs, don't bury them.** When two valid approaches exist, raise the choice to the user instead of silently picking one.
53
55
  - **Budget-aware, not dispatch-happy.** Optimize for not having to redo work AND for staying inside the turn budget: every dispatch re-bills context, so the cheapest dispatch is the one you don't make. Batch instead of splitting; reuse findings instead of re-deriving them.
54
56
  - **Summarize crisply.** Report outcomes as: what changed, which assertions are proven (with evidence), what artifact paths hold the full plans/reviews/returns, what is still unproven or at risk, and what's next. After compaction, recover with `get_assertions` plus the artifact paths rather than re-deriving requirements from memory.
57
+
58
+ ## Peers and panes (coms)
59
+
60
+ Peers are long-lived agents in their own panes, not dispatches. They keep their context between messages, which makes them valuable and makes an abandoned one expensive.
61
+
62
+ - **`coms_list` is the status source; `herdr_read_pane` is not.** Every entry reports `pane_id` and `status` (`idle` | `working` | `booting`). Check it before you send: `working` means your `coms_send` waits behind the peer's current turn, and `booting` means the peer registered but cannot take work yet. Reading a pane to guess whether an agent is busy is screen-scraping a field you already have — reserve `herdr_read_pane` for unbridged panes and post-mortems, never for polling.
63
+ - **Give a peer time, not retries.** Put the same budget on both calls: `coms_send(reply_timeout_ms: 1200000, ...)`, then `coms_await(timeout_ms: 1200000, ...)`. The send carries the receiver-side deadline; await controls only your local wait. The bridge waits for a busy pane instead of failing, and deadline exhaustion returns `pending` so you can await/get again without re-queueing the work.
64
+ - **Spawn a peer only immediately before the first message to it.** `herdr_spawn_peer` starts a *reusable* peer that boots idle and waits for `coms_send`; it does not receive your task by being spawned. Spawn it, wait for `peer_ready`, and send. A peer spawned "to have it ready" and never addressed is an empty pane consuming a model session — exactly the failure this rule exists for.
65
+ - **Close what you opened.** If a peer you spawned received no work by the end of the turn, say so and offer to close it. The hub names never-addressed hub-spawned panes in the end-of-session digest; `herdr_close_pane` still needs the human's confirmation, so surface the suggestion rather than assuming it.
@@ -12,7 +12,7 @@ thinking: medium
12
12
  delegate_depth: 1
13
13
  subagents:
14
14
  feasibility:
15
- model: openai-codex/gpt-5.6-terra
15
+ model: openai-codex/gpt-5.6-luna
16
16
  tools: read,grep,find,ls
17
17
  deps:
18
18
  model: openai-codex/gpt-5.6-luna
package/agents/planner.md CHANGED
@@ -18,7 +18,7 @@ subagents:
18
18
  model: openai-codex/gpt-5.6-luna
19
19
  tools: read,grep,find,ls
20
20
  risk:
21
- model: openai-codex/gpt-5.6-terra
21
+ model: openai-codex/gpt-5.6-luna
22
22
  tools: read,grep,find,ls
23
23
  ---
24
24
  You are a planner agent. Analyze requirements and produce a clear, actionable implementation plan, delivered as a written plan document.
@@ -15,7 +15,7 @@ subagents:
15
15
  model: openai-codex/gpt-5.6-luna
16
16
  tools: read,grep,find,ls
17
17
  input-sweep:
18
- model: openai-codex/gpt-5.6-terra
18
+ model: openai-codex/gpt-5.6-luna
19
19
  tools: read,grep,find,ls
20
20
  secrets-sweep:
21
21
  model: openai-codex/gpt-5.6-luna
package/bin/cli.js CHANGED
@@ -26,7 +26,8 @@ import { listPersonas, transformPersona } from "./lib/transform-persona.js";
26
26
  import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
27
27
  import { checkAndNotify } from "./lib/update-notifier.js";
28
28
  import { bootstrap, cleanupInstaller, readBootstrapMarker } from "./lib/bootstrap.js";
29
- import { setHermesTelegram } from "./lib/set-hermes-telegram.js";
29
+ import { setHermesTelegram, runHermesCommand } from "./lib/set-hermes-telegram.js";
30
+ import { setHermesWatchdog } from "./lib/set-hermes-watchdog.js";
30
31
 
31
32
  const __dirname = dirname(fileURLToPath(import.meta.url));
32
33
  const pkgRoot = resolve(__dirname, "..");
@@ -97,11 +98,28 @@ switch (sub) {
97
98
  case "cleanup-installer": await cmdCleanupInstaller(); break;
98
99
  case "transform-persona": await cmdTransformPersona(); break;
99
100
  case "set-hermes-telegram": await cmdSetHermesTelegram(); break;
101
+ case "set-hermes-watchdog": await cmdSetHermesWatchdog(); break;
100
102
  default: fail(`unknown command: ${sub}\n\nRun "agent-fleet --help" for usage.`);
101
103
  }
102
104
 
103
105
  // ── commands ──────────────────────────────────────────────────────────────
104
106
 
107
+ async function cmdSetHermesWatchdog() {
108
+ try {
109
+ const result = await setHermesWatchdog({
110
+ positionals: parsed.positionals,
111
+ profile: opts.profile,
112
+ force: opts.force,
113
+ dryRun: opts["dry-run"],
114
+ packageRoot: pkgRoot,
115
+ hermes: runHermesCommand,
116
+ });
117
+ console.log(JSON.stringify(result, null, 2));
118
+ } catch (err) {
119
+ fail(err instanceof Error ? err.message : String(err));
120
+ }
121
+ }
122
+
105
123
  async function cmdSetHermesTelegram() {
106
124
  try {
107
125
  const result = await setHermesTelegram({
@@ -626,6 +644,25 @@ Examples:
626
644
  agent-fleet transform-persona --list --agent claude-code
627
645
  agent-fleet transform-persona --agent claude-code code-reviewer
628
646
  agent-fleet transform-persona --agent opencode --all --workspace ~/projects/foo
647
+ `);
648
+ return;
649
+ }
650
+ if (sub === "set-hermes-watchdog") {
651
+ console.log(`agent-fleet set-hermes-watchdog <status|install|update|uninstall> [options]
652
+
653
+ Actions:
654
+ status Inspect profile, packaged-skill drift, receipt, and active-lock state
655
+ install | update Atomically install/reconcile the optional foreground watchdog skill
656
+ uninstall Remove only a managed unchanged skill tree; preserve config and journals
657
+
658
+ Options:
659
+ --profile <name> Hermes profile; required unless exactly one gateway is running
660
+ --force Back up a drifted tree before replacement/removal
661
+ --dry-run Report the write that would occur without changing files
662
+ -h, --help Show this help
663
+
664
+ No action starts/stops/restarts a gateway, changes tools, kills a watcher, or enables delivery.
665
+ Gate O remains fail-closed: without genuine live origin proof the installed watcher is local-journal-only.
629
666
  `);
630
667
  return;
631
668
  }
@@ -693,6 +730,7 @@ Commands:
693
730
  transform-persona Generate per-agent subagent files from the canonical
694
731
  agents/*.md personas (used by the setup skill during apply)
695
732
  set-hermes-telegram Install/status the liaison and start/stop its Herdr bridge
733
+ set-hermes-watchdog Install/status/update/uninstall the fail-closed watchdog skill
696
734
 
697
735
  Options:
698
736
  -v, --version Print the package version
@@ -704,6 +742,7 @@ Examples:
704
742
  npx agent-fleet doctor --workspace ~/projects/foo
705
743
  npx agent-fleet update
706
744
  npx agent-fleet set-hermes-telegram on 7883056502:1735
745
+ npx agent-fleet set-hermes-watchdog status --profile default
707
746
 
708
747
  Environment:
709
748
  AGENT_SKILLS_NO_UPDATE_CHECK=1 Disable the background update check
@@ -0,0 +1,144 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
3
+ import { isAbsolute, join, relative, resolve } from "node:path";
4
+
5
+ const ANSI_RE = /\x1B\[[0-?]*[ -/]*[@-~]/g;
6
+
7
+ export const SAFE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
8
+
9
+ export function validateSafeName(value, label = "name") {
10
+ if (!SAFE_NAME_RE.test(value) || value === "." || value.includes("..")) {
11
+ throw new Error(`Invalid ${label}: ${JSON.stringify(value)}`);
12
+ }
13
+ return value;
14
+ }
15
+
16
+ /** Profiles Hermes reports as running, one per `✓ <profile>` line. */
17
+ export function parseRunningGatewayProfiles(output) {
18
+ return String(output)
19
+ .replace(ANSI_RE, "")
20
+ .split("\n")
21
+ .flatMap(line => line.match(/^\s*✓\s+([A-Za-z0-9][A-Za-z0-9._-]*)(?:\s|$)/u)?.[1] ?? []);
22
+ }
23
+
24
+ export function parseProfilePath(output, expectedProfile) {
25
+ const text = String(output).replace(ANSI_RE, "");
26
+ const profile = text.match(/^Profile:\s*(\S+)\s*$/m)?.[1];
27
+ const path = text.match(/^Path:\s*(.+?)\s*$/m)?.[1];
28
+ if (profile !== expectedProfile || !path || !isAbsolute(path)) {
29
+ throw new Error(`Hermes returned an invalid profile description for ${expectedProfile}`);
30
+ }
31
+ return resolve(path);
32
+ }
33
+
34
+ /**
35
+ * Resolve the target profile read-only: `gateway list` for inference plus
36
+ * `profile show` for the path. Never starts, stops, or mutates anything.
37
+ */
38
+ export async function resolveHermesProfile(requestedProfile, hermes) {
39
+ const running = parseRunningGatewayProfiles(await hermes(["gateway", "list"]));
40
+ let profile = requestedProfile?.trim();
41
+ if (profile) {
42
+ validateSafeName(profile, "Hermes profile");
43
+ } else {
44
+ if (running.length !== 1) {
45
+ throw new Error(`cannot infer Hermes profile: expected exactly one running gateway, found ${running.length}; pass --profile NAME`);
46
+ }
47
+ [profile] = running;
48
+ }
49
+ const profilePath = parseProfilePath(await hermes(["profile", "show", profile]), profile);
50
+ if (!existsSync(profilePath)) throw new Error(`unsafe or missing Hermes profile directory: ${profilePath}`);
51
+ const stat = lstatSync(profilePath);
52
+ if (stat.isSymbolicLink() || !stat.isDirectory()) {
53
+ throw new Error(`unsafe or missing Hermes profile directory: ${profilePath}`);
54
+ }
55
+ return { profile, profilePath, gatewayRunning: running.includes(profile) };
56
+ }
57
+
58
+ /**
59
+ * Content-addressed fingerprint over a plain-file tree. Symlinks and other
60
+ * special entries are refusals, not silently skipped or followed.
61
+ * Returns null when the tree is absent.
62
+ */
63
+ export function directoryFingerprint(root) {
64
+ if (!existsSync(root)) return null;
65
+ const hash = createHash("sha256");
66
+ const visit = current => {
67
+ const stat = lstatSync(current);
68
+ if (stat.isSymbolicLink()) throw new Error(`refusing symlink in Hermes skill tree: ${current}`);
69
+ if (stat.isDirectory()) {
70
+ for (const entry of readdirSync(current).sort()) visit(join(current, entry));
71
+ return;
72
+ }
73
+ if (!stat.isFile()) throw new Error(`unsupported entry in Hermes skill tree: ${current}`);
74
+ hash.update(relative(root, current));
75
+ hash.update("\0");
76
+ hash.update(readFileSync(current));
77
+ hash.update("\0");
78
+ };
79
+ visit(root);
80
+ return hash.digest("hex");
81
+ }
82
+
83
+ export function ensurePlainDirectory(dir, parent) {
84
+ if (existsSync(dir)) {
85
+ const stat = lstatSync(dir);
86
+ if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`refusing unsafe Hermes directory: ${dir}`);
87
+ return;
88
+ }
89
+ if (parent) ensurePlainDirectory(parent);
90
+ mkdirSync(dir, { mode: 0o700 });
91
+ }
92
+
93
+ export function artifactState(sourceDir, installedDir) {
94
+ const sourceFingerprint = directoryFingerprint(sourceDir);
95
+ if (!sourceFingerprint) throw new Error(`packaged source is missing: ${sourceDir}`);
96
+ const installedFingerprint = directoryFingerprint(installedDir);
97
+ let state = "drifted";
98
+ if (installedFingerprint === null) state = "missing";
99
+ else if (installedFingerprint === sourceFingerprint) state = "current";
100
+ return { state, sourceFingerprint, installedFingerprint };
101
+ }
102
+
103
+ /** Receipts are rewritten, never appended to, so the 0600 mode always applies. */
104
+ export function writeReceipt(receipt, { name, fingerprint }) {
105
+ const body = JSON.stringify({ schemaVersion: 1, name, fingerprint }, null, 2) + "\n";
106
+ rmSync(receipt, { force: true });
107
+ writeFileSync(receipt, body, { mode: 0o600 });
108
+ }
109
+
110
+ /**
111
+ * Install `sourceDir` at `installedDir` so the profile is left with either the
112
+ * prior complete tree or the new complete tree plus a valid receipt — never a
113
+ * partial tree, a stray temp entry, or a new tree without its receipt.
114
+ * Returns the backup directory holding the replaced tree, or null.
115
+ */
116
+ export function atomicInstallArtifact({ sourceDir, installedDir, profilePath, name, now = () => new Date(), receipt }) {
117
+ const skillsDir = join(profilePath, "skills");
118
+ ensurePlainDirectory(skillsDir, profilePath);
119
+ const temp = join(skillsDir, `.${name}.tmp-${process.pid}-${randomUUID()}`);
120
+ const backupRoot = join(profilePath, "backups", "agent-fleet");
121
+ let backupDir = null;
122
+ let installed = false;
123
+ try {
124
+ cpSync(sourceDir, temp, { recursive: true, errorOnExist: true, force: false });
125
+ directoryFingerprint(temp);
126
+ if (existsSync(installedDir)) {
127
+ ensurePlainDirectory(join(profilePath, "backups"), profilePath);
128
+ ensurePlainDirectory(backupRoot, join(profilePath, "backups"));
129
+ backupDir = join(backupRoot, `${name}-${now().toISOString().replace(/[:.]/g, "-")}`);
130
+ renameSync(installedDir, backupDir);
131
+ }
132
+ renameSync(temp, installedDir);
133
+ installed = true;
134
+ if (receipt) writeReceipt(receipt, { name, fingerprint: directoryFingerprint(installedDir) });
135
+ return backupDir;
136
+ } catch (error) {
137
+ rmSync(temp, { recursive: true, force: true });
138
+ // A receipt failure leaves the new tree in place; undo it so the profile
139
+ // keeps exactly the state it had before this call.
140
+ if (installed) rmSync(installedDir, { recursive: true, force: true });
141
+ if (backupDir && existsSync(backupDir) && !existsSync(installedDir)) renameSync(backupDir, installedDir);
142
+ throw error;
143
+ }
144
+ }
@@ -0,0 +1,173 @@
1
+ import { createHash } from "node:crypto";
2
+ import { existsSync, lstatSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import {
5
+ artifactState,
6
+ atomicInstallArtifact,
7
+ ensurePlainDirectory,
8
+ resolveHermesProfile,
9
+ writeReceipt,
10
+ } from "./hermes-profile-artifact.js";
11
+
12
+ const NAME = "hub-watchdog";
13
+ const ACTIONS = ["status", "install", "update", "uninstall"];
14
+
15
+ const defaultConfig = {
16
+ schemaVersion: 1,
17
+ autonomy: "observe",
18
+ maximumAutonomy: "observe",
19
+ surgicalAllowlist: [],
20
+ originDelivery: "required",
21
+ runtimeDir: null,
22
+ };
23
+
24
+ export function watchdogLockPath(runtimeRoot, profileId) {
25
+ // Keep lifecycle inspection byte-for-byte aligned with watchdog.py profile_root().
26
+ const profileHash = createHash("sha256").update(profileId).digest("hex");
27
+ return join(runtimeRoot, "agent-fleet-hermes-watchdog", profileHash, "watch.lock");
28
+ }
29
+
30
+ function usage() {
31
+ return new Error("Usage: agent-fleet set-hermes-watchdog <status|install|update|uninstall> [--profile NAME] [--force] [--dry-run]");
32
+ }
33
+
34
+ export function parseSetHermesWatchdogArgs(argv) {
35
+ if (argv.length !== 1 || !ACTIONS.includes(argv[0])) throw usage();
36
+ return { action: argv[0] };
37
+ }
38
+
39
+ function plainFile(path) {
40
+ if (!existsSync(path)) return false;
41
+ const stat = lstatSync(path);
42
+ return !stat.isSymbolicLink() && stat.isFile();
43
+ }
44
+
45
+ /**
46
+ * `managed` only when a plain receipt names the exact installed fingerprint;
47
+ * `unmanaged` when no receipt exists at all; anything else is `drifted`.
48
+ */
49
+ function receiptState(receipt, installedFingerprint) {
50
+ if (!existsSync(receipt)) return "unmanaged";
51
+ if (!plainFile(receipt)) return "drifted";
52
+ try {
53
+ const parsed = JSON.parse(readFileSync(receipt, "utf8"));
54
+ return parsed.fingerprint === installedFingerprint ? "managed" : "drifted";
55
+ } catch {
56
+ return "drifted";
57
+ }
58
+ }
59
+
60
+ /** Read-only inspection: two Hermes reads, no profile, service, or tool mutation. */
61
+ export async function inspectHermesWatchdog(options) {
62
+ const resolved = await resolveHermesProfile(options.profile, options.hermes);
63
+ const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", NAME);
64
+ const installedDir = join(resolved.profilePath, "skills", NAME);
65
+ const receipt = join(resolved.profilePath, "agent-fleet", `${NAME}.receipt.json`);
66
+ const skill = artifactState(sourceDir, installedDir);
67
+ const runtimeRoot = options.runtimeRoot ?? process.env.XDG_RUNTIME_DIR ?? "/tmp";
68
+ return {
69
+ ...resolved,
70
+ sourceDir,
71
+ installedDir,
72
+ receipt,
73
+ configPath: join(resolved.profilePath, "agent-fleet", "watchdog.json"),
74
+ skillState: skill.state,
75
+ receiptState: receiptState(receipt, skill.installedFingerprint),
76
+ lockActive: existsSync(watchdogLockPath(runtimeRoot, resolved.profile)),
77
+ originDelivery: false,
78
+ };
79
+ }
80
+
81
+ /**
82
+ * What an explicit install/update would do, without touching anything.
83
+ * `adopt` covers an identical unmanaged tree: only the receipt is missing.
84
+ */
85
+ function planInstall(before, force) {
86
+ if (before.skillState === "missing") return { mode: "install" };
87
+ if (before.skillState === "drifted") {
88
+ if (!force) throw new Error(`${NAME} differs from packaged Agent Fleet source; re-run with --force to back it up and replace it`);
89
+ return { mode: "install" };
90
+ }
91
+ if (before.receiptState === "managed") return { mode: "none" };
92
+ if (before.receiptState === "unmanaged") return { mode: "adopt" };
93
+ if (!force) throw new Error(`${NAME} has an unreadable or mismatched receipt; re-run with --force to back up the tree and reinstall it`);
94
+ return { mode: "install" };
95
+ }
96
+
97
+ /**
98
+ * Adopt an identical unmanaged tree by writing only the receipt. The
99
+ * fingerprint is recomputed here so a tree that changed since inspection —
100
+ * or that grew a symlink — is refused instead of blessed.
101
+ */
102
+ function adoptUnmanaged(before) {
103
+ const fresh = artifactState(before.sourceDir, before.installedDir);
104
+ if (fresh.state !== "current") {
105
+ throw new Error(`${NAME} changed while being adopted; re-run status and retry`);
106
+ }
107
+ ensurePlainDirectory(join(before.profilePath, "agent-fleet"), before.profilePath);
108
+ writeReceipt(before.receipt, { name: NAME, fingerprint: fresh.installedFingerprint });
109
+ }
110
+
111
+ function writeDefaultConfig(before) {
112
+ if (existsSync(before.configPath)) return;
113
+ ensurePlainDirectory(join(before.profilePath, "agent-fleet"), before.profilePath);
114
+ writeFileSync(before.configPath, JSON.stringify(defaultConfig, null, 2) + "\n", { mode: 0o600 });
115
+ }
116
+
117
+ /**
118
+ * Remove only a matching managed tree. Config and journals are preserved, and
119
+ * an active watcher is reported by `lockActive` but never signalled.
120
+ */
121
+ function removeManaged(before, { force, dryRun }) {
122
+ if (before.skillState === "missing") return { changed: false };
123
+ const managed = before.skillState === "current" && before.receiptState === "managed";
124
+ if (!managed && !force) {
125
+ throw new Error(`${NAME} is ${before.skillState}/${before.receiptState}; re-run with --force to back it up and remove only this tree`);
126
+ }
127
+ if (dryRun) return { changed: true, dryRun: true };
128
+ const backupRoot = join(before.profilePath, "backups", "agent-fleet");
129
+ ensurePlainDirectory(join(before.profilePath, "backups"), before.profilePath);
130
+ ensurePlainDirectory(backupRoot, join(before.profilePath, "backups"));
131
+ const backupDir = join(backupRoot, `${NAME}-uninstall-${new Date().toISOString().replace(/[:.]/g, "-")}`);
132
+ renameSync(before.installedDir, backupDir);
133
+ rmSync(before.receipt, { force: true });
134
+ return { changed: true, backupDir };
135
+ }
136
+
137
+ export async function setHermesWatchdog(options) {
138
+ const { action } = parseSetHermesWatchdogArgs(options.positionals);
139
+ const before = await inspectHermesWatchdog(options);
140
+
141
+ if (action === "status") return { action, ...before };
142
+ if (action === "uninstall") return { action, ...before, ...removeManaged(before, options) };
143
+
144
+ const planned = planInstall(before, options.force);
145
+ const configPending = !existsSync(before.configPath);
146
+ if (options.dryRun) {
147
+ return { action, ...before, changed: planned.mode !== "none" || configPending, adopted: planned.mode === "adopt", dryRun: true };
148
+ }
149
+
150
+ let backupDir = null;
151
+ if (planned.mode === "install") {
152
+ ensurePlainDirectory(join(before.profilePath, "agent-fleet"), before.profilePath);
153
+ backupDir = atomicInstallArtifact({
154
+ sourceDir: before.sourceDir,
155
+ installedDir: before.installedDir,
156
+ profilePath: before.profilePath,
157
+ name: NAME,
158
+ receipt: before.receipt,
159
+ now: options.now,
160
+ });
161
+ } else if (planned.mode === "adopt") {
162
+ adoptUnmanaged(before);
163
+ }
164
+ writeDefaultConfig(before);
165
+
166
+ return {
167
+ action,
168
+ changed: planned.mode !== "none" || configPending,
169
+ adopted: planned.mode === "adopt",
170
+ backupDir,
171
+ ...await inspectHermesWatchdog(options),
172
+ };
173
+ }
@@ -0,0 +1,26 @@
1
+ #!/usr/bin/env node
2
+ import { fileURLToPath } from "node:url";
3
+ import { dirname, resolve } from "node:path";
4
+ import { runHermesCommand } from "./lib/set-hermes-telegram.js";
5
+ import { setHermesWatchdog } from "./lib/set-hermes-watchdog.js";
6
+
7
+ const argv = process.argv.slice(2);
8
+ const profileIndex = argv.indexOf("--profile");
9
+ const profile = profileIndex < 0 ? undefined : argv[profileIndex + 1];
10
+ const positionals = argv.filter((value, index) => !value.startsWith("--") && (profileIndex < 0 || index !== profileIndex + 1));
11
+ const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
12
+
13
+ try {
14
+ const result = await setHermesWatchdog({
15
+ positionals,
16
+ profile,
17
+ force: argv.includes("--force"),
18
+ dryRun: argv.includes("--dry-run"),
19
+ packageRoot,
20
+ hermes: runHermesCommand,
21
+ });
22
+ console.log(JSON.stringify(result, null, 2));
23
+ } catch (error) {
24
+ console.error(error instanceof Error ? error.message : String(error));
25
+ process.exitCode = 1;
26
+ }
@@ -13,7 +13,8 @@ the runtime responsibilities and where each module lives in the repository.
13
13
  | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | `.pi/harnesses/coms/`, `scripts/lib/coms-envelope.ts`, `scripts/coms-cli.ts` |
14
14
  | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
15
15
  | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
16
- | **Hermes local monitor transport** | Local, authenticated visibility/control contract for hub-owned task generations; presentation is supplied by an external consumer | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) |
16
+ | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
17
+ | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
17
18
  | **Codex remote-control conductor** | Experimental outbound-only, user-systemd-managed Android conductor; verified on Codex CLI 0.144.x | `scripts/codex-remote-control.ts`, `scripts/codex-conductor.ts`, `codex/CONDUCTOR.md`, `systemd/user/`; runtime under `~/.local/state/agent-fleet/codex-conductor/` — see [codex-remote-conductor.md](codex-remote-conductor.md) |
18
19
  | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
19
20
  | **Personas** | Reusable specialist definitions, transformed per harness | `agents/`, `bin/lib/transform-persona.js` |
@@ -96,10 +97,18 @@ The hub enforces per-user-turn budgets in code (`run-budget.js`): `fast`/`standa
96
97
  modes cap `dispatch_agent` calls, `spawn_research` calls, and wall clock per turn, set the
97
98
  per-run deadline above, and control nested delegation. Exhausted budgets make the dispatch
98
99
  tools refuse with "summarize and ask the user"; a new user message opens a fresh window.
99
- Specialist context pressure is measured over input + cacheRead + cacheWrite, and specialist
100
- sessions are recycled (fresh spawn instead of `-c` resume) after `session-recycle-runs` runs
101
- or ≥60% measured context — resumed sessions otherwise re-bill their accumulated context on
102
- every model call. Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
100
+ Specialist context pressure is measured over input + cacheRead + cacheWrite against **that
101
+ agent's own** model window, resolved from pi's model registry with the source recorded
102
+ (`context-window.js`) — measuring a 49k local model against the dispatcher's window is what
103
+ made readings like "315%" unactionable; anything over 100% now emits a one-time diagnostic
104
+ naming the window and where it came from. Specialist sessions are recycled (fresh spawn
105
+ instead of `-c` resume) after `session-recycle-runs` runs, at ≥60% measured context, and
106
+ unconditionally at a full window; a resumed session whose *projected* prompt would overflow
107
+ is recycled before the spawn rather than after the run. Requests to one provider are capped
108
+ per process (`provider-semaphore.js`: 2 in flight for `custom/*` by default, unlimited
109
+ elsewhere, `AGENT_HUB_PROVIDER_LIMITS` to override) — the cap is per level of the delegation
110
+ tree, and a nested spawn reuses its parent's permit so it can never wait on its own ancestor.
111
+ Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
103
112
  `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
104
113
  switched live with `/af-hub-mode`.
105
114
 
@@ -111,7 +120,11 @@ observed in-flight from the JSON event stream — deterministic rules (out-of-sc
111
120
  against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
112
121
  escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
113
122
  `drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
114
- (`watchdog` key, `/af-watchdog`, `watchdog` param). **Dynamic teams**: `/af-agents-add`,
123
+ (`watchdog` key, `/af-watchdog`, `watchdog` param). Two rules about scope: the session's
124
+ own `artifacts/`, `findings/`, and `delegations/` subtrees are implicitly in scope (the
125
+ deliverable protocol *orders* specialists to write there, and the judge is told so), and the
126
+ `scope` rule is non-terminal — it reports a drift advisory on the result and never stops a
127
+ run by itself, matching the post-run scope gate, which reverts nothing. **Dynamic teams**: `/af-agents-add`,
115
128
  `/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
116
129
  every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
117
130
  outside fast mode, with user notification. `/af-hub-report` accounts each turn's dispatches,
@@ -126,7 +139,7 @@ flowchart TD
126
139
  AF -->|control plane| HERDR["<b>herdr</b><br/>tiled peer workspaces,<br/>presence, snapshot/resume"]
127
140
  AF -->|peer + install target| CC["<b>Claude Code</b><br/>bidirectional peer via<br/>the coms bridge"]
128
141
  AF -->|install target| OC["<b>OpenCode</b><br/>skill-driven execution<br/>(AGENTS.md + skill tool)"]
129
- AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed<br/>to your phone (Telegram)"]
142
+ AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed to your phone,<br/>plus the Desktop fleet panel"]
130
143
  AF -->|outbound remote delegation| CODEX["<b>Codex Remote Control</b><br/>Android-approved calls to<br/>listed coms peers (experimental)"]
131
144
  ```
132
145
 
@@ -140,7 +153,7 @@ These are the external systems Agent Fleet assumes or integrates with — not np
140
153
  | **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for team mode (`just fleet team`); optional for `just fleet hub` |
141
154
  | **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class peer via the [coms bridge](claude-code-coms-bridge.md); also a supported install target for skills/personas | Optional peer / alternate harness |
142
155
  | **[OpenCode](https://opencode.ai)** | Skill-driven execution target (`AGENTS.md` + `skill` tool); `af-*` slash commands | Optional alternate harness |
143
- | **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions) — [coms-hermes-bridge](coms-hermes-bridge.md) | Optional |
156
+ | **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions — [coms-hermes-bridge](coms-hermes-bridge.md)) and the Desktop fleet panel ([hermes-desktop-plugins](hermes-desktop-plugins.md), needs v0.19.0+ and the Desktop app) | Optional |
144
157
  | **Codex CLI + ChatGPT Android** | Experimental outbound remote-control conductor on supported `0.144.x`; requires Node `22.6+`, user systemd, interactive pairing, and per-command mobile approvals — [runbook](codex-remote-conductor.md) | Optional / revalidate after minor-version or mobile-client changes |
145
158
  | **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)** | Upstream skill library (manually vendored) | Bundled (vendored) |
146
159
  | **[disler/pi-vs-claude-code](https://github.com/disler/pi-vs-claude-code)** | Source inspiration / MIT port origin for pi harnesses | Design lineage (ported in-repo) |
@@ -179,6 +192,32 @@ packages/hermes-bridge/ # future Hermes integration package
179
192
  - **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
180
193
  context if it can live on disk or in a one-line status. Research findings,
181
194
  the Verification Contract ledger, and team snapshots are all disk-first.
195
+ - **A harness fault must never look like a specialist fault.** The hub passes
196
+ `--session <file>` on every run, so one corrupt session file used to fail a
197
+ persona in ~1s with no output — indistinguishable from a bad agent, and
198
+ unrecoverable by drop + re-add. Unusable session files are now validated and
199
+ quarantined (`session-health.js`) with the reset named in the result. Same rule
200
+ for the return contract: a report the parser cannot read gets one cheap
201
+ read-only extraction pass (`return-extract.js`) before its assertions are
202
+ written off as unproven, and extracted evidence is always labelled as weaker
203
+ than declared evidence. The converse also holds: a run that errored or timed
204
+ out writes to `artifacts/failures/`, never `returns/` — an error stub filed
205
+ as a return reads as a specialist verdict and gets acted on as one.
206
+ - **A pool status field beats reading the screen.** `coms_list` publishes each
207
+ peer's `pane_id` and `status` (`idle`/`working`/`booting`), and
208
+ `herdr_spawn_peer` waits for the peer to register and returns `peer_ready`
209
+ rather than a bare pane id. A spawned peer boots idle and does nothing until
210
+ addressed, so peers spawned and never sent to are named at turn end and in
211
+ `/af-hub-report` (`spawned-peers.js`); closing stays the human's call.
212
+ - **A declared requirement carries its origin.** Every assertion in the ledger
213
+ names its source (`assertion-ledger.js`), and the open ledger is soft-capped
214
+ at 8 — an id nobody can trace back to a plan line costs a dispatch and an
215
+ ASK_USER cycle to re-derive.
216
+ - **Pre-flight validation is free.** Anything the hub can reject before spawning
217
+ — an unresolvable artifact path, an unknown research persona — is refused
218
+ without spending a turn-budget slot. Artifact paths also resolve across
219
+ artifact kinds when the name is unique, since the hub writes every auto-return
220
+ under `returns/` while dispatchers reasonably guess `reviews/`.
182
221
  - **Herdr owns panes, presence, and lifecycle; coms owns messages.** Fleet
183
222
  recipes hard-require a running herdr server and refuse with an actionable
184
223
  message otherwise; non-fleet recipes never touch herdr.
@@ -187,10 +226,23 @@ packages/hermes-bridge/ # future Hermes integration package
187
226
  the fleet core stays agent-agnostic. Hermes remains the inbound `ask_user`/
188
227
  Telegram route; the experimental Codex conductor is outbound-initiated only,
189
228
  approval-gated, and restricted to listed peers through the validated wrapper.
190
- - **Hermes monitor presentation is outside the fleet core.** Agent Fleet owns task state,
191
- bounded output, leases, and generation-safe cancellation, and exposes them only through
192
- owner-only discovery and a local Unix socket. A Hermes-facing consumer owns its UI and
193
- reconnect behavior; no Hermes backend/Desktop plugin is bundled or installed.
229
+ - **Hermes monitor presentation is outside the fleet core.** Agent Fleet exposes owner-only
230
+ local monitor operations for Hub-owned state; a consumer owns its UI and lifecycle. The
231
+ worktree contains additive monitor/event/invoke code, but that implementation and its local
232
+ tests are not proof of a durable external identity or live delivery contract. `invoke`, where
233
+ available, is Hub-owned and queues dispatcher work rather than exposing tools directly.
234
+ - **Packaged Hermes source is opt-in, never auto-installed.** The npm tarball carries the
235
+ `hub-watchdog` skill (`hermes/skills/`) plus the backend and Desktop monitor plugin source
236
+ (`hermes/plugins/`, `hermes/desktop-plugins/`) as runtime-only source. Shipping that source
237
+ makes it available to an operator; installing it into a Hermes profile is always an explicit
238
+ action through `agent-fleet set-hermes-watchdog` (skill) or the consumer's own flow (plugins).
239
+ Nothing is enabled, launched, or configured by installing the package.
240
+ - **Watchdog delivery is capability-gated and currently unproven.** No checked-in
241
+ Gate O live artifact proves Hermes origin identity, updates, reconnect, or two-chat isolation,
242
+ so its supported posture is journal-only/dormant: no delivery, steering, or surgical use. It
243
+ never manages services, gateways, Herdr, or shell commands. Local runtime evidence — including
244
+ a real foreground watcher against a disposable Hub UDS — is `synthetic-local` and proves none of
245
+ those capabilities; see [the watchdog runbook](hermes-watchdog-supervisor.md).
194
246
  - **External conductor contracts are advisory.** Pi damage-control wraps Pi
195
247
  tool calls, not Hermes or Codex processes; human approvals and their
196
248
  contracts reduce risk but do not provide an OS command allowlist.
@@ -98,10 +98,10 @@ targets an end-of-session compound pass writes lessons to.
98
98
  |-----|---------|---------|
99
99
  | `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
100
100
  | `persona-gate` | `off` | When `on`, blocks input at session start until an orchestrator persona is picked. |
101
- | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). |
101
+ | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). If the override reports a model/provider error or aborted request before producing text or starting a tool (including a local-model memory-limit failure), agent-hub restores the child session and retries once with the original frontmatter model; it does not fallback after work starts, cancellation, timeout, drift stop, or process-spawn failure. |
102
102
  | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
103
103
  | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
104
- | `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>]`. Other declared roles keep their frontmatter values. |
104
+ | `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>]`. Other declared roles keep their frontmatter values. Existing roles retain their original frontmatter model as the same one-shot, pre-work-only runtime fallback; model-only overrides retain the declared tool cap. |
105
105
  | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
106
106
  | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
107
107
  | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |