@chankov/agent-fleet 0.0.5 → 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 (695) 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/extensions/agent-fleet-update-check/README.md +4 -4
  4. package/.pi/extensions/btw/README.md +10 -10
  5. package/.pi/extensions/btw/index.ts +11 -11
  6. package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
  7. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  8. package/.pi/extensions/compact-and-continue/README.md +2 -2
  9. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  10. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  11. package/.pi/harnesses/agent-hub/README.md +133 -74
  12. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  13. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  14. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  15. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  16. package/.pi/harnesses/agent-hub/delegate.ts +61 -12
  17. package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
  18. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  19. package/.pi/harnesses/agent-hub/index.ts +970 -406
  20. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  21. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  22. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  23. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  24. package/.pi/harnesses/agent-hub/package.json +1 -1
  25. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  26. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  27. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  28. package/.pi/harnesses/agent-hub/run-budget.js +30 -4
  29. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  30. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  31. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  32. package/.pi/harnesses/coms/README.md +6 -5
  33. package/.pi/harnesses/coms/index.ts +92 -70
  34. package/.pi/harnesses/coms/package.json +1 -1
  35. package/.pi/harnesses/damage-control-continue/README.md +9 -9
  36. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  37. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  38. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  39. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  40. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  41. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  42. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  43. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  44. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  45. package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
  46. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  47. package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
  48. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  49. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  50. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  51. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  52. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  53. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  54. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  55. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  56. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  57. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  58. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  59. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  60. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  61. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  62. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  63. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  64. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  65. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  66. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  67. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  68. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  69. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  70. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  71. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  72. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  73. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  74. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  75. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  76. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  77. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  78. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  79. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  80. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  81. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  82. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  83. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  84. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  85. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  86. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  87. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  88. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  89. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  90. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  91. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  92. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  93. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  94. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  95. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  96. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  97. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  98. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  99. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  100. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  101. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  102. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  103. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  104. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  105. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  106. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  107. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  108. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  109. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  110. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  111. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  112. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  113. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  114. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  115. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  116. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  117. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  118. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  119. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  120. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  121. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  122. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  123. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  124. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  125. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  126. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  127. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  128. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  129. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  130. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  131. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  132. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  133. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  134. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  135. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  136. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  137. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  138. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  139. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  140. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  141. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  142. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  143. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  144. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  145. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  146. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  147. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  148. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  150. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  152. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  154. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  155. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  156. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  157. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  158. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  159. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  160. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  161. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.6/.version +1 -0
  167. package/.versions/0.0.6/agents/architect.md +23 -0
  168. package/.versions/0.0.6/agents/bowser.md +26 -0
  169. package/.versions/0.0.6/agents/builder.md +53 -0
  170. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.6/agents/documenter.md +18 -0
  173. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  174. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.6/agents/planner.md +69 -0
  176. package/.versions/0.0.6/agents/releaser.md +24 -0
  177. package/.versions/0.0.6/agents/researcher.md +28 -0
  178. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  184. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  186. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  188. package/.versions/0.0.6/docs/getting-started.md +183 -0
  189. package/.versions/0.0.6/docs/npm-install.md +337 -0
  190. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.6/hermes/README.md +231 -0
  195. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  196. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  197. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  198. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  199. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  200. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  201. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  202. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  203. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  204. package/.versions/0.0.6/hooks/hooks.json +14 -0
  205. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  206. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  207. package/.versions/0.0.6/justfile +245 -0
  208. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  209. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  210. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  211. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  212. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  213. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  214. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  215. package/.versions/0.0.6/references/security-checklist.md +179 -0
  216. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  217. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  218. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  219. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  220. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  221. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  222. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  223. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  224. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  225. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  226. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  227. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  228. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  229. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  230. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  231. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  232. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  233. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  234. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  235. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  236. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  237. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  238. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  239. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  240. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  241. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  242. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  243. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  244. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  245. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  246. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  247. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  248. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  249. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  250. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  251. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  252. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  253. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  254. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  255. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  256. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  257. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  258. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  259. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  260. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  261. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  262. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  263. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  264. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  265. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  266. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  268. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  269. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  270. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  271. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  272. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  273. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  274. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  275. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  276. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  277. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  278. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  279. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  280. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  281. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  282. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  283. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  284. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  285. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  286. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  287. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  288. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  289. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  290. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  291. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  292. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  293. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  294. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  295. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  296. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  297. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  298. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  299. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  300. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  301. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  302. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  303. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  304. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  305. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  306. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  307. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  308. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  309. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  310. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  311. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  312. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  313. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  314. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  315. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  316. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  317. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  318. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  319. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  320. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  321. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  322. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  323. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  324. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  325. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  326. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  327. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  328. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  329. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  330. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  331. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  332. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  333. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  334. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  335. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  336. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  337. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  338. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  339. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  340. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  341. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  342. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  343. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  344. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  345. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  346. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  347. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  348. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  349. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  350. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  351. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  352. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  353. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  354. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  355. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  356. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  357. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  358. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  359. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  360. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  361. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  362. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  363. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  364. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  365. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  366. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  367. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  368. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  369. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  370. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  371. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  372. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  373. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  374. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  375. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  376. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  377. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  378. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  379. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  380. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  381. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  382. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  383. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  384. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  385. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  386. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  387. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  388. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  389. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  390. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  391. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  392. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  393. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  394. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  395. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  396. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  397. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  398. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  399. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  400. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  401. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  402. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  403. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  404. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  405. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  406. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  407. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  408. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  409. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  410. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  411. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  412. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  413. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  414. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  415. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  416. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  417. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  418. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  419. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  420. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  421. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  422. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  423. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  424. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  425. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  426. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  427. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  428. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  429. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  430. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  431. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  432. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  433. package/.versions/0.0.7/.version +1 -0
  434. package/.versions/0.0.7/agents/architect.md +23 -0
  435. package/.versions/0.0.7/agents/bowser.md +26 -0
  436. package/.versions/0.0.7/agents/builder.md +53 -0
  437. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  438. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  439. package/.versions/0.0.7/agents/documenter.md +18 -0
  440. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  441. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  442. package/.versions/0.0.7/agents/planner.md +69 -0
  443. package/.versions/0.0.7/agents/releaser.md +24 -0
  444. package/.versions/0.0.7/agents/researcher.md +28 -0
  445. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  446. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  447. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  448. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  449. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  450. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  451. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  452. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  453. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  454. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  455. package/.versions/0.0.7/docs/getting-started.md +231 -0
  456. package/.versions/0.0.7/docs/npm-install.md +337 -0
  457. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  458. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  459. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  460. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  461. package/.versions/0.0.7/hermes/README.md +347 -0
  462. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  463. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  464. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  465. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  466. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  467. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  468. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  469. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  470. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  471. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  472. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  473. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  474. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  475. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  476. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  477. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  478. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  479. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  480. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  481. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  482. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  483. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  484. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  485. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  486. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  487. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  488. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  489. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  490. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  491. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  492. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  493. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  494. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  495. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  496. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  497. package/.versions/0.0.7/hooks/hooks.json +14 -0
  498. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  499. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  500. package/.versions/0.0.7/justfile +245 -0
  501. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  502. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  503. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  504. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  505. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  506. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  507. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  508. package/.versions/0.0.7/references/security-checklist.md +179 -0
  509. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  510. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  511. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  512. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  513. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  514. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  515. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  516. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  517. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  518. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  519. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  520. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  521. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  522. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  523. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  524. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  525. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  526. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  527. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  528. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  529. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  530. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  531. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  532. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  533. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  534. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  535. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  536. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  537. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  538. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  539. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  540. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  541. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  542. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  543. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  544. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  545. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  546. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  547. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  548. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  549. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  550. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  551. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  552. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  553. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  554. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  555. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  556. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  557. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  558. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  559. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  560. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  561. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  562. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  563. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  564. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  565. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  566. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  567. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  568. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  569. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  570. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  571. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  572. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  573. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  574. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  575. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  576. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  577. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  578. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  579. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  580. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  581. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  582. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  583. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  584. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  585. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  586. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  587. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  588. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  589. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  590. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  591. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  592. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  593. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  594. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  595. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  596. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  597. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  598. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  599. package/CHANGELOG.md +140 -0
  600. package/README.md +198 -40
  601. package/agents/code-reviewer.md +2 -2
  602. package/agents/documenter.md +1 -1
  603. package/agents/orchestrator.md +11 -0
  604. package/agents/plan-reviewer.md +1 -1
  605. package/agents/planner.md +1 -1
  606. package/agents/releaser.md +1 -1
  607. package/agents/security-auditor.md +1 -1
  608. package/bin/cli.js +60 -21
  609. package/bin/lib/bootstrap.js +16 -16
  610. package/bin/lib/doctor.js +1 -1
  611. package/bin/lib/hermes-profile-artifact.js +144 -0
  612. package/bin/lib/set-hermes-watchdog.js +173 -0
  613. package/bin/set-hermes-watchdog.js +26 -0
  614. package/docs/ARCHITECTURE.md +67 -15
  615. package/docs/agent-fleet-setup.md +13 -13
  616. package/docs/claude-code-coms-bridge.md +7 -1
  617. package/docs/coms-hermes-bridge.md +18 -8
  618. package/docs/getting-started.md +48 -0
  619. package/docs/hermes-watchdog-supervisor.md +140 -0
  620. package/docs/npm-install.md +21 -21
  621. package/docs/pi-extensions.md +7 -7
  622. package/docs/pi-setup.md +51 -47
  623. package/hermes/README.md +135 -19
  624. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  625. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  626. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  627. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  628. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  629. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  630. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  631. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  632. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  633. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  634. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  635. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  636. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  637. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  638. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  639. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  640. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  641. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  642. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  643. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  644. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  645. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  646. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  647. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  648. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  649. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  650. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  651. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  652. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  653. package/hooks/coms-stop-hook.mjs +12 -1
  654. package/package.json +11 -2
  655. package/references/fleet-coordination-patterns.md +2 -2
  656. package/scripts/coms-claude-bridge.ts +154 -39
  657. package/scripts/fleet.ts +9 -1
  658. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  659. package/scripts/lib/claude-bridge-core.ts +65 -0
  660. package/scripts/lib/coms-envelope.ts +44 -1
  661. package/scripts/lib/hermes-monitor-events.ts +1 -0
  662. package/scripts/lib/monitor-env.ts +120 -0
  663. package/scripts/team-snapshot.ts +1 -1
  664. package/scripts/team-up.ts +10 -1
  665. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  666. package/skills/compound-learning/SKILL.md +3 -3
  667. package/skills/guided-workspace-setup/SKILL.md +16 -14
  668. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  669. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  670. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  671. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  672. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  673. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  674. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  675. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  676. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  677. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  678. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  679. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  680. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  681. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  682. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  683. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  684. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  685. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  686. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  687. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  688. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  689. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  690. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  691. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  692. /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
  693. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  694. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  695. /package/.pi/prompts/{test.md → af-test.md} +0 -0
@@ -0,0 +1,8 @@
1
+ # Manifest-only plugin: it ships no agent tools and no hooks, and exists so
2
+ # `hermes plugins enable agent-fleet-herdr` has a name to accept. That enable
3
+ # record in config.yaml is what opens the `/api/plugins/agent-fleet-herdr/*`
4
+ # gate in hermes_cli/web_server.py:576 — without it every request 404s with
5
+ # {"detail": "Plugin not found"} before routing is even reached.
6
+ name: agent-fleet-herdr
7
+ version: "0.1.0"
8
+ description: Read-only view of live Agent Fleet sessions in Hermes Desktop
@@ -0,0 +1,139 @@
1
+ """Agent Fleet-owned, local-only monitor transport boundary.
2
+
3
+ Hermes supplies the FastAPI router; this adapter speaks only the source-owned
4
+ monitor UDS protocol and never controls Hermes, Pi, or Herdr lifecycle.
5
+ """
6
+ import hashlib
7
+ import json
8
+ import os
9
+ import re
10
+ import socket
11
+ import stat
12
+ from datetime import datetime, timezone
13
+ from pathlib import Path
14
+
15
+ MAX_SNAPSHOT_RESPONSE_BYTES = 256 * 1024
16
+ MAX_CANCEL_RESPONSE_BYTES = 16 * 1024
17
+ MAX_OUTPUT_RESPONSE_BYTES = 2 * 1024 * 1024
18
+
19
+ class MonitorUnavailable(RuntimeError): pass
20
+
21
+ class MonitorAdapter:
22
+ def __init__(self, socket_path: str, token: str) -> None:
23
+ if not socket_path or not token or not os.path.isabs(socket_path):
24
+ raise MonitorUnavailable("local monitor configuration is unavailable")
25
+ self._socket_path, self._token = socket_path, token
26
+
27
+ @classmethod
28
+ def from_environment(cls, env: dict[str, str] | None = None) -> "MonitorAdapter":
29
+ values = os.environ if env is None else env
30
+ return cls(values.get("AGENT_FLEET_MONITOR_SOCKET", ""), values.get("AGENT_FLEET_MONITOR_TOKEN", ""))
31
+
32
+ @staticmethod
33
+ def canonical_profile_id(profile_id: str) -> str:
34
+ # Matches Node's conservative human profile-ID validation and namespace hash.
35
+ if not isinstance(profile_id, str) or not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]{0,127}", profile_id) or ".." in profile_id:
36
+ raise MonitorUnavailable("monitor profile discovery is unavailable")
37
+ return hashlib.sha256(profile_id.encode()).hexdigest()
38
+
39
+ @classmethod
40
+ def from_profile_environment(cls, env: dict[str, str] | None = None) -> "MonitorAdapter":
41
+ values = os.environ if env is None else env
42
+ profile_id, runtime = values.get("AGENT_FLEET_PROFILE_ID", ""), values.get("AGENT_FLEET_MONITOR_RUNTIME_DIR", "")
43
+ if not os.path.isabs(runtime):
44
+ raise MonitorUnavailable("monitor profile discovery is unavailable")
45
+ profile_id = cls.canonical_profile_id(profile_id)
46
+ try:
47
+ root = Path(runtime)
48
+ if root.is_symlink() or not root.is_dir() or stat.S_IMODE(root.stat().st_mode) != 0o700: raise ValueError()
49
+ candidates = []
50
+ for candidate in (root / profile_id).glob("*/discovery-*.json"):
51
+ try:
52
+ candidate_stat = candidate.lstat()
53
+ if candidate.is_symlink() or not stat.S_ISREG(candidate_stat.st_mode) or stat.S_IMODE(candidate_stat.st_mode) != 0o600: raise ValueError()
54
+ item = json.loads(candidate.read_text())
55
+ lease = item["lease"]
56
+ if not isinstance(lease, dict) or not isinstance(item.get("owner"), str) or not re.fullmatch(r"[0-9a-f-]{36}", item["owner"], re.I) or not isinstance(item.get("token"), str) or not re.fullmatch(r"token-[0-9a-f-]{36}", item["token"], re.I) or not isinstance(item.get("socket"), str) or not re.fullmatch(r"@runtime/s/[0-9a-f]+/s", item["socket"]) or not isinstance(lease.get("hub"), str) or not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]{0,127}", lease["hub"]) or type(lease.get("pid")) is not int or lease["pid"] < 1 or not isinstance(lease.get("startedAt"), str) or not isinstance(lease.get("expiresAt"), str): raise ValueError()
57
+ expected_token = f"token-{item['owner']}"
58
+ hub_hash = hashlib.sha256(lease['hub'].encode()).hexdigest()
59
+ expected_socket = "@runtime/s/" + hashlib.sha256(f"{profile_id}:{hub_hash}:{item['owner']}".encode()).hexdigest()[:32] + "/s"
60
+ if item['token'] != expected_token or item['socket'] != expected_socket: raise ValueError()
61
+ if datetime.fromisoformat(lease["expiresAt"].replace("Z", "+00:00")) <= datetime.now(timezone.utc):
62
+ token = item.get("token", "")
63
+ if isinstance(token, str) and token.startswith("token-") and "/" not in token: (candidate.parent / token).unlink(missing_ok=True)
64
+ candidate.unlink(missing_ok=True)
65
+ continue
66
+ candidates.append(candidate)
67
+ except (OSError, ValueError, KeyError, TypeError, json.JSONDecodeError) as error:
68
+ raise ValueError("monitor discovery metadata is malformed") from error
69
+ if not candidates: raise ValueError()
70
+ adapters = []
71
+ for discovery_path in candidates:
72
+ discovery = json.loads(discovery_path.read_text())
73
+ lease = discovery["lease"]
74
+ socket_ref, token_ref = discovery["socket"], discovery["token"]
75
+ if not isinstance(socket_ref, str) or not socket_ref.startswith("@runtime/") or ".." in Path(socket_ref).parts: raise ValueError()
76
+ if not isinstance(token_ref, str) or not token_ref.startswith("token-") or "/" in token_ref or ".." in token_ref: raise ValueError()
77
+ token_path = discovery_path.parent / token_ref
78
+ if token_path.is_symlink() or stat.S_IMODE(token_path.stat().st_mode) != 0o600: raise ValueError()
79
+ adapters.append((lease["hub"], cls(str(root / socket_ref.removeprefix("@runtime/")), token_path.read_text().strip())))
80
+ return FleetMonitorAdapter(adapters)
81
+ except (OSError, ValueError, KeyError, TypeError, json.JSONDecodeError) as error:
82
+ raise MonitorUnavailable("monitor profile discovery is unavailable") from error
83
+
84
+ def _request(self, request: dict, max_response_bytes: int = MAX_SNAPSHOT_RESPONSE_BYTES) -> dict:
85
+ try:
86
+ with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as client:
87
+ client.settimeout(2); client.connect(self._socket_path)
88
+ client.sendall((json.dumps({**request, "token": self._token})+"\n").encode())
89
+ data = b""
90
+ while b"\n" not in data:
91
+ chunk = client.recv(min(8192, max_response_bytes + 1 - len(data)))
92
+ if not chunk: raise MonitorUnavailable("local monitor closed the response")
93
+ data += chunk
94
+ if len(data) > max_response_bytes + 1: raise MonitorUnavailable("local monitor response is too large")
95
+ frame = data.split(b"\n", 1)[0]
96
+ if len(frame) > max_response_bytes: raise MonitorUnavailable("local monitor response is too large")
97
+ response = json.loads(frame)
98
+ if not isinstance(response, dict): raise MonitorUnavailable("local monitor response is invalid")
99
+ return response
100
+ except (OSError, ValueError) as error:
101
+ raise MonitorUnavailable("local monitor is unavailable") from error
102
+
103
+ def snapshot(self) -> dict:
104
+ response = self._request({"type": "snapshot"})
105
+ if response.get("ok") is not True or not isinstance(response.get("snapshot"), dict):
106
+ raise MonitorUnavailable("local monitor rejected the snapshot request")
107
+ return response["snapshot"]
108
+
109
+ def output(self, task_id: str, generation: int, after_sequence: int) -> dict:
110
+ response = self._request({"type": "output", "taskId": task_id, "generation": generation, "afterSequence": after_sequence}, MAX_OUTPUT_RESPONSE_BYTES)
111
+ if response.get("ok") is not True or not isinstance(response.get("output"), dict): raise MonitorUnavailable("local monitor rejected output")
112
+ return response["output"]
113
+
114
+ def cancel(self, task_id: str, generation: int) -> dict:
115
+ if not task_id or not isinstance(generation, int):
116
+ raise MonitorUnavailable("local monitor cancellation is invalid")
117
+ response = self._request({"type": "cancel", "taskId": task_id, "generation": generation}, MAX_CANCEL_RESPONSE_BYTES)
118
+ if response.get("ok") is not True or not isinstance(response.get("result"), dict):
119
+ raise MonitorUnavailable("local monitor rejected cancellation")
120
+ return response["result"]
121
+
122
+ class FleetMonitorAdapter:
123
+ def __init__(self, hubs):
124
+ self._hubs = dict(hubs)
125
+ if len(self._hubs) == 1:
126
+ only = next(iter(self._hubs.values()))
127
+ self._socket_path, self._token = only._socket_path, only._token
128
+ def snapshot(self):
129
+ tasks, errors = [], []
130
+ for hub_id, adapter in self._hubs.items():
131
+ try:
132
+ for task in adapter.snapshot().get("tasks", []): tasks.append({**task, "hubInstanceId": hub_id})
133
+ except MonitorUnavailable: errors.append({"hubInstanceId": hub_id, "state": "orphaned", "error": "unavailable"})
134
+ return {"tasks": tasks, "hubs": errors}
135
+ def _hub(self, hub_instance_id):
136
+ if not isinstance(hub_instance_id, str) or hub_instance_id not in self._hubs: raise MonitorUnavailable("local monitor hub is unavailable")
137
+ return self._hubs[hub_instance_id]
138
+ def output(self, task_id, generation, after_sequence, hub_instance_id): return self._hub(hub_instance_id).output(task_id, generation, after_sequence)
139
+ def cancel(self, task_id, generation, hub_instance_id): return self._hub(hub_instance_id).cancel(task_id, generation)
@@ -0,0 +1,10 @@
1
+ (function () {
2
+ "use strict";
3
+ window.__HERMES_PLUGINS__.register("agent-fleet-monitor", function AgentFleetMonitorBridge() {
4
+ const root = document.createElement("section");
5
+ root.setAttribute("role", "status");
6
+ root.setAttribute("aria-label", "Agent Fleet Monitor capability");
7
+ root.textContent = "Agent Fleet Monitor backend registered. The Desktop pane is provided separately; this hidden bundle does not create a duplicate pane under the current SDK.";
8
+ return root;
9
+ });
10
+ })();
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "agent-fleet-monitor",
3
+ "label": "Agent Fleet Monitor",
4
+ "version": "0.1.0",
5
+ "tab": {
6
+ "path": "/agent-fleet-monitor",
7
+ "hidden": true
8
+ },
9
+ "entry": "dist/index.js",
10
+ "api": "plugin_api.py"
11
+ }
@@ -0,0 +1,50 @@
1
+ """Manifest-mounted, fail-closed local Agent Fleet monitor boundary."""
2
+
3
+ from fastapi import APIRouter, HTTPException
4
+
5
+ from adapter import MonitorAdapter, MonitorUnavailable
6
+
7
+ router = APIRouter()
8
+ MAX_TASK_ID_LENGTH = 128
9
+ MAX_AFTER_SEQUENCE = 1_000_000_000
10
+
11
+ def validate_task_request(task_id: str, generation: int, after_sequence: int | None = None) -> None:
12
+ if not isinstance(task_id, str) or not 1 <= len(task_id) <= MAX_TASK_ID_LENGTH or not __import__("re").fullmatch(r"[A-Za-z0-9][A-Za-z0-9._:-]*", task_id):
13
+ raise HTTPException(status_code=422, detail="invalid task_id")
14
+ if type(generation) is not int or generation < 1:
15
+ raise HTTPException(status_code=422, detail="invalid generation")
16
+ if after_sequence is not None and (type(after_sequence) is not int or not 0 <= after_sequence <= MAX_AFTER_SEQUENCE):
17
+ raise HTTPException(status_code=422, detail="invalid after_sequence")
18
+
19
+
20
+ @router.get("/capabilities")
21
+ def capabilities() -> dict[str, bool]:
22
+ return {"monitor_adapter": True}
23
+
24
+
25
+ @router.get("/snapshot")
26
+ def snapshot() -> dict:
27
+ try:
28
+ return MonitorAdapter.from_profile_environment().snapshot()
29
+ except MonitorUnavailable as error:
30
+ raise HTTPException(status_code=503, detail="local Agent Fleet monitor unavailable") from error
31
+
32
+
33
+ @router.get("/output")
34
+ def output(task_id: str, generation: int, after_sequence: int, hub_instance_id: str) -> dict:
35
+ validate_task_request(task_id, generation, after_sequence)
36
+ if not isinstance(hub_instance_id, str) or not hub_instance_id: raise HTTPException(status_code=422, detail="invalid hub_instance_id")
37
+ try:
38
+ return MonitorAdapter.from_profile_environment().output(task_id, generation, after_sequence, hub_instance_id)
39
+ except MonitorUnavailable as error:
40
+ raise HTTPException(status_code=503, detail="local Agent Fleet monitor unavailable") from error
41
+
42
+
43
+ @router.post("/cancel")
44
+ def cancel(task_id: str, generation: int, hub_instance_id: str) -> dict:
45
+ validate_task_request(task_id, generation)
46
+ if not isinstance(hub_instance_id, str) or not hub_instance_id: raise HTTPException(status_code=422, detail="invalid hub_instance_id")
47
+ try:
48
+ return MonitorAdapter.from_profile_environment().cancel(task_id, generation, hub_instance_id)
49
+ except MonitorUnavailable as error:
50
+ raise HTTPException(status_code=503, detail="local Agent Fleet monitor unavailable") from error
@@ -0,0 +1,76 @@
1
+ ---
2
+ name: hub-watchdog
3
+ description: Foreground, fail-closed local Agent Hub watchdog. Use only for explicit operator observation of a profile-scoped Hub through its authenticated monitor socket.
4
+ ---
5
+ # Hub Watchdog
6
+
7
+ `hub-watchdog` is a packaged source skill, not a service or an enabled Hermes integration. Run it only as an explicit foreground operator action:
8
+
9
+ ```bash
10
+ python3 scripts/watchdog.py status --invocation-json '<json>'
11
+ python3 scripts/watchdog.py validate-config --invocation-json '<json>'
12
+ python3 scripts/watchdog.py watch --invocation-json '<json>'
13
+ ```
14
+
15
+ `status` and `validate-config` report the resolved autonomy tier and delivery disposition without connecting to anything. Run them before `watch` and stop if either reports something you did not intend.
16
+
17
+ Default and maximum autonomy are `observe`. Send `SIGINT` to stop the foreground process; it releases its per-profile `watch.lock`, closes its socket clients and any long-poll waiter, and leaves the local journal in place. Do not create a daemon, schedule it, wake/reopen a Hermes session, or use a last-chat/default-route fallback. A second watcher for the same profile fails closed with `watcher_locked` rather than sharing state.
18
+
19
+ ## Discovery is profile-scoped
20
+
21
+ Read exactly one discovery record from the namespace the invocation names — the validated profile key and hub key under the configured runtime directory. Never scan a runtime root, walk sibling profiles, or fall back to another namespace when a lease is expired, a token is missing, or a socket is gone. An unsafe runtime mode, a symlink, a world-readable token, an expired lease, or more than one discovery entry is a refusal.
22
+
23
+ Identity is bound on every request: the configured profile key, hub instance, and owner must all equal what live discovery reports. A mismatch is a refusal, not a fallback. After an owner rollover, rediscover from scratch; never reuse the previous owner's token or socket, and never re-drive a request that was already accepted.
24
+
25
+ ## Gate O: currently closed
26
+
27
+ There is no checked-in genuine live proof of a Hermes originating-chat identity, incremental-update, wake/reconnect, or session API. `hermes send --to` is an explicit destination only; it is not origin evidence. A validator, fixture, fake adapter, or local UDS test cannot close Gate O.
28
+
29
+ Until a sanitized, human-reviewed disposable live artifact names the real API and proves the required behavior, operate journal-only:
30
+
31
+ - do not send chat updates, including out-of-turn status messages;
32
+ - do not steer, cancel, or recover work;
33
+ - do not claim live delivery, A6, or higher-tier autonomy; and
34
+ - do not redirect when a route is unavailable.
35
+
36
+ The entrypoint lowers requested `steer`/`surgical` autonomy to `observe` when Gate O is invalid. That safeguard does not authorize higher tiers when an artifact merely looks valid.
37
+
38
+ ## Evidence and judgment stay bounded
39
+
40
+ Base every decision on the events the Hub actually returned. Cite them by event id, keep the cited set small, and record the deviation you believe they show. A judgment adapter is optional; when present it may only select one action from the closed set, and any malformed verdict resolves to `none`. Never infer a task's identity, completion, route, or delivery outcome beyond what the Hub explicitly returned, and never treat your own journal as Hub history.
41
+
42
+ If a cursor falls outside the retained window, reconcile from a fresh snapshot and resume — do not guess at the events you missed.
43
+
44
+ ## Durability precedes transport
45
+
46
+ Before the first transport call for any action, persist the canonical request digest and the proposed decision. If that write fails, refuse — do not send. An ambiguous transport failure is never retried: one bounded attempt, then refuse and let an operator decide.
47
+
48
+ ## Recovery is exact-generation only
49
+
50
+ Recovery is available only at `surgical` autonomy with Gate O open, only for an allow-listed native task, and only through the narrow monitor adapter. The sequence is fixed: persist the proposal, re-read a fresh snapshot, cancel exactly generation N, observe N reach a terminal state, re-read a fresh snapshot again, then enqueue at most one recovery request. A newer generation observed at any point freezes the transaction as `superseded`. A missing owner, profile, or hub identity is a refusal, not a wildcard. A completed step is never repeated after a restart, and a timeout, a refused cancel, a rejected enqueue, or an unobserved exit never retargets or retries.
51
+
52
+ Coms runs have no recovery path at all. Cancelling one abandons only the local wait; the remote peer may continue.
53
+
54
+ ## Boundaries
55
+
56
+ The watcher reads owner-only monitor discovery and UDS responses, writes a local decision journal, and may render bounded local summaries. Hub state remains authoritative. A journal, event cursor, discovery field, or local test is not independent proof of task identity, ownership, route identity, completion, or delivery.
57
+
58
+ Never shell out, search PIDs, use `pkill`, control Herdr, manage a gateway/service, invoke Pi tools directly, or delegate through coms. Do not turn a coms wait cancellation into peer cancellation or automatic recovery. Keep tokens in memory only: never write one to a journal, log, argument, or summary.
59
+
60
+ On malformed or unavailable monitor data, ownership/profile uncertainty, reconciliation uncertainty, journal trouble, or Gate O failure, fail closed: keep or return to local journal-only operation and ask an operator to inspect the issue.
61
+
62
+ ## Summaries for a human
63
+
64
+ A summary is for the operator reading it, so write it in their language — Bulgarian when that is what they use — and keep the identifiers untranslated: task ids, generations, event ids, and states stay verbatim so they can be matched against the Hub. Say what was observed and what was journaled. Never describe a queued request as work that ran, and never present local runtime evidence as proof of live delivery.
65
+
66
+ ## Install lifecycle
67
+
68
+ Use `agent-fleet set-hermes-watchdog status|install|update|uninstall --profile <id> [--force] [--dry-run]` or the matching guided command. `status` is read-only. Install/update are profile-artifact operations; drift is refused unless an operator explicitly selects backed-up `--force`. An identical unmanaged tree is adopted by writing only a receipt, and only when a fresh symlink-free fingerprint exactly equals the packaged source. Uninstall preserves configuration and journals and reports, rather than kills, an active lock.
69
+
70
+ None of these lifecycle actions starts, stops, restarts, or kills Hermes or the watcher; changes Hermes tools/permissions; sends a test message; or manages Herdr. Packaging the skill does not install or enable it.
71
+
72
+ ## Rollback
73
+
74
+ To stand down: set the profile configuration back to `observe` (or leave the default), `SIGINT` the foreground watcher, and confirm `watch.lock` is gone. That leaves the journal intact, cancels nothing, and withdraws no queued follow-up. Run `uninstall` only after reviewing its status and backup behavior. Never delete a journal, lock, runtime directory, or profile tree to force recovery — preserve suspect files for inspection.
75
+
76
+ See `docs/hermes-watchdog-supervisor.md` for the configuration example, the `events`/`invoke` responses, the migration path, and the evidence boundary.
@@ -0,0 +1 @@
1
+ {"schemaVersion":1,"name":"hub-watchdog","defaultAutonomy":"observe","maximumAutonomy":"observe","originDelivery":"required","foregroundOnly":true}
@@ -0,0 +1,249 @@
1
+ #!/usr/bin/env python3
2
+ """Foreground fail-closed watchdog entrypoint; no daemon/service lifecycle."""
3
+ import argparse
4
+ import hashlib
5
+ import json
6
+ import os
7
+ import selectors
8
+ import signal
9
+ import sys
10
+ import time
11
+ from pathlib import Path
12
+
13
+ from watchdog_actions import MAXIMUM_ACTION, admit
14
+ from watchdog_contract import gate_o_valid
15
+ from watchdog_delivery import deliver, delivery_state
16
+ from watchdog_engine import bulgarian_summary, due_deviations, reduce_event
17
+ from watchdog_judgment import request as judgment_request, response as judgment_response
18
+ from watchdog_recovery import recover
19
+ from watchdog_state import atomic_json, audit, load_json, profile_root
20
+ from watchdog_transport import MonitorTransport, TransportError, discover, reconcile
21
+
22
+ LEVELS = ('observe', 'shadow', 'steer', 'surgical')
23
+
24
+
25
+ def request_id(record, profile_key, owner_session_id, hub_instance_id):
26
+ """Canonical owner/profile/generation identity for a single Hub invoke."""
27
+ ref = record['taskRef']
28
+ payload = json.dumps({'deviation': record.get('candidateDeviation'), 'taskId': ref['taskId'],
29
+ 'generation': ref['generation'], 'profileKey': profile_key,
30
+ 'ownerSessionId': owner_session_id, 'hubInstanceId': hub_instance_id},
31
+ sort_keys=True, separators=(',', ':')).encode()
32
+ return 'watchdog:' + hashlib.sha256(payload).hexdigest()
33
+
34
+
35
+ def safe_invocation(raw):
36
+ try:
37
+ value = json.loads(raw or '{}')
38
+ except json.JSONDecodeError as error:
39
+ raise ValueError('invalid_invocation') from error
40
+ if not isinstance(value, dict):
41
+ raise ValueError('invalid_invocation')
42
+ requested = value.get('autonomy', 'observe')
43
+ maximum = value.get('maximumAutonomy', 'observe')
44
+ if requested not in LEVELS or maximum not in LEVELS:
45
+ raise ValueError('invalid_autonomy')
46
+ level = LEVELS[min(LEVELS.index(requested), LEVELS.index(maximum))]
47
+ if not delivery_state(value.get('gateO'))['originDelivery'] and level in ('steer', 'surgical'):
48
+ level = 'observe'
49
+ return value, level
50
+
51
+
52
+ def _lock(invocation):
53
+ root = Path(invocation.get('lockDir') or os.environ.get('XDG_RUNTIME_DIR', '/tmp'))
54
+ # is_symlink() uses lstat: reject even a dangling link before any operation
55
+ # that could follow it (exists, mkdir, chmod, or stat).
56
+ if root.is_symlink():
57
+ raise ValueError('unsafe_lock')
58
+ root.mkdir(mode=0o700, parents=True, exist_ok=True)
59
+ if not root.is_dir() or root.stat().st_mode & 0o077:
60
+ raise ValueError('unsafe_lock')
61
+ root = root.resolve(strict=True)
62
+ path = root / 'agent-fleet-hermes-watchdog' / profile_root('', invocation.get('profileId', 'default')).name / 'watch.lock'
63
+ # Refuse a pre-existing symlink before mkdir/chmod can follow it.
64
+ for parent in (path.parent.parent, path.parent):
65
+ if parent.is_symlink() or (parent.exists() and (not parent.is_dir() or root not in (parent.resolve(), *parent.resolve().parents))):
66
+ raise ValueError('unsafe_lock')
67
+ parent.mkdir(mode=0o700, exist_ok=True)
68
+ if parent.is_symlink() or not parent.is_dir() or root not in (parent.resolve(), *parent.resolve().parents):
69
+ raise ValueError('unsafe_lock')
70
+ os.chmod(parent, 0o700)
71
+ if parent.stat().st_mode & 0o077:
72
+ raise ValueError('unsafe_lock')
73
+ try:
74
+ descriptor = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY | os.O_NOFOLLOW, 0o600)
75
+ except FileExistsError:
76
+ try:
77
+ contents = path.read_text(encoding='ascii').strip()
78
+ if path.is_symlink() or not contents.isdecimal() or int(contents) <= 0:
79
+ raise ValueError('unsafe_lock')
80
+ os.kill(int(contents), 0)
81
+ except ProcessLookupError:
82
+ path.unlink()
83
+ return _lock(invocation)
84
+ except (OSError, UnicodeError, ValueError) as error:
85
+ raise ValueError('watcher_locked') from error
86
+ raise ValueError('watcher_locked')
87
+ os.write(descriptor, str(os.getpid()).encode())
88
+ return path, descriptor
89
+
90
+
91
+ def _audit_path(invocation):
92
+ base = invocation.get('stateDir') or os.environ.get('XDG_STATE_HOME') or str(Path.home() / '.local/state')
93
+ return profile_root(Path(base) / 'agent-fleet/hermes-watchdog', invocation.get('profileId', 'default')) / 'audit.ndjson'
94
+
95
+
96
+ def _recovery_path(invocation):
97
+ return _audit_path(invocation).with_name('recovery.json')
98
+
99
+
100
+ def _recovery_key(task_ref):
101
+ return json.dumps([task_ref['taskId'], task_ref['generation']], separators=(',', ':'))
102
+
103
+
104
+ def _load_recovery(invocation):
105
+ path = _recovery_path(invocation)
106
+ try:
107
+ value = load_json(path) if path.exists() else {}
108
+ return value if isinstance(value, dict) and all(isinstance(tx, dict) for tx in value.values()) else {}
109
+ except (OSError, ValueError, json.JSONDecodeError):
110
+ return {}
111
+
112
+
113
+ def _save_recovery(invocation, transaction):
114
+ try:
115
+ atomic_json(_recovery_path(invocation), transaction)
116
+ return True
117
+ except (OSError, ValueError):
118
+ return False
119
+
120
+
121
+ def _safe_audit(path, record):
122
+ """Offline/corrupt local audit is fail-closed but must not crash the watcher."""
123
+ try:
124
+ audit(path, record)
125
+ return True
126
+ except (OSError, ValueError):
127
+ return False
128
+
129
+
130
+ def _action_for(record, invocation):
131
+ """Only a validated judgment may confirm an invoke; it can never escalate the table action."""
132
+ deviation = record.get('candidateDeviation')
133
+ maximum = MAXIMUM_ACTION.get(deviation, 'none')
134
+ adapter = invocation.get('judgmentAdapter')
135
+ if maximum == 'none' or not adapter:
136
+ return 'none', None
137
+ try:
138
+ verdict = judgment_response(adapter(judgment_request(
139
+ deviation, [record['eventId']], task_ref=record['taskRef'])), deviation, [record['eventId']])
140
+ recommended = verdict['recommendedAction']
141
+ return (recommended, verdict['verdict']) if recommended == maximum and verdict['verdict'] == 'confirmed' else ('none', None)
142
+ except (ValueError, TypeError, KeyError):
143
+ return 'none', None
144
+
145
+
146
+ def run_watch(invocation, level, *, once=False, transport_factory=None):
147
+ """Run the foreground polling/event loop. Dependencies are injectable only for tests."""
148
+ lock_path, lock_fd = _lock(invocation)
149
+ state, cursor, stopped = {}, 0, False
150
+ recovery_transactions = _load_recovery(invocation)
151
+ selector = selectors.DefaultSelector()
152
+ read_fd, write_fd = os.pipe()
153
+ os.set_blocking(read_fd, False)
154
+ selector.register(read_fd, selectors.EVENT_READ)
155
+ old_handler = signal.getsignal(signal.SIGINT)
156
+
157
+ def stop(*_):
158
+ nonlocal stopped
159
+ stopped = True
160
+ try: os.write(write_fd, b'x')
161
+ except OSError: pass
162
+
163
+ audit_path = _audit_path(invocation)
164
+ try:
165
+ signal.signal(signal.SIGINT, stop)
166
+ while not stopped:
167
+ try:
168
+ factory = transport_factory or (lambda: MonitorTransport(discover(
169
+ invocation['runtimeDir'], invocation['profileKey'], invocation['hubKey'],
170
+ invocation.get('now') or time.strftime('%Y-%m-%dT%H:%M:%SZ', time.gmtime()))))
171
+ transport = factory()
172
+ batch = reconcile(transport, cursor)
173
+ if batch.get('snapshot'):
174
+ cursor = 0
175
+ _safe_audit(audit_path, {'decision': 'snapshot_reconciled', 'hubInstanceId': invocation.get('hubInstanceId')})
176
+ events = batch.get('items', batch.get('events', []))
177
+ for event in events:
178
+ state, records = reduce_event(state, event, time.monotonic(), online=True)
179
+ cursor = max(cursor, event.get('eventSequence', cursor))
180
+ for record in records:
181
+ _safe_audit(audit_path, {'decision': 'material_event', 'hubInstanceId': invocation.get('hubInstanceId'),
182
+ 'taskRef': record['taskRef'], 'eventIds': [record['eventId']],
183
+ 'deviation': record.get('candidateDeviation'), 'tier': level})
184
+ action, judgment = _action_for(record, invocation)
185
+ # Gate O is the hard boundary: otherwise journal-only and no invoke/cancel.
186
+ if level in ('steer', 'surgical') and action != 'none' and judgment == 'confirmed':
187
+ request = {'requestId': request_id(record, invocation.get('profileKey'), transport.owner, invocation.get('hubInstanceId')), 'action': action,
188
+ 'taskId': record['taskRef']['taskId'], 'generation': record['taskRef']['generation'],
189
+ 'profileKey': invocation.get('profileKey'), 'ownerSessionId': transport.owner,
190
+ 'hubInstanceId': invocation.get('hubInstanceId'),
191
+ 'parameters': {'assertionIds': [], 'evidenceEventIds': [record['eventId']],
192
+ 'instruction': 'Изпълни ограничената проверка и докладвай доказателства.'},
193
+ 'basis': {'deviation': record['candidateDeviation'], 'judgment': judgment}}
194
+ admit({**invocation, 'autonomy': level, 'ownerSessionId': transport.owner}, request, transport,
195
+ persist=lambda row: _safe_audit(audit_path, row))
196
+ if delivery_state(invocation.get('gateO'))['originDelivery'] and invocation.get('origin'):
197
+ try:
198
+ deliver(invocation['gateO'], invocation['origin'], bulgarian_summary(record), invocation.get('deliveryAdapter'))
199
+ except RuntimeError:
200
+ _safe_audit(audit_path, {'decision': 'delivery_refused', 'hubInstanceId': invocation.get('hubInstanceId'),
201
+ 'taskRef': record['taskRef'], 'tier': level})
202
+ for record in due_deviations(state, time.monotonic()):
203
+ _safe_audit(audit_path, {'decision': 'due_deviation', 'hubInstanceId': invocation.get('hubInstanceId'),
204
+ 'taskRef': record['taskRef'], 'deviation': record['candidateDeviation'], 'tier': level})
205
+ # Due deviations use the same exact table and recovery gate as event candidates.
206
+ if level == 'surgical' and gate_o_valid(invocation.get('gateO')) and record['candidateDeviation'] == 'stalled_progress':
207
+ key = _recovery_key(record['taskRef'])
208
+ transaction = recovery_transactions.get(key, {'taskId': record['taskRef']['taskId'], 'generation': record['taskRef']['generation'],
209
+ 'kind': 'native', 'ownerSessionId': transport.owner, 'profileKey': invocation.get('profileKey'),
210
+ 'hubInstanceId': invocation.get('hubInstanceId'), 'state': 'proposed'})
211
+ recovery = recover(transaction, transport, invocation.get('surgicalAllowlist', []), True,
212
+ persist=lambda row: _safe_audit(audit_path, row))
213
+ recovery_transactions[key] = recovery
214
+ _save_recovery(invocation, recovery_transactions)
215
+ _safe_audit(audit_path, {'decision': 'recovery_checked', 'hubInstanceId': invocation.get('hubInstanceId'),
216
+ 'taskRef': {'taskId': recovery['taskId'], 'generation': recovery['generation']}, 'recoveryState': recovery['state'], 'tier': level})
217
+ except (KeyError, TransportError, ValueError, OSError) as error:
218
+ _safe_audit(audit_path, {'decision': 'offline', 'hubInstanceId': invocation.get('hubInstanceId'),
219
+ 'deviation': 'route_unavailable'})
220
+ if once:
221
+ return {'foreground': True, 'offline': True, 'autonomy': level}
222
+ selector.select(timeout=.25)
223
+ if once:
224
+ return {'foreground': True, 'offline': False, 'autonomy': level, 'cursor': cursor}
225
+ return {'foreground': True, 'stopped': True, 'autonomy': level}
226
+ finally:
227
+ signal.signal(signal.SIGINT, old_handler)
228
+ selector.close(); os.close(read_fd); os.close(write_fd); os.close(lock_fd)
229
+ try: lock_path.unlink()
230
+ except FileNotFoundError: pass
231
+
232
+
233
+ def main(argv=None):
234
+ parser = argparse.ArgumentParser()
235
+ parser.add_argument('command', choices=['status', 'validate-config', 'watch'])
236
+ parser.add_argument('--invocation-json')
237
+ parser.add_argument('--once', action='store_true', help=argparse.SUPPRESS)
238
+ args = parser.parse_args(argv)
239
+ try:
240
+ invocation, level = safe_invocation(args.invocation_json)
241
+ result = {'ok': True, 'autonomy': level, **delivery_state(invocation.get('gateO'))}
242
+ if args.command == 'watch':
243
+ result.update(run_watch(invocation, level, once=args.once))
244
+ except ValueError as error:
245
+ print(json.dumps({'ok': False, 'error': str(error)}, sort_keys=True)); return 2
246
+ print(json.dumps(result, sort_keys=True)); return 0
247
+
248
+ if __name__ == '__main__':
249
+ raise SystemExit(main())