@chankov/agent-fleet 2.0.21 → 2.0.22

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 (633) hide show
  1. package/.pi/harnesses/agent-hub/README.md +10 -0
  2. package/.pi/harnesses/agent-hub/acceptance.ts +2 -1
  3. package/.pi/harnesses/agent-hub/damage-guard-hub.ts +7 -2
  4. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +3 -1
  5. package/.pi/harnesses/agent-hub/external-blocker.js +9 -2
  6. package/.pi/harnesses/agent-hub/no-progress.ts +4 -2
  7. package/.pi/harnesses/agent-hub/package.json +1 -1
  8. package/.pi/harnesses/agent-hub/runtime-test-check.ts +16 -2
  9. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +3 -2
  10. package/.pi/harnesses/coms/package.json +1 -1
  11. package/.pi/harnesses/damage-control-continue/index.ts +2 -2
  12. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  13. package/.pi/harnesses/damage-control-continue/system1-child.ts +16 -6
  14. package/.pi/harnesses/lib/bash-policy-analysis.ts +31 -1
  15. package/.versions/2.0.22/.pi/agent-fleet/hermes/README.md +347 -0
  16. package/.versions/2.0.22/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  17. package/.versions/2.0.22/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  18. package/.versions/2.0.22/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  19. package/.versions/2.0.22/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  20. package/.versions/2.0.22/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  21. package/.versions/2.0.22/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  22. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  23. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  24. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  25. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  26. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  27. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  28. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  29. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  30. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  31. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  32. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  33. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  34. package/.versions/2.0.22/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  35. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  36. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  37. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  38. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  39. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  40. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  41. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  42. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  43. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  44. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  45. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  46. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  47. package/.versions/2.0.22/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  48. package/.versions/2.0.22/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  49. package/.versions/2.0.22/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  50. package/.versions/2.0.22/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  51. package/.versions/2.0.22/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  52. package/.versions/2.0.22/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  53. package/.versions/2.0.22/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  54. package/.versions/2.0.22/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  55. package/.versions/2.0.22/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  56. package/.versions/2.0.22/.pi/agent-fleet/scripts/fleet.ts +217 -0
  57. package/.versions/2.0.22/.pi/agent-fleet/scripts/flow.ts +157 -0
  58. package/.versions/2.0.22/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  59. package/.versions/2.0.22/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  60. package/.versions/2.0.22/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  61. package/.versions/2.0.22/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  62. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  63. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  64. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  65. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  66. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  67. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  68. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  69. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  70. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  71. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  72. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  73. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  74. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  75. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  76. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  77. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  78. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  79. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  80. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  81. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  82. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  83. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  84. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  85. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  86. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  87. package/.versions/2.0.22/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  88. package/.versions/2.0.22/.pi/agent-fleet/scripts/package-lock.json +35 -0
  89. package/.versions/2.0.22/.pi/agent-fleet/scripts/package.json +9 -0
  90. package/.versions/2.0.22/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  91. package/.versions/2.0.22/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  92. package/.versions/2.0.22/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  93. package/.versions/2.0.22/.pi/agent-fleet/scripts/team-up.ts +378 -0
  94. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  95. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  96. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  97. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  98. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  99. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  100. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  101. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  102. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  103. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  104. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  105. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  106. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  107. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  108. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  109. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  110. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  111. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  112. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  113. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  114. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  115. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  116. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  117. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  118. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  119. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  120. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  121. package/.versions/2.0.22/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  122. package/.versions/2.0.22/.pi/agents/dispatch-policy.yaml +32 -0
  123. package/.versions/2.0.22/.pi/agents/model-profiles.yaml +134 -0
  124. package/.versions/2.0.22/.pi/agents/peers.yaml +147 -0
  125. package/.versions/2.0.22/.pi/agents/teams.yaml +41 -0
  126. package/.versions/2.0.22/.pi/agents/voices.yaml +13 -0
  127. package/.versions/2.0.22/.pi/damage-control-rules.yaml +297 -0
  128. package/.versions/2.0.22/.pi/extensions/btw/README.md +120 -0
  129. package/.versions/2.0.22/.pi/extensions/btw/index.ts +914 -0
  130. package/.versions/2.0.22/.pi/extensions/btw/package.json +6 -0
  131. package/.versions/2.0.22/.pi/extensions/btw/state.js +179 -0
  132. package/.versions/2.0.22/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  133. package/.versions/2.0.22/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  134. package/.versions/2.0.22/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  135. package/.versions/2.0.22/.pi/extensions/compact-and-continue/README.md +42 -0
  136. package/.versions/2.0.22/.pi/extensions/compact-and-continue/index.ts +136 -0
  137. package/.versions/2.0.22/.pi/extensions/compact-and-continue/package.json +6 -0
  138. package/.versions/2.0.22/.pi/extensions/mcp-bridge/README.md +46 -0
  139. package/.versions/2.0.22/.pi/extensions/mcp-bridge/index.ts +206 -0
  140. package/.versions/2.0.22/.pi/extensions/mcp-bridge/package.json +6 -0
  141. package/.versions/2.0.22/.pi/extensions/package-lock.json +1175 -0
  142. package/.versions/2.0.22/.pi/extensions/package.json +9 -0
  143. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/README.md +224 -0
  144. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/config.ts +198 -0
  145. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  146. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/index.ts +248 -0
  147. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/package.json +6 -0
  148. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  149. package/.versions/2.0.22/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  150. package/.versions/2.0.22/.pi/harnesses/agent-hub/README.md +1527 -0
  151. package/.versions/2.0.22/.pi/harnesses/agent-hub/acceptance.ts +200 -0
  152. package/.versions/2.0.22/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  153. package/.versions/2.0.22/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  154. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  155. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  156. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  157. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  158. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  159. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  160. package/.versions/2.0.22/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  161. package/.versions/2.0.22/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  162. package/.versions/2.0.22/.pi/harnesses/agent-hub/artifacts.js +146 -0
  163. package/.versions/2.0.22/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  164. package/.versions/2.0.22/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  165. package/.versions/2.0.22/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  166. package/.versions/2.0.22/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  167. package/.versions/2.0.22/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  168. package/.versions/2.0.22/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  169. package/.versions/2.0.22/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  170. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  171. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  172. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  173. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  174. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  175. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  176. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  177. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  178. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  179. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  180. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  181. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  182. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  183. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  184. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  185. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  186. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  187. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  188. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  189. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  190. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  191. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  192. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  193. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  194. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  195. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  196. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  197. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  198. package/.versions/2.0.22/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  199. package/.versions/2.0.22/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  200. package/.versions/2.0.22/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  201. package/.versions/2.0.22/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  202. package/.versions/2.0.22/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  203. package/.versions/2.0.22/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  204. package/.versions/2.0.22/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  205. package/.versions/2.0.22/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  206. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  207. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  208. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  209. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  210. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  211. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  212. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  213. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  214. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  215. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  216. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  217. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  218. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  219. package/.versions/2.0.22/.pi/harnesses/agent-hub/context-window.js +108 -0
  220. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  221. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  222. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  223. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  224. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-hub.ts +254 -0
  225. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  226. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  227. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  228. package/.versions/2.0.22/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  229. package/.versions/2.0.22/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  230. package/.versions/2.0.22/.pi/harnesses/agent-hub/delegate.ts +478 -0
  231. package/.versions/2.0.22/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  232. package/.versions/2.0.22/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  233. package/.versions/2.0.22/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  234. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  235. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  236. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  237. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  238. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +255 -0
  239. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  240. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  241. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  242. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  243. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  244. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  245. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  246. package/.versions/2.0.22/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  247. package/.versions/2.0.22/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  248. package/.versions/2.0.22/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  249. package/.versions/2.0.22/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  250. package/.versions/2.0.22/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  251. package/.versions/2.0.22/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  252. package/.versions/2.0.22/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  253. package/.versions/2.0.22/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  254. package/.versions/2.0.22/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  255. package/.versions/2.0.22/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  256. package/.versions/2.0.22/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  257. package/.versions/2.0.22/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  258. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  259. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  260. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  261. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  262. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  263. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  264. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  265. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  266. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  267. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  268. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  269. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  270. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  271. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  272. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  273. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  274. package/.versions/2.0.22/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  275. package/.versions/2.0.22/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  276. package/.versions/2.0.22/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  277. package/.versions/2.0.22/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  278. package/.versions/2.0.22/.pi/harnesses/agent-hub/footer.ts +30 -0
  279. package/.versions/2.0.22/.pi/harnesses/agent-hub/helpers.ts +270 -0
  280. package/.versions/2.0.22/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  281. package/.versions/2.0.22/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  282. package/.versions/2.0.22/.pi/harnesses/agent-hub/index.ts +2616 -0
  283. package/.versions/2.0.22/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  284. package/.versions/2.0.22/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  285. package/.versions/2.0.22/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  286. package/.versions/2.0.22/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  287. package/.versions/2.0.22/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  288. package/.versions/2.0.22/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  289. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  290. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  291. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  292. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  293. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  294. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  295. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  296. package/.versions/2.0.22/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  297. package/.versions/2.0.22/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  298. package/.versions/2.0.22/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  299. package/.versions/2.0.22/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  300. package/.versions/2.0.22/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  301. package/.versions/2.0.22/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  302. package/.versions/2.0.22/.pi/harnesses/agent-hub/package.json +7 -0
  303. package/.versions/2.0.22/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  304. package/.versions/2.0.22/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  305. package/.versions/2.0.22/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  306. package/.versions/2.0.22/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  307. package/.versions/2.0.22/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  308. package/.versions/2.0.22/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  309. package/.versions/2.0.22/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  310. package/.versions/2.0.22/.pi/harnesses/agent-hub/presentation.ts +48 -0
  311. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  312. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  313. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  314. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  315. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  316. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  317. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  318. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  319. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  320. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  321. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  322. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  323. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  324. package/.versions/2.0.22/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  325. package/.versions/2.0.22/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  326. package/.versions/2.0.22/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  327. package/.versions/2.0.22/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  328. package/.versions/2.0.22/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  329. package/.versions/2.0.22/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  330. package/.versions/2.0.22/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  331. package/.versions/2.0.22/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  332. package/.versions/2.0.22/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  333. package/.versions/2.0.22/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  334. package/.versions/2.0.22/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  335. package/.versions/2.0.22/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  336. package/.versions/2.0.22/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  337. package/.versions/2.0.22/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  338. package/.versions/2.0.22/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  339. package/.versions/2.0.22/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  340. package/.versions/2.0.22/.pi/harnesses/agent-hub/return-contract.js +349 -0
  341. package/.versions/2.0.22/.pi/harnesses/agent-hub/return-extract.js +77 -0
  342. package/.versions/2.0.22/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  343. package/.versions/2.0.22/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  344. package/.versions/2.0.22/.pi/harnesses/agent-hub/review-findings.js +96 -0
  345. package/.versions/2.0.22/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  346. package/.versions/2.0.22/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  347. package/.versions/2.0.22/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  348. package/.versions/2.0.22/.pi/harnesses/agent-hub/run-budget.js +342 -0
  349. package/.versions/2.0.22/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  350. package/.versions/2.0.22/.pi/harnesses/agent-hub/runtime-test-check.ts +68 -0
  351. package/.versions/2.0.22/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  352. package/.versions/2.0.22/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  353. package/.versions/2.0.22/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  354. package/.versions/2.0.22/.pi/harnesses/agent-hub/session-health.js +110 -0
  355. package/.versions/2.0.22/.pi/harnesses/agent-hub/session-start.ts +42 -0
  356. package/.versions/2.0.22/.pi/harnesses/agent-hub/spawn.ts +639 -0
  357. package/.versions/2.0.22/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  358. package/.versions/2.0.22/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  359. package/.versions/2.0.22/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  360. package/.versions/2.0.22/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  361. package/.versions/2.0.22/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  362. package/.versions/2.0.22/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  363. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  364. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  365. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  366. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  367. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  368. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  369. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  370. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  371. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  372. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  373. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  374. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  375. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  376. package/.versions/2.0.22/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  377. package/.versions/2.0.22/.pi/harnesses/agent-hub/timeline.ts +72 -0
  378. package/.versions/2.0.22/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  379. package/.versions/2.0.22/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  380. package/.versions/2.0.22/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  381. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  382. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  383. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  384. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  385. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  386. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  387. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +641 -0
  388. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  389. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  390. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  391. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  392. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  393. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  394. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  395. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  396. package/.versions/2.0.22/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  397. package/.versions/2.0.22/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  398. package/.versions/2.0.22/.pi/harnesses/agent-hub/types.ts +66 -0
  399. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  400. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  401. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  402. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  403. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  404. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  405. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  406. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  407. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  408. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  409. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  410. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  411. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  412. package/.versions/2.0.22/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  413. package/.versions/2.0.22/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  414. package/.versions/2.0.22/.pi/harnesses/agent-hub/version.ts +42 -0
  415. package/.versions/2.0.22/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  416. package/.versions/2.0.22/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  417. package/.versions/2.0.22/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  418. package/.versions/2.0.22/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  419. package/.versions/2.0.22/.pi/harnesses/ask-user-remote/README.md +59 -0
  420. package/.versions/2.0.22/.pi/harnesses/ask-user-remote/index.ts +569 -0
  421. package/.versions/2.0.22/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  422. package/.versions/2.0.22/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  423. package/.versions/2.0.22/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  424. package/.versions/2.0.22/.pi/harnesses/coms/README.md +100 -0
  425. package/.versions/2.0.22/.pi/harnesses/coms/index.ts +285 -0
  426. package/.versions/2.0.22/.pi/harnesses/coms/package.json +7 -0
  427. package/.versions/2.0.22/.pi/harnesses/coms/version.ts +42 -0
  428. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/README.md +161 -0
  429. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/index.ts +600 -0
  430. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/package.json +7 -0
  431. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  432. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  433. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  434. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  435. package/.versions/2.0.22/.pi/harnesses/damage-control-continue/version.ts +42 -0
  436. package/.versions/2.0.22/.pi/harnesses/lib/approval-wait.ts +17 -0
  437. package/.versions/2.0.22/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  438. package/.versions/2.0.22/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  439. package/.versions/2.0.22/.pi/harnesses/lib/clarification-policy.ts +9 -0
  440. package/.versions/2.0.22/.pi/harnesses/lib/coms-core-io.ts +413 -0
  441. package/.versions/2.0.22/.pi/harnesses/lib/coms-core.ts +680 -0
  442. package/.versions/2.0.22/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  443. package/.versions/2.0.22/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  444. package/.versions/2.0.22/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  445. package/.versions/2.0.22/.pi/harnesses/lib/context-budget-view.ts +112 -0
  446. package/.versions/2.0.22/.pi/harnesses/lib/context-budget.ts +114 -0
  447. package/.versions/2.0.22/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  448. package/.versions/2.0.22/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  449. package/.versions/2.0.22/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  450. package/.versions/2.0.22/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  451. package/.versions/2.0.22/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  452. package/.versions/2.0.22/.pi/harnesses/lib/damage-result-view.ts +16 -0
  453. package/.versions/2.0.22/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  454. package/.versions/2.0.22/.pi/harnesses/lib/execution-trace.ts +45 -0
  455. package/.versions/2.0.22/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  456. package/.versions/2.0.22/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  457. package/.versions/2.0.22/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  458. package/.versions/2.0.22/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  459. package/.versions/2.0.22/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  460. package/.versions/2.0.22/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  461. package/.versions/2.0.22/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  462. package/.versions/2.0.22/.pi/harnesses/lib/fleet-panel.ts +34 -0
  463. package/.versions/2.0.22/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  464. package/.versions/2.0.22/.pi/harnesses/lib/fleet-selection.ts +24 -0
  465. package/.versions/2.0.22/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  466. package/.versions/2.0.22/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  467. package/.versions/2.0.22/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  468. package/.versions/2.0.22/.pi/harnesses/lib/herdr-client.ts +472 -0
  469. package/.versions/2.0.22/.pi/harnesses/lib/herdr-presence.ts +399 -0
  470. package/.versions/2.0.22/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  471. package/.versions/2.0.22/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  472. package/.versions/2.0.22/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  473. package/.versions/2.0.22/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  474. package/.versions/2.0.22/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  475. package/.versions/2.0.22/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  476. package/.versions/2.0.22/.pi/harnesses/lib/identical-dialog.ts +27 -0
  477. package/.versions/2.0.22/.pi/harnesses/lib/installation-state.js +62 -0
  478. package/.versions/2.0.22/.pi/harnesses/lib/policy-roots.js +106 -0
  479. package/.versions/2.0.22/.pi/harnesses/lib/policy-roots.ts +31 -0
  480. package/.versions/2.0.22/.pi/harnesses/lib/process-shared.ts +9 -0
  481. package/.versions/2.0.22/.pi/harnesses/lib/safe-source-read.js +29 -0
  482. package/.versions/2.0.22/.pi/harnesses/lib/semantic-approval.ts +80 -0
  483. package/.versions/2.0.22/.pi/harnesses/lib/spawned-peers.js +191 -0
  484. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  485. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  486. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  487. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  488. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-json.js +37 -0
  489. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-loader.js +44 -0
  490. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  491. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-triage.js +42 -0
  492. package/.versions/2.0.22/.pi/harnesses/lib/system1/config-v2.js +112 -0
  493. package/.versions/2.0.22/.pi/harnesses/lib/system1/config.js +50 -0
  494. package/.versions/2.0.22/.pi/harnesses/lib/system1/contracts.ts +154 -0
  495. package/.versions/2.0.22/.pi/harnesses/lib/system1/demo.ts +95 -0
  496. package/.versions/2.0.22/.pi/harnesses/lib/system1/jev.ts +503 -0
  497. package/.versions/2.0.22/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  498. package/.versions/2.0.22/.pi/harnesses/lib/system1/selection.js +11 -0
  499. package/.versions/2.0.22/.pi/harnesses/lib/system1/service.ts +245 -0
  500. package/.versions/2.0.22/.pi/harnesses/lib/update-check.ts +222 -0
  501. package/.versions/2.0.22/.pi/harnesses/package-lock.json +2121 -0
  502. package/.versions/2.0.22/.pi/harnesses/package.json +13 -0
  503. package/.versions/2.0.22/.pi/prompts/af-build.md +27 -0
  504. package/.versions/2.0.22/.pi/prompts/af-code-simplify.md +22 -0
  505. package/.versions/2.0.22/.pi/prompts/af-constraints.md +31 -0
  506. package/.versions/2.0.22/.pi/prompts/af-plan.md +17 -0
  507. package/.versions/2.0.22/.pi/prompts/af-review.md +16 -0
  508. package/.versions/2.0.22/.pi/prompts/af-set-hermes-telegram.md +15 -0
  509. package/.versions/2.0.22/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  510. package/.versions/2.0.22/.pi/prompts/af-setup-rules.md +20 -0
  511. package/.versions/2.0.22/.pi/prompts/af-ship.md +17 -0
  512. package/.versions/2.0.22/.pi/prompts/af-spec.md +15 -0
  513. package/.versions/2.0.22/.pi/prompts/af-test.md +19 -0
  514. package/.versions/2.0.22/.pi/skills/bowser/SKILL.md +145 -0
  515. package/.versions/2.0.22/.version +1 -0
  516. package/.versions/2.0.22/agents/architect.md +24 -0
  517. package/.versions/2.0.22/agents/bowser.md +28 -0
  518. package/.versions/2.0.22/agents/builder.md +55 -0
  519. package/.versions/2.0.22/agents/code-reviewer.md +209 -0
  520. package/.versions/2.0.22/agents/deep-researcher.md +32 -0
  521. package/.versions/2.0.22/agents/documenter.md +22 -0
  522. package/.versions/2.0.22/agents/orchestrator.md +22 -0
  523. package/.versions/2.0.22/agents/plan-reviewer.md +83 -0
  524. package/.versions/2.0.22/agents/planner.md +107 -0
  525. package/.versions/2.0.22/agents/releaser.md +24 -0
  526. package/.versions/2.0.22/agents/researcher.md +30 -0
  527. package/.versions/2.0.22/agents/security-auditor.md +167 -0
  528. package/.versions/2.0.22/agents/test-engineer.md +153 -0
  529. package/.versions/2.0.22/agents/web-debugger.md +44 -0
  530. package/.versions/2.0.22/agents/web-performance-auditor.md +194 -0
  531. package/.versions/2.0.22/bin/catalog/harness-runtime-closure.json +73 -0
  532. package/.versions/2.0.22/codex/fleet-session-client/SKILL.md +34 -0
  533. package/.versions/2.0.22/codex/fleet-session-client.zip +0 -0
  534. package/.versions/2.0.22/docs/ARCHITECTURE.md +982 -0
  535. package/.versions/2.0.22/docs/agent-fleet-setup.md +1103 -0
  536. package/.versions/2.0.22/docs/claude-code-coms-bridge.md +147 -0
  537. package/.versions/2.0.22/docs/codex-session-bridge.md +219 -0
  538. package/.versions/2.0.22/docs/coms-hermes-bridge.md +188 -0
  539. package/.versions/2.0.22/docs/getting-started.md +126 -0
  540. package/.versions/2.0.22/docs/npm-install.md +535 -0
  541. package/.versions/2.0.22/docs/pi-extensions.md +455 -0
  542. package/.versions/2.0.22/docs/pi-setup.md +92 -0
  543. package/.versions/2.0.22/docs/skill-anatomy.md +150 -0
  544. package/.versions/2.0.22/install-manifest.json +3210 -0
  545. package/.versions/2.0.22/justfile +247 -0
  546. package/.versions/2.0.22/manifest-meta.json +1088 -0
  547. package/.versions/2.0.22/references/accessibility-checklist.md +160 -0
  548. package/.versions/2.0.22/references/communication-contract.md +26 -0
  549. package/.versions/2.0.22/references/definition-of-done.md +67 -0
  550. package/.versions/2.0.22/references/fleet-coordination-patterns.md +171 -0
  551. package/.versions/2.0.22/references/observability-checklist.md +92 -0
  552. package/.versions/2.0.22/references/orchestration-patterns.md +370 -0
  553. package/.versions/2.0.22/references/performance-checklist.md +236 -0
  554. package/.versions/2.0.22/references/prompting-patterns.md +380 -0
  555. package/.versions/2.0.22/references/security-checklist.md +245 -0
  556. package/.versions/2.0.22/references/testing-patterns.md +235 -0
  557. package/.versions/2.0.22/references/workflow-authoring.md +304 -0
  558. package/.versions/2.0.22/skills/_internal/grilling.md +59 -0
  559. package/.versions/2.0.22/skills/browser-testing-with-devtools/SKILL.md +351 -0
  560. package/.versions/2.0.22/skills/code-review-and-quality/SKILL.md +396 -0
  561. package/.versions/2.0.22/skills/compound-learning/SKILL.md +137 -0
  562. package/.versions/2.0.22/skills/constraint-driven-development/SKILL.md +338 -0
  563. package/.versions/2.0.22/skills/constraint-driven-development/references/floor-guard.md +99 -0
  564. package/.versions/2.0.22/skills/context-engineering/SKILL.md +341 -0
  565. package/.versions/2.0.22/skills/deprecation-and-migration/SKILL.md +247 -0
  566. package/.versions/2.0.22/skills/designing-agents/SKILL.md +394 -0
  567. package/.versions/2.0.22/skills/designing-agents/pi-harness-authoring.md +222 -0
  568. package/.versions/2.0.22/skills/drafting-workflows/SKILL.md +143 -0
  569. package/.versions/2.0.22/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  570. package/.versions/2.0.22/skills/frontend-ui-engineering/SKILL.md +328 -0
  571. package/.versions/2.0.22/skills/git-workflow-and-versioning/SKILL.md +316 -0
  572. package/.versions/2.0.22/skills/idea-refine/SKILL.md +182 -0
  573. package/.versions/2.0.22/skills/idea-refine/examples.md +238 -0
  574. package/.versions/2.0.22/skills/idea-refine/frameworks.md +99 -0
  575. package/.versions/2.0.22/skills/idea-refine/refinement-criteria.md +113 -0
  576. package/.versions/2.0.22/skills/idea-refine/scripts/idea-refine.sh +15 -0
  577. package/.versions/2.0.22/skills/incremental-implementation/SKILL.md +353 -0
  578. package/.versions/2.0.22/skills/incremental-implementation.zip +0 -0
  579. package/.versions/2.0.22/skills/interview-me/SKILL.md +226 -0
  580. package/.versions/2.0.22/skills/orchestration-verification/SKILL.md +182 -0
  581. package/.versions/2.0.22/skills/peer-coms/SKILL.md +90 -0
  582. package/.versions/2.0.22/skills/performance-optimization/SKILL.md +496 -0
  583. package/.versions/2.0.22/skills/planning-and-task-breakdown/SKILL.md +318 -0
  584. package/.versions/2.0.22/skills/planning-and-task-breakdown.zip +0 -0
  585. package/.versions/2.0.22/skills/repository-ai-setup/SKILL.md +135 -0
  586. package/.versions/2.0.22/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  587. package/.versions/2.0.22/skills/repository-ai-setup/references/apply-contract.md +74 -0
  588. package/.versions/2.0.22/skills/repository-ai-setup/references/provenance-template.md +16 -0
  589. package/.versions/2.0.22/skills/repository-ai-setup/references/setup-flow.md +108 -0
  590. package/.versions/2.0.22/skills/repository-ai-setup/references/verify-setup.md +20 -0
  591. package/.versions/2.0.22/skills/repository-ai-setup.zip +0 -0
  592. package/.versions/2.0.22/skills/security-and-hardening/SKILL.md +524 -0
  593. package/.versions/2.0.22/skills/spec-driven-development/SKILL.md +295 -0
  594. package/.versions/2.0.22/skills/spec-driven-development.zip +0 -0
  595. package/.versions/2.0.22/skills/using-agent-skills/SKILL.md +198 -0
  596. package/.versions/2.0.22/vendor/agent-skills-upstream/LICENSE +21 -0
  597. package/.versions/2.0.22/vendor/agent-skills-upstream/README.md +430 -0
  598. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  599. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  600. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  601. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  602. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  603. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  604. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  605. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  606. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  607. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  608. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  609. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  610. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  611. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  612. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  613. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  614. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  615. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  616. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  617. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  618. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  619. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  620. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  621. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  622. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  623. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  624. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  625. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  626. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  627. package/.versions/2.0.22/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  628. package/CHANGELOG.md +13 -0
  629. package/bin/cli.js +3 -2
  630. package/docs/ARCHITECTURE.md +6 -3
  631. package/docs/system1-damage-guard.md +23 -2
  632. package/install-manifest.json +1 -1
  633. package/package.json +1 -1
@@ -0,0 +1,217 @@
1
+ // Unified `just fleet` command dispatcher. Parsing is kept pure and tested in
2
+ // .pi/agent-fleet/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
+ import { assertRuntimeDependencies } from "./lib/runtime-dependencies.js";
9
+
10
+ const PI_LAUNCH_RECIPES = new Set([
11
+ "_fleet-core",
12
+ "_fleet-hub",
13
+ "_fleet-hub-team",
14
+ "_fleet-team-up",
15
+ "_fleet-conductor",
16
+ "_fleet-team-resume",
17
+ ]);
18
+
19
+ const HELP = `Agent Fleet — one guarded Hub runtime, two work modes, independent topology
20
+
21
+ SET UP A NEW REPOSITORY
22
+ npx @chankov/agent-fleet@latest setup
23
+ Run this from the target repository. A repository without Agent Fleet has
24
+ no justfile yet — setup writes it — so the first install cannot use just.
25
+ Select Default/Full and optional features, inspect the exact plan, then
26
+ confirm once to apply it. Follow with just fleet deps, then just fleet doctor.
27
+ Source checkout development: node bin/cli.js setup.
28
+ Once installed, just fleet setup wraps the same command for this repository.
29
+
30
+ QUICK START
31
+ just fleet # Hub/operator, empty native roster
32
+ just fleet --agents frontend # Hub/orchestrator with native specialists
33
+ just fleet --herdr --project af
34
+ # Hub/operator in a one-pane Herdr workspace
35
+ just fleet --agents frontend --peers frontend --project af
36
+ # matching native roster + standing peers
37
+
38
+ DETERMINISTIC FLOWS
39
+ just flow quality
40
+ just flow scout "where is authentication configured?"
41
+ just flow build-test "add the validated endpoint"
42
+ Run code-owned headless phase graphs on isolated flow/<name>-<runId> branches.
43
+
44
+ just flow cleanup # list flow branches and prompt for a number
45
+ just flow cleanup 2 # safely remove empty/integrated selection 2
46
+ just flow merge # list flow branches and prompt for a number
47
+ just flow merge 2 # squash-merge accepted selection 2, then remove it
48
+ Cleanup and merge require Worktrunk. Dirty worktrees are refused; merge
49
+ targets the source branch recorded when the run started. See
50
+ docs/workflows.md in a source checkout, or
51
+ .pi/agent-fleet/docs/workflows.md in an installed workspace.
52
+
53
+ FLEET CORE — loaded in every Pi mode
54
+ Damage Control Continue · local/remote ask_user · Compact & Continue
55
+ BTW side sessions · update check via damage-control-continue (voice is opt-in with --voice)
56
+
57
+ UNIFIED HUB
58
+ just fleet [--work-mode operator|orchestrator] [--agents <roster>]
59
+ [--herdr] [--peers <preset>] [--no-coms] [PI_ARGS...]
60
+ Bare Fleet always loads Agent Hub in operator work mode. Operator keeps
61
+ read/bash/edit/write plus orchestration; the initial native roster is empty.
62
+ --agents selects .pi/agents/teams.yaml and implies orchestrator unless an
63
+ explicit --work-mode operator is supplied. --no-coms leaves direct/native work
64
+ available while coms, peer dispatch, and handoff refuse actionably.
65
+
66
+ WORK MODE AND ROSTER
67
+ /af-work-mode # report work mode and capability state
68
+ /af-agents-add code-reviewer # add a native Pi specialist at runtime
69
+ /af-work-mode orchestrator # remove direct coding tools; keep orchestration
70
+ /af-work-mode operator # restore the approved direct tool surface
71
+
72
+ Work mode is independent from the native roster and peer topology. Budgets follow task tier.
73
+ All Hub slash commands, including /af-handoff, stay registered in both work modes;
74
+ actions whose coms/Herdr capability is unavailable return remediation guidance.
75
+
76
+ Explicit dispatch backend examples (inside the Hub):
77
+ dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "native" })
78
+ dispatch_agent({ agent: "code-reviewer", task: "Review the diff", backend: "coms" })
79
+ backend "auto" follows .pi/agents/dispatch-policy.yaml; native always starts
80
+ the local Pi specialist, while coms requires a live same-name peer and never
81
+ falls back to native.
82
+
83
+ HERDR TOPOLOGY — requires a running Herdr server (https://herdr.dev)
84
+ just fleet --herdr [--project <name>]
85
+ Hub-only workspace using the empty base peer preset.
86
+
87
+ just fleet --peers <preset> [--agents <roster>] [--project <name>]
88
+ Add standing Pi/Claude peers from .pi/agents/peers.yaml. Hub and every peer
89
+ receive the same project. Add --dry-run to print the redacted layout only.
90
+
91
+ Dynamic Claude reviewer from a Hub already running inside Herdr:
92
+ herdr_spawn_peer({ name: "code-reviewer" })
93
+ coms_send({ target: "code-reviewer", prompt: "Review the current diff" })
94
+ coms_await({ msg_id: "<returned-id>" })
95
+ /af-handoff code-reviewer
96
+ The declared runner may be Claude Code. Spawn requires Herdr; messaging and
97
+ handoff require coms readiness and a target visible in this Hub's project pool.
98
+ Every spawned peer gets a sibling pane and is locked to the Hub's project.
99
+
100
+ ONE STANDALONE PEER
101
+ just fleet peer <name> [--runner pi|claude-code] [--persona <p>|--no-persona]
102
+ [--model <m>] [--project <p>] [--extensions a,b]
103
+ [--browser] [--all-extensions] [--direction right|down]
104
+ [--here] [--dry-run] [-- PI_ARGS...]
105
+ A single addressable peer. Inside Herdr it splits the current pane; outside
106
+ it creates a one-pane workspace; --here uses this terminal. A peers.yaml
107
+ declaration controls runner/model/extensions/env_file. A matching persona
108
+ starts guarded Pi; --runner claude-code starts Claude Code plus its bridge.
109
+
110
+ TEAM LIFECYCLE
111
+ just fleet snapshot <preset> [--project <name>]
112
+ just fleet down <preset> [--project <name>]
113
+ just fleet resume <preset> [--project <name>]
114
+ Save session refs, close cleanly, and rebuild available Pi/Claude sessions.
115
+
116
+ HERMES CONDUCTOR
117
+ just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
118
+ Start Hermes with a peer team, or preview the layout with --dry-run.
119
+
120
+ CAPABILITY FLAGS
121
+ --browser Add Chrome DevTools MCP tools to the Hub/main Pi process.
122
+ --voice Load pi-voice-stt after selecting the voice setup feature.
123
+ --all-extensions Also auto-load project/global extensions outside Fleet Core.
124
+ --no-coms Disable only the Hub's embedded coms layer.
125
+
126
+ COMPATIBILITY ALIASES — accepted with migration warnings
127
+ just fleet hub [--solo] ... -> just fleet [--no-coms] ...
128
+ just fleet team <preset> ... -> just fleet --agents <roster> --peers <preset> ...
129
+ just fleet team <preset> --no-hub -> legacy peers-only topology
130
+ Legacy peer-only presets full/web/docs retain the default native roster.
131
+
132
+ LIFECYCLE
133
+ just fleet setup [--dry-run] [--preset default|full --features none --yes]
134
+ Reconcile desired state with the newest published package. Preset and
135
+ features are remembered in .ai/agent-fleet.json, so a plain setup needs no
136
+ flags; flags apply to one run unless --save-desired persists them.
137
+ just fleet deps
138
+ Install Node dependencies for .pi/extensions, .pi/harnesses, and scripts.
139
+ Does not launch Pi, configure STT, install ffmpeg/Herdr, or pair Codex.
140
+ just fleet doctor [--fix]
141
+ just fleet uninstall --all --yes
142
+ Reinstall after self-uninstall with npx @chankov/agent-fleet@latest setup.
143
+
144
+ UPDATE NOTE
145
+ Update with: just fleet setup --dry-run, then just fleet setup, then deps+doctor.
146
+ setup reconciles TOWARD the package: an artifact you edited in place is
147
+ refreshed and your edit overwritten. --dry-run shows that before it happens;
148
+ .ai/agent-fleet-overrides.md is the customization no lifecycle command touches.
149
+ If you and the new version changed the same file, setup exits 3 having written
150
+ nothing — re-run with --on-conflict theirs or --on-conflict ours.
151
+ pi update --extensions updates pi extensions only; it does not update this npm
152
+ installer. just fleet install was removed; use setup or deps.
153
+
154
+ HELP
155
+ just Show this complete command guide.
156
+ just fleet help Show this complete command guide.
157
+ just --list Show the intentionally small public recipe surface.
158
+
159
+ Configuration:
160
+ Native rosters: .pi/agents/teams.yaml
161
+ Peer presets: .pi/agents/peers.yaml
162
+ Routing: .pi/agents/dispatch-policy.yaml
163
+ Overrides: .ai/agent-fleet-overrides.md
164
+ Safety: .pi/damage-control-rules.yaml
165
+ Full docs: docs/pi-extensions.md and docs/pi-setup.md
166
+ `;
167
+
168
+ function main(): void {
169
+ const argv = process.argv.slice(2);
170
+ if (argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
171
+ process.stdout.write(HELP);
172
+ return;
173
+ }
174
+ let invocation;
175
+ try {
176
+ invocation = parseFleetCommand(argv);
177
+ } catch (err) {
178
+ console.error(`fleet: ${err instanceof Error ? err.message : String(err)}\n`);
179
+ process.stderr.write(HELP);
180
+ process.exitCode = 2;
181
+ return;
182
+ }
183
+ for (const warning of invocation.warnings ?? []) {
184
+ console.error(`fleet: warning: ${warning}`);
185
+ }
186
+ // Refuse before Just/Pi starts. Without this guard a top-level extension
187
+ // import can fail before agent-hub registers flags such as --project, making
188
+ // a missing npm tree look like an unrelated "Unknown option" parser error.
189
+ if (PI_LAUNCH_RECIPES.has(invocation.recipe)) {
190
+ try {
191
+ assertRuntimeDependencies(process.cwd());
192
+ } catch (error) {
193
+ console.error(`fleet: ${error instanceof Error ? error.message : String(error)}`);
194
+ process.exitCode = 1;
195
+ return;
196
+ }
197
+ }
198
+ // Every mode gets the monitor variables, not just `hub`: a plain `just fleet`
199
+ // or a `peer` loads no agent-hub and so reads them never, while `hub` and
200
+ // `team` both reach the hub through a Just recipe that inherits this
201
+ // environment. Deciding here rather than per recipe keeps it one line of
202
+ // truth; a null answer (opted out, or no directory we can make private)
203
+ // leaves the environment untouched and the hub unmonitored, exactly as
204
+ // before this existed.
205
+ const result = spawnSync("just", [invocation.recipe, ...invocation.args], {
206
+ stdio: "inherit",
207
+ env: { ...process.env, ...(resolveMonitorEnv() ?? {}) },
208
+ });
209
+ if (result.error) {
210
+ console.error(`fleet: could not run just: ${result.error.message}`);
211
+ process.exitCode = 1;
212
+ return;
213
+ }
214
+ process.exitCode = result.status ?? 1;
215
+ }
216
+
217
+ main();
@@ -0,0 +1,157 @@
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, type ScoutWorkflowDeps } 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 }, deps?: any) => 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 interface HubScoutExecution {
68
+ /** Hub-only no-branch mode. CLI callers omit this; branch creation is separately opt-in. */
69
+ noBranch: true;
70
+ traceDirectory: string;
71
+ signal?: AbortSignal;
72
+ scoutAgent?: ScoutWorkflowDeps["agent"];
73
+ }
74
+
75
+ export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string; hubScout?: HubScoutExecution } = {}): Promise<FinishResult> {
76
+ const cwd = options.cwd ?? process.cwd();
77
+ if (options.hubScout && command.branch) throw Object.assign(new Error("Hub scout cannot create a branch"), { exitCode: 2 });
78
+ if (options.hubScout && command.name !== "scout") throw Object.assign(new Error("Hub no-branch execution currently permits only the read-only scout flow"), { exitCode: 2 });
79
+ const workflow = await resolveWorkflow(command.name, options.workflowsDir);
80
+ if (!workflow) throw Object.assign(new Error(`Unknown flow: ${command.name}`), { exitCode: 2 });
81
+ workflow.validate?.(command, cwd);
82
+ loadEnv(cwd);
83
+ // CLI keeps its clean-tree guard, but creates a branch only on explicit request.
84
+ // Hub scout runs only in a detached
85
+ // isolated snapshot and never creates or annotates a branch.
86
+ if (!options.hubScout) requireCleanTree(cwd, command.allowDirty);
87
+ workflow.preflight?.(cwd, command);
88
+ const runId = command.runId ?? makeRunId();
89
+ const repositoryBaseline = snapshot(cwd);
90
+ const branch = !options.hubScout && command.branch ? createFlowBranch(command.name, runId, cwd) : undefined;
91
+ const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline, traceDirectory: options.hubScout?.traceDirectory });
92
+ const persistResult = (result: FinishResult) => {
93
+ if (!branch) return;
94
+ try { recordFlowResult(branch, result.status, cwd); }
95
+ catch (error) { console.error(`Warning: flow result metadata was not recorded: ${error instanceof Error ? error.message : String(error)}`); }
96
+ };
97
+ let interruption: FinishResult | undefined;
98
+ const onSignal = (signal: NodeJS.Signals) => {
99
+ if (interruption) return;
100
+ interruption = run.interrupt(signal);
101
+ };
102
+ const onAbort = () => { if (!interruption) interruption = run.abort("cancelled by Hub owner", 130); };
103
+ process.once("SIGINT", onSignal);
104
+ process.once("SIGTERM", onSignal);
105
+ options.hubScout?.signal?.addEventListener("abort", onAbort, { once: true });
106
+ try {
107
+ if (options.hubScout?.signal?.aborted) onAbort();
108
+ const input = { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply };
109
+ const result = options.hubScout
110
+ ? await workflow.run(run, input, { ...(options.hubScout.scoutAgent ? { agent: options.hubScout.scoutAgent } : {}), dataReadRoot: cwd })
111
+ : await workflow.run(run, input);
112
+ const finalResult = interruption ?? result;
113
+ persistResult(finalResult);
114
+ console.error(finalResult.banner);
115
+ return finalResult;
116
+ } catch (error) {
117
+ if (!interruption) {
118
+ const message = error instanceof Error ? error.message : String(error);
119
+ const rejected = run.abort(message);
120
+ persistResult(rejected);
121
+ console.error(rejected.banner);
122
+ throw error;
123
+ }
124
+ persistResult(interruption);
125
+ console.error(interruption.banner);
126
+ return interruption;
127
+ } finally {
128
+ process.removeListener("SIGINT", onSignal);
129
+ process.removeListener("SIGTERM", onSignal);
130
+ options.hubScout?.signal?.removeEventListener("abort", onAbort);
131
+ }
132
+ }
133
+
134
+ export async function main(argv = process.argv.slice(2)): Promise<number> {
135
+ if (argv[0] === "cleanup" || argv[0] === "merge") {
136
+ let command;
137
+ try { command = parseFlowMaintenanceCommand(argv); }
138
+ catch (error) { console.error(error instanceof Error ? error.message : String(error)); return 2; }
139
+ try { return await runFlowMaintenance(command); }
140
+ catch (error) {
141
+ console.error(error instanceof Error ? error.message : String(error));
142
+ return Number((error as { exitCode?: number })?.exitCode ?? 1);
143
+ }
144
+ }
145
+ let parsed: FlowCommand;
146
+ try { parsed = parseFlowCommand(argv); }
147
+ catch (error) { console.error(error instanceof Error ? error.message : String(error)); return 2; }
148
+ try {
149
+ return (await executeFlow(parsed)).exitCode;
150
+ } catch (error) {
151
+ const message = error instanceof Error ? error.message : String(error);
152
+ console.error(message);
153
+ return Number((error as { exitCode?: number })?.exitCode ?? (error instanceof StartRefusedError ? 3 : 1));
154
+ }
155
+ }
156
+
157
+ 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()}};}