@chankov/agent-fleet 1.0.2 → 1.0.4

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 (624) hide show
  1. package/.pi/harnesses/agent-hub/README.md +85 -71
  2. package/.pi/harnesses/agent-hub/context-window.js +1 -1
  3. package/.pi/harnesses/agent-hub/delegate.ts +14 -3
  4. package/.pi/harnesses/agent-hub/drift-watchdog.js +11 -4
  5. package/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  6. package/.pi/harnesses/agent-hub/footer.ts +3 -2
  7. package/.pi/harnesses/agent-hub/hub-state-audit.js +0 -14
  8. package/.pi/harnesses/agent-hub/index.ts +562 -300
  9. package/.pi/harnesses/agent-hub/package.json +1 -1
  10. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  11. package/.pi/harnesses/agent-hub/run-budget.js +67 -69
  12. package/.pi/harnesses/agent-hub/spawn.ts +25 -3
  13. package/.pi/harnesses/coms/package.json +1 -1
  14. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  15. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +2 -2
  16. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  17. package/.pi/harnesses/lib/fleet-detail-view.ts +134 -20
  18. package/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  19. package/.pi/prompts/af-plan.md +6 -5
  20. package/.versions/1.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  21. package/.versions/1.0.3/.pi/agents/model-profiles.yaml +27 -0
  22. package/.versions/1.0.3/.pi/agents/peers.yaml +142 -0
  23. package/.versions/1.0.3/.pi/agents/teams.yaml +41 -0
  24. package/.versions/1.0.3/.pi/damage-control-rules.yaml +297 -0
  25. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  26. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  27. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  28. package/.versions/1.0.3/.pi/extensions/btw/README.md +120 -0
  29. package/.versions/1.0.3/.pi/extensions/btw/index.ts +914 -0
  30. package/.versions/1.0.3/.pi/extensions/btw/package.json +6 -0
  31. package/.versions/1.0.3/.pi/extensions/btw/state.js +179 -0
  32. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  33. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  34. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  35. package/.versions/1.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  36. package/.versions/1.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  37. package/.versions/1.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  38. package/.versions/1.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  39. package/.versions/1.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  40. package/.versions/1.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  41. package/.versions/1.0.3/.pi/extensions/package-lock.json +1175 -0
  42. package/.versions/1.0.3/.pi/extensions/package.json +9 -0
  43. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  44. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  45. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  46. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  47. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  48. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  49. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  50. package/.versions/1.0.3/.pi/harnesses/agent-hub/README.md +1156 -0
  51. package/.versions/1.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  52. package/.versions/1.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  53. package/.versions/1.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  54. package/.versions/1.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  55. package/.versions/1.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  56. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  57. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  58. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  59. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  60. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  61. package/.versions/1.0.3/.pi/harnesses/agent-hub/delegate.ts +435 -0
  62. package/.versions/1.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  63. package/.versions/1.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  64. package/.versions/1.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.versions/1.0.3/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  66. package/.versions/1.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  67. package/.versions/1.0.3/.pi/harnesses/agent-hub/footer.ts +36 -0
  68. package/.versions/1.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  69. package/.versions/1.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  70. package/.versions/1.0.3/.pi/harnesses/agent-hub/index.ts +9999 -0
  71. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  72. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  73. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  74. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  75. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  76. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  77. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  78. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  79. package/.versions/1.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  80. package/.versions/1.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  81. package/.versions/1.0.3/.pi/harnesses/agent-hub/posture.ts +158 -0
  82. package/.versions/1.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  83. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-retention.js +34 -0
  84. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  85. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  86. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  87. package/.versions/1.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  88. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  89. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  90. package/.versions/1.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  91. package/.versions/1.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  92. package/.versions/1.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  93. package/.versions/1.0.3/.pi/harnesses/agent-hub/spawn.ts +366 -0
  94. package/.versions/1.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  95. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  96. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  97. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  98. package/.versions/1.0.3/.pi/harnesses/coms/README.md +100 -0
  99. package/.versions/1.0.3/.pi/harnesses/coms/index.ts +1767 -0
  100. package/.versions/1.0.3/.pi/harnesses/coms/package.json +7 -0
  101. package/.versions/1.0.3/.pi/harnesses/coms/version.ts +42 -0
  102. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  103. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  104. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  105. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  106. package/.versions/1.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  107. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  108. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  109. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  110. package/.versions/1.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  111. package/.versions/1.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  112. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  113. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  114. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  115. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  116. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  117. package/.versions/1.0.3/.pi/harnesses/lib/fleet-detail-view.ts +168 -0
  118. package/.versions/1.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  119. package/.versions/1.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  120. package/.versions/1.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  121. package/.versions/1.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  122. package/.versions/1.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  123. package/.versions/1.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  124. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  125. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  126. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  127. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  128. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  129. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  130. package/.versions/1.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  131. package/.versions/1.0.3/.pi/harnesses/package-lock.json +2039 -0
  132. package/.versions/1.0.3/.pi/harnesses/package.json +10 -0
  133. package/.versions/1.0.3/.pi/prompts/af-build.md +24 -0
  134. package/.versions/1.0.3/.pi/prompts/af-code-simplify.md +22 -0
  135. package/.versions/1.0.3/.pi/prompts/af-plan.md +16 -0
  136. package/.versions/1.0.3/.pi/prompts/af-review.md +16 -0
  137. package/.versions/1.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  138. package/.versions/1.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  139. package/.versions/1.0.3/.pi/prompts/af-ship.md +17 -0
  140. package/.versions/1.0.3/.pi/prompts/af-spec.md +15 -0
  141. package/.versions/1.0.3/.pi/prompts/af-test.md +19 -0
  142. package/.versions/1.0.3/.pi/skills/bowser/SKILL.md +145 -0
  143. package/.versions/1.0.3/.version +1 -0
  144. package/.versions/1.0.3/agents/architect.md +25 -0
  145. package/.versions/1.0.3/agents/bowser.md +28 -0
  146. package/.versions/1.0.3/agents/builder.md +55 -0
  147. package/.versions/1.0.3/agents/code-reviewer.md +209 -0
  148. package/.versions/1.0.3/agents/deep-researcher.md +33 -0
  149. package/.versions/1.0.3/agents/documenter.md +19 -0
  150. package/.versions/1.0.3/agents/orchestrator.md +21 -0
  151. package/.versions/1.0.3/agents/plan-reviewer.md +84 -0
  152. package/.versions/1.0.3/agents/planner.md +71 -0
  153. package/.versions/1.0.3/agents/releaser.md +25 -0
  154. package/.versions/1.0.3/agents/researcher.md +29 -0
  155. package/.versions/1.0.3/agents/security-auditor.md +168 -0
  156. package/.versions/1.0.3/agents/test-engineer.md +154 -0
  157. package/.versions/1.0.3/agents/web-debugger.md +44 -0
  158. package/.versions/1.0.3/agents/web-performance-auditor.md +194 -0
  159. package/.versions/1.0.3/bin/catalog/harness-runtime-closure.json +38 -0
  160. package/.versions/1.0.3/codex/CONDUCTOR.md +148 -0
  161. package/.versions/1.0.3/docs/ARCHITECTURE.md +375 -0
  162. package/.versions/1.0.3/docs/agent-fleet-setup.md +468 -0
  163. package/.versions/1.0.3/docs/claude-code-coms-bridge.md +128 -0
  164. package/.versions/1.0.3/docs/codex-remote-conductor.md +170 -0
  165. package/.versions/1.0.3/docs/coms-hermes-bridge.md +189 -0
  166. package/.versions/1.0.3/docs/getting-started.md +98 -0
  167. package/.versions/1.0.3/docs/npm-install.md +292 -0
  168. package/.versions/1.0.3/docs/pi-extensions.md +441 -0
  169. package/.versions/1.0.3/docs/pi-setup.md +74 -0
  170. package/.versions/1.0.3/docs/skill-anatomy.md +150 -0
  171. package/.versions/1.0.3/hermes/README.md +347 -0
  172. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  173. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  174. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  175. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  176. package/.versions/1.0.3/hermes/gates/gate-o-capability.md +8 -0
  177. package/.versions/1.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  178. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  179. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  180. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  181. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  182. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  183. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  184. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  185. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  186. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  187. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  188. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  189. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  190. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  191. package/.versions/1.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  192. package/.versions/1.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  193. package/.versions/1.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  194. package/.versions/1.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  195. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  196. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  197. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  198. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  199. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  200. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  201. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  202. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  203. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  204. package/.versions/1.0.3/hermes/watchdog-tests/__init__.py +0 -0
  205. package/.versions/1.0.3/hooks/coms-stop-hook.mjs +84 -0
  206. package/.versions/1.0.3/install-manifest.json +2745 -0
  207. package/.versions/1.0.3/justfile +272 -0
  208. package/.versions/1.0.3/manifest-meta.json +882 -0
  209. package/.versions/1.0.3/references/accessibility-checklist.md +160 -0
  210. package/.versions/1.0.3/references/definition-of-done.md +67 -0
  211. package/.versions/1.0.3/references/fleet-coordination-patterns.md +151 -0
  212. package/.versions/1.0.3/references/observability-checklist.md +91 -0
  213. package/.versions/1.0.3/references/orchestration-patterns.md +370 -0
  214. package/.versions/1.0.3/references/performance-checklist.md +153 -0
  215. package/.versions/1.0.3/references/prompting-patterns.md +380 -0
  216. package/.versions/1.0.3/references/security-checklist.md +179 -0
  217. package/.versions/1.0.3/references/testing-patterns.md +236 -0
  218. package/.versions/1.0.3/scripts/codex-conductor.ts +41 -0
  219. package/.versions/1.0.3/scripts/codex-remote-control.ts +167 -0
  220. package/.versions/1.0.3/scripts/coms-claude-bridge.ts +411 -0
  221. package/.versions/1.0.3/scripts/coms-cli.ts +484 -0
  222. package/.versions/1.0.3/scripts/coms-hermes-bridge.ts +413 -0
  223. package/.versions/1.0.3/scripts/fleet.ts +185 -0
  224. package/.versions/1.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  225. package/.versions/1.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  226. package/.versions/1.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  227. package/.versions/1.0.3/scripts/install-hermes-plugin.sh +180 -0
  228. package/.versions/1.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  229. package/.versions/1.0.3/scripts/lib/codex-conductor.ts +88 -0
  230. package/.versions/1.0.3/scripts/lib/codex-remote-control.ts +480 -0
  231. package/.versions/1.0.3/scripts/lib/coms-envelope.ts +582 -0
  232. package/.versions/1.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  233. package/.versions/1.0.3/scripts/lib/fleet-command.ts +266 -0
  234. package/.versions/1.0.3/scripts/lib/herdr-layout.ts +281 -0
  235. package/.versions/1.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  236. package/.versions/1.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  237. package/.versions/1.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  238. package/.versions/1.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  239. package/.versions/1.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  240. package/.versions/1.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  241. package/.versions/1.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  242. package/.versions/1.0.3/scripts/lib/monitor-env.ts +146 -0
  243. package/.versions/1.0.3/scripts/lib/peer-launch.ts +318 -0
  244. package/.versions/1.0.3/scripts/lib/persona-banner.ts +62 -0
  245. package/.versions/1.0.3/scripts/lib/spawn-stagger.ts +101 -0
  246. package/.versions/1.0.3/scripts/lib/team-project.ts +213 -0
  247. package/.versions/1.0.3/scripts/lib/team-snapshot.ts +147 -0
  248. package/.versions/1.0.3/scripts/peer-banner.ts +40 -0
  249. package/.versions/1.0.3/scripts/peer-launch.ts +259 -0
  250. package/.versions/1.0.3/scripts/team-snapshot.ts +237 -0
  251. package/.versions/1.0.3/scripts/team-up.ts +406 -0
  252. package/.versions/1.0.3/skills/_internal/grilling.md +11 -0
  253. package/.versions/1.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  254. package/.versions/1.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  255. package/.versions/1.0.3/skills/compound-learning/SKILL.md +137 -0
  256. package/.versions/1.0.3/skills/context-engineering/SKILL.md +291 -0
  257. package/.versions/1.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  258. package/.versions/1.0.3/skills/designing-agents/SKILL.md +394 -0
  259. package/.versions/1.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  260. package/.versions/1.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  261. package/.versions/1.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  262. package/.versions/1.0.3/skills/idea-refine/SKILL.md +182 -0
  263. package/.versions/1.0.3/skills/idea-refine/examples.md +238 -0
  264. package/.versions/1.0.3/skills/idea-refine/frameworks.md +99 -0
  265. package/.versions/1.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  266. package/.versions/1.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  267. package/.versions/1.0.3/skills/incremental-implementation/SKILL.md +287 -0
  268. package/.versions/1.0.3/skills/interview-me/SKILL.md +226 -0
  269. package/.versions/1.0.3/skills/orchestration-verification/SKILL.md +181 -0
  270. package/.versions/1.0.3/skills/peer-coms/SKILL.md +90 -0
  271. package/.versions/1.0.3/skills/performance-optimization/SKILL.md +350 -0
  272. package/.versions/1.0.3/skills/planning-and-task-breakdown/SKILL.md +254 -0
  273. package/.versions/1.0.3/skills/security-and-hardening/SKILL.md +461 -0
  274. package/.versions/1.0.3/skills/spec-driven-development/SKILL.md +257 -0
  275. package/.versions/1.0.3/skills/using-agent-skills/SKILL.md +199 -0
  276. package/.versions/1.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  277. package/.versions/1.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  278. package/.versions/1.0.3/vendor/agent-skills-upstream/README.md +11 -0
  279. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  280. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  281. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  282. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  283. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  284. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  285. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  286. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  287. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  288. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  289. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  290. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  291. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  292. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  293. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  294. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  295. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  296. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  297. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  298. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  299. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  300. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  301. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  302. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  303. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  304. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  305. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  306. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  307. package/.versions/1.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  308. package/.versions/1.0.4/.pi/agents/model-profiles.yaml +27 -0
  309. package/.versions/1.0.4/.pi/agents/peers.yaml +142 -0
  310. package/.versions/1.0.4/.pi/agents/teams.yaml +41 -0
  311. package/.versions/1.0.4/.pi/damage-control-rules.yaml +297 -0
  312. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  313. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  314. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  315. package/.versions/1.0.4/.pi/extensions/btw/README.md +120 -0
  316. package/.versions/1.0.4/.pi/extensions/btw/index.ts +914 -0
  317. package/.versions/1.0.4/.pi/extensions/btw/package.json +6 -0
  318. package/.versions/1.0.4/.pi/extensions/btw/state.js +179 -0
  319. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  320. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  321. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  322. package/.versions/1.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  323. package/.versions/1.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  324. package/.versions/1.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  325. package/.versions/1.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  326. package/.versions/1.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  327. package/.versions/1.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  328. package/.versions/1.0.4/.pi/extensions/package-lock.json +1175 -0
  329. package/.versions/1.0.4/.pi/extensions/package.json +9 -0
  330. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  331. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  332. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  333. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  334. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  335. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  336. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  337. package/.versions/1.0.4/.pi/harnesses/agent-hub/README.md +1170 -0
  338. package/.versions/1.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  339. package/.versions/1.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  340. package/.versions/1.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  341. package/.versions/1.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  342. package/.versions/1.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  343. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  344. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  345. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  346. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  347. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  348. package/.versions/1.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  349. package/.versions/1.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  350. package/.versions/1.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  351. package/.versions/1.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  352. package/.versions/1.0.4/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  353. package/.versions/1.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  354. package/.versions/1.0.4/.pi/harnesses/agent-hub/footer.ts +36 -0
  355. package/.versions/1.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  356. package/.versions/1.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  357. package/.versions/1.0.4/.pi/harnesses/agent-hub/index.ts +10171 -0
  358. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  359. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  360. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  361. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  362. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  363. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  364. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  365. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  366. package/.versions/1.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  367. package/.versions/1.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  368. package/.versions/1.0.4/.pi/harnesses/agent-hub/posture.ts +158 -0
  369. package/.versions/1.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  370. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  371. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  372. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  373. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  374. package/.versions/1.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  375. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  376. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  377. package/.versions/1.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  378. package/.versions/1.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  379. package/.versions/1.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  380. package/.versions/1.0.4/.pi/harnesses/agent-hub/spawn.ts +388 -0
  381. package/.versions/1.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  382. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  383. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  384. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  385. package/.versions/1.0.4/.pi/harnesses/coms/README.md +100 -0
  386. package/.versions/1.0.4/.pi/harnesses/coms/index.ts +1767 -0
  387. package/.versions/1.0.4/.pi/harnesses/coms/package.json +7 -0
  388. package/.versions/1.0.4/.pi/harnesses/coms/version.ts +42 -0
  389. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  390. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  391. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  392. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  393. package/.versions/1.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  394. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  395. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  396. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  397. package/.versions/1.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  398. package/.versions/1.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  399. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  400. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  401. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  402. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  403. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  404. package/.versions/1.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  405. package/.versions/1.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  406. package/.versions/1.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  407. package/.versions/1.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  408. package/.versions/1.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  409. package/.versions/1.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  410. package/.versions/1.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  411. package/.versions/1.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  412. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  413. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  414. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  415. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  416. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  417. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  418. package/.versions/1.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  419. package/.versions/1.0.4/.pi/harnesses/package-lock.json +2039 -0
  420. package/.versions/1.0.4/.pi/harnesses/package.json +10 -0
  421. package/.versions/1.0.4/.pi/prompts/af-build.md +24 -0
  422. package/.versions/1.0.4/.pi/prompts/af-code-simplify.md +22 -0
  423. package/.versions/1.0.4/.pi/prompts/af-plan.md +17 -0
  424. package/.versions/1.0.4/.pi/prompts/af-review.md +16 -0
  425. package/.versions/1.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  426. package/.versions/1.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  427. package/.versions/1.0.4/.pi/prompts/af-ship.md +17 -0
  428. package/.versions/1.0.4/.pi/prompts/af-spec.md +15 -0
  429. package/.versions/1.0.4/.pi/prompts/af-test.md +19 -0
  430. package/.versions/1.0.4/.pi/skills/bowser/SKILL.md +145 -0
  431. package/.versions/1.0.4/.version +1 -0
  432. package/.versions/1.0.4/agents/architect.md +25 -0
  433. package/.versions/1.0.4/agents/bowser.md +28 -0
  434. package/.versions/1.0.4/agents/builder.md +56 -0
  435. package/.versions/1.0.4/agents/code-reviewer.md +209 -0
  436. package/.versions/1.0.4/agents/deep-researcher.md +33 -0
  437. package/.versions/1.0.4/agents/documenter.md +19 -0
  438. package/.versions/1.0.4/agents/orchestrator.md +21 -0
  439. package/.versions/1.0.4/agents/plan-reviewer.md +84 -0
  440. package/.versions/1.0.4/agents/planner.md +71 -0
  441. package/.versions/1.0.4/agents/releaser.md +25 -0
  442. package/.versions/1.0.4/agents/researcher.md +29 -0
  443. package/.versions/1.0.4/agents/security-auditor.md +168 -0
  444. package/.versions/1.0.4/agents/test-engineer.md +154 -0
  445. package/.versions/1.0.4/agents/web-debugger.md +44 -0
  446. package/.versions/1.0.4/agents/web-performance-auditor.md +194 -0
  447. package/.versions/1.0.4/bin/catalog/harness-runtime-closure.json +38 -0
  448. package/.versions/1.0.4/codex/CONDUCTOR.md +148 -0
  449. package/.versions/1.0.4/docs/ARCHITECTURE.md +375 -0
  450. package/.versions/1.0.4/docs/agent-fleet-setup.md +468 -0
  451. package/.versions/1.0.4/docs/claude-code-coms-bridge.md +128 -0
  452. package/.versions/1.0.4/docs/codex-remote-conductor.md +170 -0
  453. package/.versions/1.0.4/docs/coms-hermes-bridge.md +189 -0
  454. package/.versions/1.0.4/docs/getting-started.md +98 -0
  455. package/.versions/1.0.4/docs/npm-install.md +292 -0
  456. package/.versions/1.0.4/docs/pi-extensions.md +441 -0
  457. package/.versions/1.0.4/docs/pi-setup.md +74 -0
  458. package/.versions/1.0.4/docs/skill-anatomy.md +150 -0
  459. package/.versions/1.0.4/hermes/README.md +347 -0
  460. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  461. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  462. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  463. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  464. package/.versions/1.0.4/hermes/gates/gate-o-capability.md +8 -0
  465. package/.versions/1.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  466. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  467. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  468. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  469. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  470. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  471. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  472. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  473. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  474. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  475. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  476. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  477. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  478. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  479. package/.versions/1.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  480. package/.versions/1.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  481. package/.versions/1.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  482. package/.versions/1.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  483. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  484. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  485. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  486. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  487. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  488. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  489. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  490. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  491. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  492. package/.versions/1.0.4/hermes/watchdog-tests/__init__.py +0 -0
  493. package/.versions/1.0.4/hooks/coms-stop-hook.mjs +84 -0
  494. package/.versions/1.0.4/install-manifest.json +2745 -0
  495. package/.versions/1.0.4/justfile +272 -0
  496. package/.versions/1.0.4/manifest-meta.json +882 -0
  497. package/.versions/1.0.4/references/accessibility-checklist.md +160 -0
  498. package/.versions/1.0.4/references/definition-of-done.md +67 -0
  499. package/.versions/1.0.4/references/fleet-coordination-patterns.md +151 -0
  500. package/.versions/1.0.4/references/observability-checklist.md +91 -0
  501. package/.versions/1.0.4/references/orchestration-patterns.md +370 -0
  502. package/.versions/1.0.4/references/performance-checklist.md +153 -0
  503. package/.versions/1.0.4/references/prompting-patterns.md +380 -0
  504. package/.versions/1.0.4/references/security-checklist.md +179 -0
  505. package/.versions/1.0.4/references/testing-patterns.md +236 -0
  506. package/.versions/1.0.4/scripts/codex-conductor.ts +41 -0
  507. package/.versions/1.0.4/scripts/codex-remote-control.ts +167 -0
  508. package/.versions/1.0.4/scripts/coms-claude-bridge.ts +411 -0
  509. package/.versions/1.0.4/scripts/coms-cli.ts +484 -0
  510. package/.versions/1.0.4/scripts/coms-hermes-bridge.ts +413 -0
  511. package/.versions/1.0.4/scripts/fleet.ts +185 -0
  512. package/.versions/1.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  513. package/.versions/1.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  514. package/.versions/1.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  515. package/.versions/1.0.4/scripts/install-hermes-plugin.sh +180 -0
  516. package/.versions/1.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  517. package/.versions/1.0.4/scripts/lib/codex-conductor.ts +88 -0
  518. package/.versions/1.0.4/scripts/lib/codex-remote-control.ts +480 -0
  519. package/.versions/1.0.4/scripts/lib/coms-envelope.ts +582 -0
  520. package/.versions/1.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  521. package/.versions/1.0.4/scripts/lib/fleet-command.ts +266 -0
  522. package/.versions/1.0.4/scripts/lib/herdr-layout.ts +281 -0
  523. package/.versions/1.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  524. package/.versions/1.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  525. package/.versions/1.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  526. package/.versions/1.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  527. package/.versions/1.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  528. package/.versions/1.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  529. package/.versions/1.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  530. package/.versions/1.0.4/scripts/lib/monitor-env.ts +146 -0
  531. package/.versions/1.0.4/scripts/lib/peer-launch.ts +318 -0
  532. package/.versions/1.0.4/scripts/lib/persona-banner.ts +62 -0
  533. package/.versions/1.0.4/scripts/lib/spawn-stagger.ts +101 -0
  534. package/.versions/1.0.4/scripts/lib/team-project.ts +213 -0
  535. package/.versions/1.0.4/scripts/lib/team-snapshot.ts +147 -0
  536. package/.versions/1.0.4/scripts/peer-banner.ts +40 -0
  537. package/.versions/1.0.4/scripts/peer-launch.ts +259 -0
  538. package/.versions/1.0.4/scripts/team-snapshot.ts +237 -0
  539. package/.versions/1.0.4/scripts/team-up.ts +406 -0
  540. package/.versions/1.0.4/skills/_internal/grilling.md +59 -0
  541. package/.versions/1.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  542. package/.versions/1.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  543. package/.versions/1.0.4/skills/compound-learning/SKILL.md +137 -0
  544. package/.versions/1.0.4/skills/context-engineering/SKILL.md +291 -0
  545. package/.versions/1.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  546. package/.versions/1.0.4/skills/designing-agents/SKILL.md +394 -0
  547. package/.versions/1.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  548. package/.versions/1.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  549. package/.versions/1.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  550. package/.versions/1.0.4/skills/idea-refine/SKILL.md +182 -0
  551. package/.versions/1.0.4/skills/idea-refine/examples.md +238 -0
  552. package/.versions/1.0.4/skills/idea-refine/frameworks.md +99 -0
  553. package/.versions/1.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  554. package/.versions/1.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  555. package/.versions/1.0.4/skills/incremental-implementation/SKILL.md +298 -0
  556. package/.versions/1.0.4/skills/interview-me/SKILL.md +226 -0
  557. package/.versions/1.0.4/skills/orchestration-verification/SKILL.md +181 -0
  558. package/.versions/1.0.4/skills/peer-coms/SKILL.md +90 -0
  559. package/.versions/1.0.4/skills/performance-optimization/SKILL.md +350 -0
  560. package/.versions/1.0.4/skills/planning-and-task-breakdown/SKILL.md +263 -0
  561. package/.versions/1.0.4/skills/security-and-hardening/SKILL.md +461 -0
  562. package/.versions/1.0.4/skills/spec-driven-development/SKILL.md +256 -0
  563. package/.versions/1.0.4/skills/using-agent-skills/SKILL.md +197 -0
  564. package/.versions/1.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  565. package/.versions/1.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  566. package/.versions/1.0.4/vendor/agent-skills-upstream/README.md +11 -0
  567. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  568. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  569. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  570. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  571. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  572. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  573. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  574. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  575. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  576. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  577. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  578. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  579. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  580. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  581. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  582. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  583. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  584. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  585. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  586. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  587. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  588. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  589. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  590. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  591. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  592. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  593. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  594. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  595. package/CHANGELOG.md +13 -0
  596. package/README.md +5 -4
  597. package/agents/architect.md +1 -0
  598. package/agents/bowser.md +1 -0
  599. package/agents/builder.md +2 -0
  600. package/agents/code-reviewer.md +1 -0
  601. package/agents/deep-researcher.md +1 -0
  602. package/agents/documenter.md +1 -0
  603. package/agents/orchestrator.md +1 -0
  604. package/agents/plan-reviewer.md +1 -0
  605. package/agents/planner.md +2 -1
  606. package/agents/releaser.md +1 -0
  607. package/agents/researcher.md +1 -0
  608. package/agents/security-auditor.md +1 -0
  609. package/agents/test-engineer.md +1 -0
  610. package/agents/web-debugger.md +1 -0
  611. package/agents/web-performance-auditor.md +1 -0
  612. package/bin/lib/validate-overrides.js +1 -1
  613. package/docs/ARCHITECTURE.md +25 -19
  614. package/docs/agent-fleet-setup.md +8 -8
  615. package/docs/pi-extensions.md +4 -2
  616. package/install-manifest.json +3 -3
  617. package/package.json +2 -2
  618. package/scripts/fleet.ts +1 -1
  619. package/skills/_internal/grilling.md +53 -5
  620. package/skills/idea-refine/SKILL.md +2 -2
  621. package/skills/incremental-implementation/SKILL.md +12 -1
  622. package/skills/planning-and-task-breakdown/SKILL.md +14 -5
  623. package/skills/spec-driven-development/SKILL.md +10 -11
  624. package/skills/using-agent-skills/SKILL.md +13 -15
@@ -0,0 +1,413 @@
1
+ // scripts/coms-hermes-bridge.ts
2
+ //
3
+ // Hermes/Telegram user-remote bridge daemon. Registers a coms peer, turns
4
+ // prompt envelopes into `hermes send` messages, watches the private answer-file
5
+ // wire, and replies to the sender with the mapped answer/error envelope.
6
+
7
+ import { spawn } from "node:child_process";
8
+ import * as fs from "node:fs";
9
+ import * as path from "node:path";
10
+ import { fileURLToPath } from "node:url";
11
+
12
+ import {
13
+ bindEndpoint,
14
+ ensureComsDirs,
15
+ isCancelEnvelope,
16
+ isPromptEnvelope,
17
+ makeConnHandler,
18
+ makeEndpoint,
19
+ makeResponseEnvelope,
20
+ nowIso,
21
+ removeRegistryEntry,
22
+ resolveUniqueName,
23
+ sendEnvelope,
24
+ ulid,
25
+ writeAck,
26
+ writeNack,
27
+ writeRegistryAtomic,
28
+ type AgentCard,
29
+ type PromptEnvelope,
30
+ type RegistryEntry,
31
+ type SenderIdentity,
32
+ } from "./lib/coms-envelope.ts";
33
+ import {
34
+ formatTelegramQuestion,
35
+ isValidQid,
36
+ logPath as defaultLogPath,
37
+ makeLogRecord,
38
+ mapAnswerToAskResponse,
39
+ qidFromPromptEnvelope,
40
+ questionsDir as defaultQuestionsDir,
41
+ renderLogRecord,
42
+ timeoutMsFromEnv,
43
+ timeoutOutcome,
44
+ validateAnswerFile,
45
+ type BridgeEventName,
46
+ type QuestionOption,
47
+ type QuestionState,
48
+ } from "./lib/hermes-bridge-core.ts";
49
+
50
+ const KEEPALIVE_MS = 30_000;
51
+ const DEFAULT_POLL_MS = 1_000;
52
+ const COLOR = "#38BDF8";
53
+ const DEFAULT_NAME = "user-remote";
54
+ const DEFAULT_PURPOSE = "Remote human via Hermes/Telegram";
55
+ const HERMES_PROFILE_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
56
+
57
+ interface PendingQuestion {
58
+ env: PromptEnvelope;
59
+ state: QuestionState;
60
+ options: QuestionOption[];
61
+ timer: NodeJS.Timeout;
62
+ }
63
+
64
+ interface ParsedPrompt {
65
+ question: string;
66
+ context?: string;
67
+ options: QuestionOption[];
68
+ }
69
+
70
+ function flagValue(argv: string[], flag: string): string | null {
71
+ const positions = argv.flatMap((arg, index) => arg === flag ? [index] : []);
72
+ if (positions.length > 1) die(`${flag} may only be specified once`);
73
+ const i = positions[0] ?? -1;
74
+ return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
75
+ }
76
+
77
+ function die(msg: string): never {
78
+ console.error(`coms-hermes-bridge: ${msg}`);
79
+ process.exit(1);
80
+ }
81
+
82
+ function parsePrompt(env: PromptEnvelope): ParsedPrompt {
83
+ try {
84
+ const parsed = JSON.parse(env.prompt) as { question?: unknown; context?: unknown; options?: unknown };
85
+ if (parsed && typeof parsed === "object" && typeof parsed.question === "string") {
86
+ const rawOptions = Array.isArray(parsed.options) ? parsed.options : [];
87
+ const options = rawOptions
88
+ .map((option): QuestionOption | null => {
89
+ if (typeof option === "string") return { title: option };
90
+ if (option && typeof option === "object" && typeof (option as { title?: unknown }).title === "string") {
91
+ const desc = (option as { description?: unknown }).description;
92
+ return typeof desc === "string"
93
+ ? { title: (option as { title: string }).title, description: desc }
94
+ : { title: (option as { title: string }).title };
95
+ }
96
+ return null;
97
+ })
98
+ .filter((option): option is QuestionOption => option !== null);
99
+ const context = typeof parsed.context === "string" && parsed.context.trim() ? parsed.context : undefined;
100
+ return { question: parsed.question, context, options };
101
+ }
102
+ } catch {
103
+ // Plain coms-cli prompts are expected; fall through.
104
+ }
105
+ return {
106
+ question: env.prompt,
107
+ context: `From ${env.sender_name} @ ${env.sender_cwd}`,
108
+ options: [],
109
+ };
110
+ }
111
+
112
+ function appendLogFile(logFile: string, qid: string, event: BridgeEventName, detail?: unknown): void {
113
+ fs.mkdirSync(path.dirname(logFile), { recursive: true });
114
+ fs.appendFileSync(logFile, renderLogRecord(makeLogRecord(qid, event, detail)));
115
+ }
116
+
117
+ function appendAnswerRejectLog(logFile: string, qid: string, detail: unknown): void {
118
+ fs.mkdirSync(path.dirname(logFile), { recursive: true });
119
+ fs.appendFileSync(logFile, JSON.stringify({ at: nowIso(), qid, event: "answer_rejected", detail }) + "\n");
120
+ }
121
+
122
+ function hermesSend(to: string, text: string, profile: string | null): Promise<void> {
123
+ return new Promise((resolve, reject) => {
124
+ const args = [...(profile ? ["--profile", profile] : []), "send", "--to", to, text];
125
+ const child = spawn("hermes", args, { stdio: ["ignore", "pipe", "pipe"] });
126
+ let stderr = "";
127
+ let stdout = "";
128
+ child.stdout?.on("data", (chunk) => { stdout += chunk.toString("utf-8"); });
129
+ child.stderr?.on("data", (chunk) => { stderr += chunk.toString("utf-8"); });
130
+ child.once("error", (err) => reject(err));
131
+ child.once("close", (code) => {
132
+ if (code === 0) {
133
+ resolve();
134
+ return;
135
+ }
136
+ const detail = (stderr || stdout).trim();
137
+ reject(new Error(`hermes send failed${code === null ? "" : ` (${code})`}${detail ? `: ${detail}` : ""}`));
138
+ });
139
+ });
140
+ }
141
+
142
+ async function main(): Promise<void> {
143
+ const argv = process.argv.slice(2);
144
+ const requestedName = flagValue(argv, "--name") ?? DEFAULT_NAME;
145
+ const project = flagValue(argv, "--project") ?? "default";
146
+ const to = flagValue(argv, "--to") ?? "telegram";
147
+ const hermesProfile = flagValue(argv, "--hermes-profile");
148
+ const timeoutMs = Number(flagValue(argv, "--timeout") ?? timeoutMsFromEnv());
149
+ const pollMs = Number(flagValue(argv, "--poll-ms") ?? DEFAULT_POLL_MS);
150
+ const qDir = flagValue(argv, "--questions-dir") ?? defaultQuestionsDir();
151
+ const logFile = path.join(path.dirname(qDir), path.basename(defaultLogPath()));
152
+
153
+ if (hermesProfile && (!HERMES_PROFILE_RE.test(hermesProfile) || hermesProfile === "." || hermesProfile.includes(".."))) die("--hermes-profile must be a safe profile name");
154
+ if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) die("--timeout must be a positive number");
155
+ if (!Number.isFinite(pollMs) || pollMs <= 0) die("--poll-ms must be a positive number");
156
+
157
+ ensureComsDirs(project);
158
+ fs.mkdirSync(qDir, { recursive: true });
159
+ fs.mkdirSync(path.dirname(logFile), { recursive: true });
160
+
161
+ const sessionId = ulid();
162
+ const uniqueName = resolveUniqueName(project, requestedName);
163
+ const id: SenderIdentity = {
164
+ session_id: sessionId,
165
+ name: uniqueName,
166
+ endpoint: makeEndpoint(sessionId),
167
+ cwd: process.cwd(),
168
+ };
169
+ const pending = new Map<string, PendingQuestion>();
170
+ const closed = new Map<string, QuestionState>();
171
+ // Answer files the liaison may still be mid-write: an invalid_json file is
172
+ // kept for a short grace window (first-seen timestamps below) instead of
173
+ // being eaten while the write is still in flight.
174
+ const invalidJsonSeen = new Map<string, number>();
175
+ const invalidJsonGraceMs = Math.max(2 * pollMs, 1_000);
176
+ const CLOSED_CAP = 1_000;
177
+
178
+ function markClosed(qid: string, state: QuestionState): void {
179
+ closed.set(qid, state);
180
+ if (closed.size > CLOSED_CAP) {
181
+ const oldest = closed.keys().next().value;
182
+ if (oldest !== undefined) closed.delete(oldest);
183
+ }
184
+ }
185
+
186
+ function queueDepth(): number {
187
+ return pending.size;
188
+ }
189
+
190
+ function registryEntry(): RegistryEntry {
191
+ return {
192
+ session_id: sessionId,
193
+ name: uniqueName,
194
+ purpose: DEFAULT_PURPOSE,
195
+ model: "hermes-bridge",
196
+ color: COLOR,
197
+ pid: process.pid,
198
+ endpoint: id.endpoint,
199
+ cwd: id.cwd,
200
+ started_at: nowIso(),
201
+ explicit: false,
202
+ version: 1,
203
+ context_used_pct: 0,
204
+ queue_depth: queueDepth(),
205
+ heartbeat_at: nowIso(),
206
+ };
207
+ }
208
+
209
+ async function sendResponse(env: PromptEnvelope, response: unknown, error: string | null = null): Promise<void> {
210
+ await sendEnvelope(env.sender_endpoint, makeResponseEnvelope(id, env.msg_id, response, error));
211
+ }
212
+
213
+ async function handleTimeout(qid: string): Promise<void> {
214
+ const item = pending.get(qid);
215
+ if (!item) return;
216
+ pending.delete(qid);
217
+ markClosed(qid, "timeout");
218
+ appendLogFile(logFile, qid, "timeout", { timeout_ms: timeoutMs });
219
+ const outcome = timeoutOutcome(qid, timeoutMs);
220
+ await hermesSend(to, outcome.telegramNote, hermesProfile).catch((err) => {
221
+ appendLogFile(logFile, qid, "delivery_error", { phase: "timeout_note", error: err instanceof Error ? err.message : String(err) });
222
+ });
223
+ await sendResponse(item.env, outcome.response, outcome.error).catch((err) => {
224
+ console.error(`coms-hermes-bridge: could not deliver timeout for ${qid}: ${err instanceof Error ? err.message : String(err)}`);
225
+ });
226
+ }
227
+
228
+ async function handlePrompt(env: PromptEnvelope): Promise<void> {
229
+ let qid: string;
230
+ try {
231
+ qid = qidFromPromptEnvelope(env);
232
+ } catch (err) {
233
+ await sendResponse(env, null, err instanceof Error ? err.message : String(err)).catch(() => {});
234
+ return;
235
+ }
236
+
237
+ const parsed = parsePrompt(env);
238
+ const duplicate = pending.get(qid);
239
+ if (duplicate) clearTimeout(duplicate.timer);
240
+ appendLogFile(logFile, qid, "question_received", { from: env.sender_name });
241
+ const timer = setTimeout(() => { void handleTimeout(qid); }, timeoutMs);
242
+ timer.unref?.();
243
+ pending.set(qid, { env, state: "pending", options: parsed.options, timer });
244
+
245
+ try {
246
+ await hermesSend(to, formatTelegramQuestion({
247
+ qid,
248
+ project,
249
+ question: parsed.question,
250
+ context: parsed.context,
251
+ options: parsed.options,
252
+ }), hermesProfile);
253
+ const item = pending.get(qid);
254
+ if (!item) return;
255
+ item.state = "delivered";
256
+ appendLogFile(logFile, qid, "delivered", { to });
257
+ } catch (err) {
258
+ const message = err instanceof Error ? err.message : String(err);
259
+ const item = pending.get(qid);
260
+ if (item) {
261
+ clearTimeout(item.timer);
262
+ pending.delete(qid);
263
+ }
264
+ appendLogFile(logFile, qid, "delivery_error", { error: message });
265
+ await sendResponse(env, null, message).catch((sendErr) => {
266
+ console.error(`coms-hermes-bridge: could not deliver error for ${qid}: ${sendErr instanceof Error ? sendErr.message : String(sendErr)}`);
267
+ });
268
+ }
269
+ }
270
+
271
+ async function handleCancel(refMsgId: string): Promise<void> {
272
+ if (!isValidQid(refMsgId)) return;
273
+ const item = pending.get(refMsgId);
274
+ if (!item) return;
275
+ clearTimeout(item.timer);
276
+ pending.delete(refMsgId);
277
+ markClosed(refMsgId, "cancelled");
278
+ appendLogFile(logFile, refMsgId, "cancelled", { reason: "cancel envelope" });
279
+ await hermesSend(to, `✖ [HUB-Q:${refMsgId}] The question was cancelled — it was answered from the console.`, hermesProfile).catch((err) => {
280
+ appendLogFile(logFile, refMsgId, "delivery_error", { phase: "cancel_note", error: err instanceof Error ? err.message : String(err) });
281
+ });
282
+ }
283
+
284
+ async function handleLateAnswer(qid: string): Promise<void> {
285
+ appendLogFile(logFile, qid, "late_answer", { state: closed.get(qid) ?? "unknown" });
286
+ await hermesSend(to, `ℹ [HUB-Q:${qid}] This question is already closed; the late answer was ignored.`, hermesProfile).catch((err) => {
287
+ appendLogFile(logFile, qid, "delivery_error", { phase: "late_note", error: err instanceof Error ? err.message : String(err) });
288
+ });
289
+ }
290
+
291
+ async function consumeAnswerFile(file: string): Promise<void> {
292
+ const full = path.join(qDir, file);
293
+ let raw: string;
294
+ try {
295
+ raw = fs.readFileSync(full, "utf-8");
296
+ } catch {
297
+ return;
298
+ }
299
+
300
+ const qidFromName = file.endsWith(".answer.json") ? file.slice(0, -".answer.json".length) : file;
301
+ if (isValidQid(qidFromName) && closed.has(qidFromName)) {
302
+ invalidJsonSeen.delete(file);
303
+ try { fs.unlinkSync(full); } catch { /* ignore */ }
304
+ await handleLateAnswer(qidFromName);
305
+ return;
306
+ }
307
+
308
+ const validation = validateAnswerFile(raw, full, pending.keys());
309
+ if (!validation.ok) {
310
+ if (validation.reason === "invalid_json") {
311
+ // Possibly a partial write from the liaison; retry until the grace expires.
312
+ const firstSeen = invalidJsonSeen.get(file);
313
+ if (firstSeen === undefined) {
314
+ invalidJsonSeen.set(file, Date.now());
315
+ return;
316
+ }
317
+ if (Date.now() - firstSeen < invalidJsonGraceMs) return;
318
+ }
319
+ invalidJsonSeen.delete(file);
320
+ const logQid = validation.qid && isValidQid(validation.qid) ? validation.qid : (isValidQid(qidFromName) ? qidFromName : "00000000000000000000000000");
321
+ // Remove the rejected file before publishing the event. Consumers use the
322
+ // log as the completion signal and may immediately write a corrected file
323
+ // at the same path; logging first lets this scan delete that replacement.
324
+ try { fs.unlinkSync(full); } catch { /* ignore */ }
325
+ appendAnswerRejectLog(logFile, logQid, { reason: validation.reason, file });
326
+ return;
327
+ }
328
+
329
+ invalidJsonSeen.delete(file);
330
+ const item = pending.get(validation.qid);
331
+ if (!item) return;
332
+ clearTimeout(item.timer);
333
+ pending.delete(validation.qid);
334
+ markClosed(validation.qid, "answered");
335
+ try { fs.unlinkSync(full); } catch { /* ignore */ }
336
+ appendLogFile(logFile, validation.qid, "answered", { answered_by: validation.answer.answered_by });
337
+ const response = mapAnswerToAskResponse(validation.answer.answer, item.options);
338
+ await sendResponse(item.env, response).catch((err) => {
339
+ console.error(`coms-hermes-bridge: could not deliver answer for ${validation.qid}: ${err instanceof Error ? err.message : String(err)}`);
340
+ });
341
+ }
342
+
343
+ async function scanAnswers(): Promise<void> {
344
+ let files: string[];
345
+ try {
346
+ files = fs.readdirSync(qDir);
347
+ } catch {
348
+ return;
349
+ }
350
+ for (const file of files) {
351
+ await consumeAnswerFile(file);
352
+ }
353
+ }
354
+
355
+ const server = await bindEndpoint(
356
+ id.endpoint,
357
+ makeConnHandler((env, socket) => {
358
+ if (isPromptEnvelope(env)) {
359
+ writeAck(socket, env.msg_id);
360
+ void handlePrompt(env);
361
+ } else if (isCancelEnvelope(env)) {
362
+ writeAck(socket, env.msg_id);
363
+ void handleCancel(env.ref_msg_id);
364
+ } else if ((env as { type?: string }).type === "ping") {
365
+ const card: AgentCard = {
366
+ name: uniqueName,
367
+ purpose: DEFAULT_PURPOSE,
368
+ model: "hermes-bridge",
369
+ color: COLOR,
370
+ context_used_pct: 0,
371
+ queue_depth: queueDepth(),
372
+ };
373
+ try {
374
+ socket.write(JSON.stringify({ type: "pong", msg_id: (env as { msg_id?: string }).msg_id ?? "", agent_card: card }) + "\n");
375
+ } catch { /* ignore */ }
376
+ try { socket.end(); } catch { /* ignore */ }
377
+ } else {
378
+ writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "bridge accepts prompts, cancels, and pings");
379
+ }
380
+ }),
381
+ );
382
+
383
+ const keepalive = setInterval(() => {
384
+ try { writeRegistryAtomic(registryEntry(), project); } catch { /* best-effort */ }
385
+ }, KEEPALIVE_MS);
386
+ keepalive.unref?.();
387
+ const watcher = setInterval(() => { void scanAnswers(); }, pollMs);
388
+ watcher.unref?.();
389
+
390
+ let shuttingDown = false;
391
+ function shutdown(): void {
392
+ if (shuttingDown) return;
393
+ shuttingDown = true;
394
+ clearInterval(keepalive);
395
+ clearInterval(watcher);
396
+ for (const item of pending.values()) clearTimeout(item.timer);
397
+ try { server.close(); } catch { /* ignore */ }
398
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
399
+ removeRegistryEntry(project, uniqueName);
400
+ process.exit(0);
401
+ }
402
+ process.on("SIGTERM", shutdown);
403
+ process.on("SIGINT", shutdown);
404
+
405
+ // Publish readiness only after shutdown handlers are installed. A caller may
406
+ // terminate the bridge as soon as its registry entry appears; publishing
407
+ // earlier can bypass cleanup and leave both the entry and socket behind.
408
+ writeRegistryAtomic(registryEntry(), project);
409
+ console.error(`coms-hermes-bridge: ${uniqueName}@${project} listening (${to})`);
410
+ }
411
+
412
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
413
+ if (isEntry) void main();
@@ -0,0 +1,185 @@
1
+ // Unified `just fleet` command dispatcher. Parsing is kept pure and tested in
2
+ // scripts/lib/fleet-command.test.ts; this entrypoint only hands the resolved
3
+ // recipe back to Just so existing compatibility recipes remain one source of truth.
4
+
5
+ import { spawnSync } from "node:child_process";
6
+ import { parseFleetCommand } from "./lib/fleet-command.ts";
7
+ import { resolveMonitorEnv } from "./lib/monitor-env.ts";
8
+
9
+ const HELP = `Agent Fleet — one guarded Hub runtime, two postures, independent topology
10
+
11
+ SET UP A NEW REPOSITORY
12
+ npx @chankov/agent-fleet@latest setup
13
+ Run this from the target repository. A repository without Agent Fleet has
14
+ no justfile yet — setup writes it — so the first install cannot use just.
15
+ Select Default/Full and optional features, inspect the exact plan, then
16
+ confirm once to apply it. Follow with just fleet deps, then just fleet doctor.
17
+ Source checkout development: node bin/cli.js setup.
18
+ Once installed, just fleet setup wraps the same command for this repository.
19
+
20
+ QUICK START
21
+ just fleet # Hub/operator, empty native roster
22
+ just fleet --agents frontend # Hub/orchestrator with native specialists
23
+ just fleet --herdr --project af
24
+ # Hub/operator in a one-pane Herdr workspace
25
+ just fleet --agents frontend --peers frontend --project af
26
+ # matching native roster + standing peers
27
+
28
+ FLEET CORE — loaded in every Pi mode
29
+ Damage Control Continue · local/remote ask_user · Compact & Continue
30
+ BTW side sessions · update checker (voice is opt-in with --voice)
31
+
32
+ UNIFIED HUB
33
+ just fleet [--posture operator|orchestrator] [--agents <roster>]
34
+ [--herdr] [--peers <preset>] [--no-coms] [PI_ARGS...]
35
+ Bare Fleet always loads Agent Hub in operator posture. Operator keeps
36
+ read/bash/edit/write plus orchestration; the initial native roster is empty.
37
+ --agents selects .pi/agents/teams.yaml and implies orchestrator unless an
38
+ explicit --posture operator is supplied. --no-coms leaves direct/native work
39
+ available while coms, peer dispatch, and handoff refuse actionably.
40
+
41
+ POSTURE AND ROSTER
42
+ /af-posture # report posture and capability state
43
+ /af-agents-add code-reviewer # add a native Pi specialist at runtime
44
+ /af-posture orchestrator # remove direct coding tools; keep orchestration
45
+ /af-posture operator # restore the approved direct tool surface
46
+
47
+ Posture is independent from the native roster and peer topology. Budgets follow task tier.
48
+ All Hub slash commands, including /af-handoff, stay registered in both postures;
49
+ actions whose coms/Herdr capability is unavailable return remediation guidance.
50
+
51
+ Explicit dispatch backend examples (inside the Hub):
52
+ dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "native" })
53
+ dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "coms" })
54
+ backend "auto" follows .pi/agents/dispatch-policy.yaml; native always starts
55
+ the local Pi specialist, while coms requires a live same-name peer and never
56
+ falls back to native.
57
+
58
+ HERDR TOPOLOGY — requires a running Herdr server (https://herdr.dev)
59
+ just fleet --herdr [--project <name>]
60
+ Hub-only workspace using the empty base peer preset.
61
+
62
+ just fleet --peers <preset> [--agents <roster>] [--project <name>]
63
+ Add standing Pi/Claude peers from .pi/agents/peers.yaml. Hub and every peer
64
+ receive the same project. Add --dry-run to print the redacted layout only.
65
+
66
+ Dynamic Claude reviewer from a Hub already running inside Herdr:
67
+ herdr_spawn_peer({ name: "code-reviewer" })
68
+ coms_send({ target: "code-reviewer", prompt: "Review the current diff" })
69
+ coms_await({ msg_id: "<returned-id>" })
70
+ /af-handoff code-reviewer
71
+ The declared runner may be Claude Code. Spawn requires Herdr; messaging and
72
+ handoff require coms readiness and a target visible in this Hub's project pool.
73
+ Every spawned peer gets a sibling pane and is locked to the Hub's project.
74
+
75
+ ONE STANDALONE PEER
76
+ just fleet peer <name> [--runner pi|claude-code] [--persona <p>|--no-persona]
77
+ [--model <m>] [--project <p>] [--extensions a,b]
78
+ [--browser] [--all-extensions] [--direction right|down]
79
+ [--here] [--dry-run] [-- PI_ARGS...]
80
+ A single addressable peer. Inside Herdr it splits the current pane; outside
81
+ it creates a one-pane workspace; --here uses this terminal. A peers.yaml
82
+ declaration controls runner/model/extensions/env_file. A matching persona
83
+ starts guarded Pi; --runner claude-code starts Claude Code plus its bridge.
84
+
85
+ TEAM LIFECYCLE
86
+ just fleet snapshot <preset> [--project <name>]
87
+ just fleet down <preset> [--project <name>]
88
+ just fleet resume <preset> [--project <name>]
89
+ Save session refs, close cleanly, and rebuild available Pi/Claude sessions.
90
+
91
+ HERMES CONDUCTOR
92
+ just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
93
+ Start Hermes with a peer team, or preview the layout with --dry-run.
94
+
95
+ CODEX REMOTE-CONTROL CONDUCTOR
96
+ just fleet conductor codex <setup|reconfigure> [preset] [ARGS...]
97
+ just fleet conductor codex <pair|start|status|stop|recover|uninstall>
98
+ just fleet conductor codex [preset] [--dry-run] [TEAM_ARGS...]
99
+
100
+ CAPABILITY FLAGS
101
+ --browser Add Chrome DevTools MCP tools to the Hub/main Pi process.
102
+ --voice Load pi-voice-stt after selecting the voice setup feature.
103
+ --all-extensions Also auto-load project/global extensions outside Fleet Core.
104
+ --no-coms Disable only the Hub's embedded coms layer.
105
+
106
+ COMPATIBILITY ALIASES — accepted with migration warnings
107
+ just fleet hub [--solo] ... -> just fleet [--no-coms] ...
108
+ just fleet team <preset> ... -> just fleet --agents <roster> --peers <preset> ...
109
+ just fleet team <preset> --no-hub -> legacy peers-only topology
110
+ Legacy peer-only presets full/web/docs retain the default native roster.
111
+
112
+ LIFECYCLE
113
+ just fleet setup [--dry-run] [--preset default|full --features none --yes]
114
+ Reconcile desired state with the newest published package. Preset and
115
+ features are remembered in .ai/agent-fleet.json, so a plain setup needs no
116
+ flags; flags apply to one run unless --save-desired persists them.
117
+ just fleet deps
118
+ Install only .pi/extensions and .pi/harnesses Node dependencies.
119
+ Does not launch Pi, configure STT, install ffmpeg/Herdr, or pair Codex.
120
+ just fleet doctor [--fix]
121
+ just fleet uninstall --all --yes
122
+ Reinstall after self-uninstall with npx @chankov/agent-fleet@latest setup.
123
+
124
+ UPDATE NOTE
125
+ Update with: just fleet setup --dry-run, then just fleet setup, then deps+doctor.
126
+ setup reconciles TOWARD the package: an artifact you edited in place is
127
+ refreshed and your edit overwritten. --dry-run shows that before it happens;
128
+ .ai/agent-fleet-overrides.md is the customization no lifecycle command touches.
129
+ If you and the new version changed the same file, setup exits 3 having written
130
+ nothing — re-run with --on-conflict theirs or --on-conflict ours.
131
+ pi update --extensions updates pi extensions only; it does not update this npm
132
+ installer. just fleet install was removed; use setup or deps.
133
+
134
+ HELP
135
+ just Show this complete command guide.
136
+ just fleet help Show this complete command guide.
137
+ just --list Show the intentionally small public recipe surface.
138
+
139
+ Configuration:
140
+ Native rosters: .pi/agents/teams.yaml
141
+ Peer presets: .pi/agents/peers.yaml
142
+ Routing: .pi/agents/dispatch-policy.yaml
143
+ Overrides: .ai/agent-fleet-overrides.md
144
+ Safety: .pi/damage-control-rules.yaml
145
+ Full docs: docs/pi-extensions.md and docs/pi-setup.md
146
+ `;
147
+
148
+ function main(): void {
149
+ const argv = process.argv.slice(2);
150
+ if (argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
151
+ process.stdout.write(HELP);
152
+ return;
153
+ }
154
+ let invocation;
155
+ try {
156
+ invocation = parseFleetCommand(argv);
157
+ } catch (err) {
158
+ console.error(`fleet: ${err instanceof Error ? err.message : String(err)}\n`);
159
+ process.stderr.write(HELP);
160
+ process.exitCode = 2;
161
+ return;
162
+ }
163
+ for (const warning of invocation.warnings ?? []) {
164
+ console.error(`fleet: warning: ${warning}`);
165
+ }
166
+ // Every mode gets the monitor variables, not just `hub`: a plain `just fleet`
167
+ // or a `peer` loads no agent-hub and so reads them never, while `hub` and
168
+ // `team` both reach the hub through a Just recipe that inherits this
169
+ // environment. Deciding here rather than per recipe keeps it one line of
170
+ // truth; a null answer (opted out, or no directory we can make private)
171
+ // leaves the environment untouched and the hub unmonitored, exactly as
172
+ // before this existed.
173
+ const result = spawnSync("just", [invocation.recipe, ...invocation.args], {
174
+ stdio: "inherit",
175
+ env: { ...process.env, ...(resolveMonitorEnv() ?? {}) },
176
+ });
177
+ if (result.error) {
178
+ console.error(`fleet: could not run just: ${result.error.message}`);
179
+ process.exitCode = 1;
180
+ return;
181
+ }
182
+ process.exitCode = result.status ?? 1;
183
+ }
184
+
185
+ 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()}};}