@chankov/agent-fleet 2.0.2 → 2.0.3

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 (438) hide show
  1. package/.pi/harnesses/agent-hub/README.md +26 -31
  2. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +1 -1
  3. package/.pi/harnesses/agent-hub/config/overrides.ts +2 -7
  4. package/.pi/harnesses/agent-hub/index.ts +14 -25
  5. package/.pi/harnesses/agent-hub/input/completions.ts +2 -2
  6. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +0 -2
  7. package/.pi/harnesses/agent-hub/package.json +1 -1
  8. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  9. package/.pi/harnesses/agent-hub/research/controls.ts +15 -16
  10. package/.pi/harnesses/agent-hub/research/runtime.ts +30 -39
  11. package/.pi/harnesses/agent-hub/research/spawn-run.ts +108 -111
  12. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +2 -3
  13. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +3 -3
  14. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +0 -7
  15. package/.pi/harnesses/agent-hub/ui/grid.ts +21 -183
  16. package/.pi/harnesses/coms/package.json +1 -1
  17. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  18. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +23 -12
  19. package/.versions/2.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  20. package/.versions/2.0.3/.pi/agents/model-profiles.yaml +27 -0
  21. package/.versions/2.0.3/.pi/agents/peers.yaml +142 -0
  22. package/.versions/2.0.3/.pi/agents/teams.yaml +41 -0
  23. package/.versions/2.0.3/.pi/agents/voices.yaml +13 -0
  24. package/.versions/2.0.3/.pi/damage-control-rules.yaml +297 -0
  25. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  26. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  27. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  28. package/.versions/2.0.3/.pi/extensions/btw/README.md +120 -0
  29. package/.versions/2.0.3/.pi/extensions/btw/index.ts +914 -0
  30. package/.versions/2.0.3/.pi/extensions/btw/package.json +6 -0
  31. package/.versions/2.0.3/.pi/extensions/btw/state.js +179 -0
  32. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  33. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  34. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  35. package/.versions/2.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  36. package/.versions/2.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  37. package/.versions/2.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  38. package/.versions/2.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  39. package/.versions/2.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  40. package/.versions/2.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  41. package/.versions/2.0.3/.pi/extensions/package-lock.json +1175 -0
  42. package/.versions/2.0.3/.pi/extensions/package.json +9 -0
  43. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  44. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  45. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  46. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  47. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  48. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  49. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  50. package/.versions/2.0.3/.pi/harnesses/agent-hub/README.md +1158 -0
  51. package/.versions/2.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  52. package/.versions/2.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  53. package/.versions/2.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  54. package/.versions/2.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  55. package/.versions/2.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  56. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  57. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  58. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  59. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  60. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  61. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  62. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  63. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  64. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  65. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  66. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  67. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  68. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  69. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  70. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  71. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  72. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  73. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  74. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  75. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  76. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  77. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  78. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  79. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  80. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  81. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  82. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/agents.ts +180 -0
  83. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  84. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  85. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  86. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  87. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  88. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  89. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  90. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  91. package/.versions/2.0.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  92. package/.versions/2.0.3/.pi/harnesses/agent-hub/delegate.ts +446 -0
  93. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  94. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  95. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  96. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  97. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  98. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  99. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  100. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  101. package/.versions/2.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  102. package/.versions/2.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  103. package/.versions/2.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  104. package/.versions/2.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  105. package/.versions/2.0.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  106. package/.versions/2.0.3/.pi/harnesses/agent-hub/footer.ts +30 -0
  107. package/.versions/2.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  108. package/.versions/2.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  109. package/.versions/2.0.3/.pi/harnesses/agent-hub/index.ts +2036 -0
  110. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  111. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  112. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  113. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  114. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  115. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  116. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  117. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  118. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  119. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  120. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  121. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  122. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  123. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  124. package/.versions/2.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  125. package/.versions/2.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  126. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  127. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  128. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  129. package/.versions/2.0.3/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  130. package/.versions/2.0.3/.pi/harnesses/agent-hub/presentation.ts +48 -0
  131. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  132. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  133. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  134. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  135. package/.versions/2.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  136. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  137. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  138. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/spawn-run.ts +143 -0
  139. package/.versions/2.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  140. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  141. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  142. package/.versions/2.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  143. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  144. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  145. package/.versions/2.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  146. package/.versions/2.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  147. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  148. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
  149. package/.versions/2.0.3/.pi/harnesses/agent-hub/spawn.ts +388 -0
  150. package/.versions/2.0.3/.pi/harnesses/agent-hub/timeline.ts +54 -0
  151. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  152. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  153. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  154. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  155. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  156. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  157. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  158. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  159. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  160. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  161. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  162. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  163. package/.versions/2.0.3/.pi/harnesses/agent-hub/types.ts +61 -0
  164. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  165. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  166. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  167. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  168. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  169. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  170. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  171. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  172. package/.versions/2.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  173. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  174. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  175. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  176. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  177. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  178. package/.versions/2.0.3/.pi/harnesses/coms/README.md +100 -0
  179. package/.versions/2.0.3/.pi/harnesses/coms/index.ts +276 -0
  180. package/.versions/2.0.3/.pi/harnesses/coms/package.json +7 -0
  181. package/.versions/2.0.3/.pi/harnesses/coms/version.ts +42 -0
  182. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  183. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  184. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  185. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  186. package/.versions/2.0.3/.pi/harnesses/lib/coms-core-io.ts +385 -0
  187. package/.versions/2.0.3/.pi/harnesses/lib/coms-core.ts +577 -0
  188. package/.versions/2.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  189. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  190. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  191. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  192. package/.versions/2.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  193. package/.versions/2.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  194. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  195. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  196. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  197. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  198. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  199. package/.versions/2.0.3/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  200. package/.versions/2.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  201. package/.versions/2.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  202. package/.versions/2.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  203. package/.versions/2.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  204. package/.versions/2.0.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  205. package/.versions/2.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  206. package/.versions/2.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  207. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  208. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  209. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  210. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  211. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  212. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  213. package/.versions/2.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  214. package/.versions/2.0.3/.pi/harnesses/package-lock.json +2039 -0
  215. package/.versions/2.0.3/.pi/harnesses/package.json +10 -0
  216. package/.versions/2.0.3/.pi/prompts/af-build.md +24 -0
  217. package/.versions/2.0.3/.pi/prompts/af-code-simplify.md +22 -0
  218. package/.versions/2.0.3/.pi/prompts/af-plan.md +17 -0
  219. package/.versions/2.0.3/.pi/prompts/af-review.md +16 -0
  220. package/.versions/2.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  221. package/.versions/2.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  222. package/.versions/2.0.3/.pi/prompts/af-ship.md +17 -0
  223. package/.versions/2.0.3/.pi/prompts/af-spec.md +15 -0
  224. package/.versions/2.0.3/.pi/prompts/af-test.md +19 -0
  225. package/.versions/2.0.3/.pi/skills/bowser/SKILL.md +145 -0
  226. package/.versions/2.0.3/.version +1 -0
  227. package/.versions/2.0.3/agents/architect.md +25 -0
  228. package/.versions/2.0.3/agents/bowser.md +28 -0
  229. package/.versions/2.0.3/agents/builder.md +56 -0
  230. package/.versions/2.0.3/agents/code-reviewer.md +210 -0
  231. package/.versions/2.0.3/agents/deep-researcher.md +33 -0
  232. package/.versions/2.0.3/agents/documenter.md +22 -0
  233. package/.versions/2.0.3/agents/orchestrator.md +23 -0
  234. package/.versions/2.0.3/agents/plan-reviewer.md +84 -0
  235. package/.versions/2.0.3/agents/planner.md +105 -0
  236. package/.versions/2.0.3/agents/releaser.md +25 -0
  237. package/.versions/2.0.3/agents/researcher.md +31 -0
  238. package/.versions/2.0.3/agents/security-auditor.md +168 -0
  239. package/.versions/2.0.3/agents/test-engineer.md +154 -0
  240. package/.versions/2.0.3/agents/web-debugger.md +44 -0
  241. package/.versions/2.0.3/agents/web-performance-auditor.md +194 -0
  242. package/.versions/2.0.3/bin/catalog/harness-runtime-closure.json +34 -0
  243. package/.versions/2.0.3/codex/CONDUCTOR.md +148 -0
  244. package/.versions/2.0.3/docs/ARCHITECTURE.md +407 -0
  245. package/.versions/2.0.3/docs/agent-fleet-setup.md +473 -0
  246. package/.versions/2.0.3/docs/claude-code-coms-bridge.md +128 -0
  247. package/.versions/2.0.3/docs/codex-remote-conductor.md +170 -0
  248. package/.versions/2.0.3/docs/coms-hermes-bridge.md +189 -0
  249. package/.versions/2.0.3/docs/getting-started.md +119 -0
  250. package/.versions/2.0.3/docs/npm-install.md +292 -0
  251. package/.versions/2.0.3/docs/pi-extensions.md +447 -0
  252. package/.versions/2.0.3/docs/pi-setup.md +74 -0
  253. package/.versions/2.0.3/docs/skill-anatomy.md +150 -0
  254. package/.versions/2.0.3/hermes/README.md +347 -0
  255. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  256. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  257. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  258. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  259. package/.versions/2.0.3/hermes/gates/gate-o-capability.md +8 -0
  260. package/.versions/2.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  261. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  262. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  263. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  264. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  265. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  266. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  267. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  268. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  269. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  270. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  271. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  272. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  273. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  274. package/.versions/2.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  275. package/.versions/2.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  276. package/.versions/2.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  277. package/.versions/2.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  278. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  279. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  280. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  281. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  282. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  283. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  284. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  285. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  286. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  287. package/.versions/2.0.3/hermes/watchdog-tests/__init__.py +0 -0
  288. package/.versions/2.0.3/hooks/coms-stop-hook.mjs +84 -0
  289. package/.versions/2.0.3/install-manifest.json +2940 -0
  290. package/.versions/2.0.3/justfile +289 -0
  291. package/.versions/2.0.3/manifest-meta.json +969 -0
  292. package/.versions/2.0.3/references/accessibility-checklist.md +160 -0
  293. package/.versions/2.0.3/references/communication-contract.md +26 -0
  294. package/.versions/2.0.3/references/definition-of-done.md +67 -0
  295. package/.versions/2.0.3/references/fleet-coordination-patterns.md +171 -0
  296. package/.versions/2.0.3/references/observability-checklist.md +91 -0
  297. package/.versions/2.0.3/references/orchestration-patterns.md +370 -0
  298. package/.versions/2.0.3/references/performance-checklist.md +153 -0
  299. package/.versions/2.0.3/references/prompting-patterns.md +380 -0
  300. package/.versions/2.0.3/references/security-checklist.md +179 -0
  301. package/.versions/2.0.3/references/testing-patterns.md +236 -0
  302. package/.versions/2.0.3/references/workflow-authoring.md +304 -0
  303. package/.versions/2.0.3/scripts/codex-conductor.ts +41 -0
  304. package/.versions/2.0.3/scripts/codex-remote-control.ts +167 -0
  305. package/.versions/2.0.3/scripts/coms-claude-bridge.ts +411 -0
  306. package/.versions/2.0.3/scripts/coms-cli.ts +484 -0
  307. package/.versions/2.0.3/scripts/coms-hermes-bridge.ts +413 -0
  308. package/.versions/2.0.3/scripts/fleet.ts +199 -0
  309. package/.versions/2.0.3/scripts/flow.ts +137 -0
  310. package/.versions/2.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  311. package/.versions/2.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  312. package/.versions/2.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  313. package/.versions/2.0.3/scripts/install-hermes-plugin.sh +180 -0
  314. package/.versions/2.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  315. package/.versions/2.0.3/scripts/lib/codex-conductor.ts +88 -0
  316. package/.versions/2.0.3/scripts/lib/codex-remote-control.ts +482 -0
  317. package/.versions/2.0.3/scripts/lib/coms-envelope.ts +582 -0
  318. package/.versions/2.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  319. package/.versions/2.0.3/scripts/lib/fleet-command.ts +270 -0
  320. package/.versions/2.0.3/scripts/lib/flow-command.ts +93 -0
  321. package/.versions/2.0.3/scripts/lib/flow-maintenance.ts +230 -0
  322. package/.versions/2.0.3/scripts/lib/herdr-layout.ts +281 -0
  323. package/.versions/2.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  324. package/.versions/2.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  325. package/.versions/2.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  326. package/.versions/2.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  327. package/.versions/2.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  328. package/.versions/2.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  329. package/.versions/2.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  330. package/.versions/2.0.3/scripts/lib/monitor-env.ts +146 -0
  331. package/.versions/2.0.3/scripts/lib/peer-launch.ts +318 -0
  332. package/.versions/2.0.3/scripts/lib/persona-banner.ts +62 -0
  333. package/.versions/2.0.3/scripts/lib/spawn-stagger.ts +101 -0
  334. package/.versions/2.0.3/scripts/lib/team-project.ts +213 -0
  335. package/.versions/2.0.3/scripts/lib/team-snapshot.ts +147 -0
  336. package/.versions/2.0.3/scripts/package-lock.json +35 -0
  337. package/.versions/2.0.3/scripts/package.json +9 -0
  338. package/.versions/2.0.3/scripts/peer-banner.ts +40 -0
  339. package/.versions/2.0.3/scripts/peer-launch.ts +259 -0
  340. package/.versions/2.0.3/scripts/team-snapshot.ts +237 -0
  341. package/.versions/2.0.3/scripts/team-up.ts +406 -0
  342. package/.versions/2.0.3/scripts/workflows/lib/agent-phase.ts +132 -0
  343. package/.versions/2.0.3/scripts/workflows/lib/changes.ts +61 -0
  344. package/.versions/2.0.3/scripts/workflows/lib/debate.ts +149 -0
  345. package/.versions/2.0.3/scripts/workflows/lib/env.ts +34 -0
  346. package/.versions/2.0.3/scripts/workflows/lib/envelopes.ts +169 -0
  347. package/.versions/2.0.3/scripts/workflows/lib/gates.ts +81 -0
  348. package/.versions/2.0.3/scripts/workflows/lib/git.ts +96 -0
  349. package/.versions/2.0.3/scripts/workflows/lib/merge.ts +95 -0
  350. package/.versions/2.0.3/scripts/workflows/lib/model-visibility.ts +92 -0
  351. package/.versions/2.0.3/scripts/workflows/lib/permissions.ts +130 -0
  352. package/.versions/2.0.3/scripts/workflows/lib/personas.ts +54 -0
  353. package/.versions/2.0.3/scripts/workflows/lib/poll.ts +86 -0
  354. package/.versions/2.0.3/scripts/workflows/lib/quality.ts +64 -0
  355. package/.versions/2.0.3/scripts/workflows/lib/run.ts +108 -0
  356. package/.versions/2.0.3/scripts/workflows/lib/trace.ts +34 -0
  357. package/.versions/2.0.3/scripts/workflows/lib/voices.ts +125 -0
  358. package/.versions/2.0.3/scripts/workflows/lib/writer-lease.ts +112 -0
  359. package/.versions/2.0.3/scripts/workflows/tsconfig.json +22 -0
  360. package/.versions/2.0.3/scripts/workflows/wf-build-test.ts +61 -0
  361. package/.versions/2.0.3/scripts/workflows/wf-debate.ts +87 -0
  362. package/.versions/2.0.3/scripts/workflows/wf-document.ts +50 -0
  363. package/.versions/2.0.3/scripts/workflows/wf-poll.ts +95 -0
  364. package/.versions/2.0.3/scripts/workflows/wf-quality.ts +20 -0
  365. package/.versions/2.0.3/scripts/workflows/wf-scout.ts +38 -0
  366. package/.versions/2.0.3/skills/_internal/grilling.md +59 -0
  367. package/.versions/2.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  368. package/.versions/2.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  369. package/.versions/2.0.3/skills/compound-learning/SKILL.md +137 -0
  370. package/.versions/2.0.3/skills/context-engineering/SKILL.md +291 -0
  371. package/.versions/2.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  372. package/.versions/2.0.3/skills/designing-agents/SKILL.md +394 -0
  373. package/.versions/2.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  374. package/.versions/2.0.3/skills/drafting-workflows/SKILL.md +143 -0
  375. package/.versions/2.0.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  376. package/.versions/2.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  377. package/.versions/2.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  378. package/.versions/2.0.3/skills/idea-refine/SKILL.md +182 -0
  379. package/.versions/2.0.3/skills/idea-refine/examples.md +238 -0
  380. package/.versions/2.0.3/skills/idea-refine/frameworks.md +99 -0
  381. package/.versions/2.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  382. package/.versions/2.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  383. package/.versions/2.0.3/skills/incremental-implementation/SKILL.md +298 -0
  384. package/.versions/2.0.3/skills/interview-me/SKILL.md +226 -0
  385. package/.versions/2.0.3/skills/orchestration-verification/SKILL.md +181 -0
  386. package/.versions/2.0.3/skills/peer-coms/SKILL.md +90 -0
  387. package/.versions/2.0.3/skills/performance-optimization/SKILL.md +350 -0
  388. package/.versions/2.0.3/skills/planning-and-task-breakdown/SKILL.md +265 -0
  389. package/.versions/2.0.3/skills/security-and-hardening/SKILL.md +461 -0
  390. package/.versions/2.0.3/skills/spec-driven-development/SKILL.md +256 -0
  391. package/.versions/2.0.3/skills/using-agent-skills/SKILL.md +197 -0
  392. package/.versions/2.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  393. package/.versions/2.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  394. package/.versions/2.0.3/vendor/agent-skills-upstream/README.md +11 -0
  395. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  396. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  397. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  398. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  399. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  400. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  401. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  402. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  403. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  404. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  405. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  406. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  407. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  408. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  409. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  410. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  411. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  412. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  413. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  414. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  415. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  416. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  417. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  418. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  419. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  420. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  421. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  422. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  423. package/CHANGELOG.md +7 -0
  424. package/README.md +2 -2
  425. package/bin/lib/doctor.js +1 -1
  426. package/bin/lib/model-visibility.js +64 -0
  427. package/docs/agent-fleet-setup.md +1 -1
  428. package/docs/getting-started.md +2 -2
  429. package/docs/npm-install.md +1 -1
  430. package/docs/pi-extensions.md +13 -10
  431. package/install-manifest.json +36 -1
  432. package/justfile +1 -0
  433. package/manifest-meta.json +25 -1
  434. package/package.json +4 -2
  435. package/scripts/fleet.ts +1 -1
  436. package/scripts/package-lock.json +35 -0
  437. package/scripts/package.json +9 -0
  438. package/.pi/harnesses/agent-hub/research-retention.js +0 -34
@@ -0,0 +1,137 @@
1
+ #!/usr/bin/env node
2
+ import { existsSync } from "node:fs";
3
+ import { dirname, resolve } from "node:path";
4
+ import { fileURLToPath, pathToFileURL } from "node:url";
5
+ import { makeRunId } from "../.pi/harnesses/agent-hub/run-namespace.js";
6
+ import { parseFlowCommand, parseFlowMaintenanceCommand, type FlowCommand } from "./lib/flow-command.ts";
7
+ import { runFlowMaintenance } from "./lib/flow-maintenance.ts";
8
+ import { loadEnv } from "./workflows/lib/env.ts";
9
+ import { createFlowBranch, recordFlowResult, requireCleanTree, StartRefusedError } from "./workflows/lib/git.ts";
10
+ import { snapshot } from "./workflows/lib/permissions.ts";
11
+ import { Run, type FinishResult } from "./workflows/lib/run.ts";
12
+ import { buildTestWorkflow, buildTestWorkflowPreflight } from "./workflows/wf-build-test.ts";
13
+ import { documentWorkflow, documentWorkflowPreflight } from "./workflows/wf-document.ts";
14
+ import { qualityWorkflow, qualityWorkflowPreflight } from "./workflows/wf-quality.ts";
15
+ import { scoutWorkflow, scoutWorkflowPreflight } from "./workflows/wf-scout.ts";
16
+ import { pollWorkflow, pollWorkflowPreflight, pollWorkflowValidate } from "./workflows/wf-poll.ts";
17
+ import { debateWorkflow, debateWorkflowPreflight, debateWorkflowValidate } from "./workflows/wf-debate.ts";
18
+
19
+ export type Workflow = (run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }) => Promise<FinishResult>;
20
+ export interface WorkflowDefinition {
21
+ run: Workflow;
22
+ validate?: (command: FlowCommand, cwd: string) => void;
23
+ preflight?: (cwd: string, command: FlowCommand) => void;
24
+ }
25
+ export const workflows: Record<string, WorkflowDefinition> = {
26
+ "build-test": {
27
+ run: buildTestWorkflow,
28
+ validate: command => { if (!command.args.join(" ").trim()) throw Object.assign(new Error("build-test flow requires an implementation request"), { exitCode: 2 }); },
29
+ preflight: buildTestWorkflowPreflight,
30
+ },
31
+ document: { run: documentWorkflow, preflight: documentWorkflowPreflight },
32
+ quality: { run: qualityWorkflow, preflight: qualityWorkflowPreflight },
33
+ scout: {
34
+ run: scoutWorkflow,
35
+ validate: command => { if (!command.args.join(" ").trim()) throw Object.assign(new Error("scout flow requires a question"), { exitCode: 2 }); },
36
+ preflight: scoutWorkflowPreflight,
37
+ },
38
+ poll: {
39
+ run: pollWorkflow,
40
+ validate: pollWorkflowValidate,
41
+ preflight: pollWorkflowPreflight,
42
+ },
43
+ debate: {
44
+ run: debateWorkflow,
45
+ validate: debateWorkflowValidate,
46
+ preflight: debateWorkflowPreflight,
47
+ },
48
+ };
49
+
50
+ function workflowExportName(name: string): string {
51
+ return `${name.replace(/-([a-z0-9])/g, (_, char: string) => char.toUpperCase())}Workflow`;
52
+ }
53
+
54
+ export async function resolveWorkflow(name: string, workflowsDir = resolve(dirname(fileURLToPath(import.meta.url)), "workflows")): Promise<WorkflowDefinition | undefined> {
55
+ if (workflows[name]) return workflows[name];
56
+ const path = resolve(workflowsDir, `wf-${name}.ts`);
57
+ if (!existsSync(path)) return undefined;
58
+ const module = await import(`${pathToFileURL(path).href}?flow=${Date.now()}`) as Record<string, unknown>;
59
+ const exportName = workflowExportName(name);
60
+ const run = module[exportName];
61
+ if (typeof run !== "function") throw Object.assign(new Error(`Flow ${name} must export ${exportName}().`), { exitCode: 2 });
62
+ const preflight = module[`${exportName}Preflight`];
63
+ if (preflight !== undefined && typeof preflight !== "function") throw Object.assign(new Error(`Flow ${name} has an invalid ${exportName}Preflight export.`), { exitCode: 2 });
64
+ return { run: run as Workflow, ...(typeof preflight === "function" ? { preflight: preflight as (cwd: string) => void } : {}) };
65
+ }
66
+
67
+ export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string } = {}): Promise<FinishResult> {
68
+ const cwd = options.cwd ?? process.cwd();
69
+ const workflow = await resolveWorkflow(command.name, options.workflowsDir);
70
+ if (!workflow) throw Object.assign(new Error(`Unknown flow: ${command.name}`), { exitCode: 2 });
71
+ workflow.validate?.(command, cwd);
72
+ loadEnv(cwd);
73
+ // All refusal checks precede branch creation and the FlowTrace constructor.
74
+ requireCleanTree(cwd, command.allowDirty);
75
+ workflow.preflight?.(cwd, command);
76
+ const runId = command.runId ?? makeRunId();
77
+ const repositoryBaseline = snapshot(cwd);
78
+ const branch = createFlowBranch(command.name, runId, cwd);
79
+ const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline });
80
+ const persistResult = (result: FinishResult) => {
81
+ try { recordFlowResult(branch, result.status, cwd); }
82
+ catch (error) { console.error(`Warning: flow result metadata was not recorded: ${error instanceof Error ? error.message : String(error)}`); }
83
+ };
84
+ let interruption: FinishResult | undefined;
85
+ const onSignal = (signal: NodeJS.Signals) => {
86
+ if (interruption) return;
87
+ interruption = run.interrupt(signal);
88
+ };
89
+ process.once("SIGINT", onSignal);
90
+ process.once("SIGTERM", onSignal);
91
+ try {
92
+ const result = await workflow.run(run, { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply });
93
+ const finalResult = interruption ?? result;
94
+ persistResult(finalResult);
95
+ console.error(finalResult.banner);
96
+ return finalResult;
97
+ } catch (error) {
98
+ if (!interruption) {
99
+ const message = error instanceof Error ? error.message : String(error);
100
+ const rejected = run.abort(message);
101
+ persistResult(rejected);
102
+ console.error(rejected.banner);
103
+ throw error;
104
+ }
105
+ persistResult(interruption);
106
+ console.error(interruption.banner);
107
+ return interruption;
108
+ } finally {
109
+ process.removeListener("SIGINT", onSignal);
110
+ process.removeListener("SIGTERM", onSignal);
111
+ }
112
+ }
113
+
114
+ export async function main(argv = process.argv.slice(2)): Promise<number> {
115
+ if (argv[0] === "cleanup" || argv[0] === "merge") {
116
+ let command;
117
+ try { command = parseFlowMaintenanceCommand(argv); }
118
+ catch (error) { console.error(error instanceof Error ? error.message : String(error)); return 2; }
119
+ try { return await runFlowMaintenance(command); }
120
+ catch (error) {
121
+ console.error(error instanceof Error ? error.message : String(error));
122
+ return Number((error as { exitCode?: number })?.exitCode ?? 1);
123
+ }
124
+ }
125
+ let parsed: FlowCommand;
126
+ try { parsed = parseFlowCommand(argv); }
127
+ catch (error) { console.error(error instanceof Error ? error.message : String(error)); return 2; }
128
+ try {
129
+ return (await executeFlow(parsed)).exitCode;
130
+ } catch (error) {
131
+ const message = error instanceof Error ? error.message : String(error);
132
+ console.error(message);
133
+ return Number((error as { exitCode?: number })?.exitCode ?? (error instanceof StartRefusedError ? 3 : 1));
134
+ }
135
+ }
136
+
137
+ if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) process.exitCode = await main();
@@ -0,0 +1,25 @@
1
+ import * as fs from 'node:fs';import * as path from 'node:path';import * as crypto from 'node:crypto';import {fileURLToPath} from 'node:url';import {spawn as realSpawn} from 'node:child_process';
2
+ export function parseRunnerArgs(argv:string[]){if(argv[0]!=='verify')throw Error('unsupported command');const out:any={};for(let i=1;i<argv.length;i+=2){const k=argv[i],v=argv[i+1];if(!['--root','--artifact'].includes(k)||!v||out[k])throw Error('invalid arguments');out[k]=v;}if(!out['--root']||!out['--artifact'])throw Error('missing arguments');return{root:out['--root'],artifact:out['--artifact']};}
3
+ export function verifyGateArtifact(root:string,artifactPath:string){root=validateOwnedRoot(root);const st=fs.lstatSync(artifactPath);if(st.isSymbolicLink()||!st.isFile())throw Error('unsafe gate artifact');const a=JSON.parse(fs.readFileSync(artifactPath,'utf8'));const bad=()=>{throw Error('gate artifact failed closed')};if(a.schema!=='agent-fleet.hermes-gate-c-capabilities'||a.schemaVersion!==1||a.gate!=='C'||a.status!=='passed'||a.runtimeVerified!==true)bad();const argv=a.argv??{};for(const k of ['pluginEnableArgv','backendStartArgv','backendStopArgv','desktopStartArgv','desktopStopArgv'])if(!Array.isArray(argv[k])||!argv[k].length||argv[k].some((x:any)=>typeof x!=='string'||!x))bad();if(!a.capabilities?.desktopDebugAttachment?.url||!a.capabilities?.desktopDebugAttachment?.probeExpression)bad();const proof=a.pluginLoadProof;if(proof?.backendPluginId!=='agent-fleet-monitor'||proof?.desktopPluginId!=='agent-fleet-monitor')bad();if(a.validation?.status!=='passed'||a.gateDecision?.status!=='pass'||a.gateDecision?.implementationMayProceed!==true)bad();const raw=JSON.stringify(a);if(/(api[_-]?key|token|password|\/home\/|\.pi\/agent)/i.test(raw))bad();return{sha256:crypto.createHash('sha256').update(raw).digest('hex'),argv:{enable:argv.pluginEnableArgv,backend:argv.backendStartArgv,desktop:argv.desktopStartArgv},debug:a.capabilities.desktopDebugAttachment,proof};}
4
+ export type Owned={root:string;pid?:number;argv:string[];executable:string;start?:string;reservation:string};
5
+ export function ownedIndexPath(root:string,file:string){root=validateOwnedRoot(root);const target=path.resolve(root,file);if(path.dirname(target)!==root||path.basename(target)!==file)throw Error('owned index must be direct child');return target;}
6
+ export function writeOwnedIndex(root:string,file:string,value:any){const target=ownedIndexPath(root,file);if(!value||value.schema!==1||value.root!==validateOwnedRoot(root)||typeof value.owner!=='string'||typeof value.artifactSha256!=='string'||typeof value.components!=='object')throw Error('invalid owned index');for(const [component,item] of Object.entries(value.components)){componentName(component);const x:any=item;if(!x||x.registry!==`registry-${component}.json`||typeof x.owner!=='string')throw Error('invalid owned index component');}const tmp=path.join(root,`.${path.basename(file)}.${process.pid}.tmp`);fs.writeFileSync(tmp,JSON.stringify(value),{mode:0o600});fs.renameSync(tmp,target);return value;}
7
+ export function readOwnedIndex(root:string,file:string){const target=ownedIndexPath(root,file),st=fs.lstatSync(target);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error('unsafe owned index');return JSON.parse(fs.readFileSync(target,'utf8'));}
8
+ const SENTINEL='.agent-fleet-hermes-monitor-smoke',REGISTRY='owned-registry.json';const componentName=(v:string)=>{if(!/^[A-Za-z0-9._-]+$/.test(v)||v.includes('..'))throw Error('invalid component');return v};
9
+ export async function terminateExactChild(child:any,deps:any={}){if(!child||typeof child.kill!=='function')throw Error('child handle required');if(child.exitCode!==null&&child.exitCode!==undefined)return{exited:true};const set=deps.setTimeout??setTimeout,clear=deps.clearTimeout??clearTimeout,waitMs=deps.waitMs??5000;let resolve:any;const exited=new Promise(r=>resolve=r);child.once?.('exit',()=>resolve(true));const wait=()=>new Promise(r=>{timer=set(r,waitMs)});try{child.kill('SIGTERM')}catch(e:any){if(e?.code==='ESRCH')return{exited:true};throw e}let timer:any;try{const first=await Promise.race([exited,wait()]);if(first)return{exited:true};try{child.kill('SIGKILL')}catch(e:any){if(e?.code==='ESRCH')return{exited:true};throw e}const second=await Promise.race([exited,wait()]);return{exited:!!second};}finally{if(timer!==undefined)clear(timer);}}
10
+ const finalizedLaunchErrors=new Set<string>();export async function finalizeDurableLaunchError(root:string,component:string,owner:string,reservation:string,child:any,deps:any={}){const key=`${root}:${component}:${owner}`;if(finalizedLaunchErrors.has(key))return;finalizedLaunchErrors.add(key);try{if(child?.exitCode===null||child?.exitCode===undefined)await terminateExactChild(child,deps);}catch{}try{const record=readOwnedRegistry(root,component);if(record.owner!==owner||record.state==='exited')return;writeOwnedRegistry(root,{...record,state:'failed'},component);const value=JSON.parse(fs.readFileSync(reservation,'utf8'));if(value.owner===owner)fs.unlinkSync(reservation);}catch{}}
11
+ export function safeRoot(root:string){const r=path.resolve(root);if(r===path.parse(r).root)throw Error('owned root required');return r;}
12
+ export function validateOwnedRoot(root:string){root=safeRoot(root);const st=fs.lstatSync(root);if(st.isSymbolicLink()||!st.isDirectory()||(st.mode&0o777)!==0o700)throw Error('unsafe owned root');const sentinel=path.join(root,SENTINEL),ss=fs.lstatSync(sentinel);if(ss.isSymbolicLink()||!ss.isFile()||(ss.mode&0o777)!==0o600)throw Error('unsafe owned sentinel');const value=JSON.parse(fs.readFileSync(sentinel,'utf8'));if(value?.schema!==1||value?.owner!=='agent-fleet'||value?.root!==fs.realpathSync(root))throw Error('invalid owned sentinel');return fs.realpathSync(root);}
13
+ export function buildOwnedEnv(root:string,env:any={}){root=validateOwnedRoot(root);const child=(n:string)=>path.join(root,n);for(const n of ['home','config','state','runtime','cache','hermes','sockets']){const p=child(n);fs.mkdirSync(p,{recursive:true,mode:0o700});const st=fs.lstatSync(p);if(st.isSymbolicLink()||!st.isDirectory()||(st.mode&0o777)!==0o700)throw Error('unsafe owned env path');}return{...env,HOME:child('home'),XDG_CONFIG_HOME:child('config'),XDG_STATE_HOME:child('state'),XDG_RUNTIME_DIR:child('runtime'),XDG_CACHE_HOME:child('cache'),HERMES_HOME:child('hermes'),HERDR_SOCKET_PATH:path.join(child('sockets'),'herdr.sock')};}
14
+ export function writeOwnedRegistry(root:string,value:any,component?:string){root=validateOwnedRoot(root);if(component)componentName(component);if(!Array.isArray(value.argv)||!value.argv.length||value.argv.some((x:any)=>typeof x!=='string'||!x))throw Error('invalid owned argv');const clean={schema:1,root,component:(typeof value.component==='string'&&/^[A-Za-z0-9._-]+$/.test(value.component)?value.component:(()=>{throw Error('invalid component')})()),executable:fs.realpathSync(value.executable),argv:[...(value.argv??[])].map(String),pid:Number(value.pid),start:String(value.start),state:String(value.state??'running'),owner:typeof value.owner==='string'?value.owner:undefined,createdAt:value.createdAt??new Date().toISOString(),updatedAt:new Date().toISOString()};const name=component?`registry-${component}.json`:REGISTRY,file=path.join(root,name),tmp=path.join(root,`.${name}.${process.pid}.tmp`);fs.writeFileSync(tmp,JSON.stringify(clean),{mode:0o600});fs.renameSync(tmp,file);return clean;}
15
+ export function readOwnedRegistry(root:string,component?:string){root=validateOwnedRoot(root);if(component)componentName(component);const file=path.join(root,component?`registry-${component}.json`:REGISTRY),st=fs.lstatSync(file);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error('unsafe owned registry');const v=JSON.parse(fs.readFileSync(file,'utf8'));if(v?.schema!==1||v.root!==root||!Array.isArray(v.argv)||!v.argv.length||v.argv.some((x:any)=>typeof x!=='string'||!x)||typeof v.component!=='string'||typeof v.pid!=='number'||v.pid<=0||typeof v.start!=='string'||!v.start||typeof v.owner!=='string'||!v.owner||!['starting','running','stopping','exited','failed'].includes(v.state))throw Error('invalid owned registry');return v;}
16
+ export async function launchOwnedDurable(root:string,component:string,argv:string[],deps:any={}){root=validateOwnedRoot(root);if(!/^[A-Za-z0-9._-]+$/.test(component)||!Array.isArray(argv)||!argv.length||argv.some(x=>typeof x!=='string'||!x))throw Error('invalid durable launch');const f=deps.fs??fs,spawn=deps.spawn??realSpawn,owner=deps.uuid?.()??crypto.randomUUID(),reservation=path.join(root,`.reservation-${component}`);try{f.writeFileSync(reservation,JSON.stringify({owner,component}),{flag:'wx',mode:0o600});}catch{throw Error('component reservation exists')}let child:any=null;const fail=(state:string)=>{try{writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:0,start:'',state,owner},component)}catch{}try{const value=JSON.parse(f.readFileSync(reservation,'utf8'));if(value.owner===owner)f.unlinkSync(reservation)}catch{}};try{writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:0,start:'pending',state:'starting',owner},component);child=spawn(argv[0],argv.slice(1),{cwd:root,env:buildOwnedEnv(root),shell:false,stdio:'ignore'});child.once?.('error',()=>{void finalizeDurableLaunchError(root,component,owner,reservation,child,deps).catch(()=>{})});const start=(deps.startOf??startOf)(child.pid);const record=writeOwnedRegistry(root,{component,executable:argv[0],argv,pid:child.pid,start,state:'running',owner},component);child.once?.('exit',()=>{try{const current=readOwnedRegistry(root,component);if(current.component===component&&current.pid===child.pid&&current.start===start)writeOwnedRegistry(root,{...current,state:'exited'},component);}catch{}});return{child,record,reservation};}catch(error){if(child){await finalizeDurableLaunchError(root,component,owner,reservation,child,deps);fail('failed')}else fail('failed');throw error;}}
17
+ export async function waitOwnedFromRegistry(root:string,component:string,deps:any={}){const now=deps.now??Date.now,sleep=deps.sleep??((ms:number)=>new Promise(r=>setTimeout(r,ms))),start=deps.startOf??startOf,timeout=deps.timeout??10_000;const record=readOwnedRegistry(root,component);if(record.component!==component||!['running','stopping'].includes(record.state))return record;if(start(record.pid)!==record.start)throw Error('owned process identity changed');const began=now();while(now()-began<timeout){try{if(start(record.pid)!==record.start){const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);return exited;}}catch{return writeOwnedRegistry(root,{...record,state:'exited'},component)}await sleep(10);}throw Error('owned wait timeout');}
18
+ export async function stopOwnedFromRegistry(root:string,component:string,deps:any={}){const signal=deps.signal??((pid:number,s:string)=>process.kill(pid,s)),start=deps.startOf??startOf,sleep=deps.sleep??((ms:number)=>new Promise(r=>setTimeout(r,ms)));let record=readOwnedRegistry(root,component);if(record.component!==component||record.state!=='running')throw Error('component not running');const markExited=()=>{const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);try{const p=path.join(root,`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===record.owner)fs.unlinkSync(p)}catch{}return exited};const same=()=>{try{const value=start(record.pid);if(value===undefined||value===null)return null;return value===record.start}catch(e:any){if(e?.code==='ESRCH')return null;throw e}};const initial=same();if(initial===null)return markExited();if(!initial)throw Error('owned process identity changed');record=writeOwnedRegistry(root,{...record,state:'stopping'},component);try{signal(record.pid,'SIGTERM')}catch(e:any){if(e?.code==='ESRCH'){const exited=writeOwnedRegistry(root,{...record,state:'exited'},component);try{const p=path.join(root,`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===record.owner)fs.unlinkSync(p)}catch{}return exited;}throw e}try{await waitOwnedFromRegistry(root,component,{...deps,timeout:5000});}catch{const beforeKill=same();if(beforeKill===null)return markExited();if(!beforeKill)throw Error('owned process identity changed');try{signal(record.pid,'SIGKILL')}catch(e:any){if(e?.code==='ESRCH')return writeOwnedRegistry(root,{...record,state:'exited'},component);throw e}try{await waitOwnedFromRegistry(root,component,{...deps,timeout:5000});}catch{writeOwnedRegistry(root,{...record,state:'failed'},component);throw Error('owned stop timeout');}}const final=readOwnedRegistry(root,component);try{const p=path.join(validateOwnedRoot(root),`.reservation-${component}`),v=JSON.parse(fs.readFileSync(p,'utf8'));if(v.owner===final.owner)fs.unlinkSync(p)}catch{}return final;}
19
+ export async function launchOwnedIndexed(root:string,component:string,argv:string[],ownedFile:string,artifactSha:string,deps:any={}){root=validateOwnedRoot(root);const lock=path.join(root,'.owned-index.lock');let fd,acquired=false;let launched:any,index:any,prior:any;try{fd=fs.openSync(lock,'wx',0o600);acquired=true;try{index=readOwnedIndex(root,ownedFile)}catch{index={schema:1,root,owner:crypto.randomUUID(),artifactSha256:artifactSha,components:{}}}if(index.artifactSha256!==artifactSha)throw Error('artifact mismatch');prior=index.components[component];launched=await launchOwnedDurable(root,component,argv,deps);const record=readOwnedRegistry(root,component);index.components[component]={registry:`registry-${component}.json`,owner:record.owner};writeOwnedIndex(root,ownedFile,index);return launched;}catch(error){if(launched){try{const record=readOwnedRegistry(root,component);if(record.owner===launched.record.owner&&record.pid===launched.record.pid&&record.start===launched.record.start)await stopOwnedFromRegistry(root,component,deps);}catch{}try{if(index){if(prior)index.components[component]=prior;else delete index.components[component];writeOwnedIndex(root,ownedFile,index);}}catch{}}throw error;}finally{if(acquired){try{fs.closeSync(fd)}catch{};try{fs.unlinkSync(lock)}catch{}}}}
20
+ export async function waitOwnedIndexed(root:string,component:string,ownedFile:string,artifactSha:string,deps:any={}){const index=readOwnedIndex(root,ownedFile),entry=index.components?.[component],record=readOwnedRegistry(root,component);if(index.artifactSha256!==artifactSha||!entry||entry.registry!==`registry-${component}.json`||entry.owner!==record.owner)throw Error('owned index mismatch');return waitOwnedFromRegistry(root,component,deps);}
21
+ export async function stopOwnedIndexed(root:string,component:string,ownedFile:string,artifactSha:string,deps:any={}){const index=readOwnedIndex(root,ownedFile),record=readOwnedRegistry(root,component),entry=index.components?.[component];if(!entry||entry.owner!==record.owner||index.artifactSha256!==artifactSha)throw Error('owned index mismatch');const result=await stopOwnedFromRegistry(root,component,deps);if(['exited','failed'].includes(result.state)&&index.components[component]?.owner===record.owner){delete index.components[component];writeOwnedIndex(root,ownedFile,index);}return result;}
22
+ if(process.argv[1]===fileURLToPath(import.meta.url)){try{const a=parseRunnerArgs(process.argv.slice(2)),v=verifyGateArtifact(a.root,a.artifact);process.stdout.write(JSON.stringify({ok:true,sha256:v.sha256})+'\n');}catch{process.stdout.write(JSON.stringify({ok:false,error:'verification_failed'})+'\n');process.exitCode=2;}}
23
+ export function writeGateArtifact(root:string,value:unknown){root=validateOwnedRoot(root);fs.mkdirSync(root,{recursive:true,mode:0o700});const file=path.join(root,'gate-c.json'),tmp=`${file}.${process.pid}.${Math.random()}.tmp`;fs.writeFileSync(tmp,JSON.stringify(value),{mode:0o600});fs.renameSync(tmp,file);return file;}
24
+ const startOf=(pid:number,read=(p:string)=>fs.readFileSync(p,'utf8'))=>{const stat=read(`/proc/${pid}/stat`),tail=stat.slice(stat.lastIndexOf(')')+2).split(' ');return tail[19];};
25
+ export async function runOwned(argv:string[],root:string,deps:any={}){if(!Array.isArray(argv)||!argv.length||argv.some(x=>typeof x!=='string'))throw Error('argv required');root=validateOwnedRoot(root);const f=deps.fs??fs,spawn=deps.spawn??realSpawn,set=deps.setTimeout??setTimeout,clear=deps.clearTimeout??clearTimeout,signals=deps.signals??process;f.mkdirSync(root,{recursive:true,mode:0o700});const reservation=path.join(root,'.reservation');let fd;try{fd=f.openSync(reservation,'wx',0o600);}catch{throw Error('owned reservation exists')}const owned:Owned={root,argv:[...argv],executable:argv[0],reservation};let child:any,exitResolve:any;const exited=new Promise(r=>exitResolve=r);let released=false,timer:any;const release=()=>{if(released)return;released=true;try{f.unlinkSync(reservation)}catch{};try{f.unlinkSync(path.join(root,'gate-c.json'))}catch{}};try{writeGateArtifact(root,{root,argv,executable:argv[0]});child=spawn(argv[0],argv.slice(1),{cwd:root,env:{...process.env,HOME:path.join(root,'home')},shell:false,stdio:'ignore'});owned.pid=child.pid;owned.start=(deps.startOf??startOf)(child.pid);child.once('exit',(code:any)=>{if(timer!==undefined)clear(timer);exitResolve(code);release();});}catch(e){release();throw e}const valid=()=>!!owned.pid&&(deps.startOf??startOf)(owned.pid)===owned.start;const stop=async()=>{if(released)return;if(!valid())throw Error('owned process identity changed');child.kill('SIGTERM');timer=set(()=>{if(valid())child.kill('SIGKILL')},5000);await exited;};const wait=()=>exited;const onSignal=()=>void stop();signals.once('SIGINT',onSignal);signals.once('SIGTERM',onSignal);return{child,owned,wait,stop,dispose:()=>{signals.removeListener('SIGINT',onSignal);signals.removeListener('SIGTERM',onSignal);release()}};}
@@ -0,0 +1,474 @@
1
+ /**
2
+ * Disposable, production-shaped monitor scenario.
3
+ *
4
+ * Every seam here is the real runtime: `MonitorRegistry`, `MonitorSocketServer`,
5
+ * `MonitorEventJournal`, `MonitorInvokeJournal`, the session bridge, the monitor
6
+ * lifecycle, and the production follow-up enqueue seam. There is no hand-stub
7
+ * that can turn an unsupported route into a success.
8
+ *
9
+ * Nothing here proves Gate O, live origin delivery, steering, or surgical
10
+ * runtime use. Recovery mechanics driven through `synthetic-local` commands are
11
+ * a labeled local test boundary, never capability evidence.
12
+ */
13
+ import { spawn, type ChildProcess } from "node:child_process";
14
+ import * as crypto from "node:crypto";
15
+ import * as fs from "node:fs";
16
+ import * as net from "node:net";
17
+ import * as path from "node:path";
18
+ import { fileURLToPath } from "node:url";
19
+
20
+ import { MonitorRegistry } from "./lib/hermes-monitor-registry.ts";
21
+ import { MonitorSocketServer } from "./lib/hermes-monitor-socket.ts";
22
+ import { FakeHerdrServer } from "./lib/fake-herdr-server.ts";
23
+ import { watchHubMonitor } from "./lib/hermes-monitor-herdr.ts";
24
+ import { createMonitorInvokeAdmission, createWatchdogFollowUpEnqueue } from "../.pi/harnesses/agent-hub/monitor-invoke.ts";
25
+ import { MonitorInvokeJournal } from "../.pi/harnesses/agent-hub/monitor-invoke-journal.ts";
26
+ import { createViewerGatedMonitor } from "../.pi/harnesses/agent-hub/monitor-publisher.ts";
27
+ import { createMonitorSessionBridge } from "../.pi/harnesses/agent-hub/monitor-session-bridge.ts";
28
+ import { MonitorRuntime } from "../.pi/harnesses/agent-hub/monitor-runtime.ts";
29
+ import { MonitorEventJournal } from "../.pi/harnesses/lib/hermes-monitor-events.ts";
30
+
31
+ const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
32
+ const WATCHER_ENTRYPOINT = path.join(repoRoot, "hermes", "skills", "hub-watchdog", "scripts", "watchdog.py");
33
+
34
+ const HUB_INSTANCE_ID = "hub";
35
+ const PROFILE_ID = "scenario";
36
+ const UDS_TIMEOUT_MS = 1_000;
37
+ const DEFAULT_WAIT_TIMEOUT_MS = 5_000;
38
+ // Polling a busy UDS every 5ms can starve the real Python child's 2s long-poll
39
+ // from being scheduled during owner rollover. This is only a test barrier; the
40
+ // watcher's production events() cycle remains 2s.
41
+ const WAIT_POLL_MS = 25;
42
+
43
+ export type WatcherChild = {
44
+ child: ChildProcess;
45
+ stateDir: string;
46
+ auditPath: string;
47
+ stdout: string[];
48
+ stderr: string[];
49
+ exit: Promise<{ code: number | null; signal: NodeJS.Signals | null }>;
50
+ };
51
+
52
+ export type Scenario = {
53
+ root: string;
54
+ tasks: Map<string, any>;
55
+ visible: boolean;
56
+ counters: { polls: number; outputs: number };
57
+ bridge?: any;
58
+ registration?: any;
59
+ server?: any;
60
+ herdr?: any;
61
+ hybrid?: any;
62
+ viewer?: any;
63
+ statuses: any[];
64
+ outputs: any[];
65
+ clock: any;
66
+ disposables: Set<() => any>;
67
+ /** Follow-ups rendered by the production seam, in order. */
68
+ followUps: Array<{ message: any; options: any }>;
69
+ /** Queue depth the invoke admission reads; raise it to force `queue_full`. */
70
+ queueDepth: number;
71
+ queueLimit: number;
72
+ /** Real disposable child processes standing in for native specialists. */
73
+ natives: Map<string, { child: ChildProcess; exit: Promise<number | null> }>;
74
+ cancels: Array<{ taskId: string; generation: number }>;
75
+ watcher?: WatcherChild;
76
+ eventJournal?: MonitorEventJournal;
77
+ };
78
+
79
+ export function createScenario(root: string, options: any = {}): Scenario {
80
+ root = path.resolve(root);
81
+ if (root === path.parse(root).root) throw Error("owned scenario root required");
82
+ fs.mkdirSync(root, { recursive: true, mode: 0o700 });
83
+ fs.chmodSync(root, 0o700);
84
+ return {
85
+ root,
86
+ tasks: new Map(),
87
+ visible: false,
88
+ counters: { polls: 0, outputs: 0 },
89
+ statuses: [],
90
+ outputs: [],
91
+ clock: options.clock ?? { setInterval, clearInterval, setTimeout, clearTimeout, now: Date.now },
92
+ disposables: new Set(),
93
+ followUps: [],
94
+ queueDepth: 0,
95
+ queueLimit: options.queueLimit ?? 1,
96
+ natives: new Map(),
97
+ cancels: [],
98
+ };
99
+ }
100
+
101
+ /** Register cleanup exactly once; repeated `stop-owned` runs stay idempotent. */
102
+ export function registerDisposable(s: Scenario, dispose: () => any) {
103
+ let done = false;
104
+ s.disposables.add(async () => {
105
+ if (done) return;
106
+ done = true;
107
+ await dispose();
108
+ });
109
+ }
110
+
111
+ /**
112
+ * Poll a condition instead of sleeping. Every scenario barrier goes through
113
+ * this so a loaded machine slows the test down rather than flaking it.
114
+ */
115
+ export async function waitFor(
116
+ predicate: () => boolean | Promise<boolean>,
117
+ options: { label?: string; timeoutMs?: number } = {},
118
+ ): Promise<void> {
119
+ const timeoutMs = options.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
120
+ const deadline = Date.now() + timeoutMs;
121
+ for (;;) {
122
+ if (await predicate()) return;
123
+ if (Date.now() >= deadline) throw Error(`timed out waiting for ${options.label ?? "condition"} after ${timeoutMs}ms`);
124
+ await new Promise(resolve => setTimeout(resolve, WAIT_POLL_MS));
125
+ }
126
+ }
127
+
128
+ function uds(socketPath: string, frame: any): Promise<any> {
129
+ return new Promise((resolve, reject) => {
130
+ let text = "";
131
+ const client = net.createConnection(socketPath);
132
+ client.setTimeout(UDS_TIMEOUT_MS, () => client.destroy(Error("scenario timeout")));
133
+ client.on("connect", () => client.end(JSON.stringify(frame) + "\n"));
134
+ client.on("data", chunk => { text += chunk; });
135
+ client.on("close", () => resolve(text ? JSON.parse(text) : null));
136
+ client.on("error", reject);
137
+ });
138
+ }
139
+
140
+ /** sha256 of the hub instance id — the namespace directory the watcher reads. */
141
+ export function hubKeyFor(hubInstanceId: string = HUB_INSTANCE_ID): string {
142
+ return crypto.createHash("sha256").update(hubInstanceId).digest("hex");
143
+ }
144
+
145
+ // ── serve ────────────────────────────────────────────────────────────────────
146
+
147
+ function buildRegistration(s: Scenario) {
148
+ const profile = path.join(s.root, "profile");
149
+ fs.mkdirSync(profile, { recursive: true, mode: 0o700 });
150
+
151
+ const journal = new MonitorEventJournal({ file: path.join(s.root, "events.ndjson"), now: () => new Date(s.clock.now()) });
152
+ const bridge = createMonitorSessionBridge({
153
+ now: () => new Date(s.clock.now()),
154
+ events: journal,
155
+ runtime: new MonitorRuntime({ runtimeDir: s.root, profileId: PROFILE_ID, hubInstanceId: HUB_INSTANCE_ID }),
156
+ });
157
+ const registration: any = new MonitorRegistry({ runtimeDir: s.root }).register({
158
+ profilePath: profile,
159
+ profileId: PROFILE_ID,
160
+ hubInstanceId: HUB_INSTANCE_ID,
161
+ snapshot: () => bridge.snapshot(),
162
+ });
163
+ bridge.setEventIdentity({ profileKey: registration.profileKey, hubInstanceId: HUB_INSTANCE_ID });
164
+ bridge.setCurrentOwner({
165
+ ownerSessionId: registration.ownerId,
166
+ ownerLeaseExpiresAt: registration.leaseExpiresAt,
167
+ updateActive: true,
168
+ });
169
+
170
+ const invokeJournal = new MonitorInvokeJournal(path.join(s.root, "invokes.ndjson"));
171
+ registration.output = (request: any) => { s.counters.outputs++; return bridge.readOutput(request); };
172
+ registration.events = (request: any) => journal.replay(request.afterSequence, request.limit, request.waitMs, request.signal);
173
+ registration.cancel = (request: any) => cancelNative(s, request);
174
+ registration.invoke = createMonitorInvokeAdmission({
175
+ journal: invokeJournal,
176
+ task: (id: string, generation: number) => bridge.snapshot().tasks.find((task: any) => task.id === id && task.generation === generation),
177
+ owner: () => registration.ownerId,
178
+ queueDepth: () => s.queueDepth,
179
+ queueLimit: s.queueLimit,
180
+ // The one production seam: the same renderer `index.ts` uses.
181
+ enqueue: createWatchdogFollowUpEnqueue((message, options) => { s.followUps.push({ message, options }); }),
182
+ publish: (kind: any, task: any) => bridge.publishEvent(kind, task),
183
+ });
184
+
185
+ return { bridge, registration, journal };
186
+ }
187
+
188
+ async function serve(s: Scenario) {
189
+ if (s.server) return { socketPath: s.registration.socketPath };
190
+ const { bridge, registration, journal } = buildRegistration(s);
191
+ const server = new MonitorSocketServer(registration);
192
+ await server.listen();
193
+
194
+ s.bridge = bridge;
195
+ s.registration = registration;
196
+ s.server = server;
197
+ s.eventJournal = journal;
198
+ s.herdr = await FakeHerdrServer.start({ paneId: "pane", workspaceId: "workspace", resyncOutput: { sequence: 1, text: "resync" } });
199
+
200
+ const env: any = { HERDR_ENV: "1", HERDR_PANE_ID: "pane", HERDR_SOCKET_PATH: s.herdr.socketPath };
201
+ s.hybrid = watchHubMonitor({
202
+ env,
203
+ reconnectDelayMs: 1,
204
+ onStatus: (value: any) => s.statuses.push(value),
205
+ onOutput: (value: any) => s.outputs.push(value),
206
+ });
207
+ s.viewer = createViewerGatedMonitor({
208
+ pollMetadata: async () => { s.counters.polls++; return []; },
209
+ fetchOutput: async () => ({ sequence: 0 }),
210
+ intervalMs: 1,
211
+ });
212
+
213
+ registerDisposable(s, () => s.hybrid?.close());
214
+ registerDisposable(s, () => s.viewer?.stop());
215
+ registerDisposable(s, () => s.herdr?.close());
216
+ registerDisposable(s, () => stopWatcher(s));
217
+ registerDisposable(s, () => stopNatives(s));
218
+ // Owns whichever registration is current at teardown, so an owner rollover
219
+ // never leaves a second disposable trying to close an already-closed server.
220
+ registerDisposable(s, () => closeCurrentRegistration(s));
221
+
222
+ return { socketPath: registration.socketPath, token: registration.token };
223
+ }
224
+
225
+ async function closeCurrentRegistration(s: Scenario) {
226
+ const server = s.server;
227
+ const registration = s.registration;
228
+ s.server = null;
229
+ s.registration = undefined;
230
+ if (server) await server.close();
231
+ registration?.cleanup?.();
232
+ }
233
+
234
+ /** Re-register under a fresh owner so consumers must rediscover token and socket. */
235
+ async function rollOwner(s: Scenario) {
236
+ if (!s.server) throw Error("serve first");
237
+ const previousSocket = s.registration.socketPath;
238
+ await closeCurrentRegistration(s);
239
+ // Explicit release gate: never publish a replacement until the old owned
240
+ // socket has been released, regardless of a loaded watcher's long-poll.
241
+ await waitFor(() => !fs.existsSync(previousSocket), { label: "previous owner socket release" });
242
+ const { bridge, registration, journal } = buildRegistration(s);
243
+ const server = new MonitorSocketServer(registration);
244
+ await server.listen();
245
+ s.bridge = bridge;
246
+ s.registration = registration;
247
+ s.server = server;
248
+ s.eventJournal = journal;
249
+ return { ownerId: registration.ownerId, socketPath: registration.socketPath };
250
+ }
251
+
252
+ // ── real disposable native children ──────────────────────────────────────────
253
+
254
+ /** A real child process that idles until it is signalled — never a stub. */
255
+ function startNative(s: Scenario, id: string, generation: number) {
256
+ const key = `${id}:${generation}`;
257
+ if (s.natives.has(key)) throw Error(`native ${key} already running`);
258
+ const child = spawn(process.execPath, ["-e", "setInterval(() => {}, 1000)"], { stdio: "ignore" });
259
+ const exit = new Promise<number | null>(resolve => child.once("close", code => resolve(code)));
260
+ s.natives.set(key, { child, exit });
261
+ return { pid: child.pid, key };
262
+ }
263
+
264
+ /** Cancel only the exact task/generation the request names. */
265
+ async function cancelNative(s: Scenario, request: { taskId: string; generation: number }) {
266
+ s.cancels.push({ taskId: request.taskId, generation: request.generation });
267
+ const key = `${request.taskId}:${request.generation}`;
268
+ const native = s.natives.get(key);
269
+ if (!native) return { cancelled: false, reason: "unsupported" };
270
+ native.child.kill("SIGTERM");
271
+ await native.exit;
272
+ s.natives.delete(key);
273
+ s.bridge?.finishChild?.(request.taskId, "cancelled");
274
+ return { cancelled: true, state: "cancelled" };
275
+ }
276
+
277
+ async function stopNatives(s: Scenario) {
278
+ for (const [, native] of s.natives) {
279
+ native.child.kill("SIGKILL");
280
+ await native.exit;
281
+ }
282
+ s.natives.clear();
283
+ }
284
+
285
+ // ── real foreground watcher child ────────────────────────────────────────────
286
+
287
+ /**
288
+ * Launch the shipped `watchdog.py watch` process as a real foreground child with
289
+ * a disposable HOME/XDG/profile/runtime environment and Gate O absent. It runs
290
+ * in `observe` mode, so it may only read events and journal them.
291
+ */
292
+ function startWatcher(s: Scenario, options: { autonomy?: string } = {}): WatcherChild {
293
+ if (s.watcher) throw Error("watcher already running");
294
+ if (!s.registration) throw Error("serve first");
295
+ const home = path.join(s.root, "watcher-home");
296
+ const stateDir = path.join(s.root, "watcher-state");
297
+ const lockDir = path.join(s.root, "watcher-lock");
298
+ for (const directory of [home, stateDir, lockDir]) fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
299
+
300
+ const invocation = {
301
+ // Gate O is deliberately absent: no `gateO` key at all.
302
+ autonomy: options.autonomy ?? "observe",
303
+ maximumAutonomy: "observe",
304
+ profileId: PROFILE_ID,
305
+ profileKey: s.registration.profileKey,
306
+ hubKey: hubKeyFor(),
307
+ hubInstanceId: HUB_INSTANCE_ID,
308
+ runtimeDir: s.root,
309
+ stateDir,
310
+ lockDir,
311
+ };
312
+ const child = spawn("python3", [WATCHER_ENTRYPOINT, "watch", "--invocation-json", JSON.stringify(invocation)], {
313
+ cwd: path.dirname(WATCHER_ENTRYPOINT),
314
+ env: {
315
+ PATH: process.env.PATH ?? "",
316
+ HOME: home,
317
+ XDG_STATE_HOME: path.join(home, "state"),
318
+ XDG_RUNTIME_DIR: lockDir,
319
+ PYTHONDONTWRITEBYTECODE: "1",
320
+ },
321
+ stdio: ["ignore", "pipe", "pipe"],
322
+ });
323
+ const stdout: string[] = [];
324
+ const stderr: string[] = [];
325
+ child.stdout?.on("data", chunk => stdout.push(String(chunk)));
326
+ child.stderr?.on("data", chunk => stderr.push(String(chunk)));
327
+ const exit = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>(resolve =>
328
+ child.once("close", (code, signal) => resolve({ code, signal })));
329
+
330
+ // The watcher scopes its private state by a hash of the profile id, never the
331
+ // raw name, so the audit path has to be derived the same way.
332
+ const profileRoot = crypto.createHash("sha256").update(PROFILE_ID).digest("hex");
333
+ s.watcher = {
334
+ child,
335
+ stateDir,
336
+ auditPath: path.join(stateDir, "agent-fleet", "hermes-watchdog", profileRoot, "audit.ndjson"),
337
+ stdout,
338
+ stderr,
339
+ exit,
340
+ };
341
+ return s.watcher;
342
+ }
343
+
344
+ /** Every audit decision the watcher has journaled so far. */
345
+ export function watcherAudit(s: Scenario): any[] {
346
+ const watcher = s.watcher;
347
+ if (!watcher || !fs.existsSync(watcher.auditPath)) return [];
348
+ return fs.readFileSync(watcher.auditPath, "utf8")
349
+ .split("\n")
350
+ .filter(Boolean)
351
+ .map(line => JSON.parse(line));
352
+ }
353
+
354
+ /** SIGINT the watcher and wait for it to release its lock and exit. */
355
+ async function stopWatcher(s: Scenario) {
356
+ const watcher = s.watcher;
357
+ if (!watcher) return { stopped: false };
358
+ if (watcher.child.exitCode === null && watcher.child.signalCode === null) watcher.child.kill("SIGINT");
359
+ const result = await watcher.exit;
360
+ s.watcher = undefined;
361
+ return { stopped: true, ...result };
362
+ }
363
+
364
+ /** Any `watch.lock` still present under the watcher's lock root. */
365
+ export function watcherLocks(s: Scenario, lockDir = path.join(s.root, "watcher-lock")): string[] {
366
+ const root = path.join(lockDir, "agent-fleet-hermes-watchdog");
367
+ if (!fs.existsSync(root)) return [];
368
+ const found: string[] = [];
369
+ const visit = (directory: string) => {
370
+ for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
371
+ const full = path.join(directory, entry.name);
372
+ if (entry.isDirectory()) visit(full);
373
+ else if (entry.name === "watch.lock") found.push(full);
374
+ }
375
+ };
376
+ visit(root);
377
+ return found;
378
+ }
379
+
380
+ // ── apply ────────────────────────────────────────────────────────────────────
381
+
382
+ async function apply(s: Scenario, args: string[]) {
383
+ if (args[0] === "status") { s.herdr.emitStatus(); return true; }
384
+ if (args[0] === "disconnect") { s.herdr.disconnectSubscribers(); return true; }
385
+ if (args[0] === "reconnect") { s.herdr.setWorkspaceId(args[1] ?? "workspace"); s.herdr.emitStatus(); return true; }
386
+ if (!s.bridge) throw Error("serve first");
387
+
388
+ const [action, id, value] = args;
389
+ if (action === "owner") {
390
+ s.bridge.setCurrentOwner({ ownerSessionId: id, ownerLeaseExpiresAt: value, updateActive: true });
391
+ return true;
392
+ }
393
+ if (action === "parent") return s.bridge.startParent({ id, hubInstanceId: HUB_INSTANCE_ID, checkoutId: PROFILE_ID });
394
+ if (action === "child") {
395
+ return s.bridge.startChild({ key: id, id, generation: 1, parentId: value, parentGeneration: 1, specialist: "fake" }, {});
396
+ }
397
+ if (action === "output" || action === "late") return s.bridge.appendOutput(id, value ?? "");
398
+ if (action === "wait-only") return s.bridge.registerWaitOnly(id, async () => {});
399
+ if (action === "cancel-wait") return s.bridge.cancelWaitOnly(id, { kind: "scenario_cancel" });
400
+ if (action === "evidence-loss") return s.bridge.reconcile({ owner: false, socket: false, session: false, herdr: false });
401
+ if (action === "transition") return s.bridge.finishChild(id, value);
402
+ throw Error("unsupported apply");
403
+ }
404
+
405
+ // ── get ──────────────────────────────────────────────────────────────────────
406
+
407
+ function get(s: Scenario, args: string[]) {
408
+ if (!s.registration) throw Error("serve first");
409
+ const [kind = "snapshot", id, generation = "1", after = "0"] = args;
410
+ const { socketPath, token } = s.registration;
411
+ s.counters.polls++;
412
+ if (kind === "output") {
413
+ return uds(socketPath, { type: "output", token, taskId: id, generation: Number(generation), afterSequence: Number(after) });
414
+ }
415
+ if (kind === "events") {
416
+ return uds(socketPath, { type: "events", token, afterSequence: Number(after), limit: 100, waitMs: 0 });
417
+ }
418
+ if (kind === "invoke") return uds(socketPath, { type: "invoke", token, ...JSON.parse(id!) });
419
+ if (kind === "cancel") return uds(socketPath, { type: "cancel", token, taskId: id, generation: Number(generation) });
420
+ return uds(socketPath, { type: "snapshot", token });
421
+ }
422
+
423
+ // ── command dispatch ─────────────────────────────────────────────────────────
424
+
425
+ export async function execute(s: Scenario, argv: string[]): Promise<any> {
426
+ const [command, ...args] = argv;
427
+ if (!command) throw Error("scenario command required");
428
+
429
+ if (command === "serve") return serve(s);
430
+ if (command === "roll-owner") return rollOwner(s);
431
+ if (command === "apply") return apply(s, args);
432
+ if (command === "get") return get(s, args);
433
+
434
+ if (command === "watcher") {
435
+ if (args[0] === "start") return startWatcher(s, { autonomy: args[1] });
436
+ if (args[0] === "audit") return watcherAudit(s);
437
+ if (args[0] === "stop") return stopWatcher(s);
438
+ if (args[0] === "locks") return watcherLocks(s);
439
+ throw Error("unsupported watcher command");
440
+ }
441
+ if (command === "native") {
442
+ if (args[0] === "start") return startNative(s, args[1]!, Number(args[2] ?? 1));
443
+ if (args[0] === "alive") return s.natives.has(`${args[1]}:${args[2] ?? 1}`);
444
+ throw Error("unsupported native command");
445
+ }
446
+ if (command === "queue") { s.queueDepth = Number(args[0]); return { queueDepth: s.queueDepth, queueLimit: s.queueLimit }; }
447
+ if (command === "follow-ups") return s.followUps;
448
+ if (command === "cancels") return s.cancels;
449
+
450
+ if (command === "visibility") {
451
+ s.visible = args[0] === "show";
452
+ s.viewer?.setViewers(s.visible ? 1 : 0);
453
+ return { visible: s.visible };
454
+ }
455
+ if (command === "counters") {
456
+ return { ...s.counters, statuses: s.statuses.length, outputs: s.outputs.length, subscriptions: s.herdr?.subscriptionCount() ?? 0 };
457
+ }
458
+ if (command === "wait") return s.bridge?.snapshot() ?? [];
459
+ if (command === "assert") {
460
+ if (args[0] !== "visible" || String(s.visible) !== args[1]) throw Error("assertion failed");
461
+ return true;
462
+ }
463
+ if (command === "stop-owned") {
464
+ for (const dispose of [...s.disposables]) await dispose();
465
+ s.disposables.clear();
466
+ s.server = null;
467
+ return true;
468
+ }
469
+ if (command === "wait-owned") {
470
+ if (s.disposables.size) throw Error("owned handles remain");
471
+ return { live: false, handles: 0 };
472
+ }
473
+ throw Error("unsupported scenario command");
474
+ }