@chankov/agent-fleet 0.0.11 → 1.0.0

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 (494) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +26 -25
  3. package/.pi/extensions/btw/index.ts +80 -83
  4. package/.pi/extensions/pi-voice-stt/README.md +4 -3
  5. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  6. package/.pi/harnesses/agent-hub/README.md +106 -54
  7. package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
  8. package/.pi/harnesses/agent-hub/footer.ts +4 -0
  9. package/.pi/harnesses/agent-hub/helpers.ts +18 -0
  10. package/.pi/harnesses/agent-hub/index.ts +537 -369
  11. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  14. package/.pi/harnesses/agent-hub/posture.ts +103 -0
  15. package/.pi/harnesses/ask-user-remote/README.md +37 -3
  16. package/.pi/harnesses/ask-user-remote/index.ts +173 -17
  17. package/.pi/harnesses/coms/package.json +1 -1
  18. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  19. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  20. package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  22. package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  23. package/.pi/harnesses/lib/fleet-panel.ts +34 -0
  24. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  25. package/.pi/harnesses/lib/fleet-selection.ts +24 -0
  26. package/.pi/harnesses/package-lock.json +2011 -0
  27. package/.pi/harnesses/package.json +1 -0
  28. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  29. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
  30. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
  31. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  32. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
  33. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
  34. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
  35. package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
  36. package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
  37. package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
  38. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
  39. package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
  40. package/.versions/0.0.11/docs/getting-started.md +26 -237
  41. package/.versions/0.0.11/docs/npm-install.md +60 -478
  42. package/.versions/0.0.11/docs/pi-extensions.md +4 -4
  43. package/.versions/0.0.11/docs/pi-setup.md +37 -551
  44. package/.versions/0.0.11/hermes/README.md +1 -1
  45. package/.versions/0.0.11/install-manifest.json +375 -1247
  46. package/.versions/0.0.11/justfile +13 -6
  47. package/.versions/0.0.11/manifest-meta.json +543 -134
  48. package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
  49. package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
  50. package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
  51. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
  52. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  53. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  54. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  55. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  56. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  57. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  58. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  59. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  60. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  74. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  75. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  83. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  84. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  85. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  86. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  87. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  88. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  89. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  90. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  91. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  92. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  93. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  94. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  95. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  96. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  97. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  98. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  99. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  100. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  101. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  102. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  103. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  104. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  105. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  106. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  107. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  108. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  109. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  110. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  111. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  112. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  113. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  114. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  115. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  116. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  117. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  118. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  119. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  120. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  121. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  122. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  123. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  124. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  125. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  126. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  127. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  128. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  129. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  130. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  131. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  132. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  133. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  134. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  135. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  136. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  137. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  138. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  139. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  140. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  141. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  142. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  143. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  144. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  145. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  146. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  147. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  148. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  149. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  150. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  151. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  152. package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
  153. package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
  154. package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
  155. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  156. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  157. package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
  158. package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
  159. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  160. package/.versions/1.0.0/.version +1 -0
  161. package/.versions/1.0.0/agents/architect.md +24 -0
  162. package/.versions/1.0.0/agents/bowser.md +27 -0
  163. package/.versions/1.0.0/agents/builder.md +54 -0
  164. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  165. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  166. package/.versions/1.0.0/agents/documenter.md +18 -0
  167. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  168. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  169. package/.versions/1.0.0/agents/planner.md +70 -0
  170. package/.versions/1.0.0/agents/releaser.md +24 -0
  171. package/.versions/1.0.0/agents/researcher.md +28 -0
  172. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  173. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  174. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  175. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  176. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  177. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  178. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  179. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  180. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  181. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  182. package/.versions/1.0.0/docs/getting-started.md +98 -0
  183. package/.versions/1.0.0/docs/npm-install.md +292 -0
  184. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  185. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  186. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  187. package/.versions/1.0.0/hermes/README.md +347 -0
  188. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  189. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  190. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  191. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  192. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  193. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  194. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  195. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  196. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  197. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  198. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  199. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  200. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  201. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  202. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  203. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  204. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  205. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  206. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  207. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  208. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  209. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  210. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  211. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  212. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  213. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  214. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  215. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  216. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  217. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  218. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  219. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  220. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  221. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  222. package/.versions/1.0.0/install-manifest.json +2745 -0
  223. package/.versions/1.0.0/justfile +272 -0
  224. package/.versions/1.0.0/manifest-meta.json +882 -0
  225. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  226. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  227. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  228. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  229. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  230. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  231. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  232. package/.versions/1.0.0/references/security-checklist.md +179 -0
  233. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  234. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  235. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  236. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  237. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  238. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  239. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  240. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  241. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  242. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  243. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  244. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  245. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  246. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  247. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  248. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  249. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  250. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  251. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  252. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  253. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  254. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  255. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  256. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  257. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  258. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  259. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  260. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  261. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  262. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  263. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  264. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  265. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  266. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  267. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  268. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  269. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  270. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  271. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  272. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  273. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  274. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  275. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  276. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  278. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  279. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  280. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  284. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  285. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  286. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  287. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  288. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  289. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  290. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  291. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  292. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  293. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  294. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  295. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  296. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  297. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  298. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  299. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  300. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  301. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  302. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  303. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  304. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  305. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  306. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  307. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  308. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  309. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  310. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  311. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  312. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  313. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  314. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  315. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  316. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  317. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  318. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  319. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  320. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  321. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  322. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  323. package/CHANGELOG.md +142 -0
  324. package/README.md +117 -79
  325. package/agents/orchestrator.md +1 -1
  326. package/bin/cli.js +289 -359
  327. package/bin/force-patch-changesets.js +18 -2
  328. package/bin/lib/apply.js +86 -32
  329. package/bin/lib/desired.js +87 -0
  330. package/bin/lib/detect-agent.js +22 -38
  331. package/bin/lib/doctor.js +283 -33
  332. package/bin/lib/features.js +78 -0
  333. package/bin/lib/manifest.js +127 -48
  334. package/bin/lib/overrides.js +35 -0
  335. package/bin/lib/personas.js +37 -0
  336. package/bin/lib/plan.js +18 -9
  337. package/bin/lib/purge.js +11 -0
  338. package/bin/lib/reconcile.js +68 -0
  339. package/bin/lib/scan.js +24 -0
  340. package/bin/lib/state.js +25 -1
  341. package/bin/lib/stt-wizard.js +33 -0
  342. package/bin/lib/transaction.js +149 -0
  343. package/bin/lib/tui.js +71 -0
  344. package/bin/lib/verify.js +9 -26
  345. package/bin/snapshot-version.js +3 -6
  346. package/docs/ARCHITECTURE.md +55 -21
  347. package/docs/MIGRATION-agent-fleet.md +222 -0
  348. package/docs/agent-fleet-setup.md +124 -64
  349. package/docs/claude-code-coms-bridge.md +21 -2
  350. package/docs/coms-hermes-bridge.md +1 -1
  351. package/docs/getting-started.md +61 -217
  352. package/docs/npm-install.md +207 -429
  353. package/docs/pi-extensions.md +85 -41
  354. package/docs/pi-setup.md +48 -545
  355. package/hermes/README.md +1 -1
  356. package/install-manifest.json +385 -1255
  357. package/justfile +45 -27
  358. package/manifest-meta.json +544 -134
  359. package/node_modules/pi-ask-user/README.md +43 -5
  360. package/node_modules/pi-ask-user/index.ts +630 -75
  361. package/node_modules/pi-ask-user/package.json +1 -1
  362. package/package.json +5 -11
  363. package/scripts/coms-claude-bridge.ts +10 -0
  364. package/scripts/fleet.ts +107 -90
  365. package/scripts/lib/claude-bridge-core.ts +45 -0
  366. package/scripts/lib/fleet-command.ts +170 -15
  367. package/scripts/lib/monitor-env.ts +18 -6
  368. package/scripts/lib/peer-launch.ts +6 -2
  369. package/scripts/lib/team-project.ts +24 -4
  370. package/scripts/team-up.ts +57 -11
  371. package/skills/designing-agents/SKILL.md +1 -1
  372. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  373. package/.claude/commands/build.md +0 -44
  374. package/.claude/commands/design-agent.md +0 -14
  375. package/.claude/commands/doctor-agent-fleet.md +0 -22
  376. package/.claude/commands/orchestrate.md +0 -112
  377. package/.claude/commands/prime.md +0 -22
  378. package/.claude/commands/review.md +0 -16
  379. package/.claude/commands/set-hermes-telegram.md +0 -15
  380. package/.claude/commands/set-hermes-watchdog.md +0 -6
  381. package/.claude/commands/setup-agent-fleet.md +0 -17
  382. package/.claude/commands/ship.md +0 -72
  383. package/.claude/commands/spec.md +0 -15
  384. package/.claude/commands/test.md +0 -19
  385. package/.claude/commands/webperf.md +0 -32
  386. package/.claude/orchestrate-teams.yaml +0 -24
  387. package/.opencode/commands/af-build.md +0 -17
  388. package/.opencode/commands/af-code-simplify.md +0 -16
  389. package/.opencode/commands/af-compound.md +0 -16
  390. package/.opencode/commands/af-design-agent.md +0 -15
  391. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  392. package/.opencode/commands/af-orchestrate.md +0 -112
  393. package/.opencode/commands/af-plan.md +0 -16
  394. package/.opencode/commands/af-prime.md +0 -22
  395. package/.opencode/commands/af-review.md +0 -15
  396. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  397. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  398. package/.opencode/commands/af-ship.md +0 -16
  399. package/.opencode/commands/af-spec.md +0 -16
  400. package/.opencode/commands/af-test.md +0 -21
  401. package/.opencode/commands/af-webperf.md +0 -32
  402. package/.opencode/orchestrate-teams.yaml +0 -24
  403. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  404. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  405. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  406. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  407. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  408. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  409. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  410. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  411. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  412. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  413. package/.versions/0.0.11/.claude/commands/build.md +0 -44
  414. package/.versions/0.0.11/.claude/commands/code-simplify.md +0 -22
  415. package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
  416. package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
  417. package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
  418. package/.versions/0.0.11/.claude/commands/plan.md +0 -16
  419. package/.versions/0.0.11/.claude/commands/prime.md +0 -22
  420. package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
  421. package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
  422. package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
  423. package/.versions/0.0.11/.claude/commands/ship.md +0 -72
  424. package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
  425. package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
  426. package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
  427. package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
  428. package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
  429. package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
  430. package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  431. package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
  432. package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
  433. package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
  434. package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
  435. package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +0 -15
  436. package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  437. package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
  438. package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
  439. package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
  440. package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
  441. package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
  442. package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
  443. package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  444. package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
  445. package/.versions/0.0.11/docs/opencode-setup.md +0 -281
  446. package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
  447. package/.versions/0.0.11/hooks/hooks.json +0 -14
  448. package/.versions/0.0.11/hooks/session-start.sh +0 -74
  449. package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
  450. package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
  451. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  452. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  453. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  454. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  455. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  456. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  457. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  458. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  459. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  460. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  461. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  462. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  463. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  464. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  465. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  466. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  467. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  468. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  469. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  470. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  471. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  472. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  473. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  474. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  475. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  476. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
  477. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  478. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  479. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  480. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  481. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  482. package/bin/lib/bootstrap.js +0 -323
  483. package/bin/lib/transform-persona.js +0 -180
  484. package/docs/opencode-setup.md +0 -281
  485. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  486. package/hooks/hooks.json +0 -14
  487. package/hooks/session-start.sh +0 -74
  488. package/hooks/simplify-ignore.sh +0 -302
  489. package/skills/guided-workspace-setup/SKILL.md +0 -226
  490. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  491. /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  492. /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  493. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
  494. /package/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-ask-user",
3
- "version": "0.11.1",
3
+ "version": "0.14.0",
4
4
  "description": "Interactive ask_user tool for pi-coding-agent with searchable split-pane selection UI, multi-select, and freeform input",
5
5
  "type": "module",
6
6
  "keywords": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chankov/agent-fleet",
3
- "version": "0.0.11",
3
+ "version": "1.0.0",
4
4
  "description": "Multi-agent fleet orchestration for coding agents. Pi as the primary runtime, Herdr as the workspace control plane, coms as the peer data plane, and Hermes for remote control — plus skills, personas, harnesses, and a guided setup CLI.",
5
5
  "keywords": [
6
6
  "ai",
@@ -8,9 +8,7 @@
8
8
  "multi-agent",
9
9
  "orchestration",
10
10
  "fleet",
11
- "claude",
12
- "claude-code",
13
- "opencode",
11
+ "claude-code-coms-peer",
14
12
  "pi",
15
13
  "pi-package",
16
14
  "skills",
@@ -37,10 +35,6 @@
37
35
  "bin/",
38
36
  "skills/",
39
37
  "agents/",
40
- ".claude/commands/",
41
- ".claude/orchestrate-teams.yaml",
42
- ".opencode/commands/",
43
- ".opencode/orchestrate-teams.yaml",
44
38
  ".pi/prompts/",
45
39
  ".pi/extensions/*.json",
46
40
  ".pi/extensions/*/*.ts",
@@ -78,6 +72,7 @@
78
72
  "references/",
79
73
  "hooks/",
80
74
  "docs/agent-fleet-setup.md",
75
+ "docs/MIGRATION-agent-fleet.md",
81
76
  "docs/ARCHITECTURE.md",
82
77
  "docs/codex-remote-conductor.md",
83
78
  "docs/claude-code-coms-bridge.md",
@@ -87,7 +82,6 @@
87
82
  "docs/skill-anatomy.md",
88
83
  "docs/getting-started.md",
89
84
  "docs/hermes-watchdog-supervisor.md",
90
- "docs/opencode-setup.md",
91
85
  "docs/pi-setup.md",
92
86
  ".versions/",
93
87
  "vendor/agent-skills-upstream/",
@@ -110,7 +104,7 @@
110
104
  "access": "public"
111
105
  },
112
106
  "scripts": {
113
- "test": "node bin/cli.js --version && node bin/cli.js --help && node bin/cli.js transform-persona --list --agent claude-code && node --test \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts .pi/harnesses/lib/coms-registry-entry.test.ts scripts/coms-cli.test.ts scripts/lib/codex-conductor.test.ts scripts/lib/codex-remote-control.test.ts scripts/lib/fleet-command.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/peer-launch.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/monitor-env.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/team-snapshot.command.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/index.test.ts .pi/harnesses/agent-hub/extension-loader.test.ts .pi/extensions/btw/state.test.js .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/view-default.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/docs-lane.test.js .pi/harnesses/agent-hub/external-blocker.test.js .pi/harnesses/agent-hub/run-namespace.test.js .pi/harnesses/agent-hub/review-findings.test.js .pi/harnesses/agent-hub/assertion-ledger.test.js .pi/harnesses/agent-hub/provider-semaphore.test.js .pi/harnesses/lib/spawned-peers.test.js .pi/harnesses/agent-hub/context-window.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/session-health.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/return-extract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research-retention.test.js .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-events.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/lib/hermes-monitor-plugin-handshake.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts scripts/hermes-watchdog-capability-probe.test.ts .pi/harnesses/agent-hub/monitor-invoke.test.ts .pi/harnesses/agent-hub/monitor-invoke-journal.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-publisher.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts hermes/desktop-plugins/agent-fleet-herdr/presentation.test.js scripts/docs-links.test.mjs && npm run test:watchdog-py",
107
+ "test": "node bin/cli.js --version && node bin/cli.js --help && node --test \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts .pi/harnesses/lib/coms-registry-entry.test.ts .pi/harnesses/lib/fleet-overlay.test.ts .pi/harnesses/lib/fleet-selection.test.ts .pi/harnesses/lib/fleet-panel.test.ts .pi/harnesses/lib/fleet-read-model.test.ts .pi/harnesses/lib/fleet-dashboard-view.test.ts .pi/harnesses/lib/fleet-dashboard-ops.test.ts .pi/harnesses/lib/fleet-detail-view.test.ts .pi/harnesses/agent-hub/fleet-dashboard.integration.test.ts scripts/coms-cli.test.ts scripts/lib/codex-conductor.test.ts scripts/lib/codex-remote-control.test.ts scripts/lib/fleet-command.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/peer-launch.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/monitor-env.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/team-snapshot.command.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/index.test.ts .pi/harnesses/agent-hub/extension-loader.test.ts .pi/extensions/btw/state.test.js .pi/extensions/btw/index.test.ts .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/view-default.test.ts .pi/harnesses/agent-hub/overlay-migration.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/docs-lane.test.js .pi/harnesses/agent-hub/external-blocker.test.js .pi/harnesses/agent-hub/run-namespace.test.js .pi/harnesses/agent-hub/review-findings.test.js .pi/harnesses/agent-hub/assertion-ledger.test.js .pi/harnesses/agent-hub/provider-semaphore.test.js .pi/harnesses/lib/spawned-peers.test.js .pi/harnesses/agent-hub/context-window.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/session-health.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/return-extract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research-retention.test.js .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-events.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/lib/hermes-monitor-plugin-handshake.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts scripts/hermes-watchdog-capability-probe.test.ts .pi/harnesses/agent-hub/monitor-invoke.test.ts .pi/harnesses/agent-hub/monitor-invoke-journal.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-publisher.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts hermes/desktop-plugins/agent-fleet-herdr/presentation.test.js scripts/docs-links.test.mjs && npm run test:watchdog-py",
114
108
  "test:watchdog-py": "PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s hermes/watchdog-tests -p 'test_*.py'",
115
109
  "pack:dry": "npm pack --dry-run",
116
110
  "changeset": "changeset",
@@ -125,7 +119,7 @@
125
119
  "dependencies": {
126
120
  "@modelcontextprotocol/sdk": "^1.29.0",
127
121
  "@sinclair/typebox": "^0.34.49",
128
- "pi-ask-user": "^0.11.1",
122
+ "pi-ask-user": "^0.14.0",
129
123
  "typebox": "^1.1.33",
130
124
  "yaml": "^2.9.0"
131
125
  },
@@ -63,6 +63,7 @@ import {
63
63
  ReplyPendingError,
64
64
  replyDeadlineAt,
65
65
  resolveReplyTimeoutMs,
66
+ waitForClaudePaneReady,
66
67
  } from "./lib/claude-bridge-core.ts";
67
68
  import { herdr, requireHerdr, HerdrUnavailableError } from "../.pi/harnesses/lib/herdr-client.ts";
68
69
  import { HerdrPresence } from "../.pi/harnesses/lib/herdr-presence.ts";
@@ -152,6 +153,15 @@ async function main(): Promise<void> {
152
153
  throw err;
153
154
  }
154
155
 
156
+ // `_claude-peer` backgrounds this bridge before the shell starts Claude Code.
157
+ // Do not publish a coms identity during that gap: Hub peer readiness is based
158
+ // on registration, and an immediate prompt typed into the still-booting pane
159
+ // is lost while the Claude TUI replaces the shell screen.
160
+ const startup = await waitForClaudePaneReady(async () => (await herdr.paneGet(paneId)).pane);
161
+ if (!startup.ready) {
162
+ die(`Claude Code was not detected as ready in pane ${paneId} after ${Math.round(startup.waitedMs / 1000)}s`);
163
+ }
164
+
155
165
  // ── identity ──
156
166
  ensureComsDirs(project);
157
167
  const sessionId = ulid();
package/scripts/fleet.ts CHANGED
@@ -6,116 +6,130 @@ import { spawnSync } from "node:child_process";
6
6
  import { parseFleetCommand } from "./lib/fleet-command.ts";
7
7
  import { resolveMonitorEnv } from "./lib/monitor-env.ts";
8
8
 
9
- const HELP = `Agent Fleet — unified Pi runtime
9
+ const HELP = `Agent Fleet — one guarded Hub runtime, two postures, independent topology
10
10
 
11
- QUICK START
12
- just fleet
13
- Start the default guarded Pi session with Fleet Core.
14
-
15
- just fleet hub --project af
16
- Start Agent Hub with specialists, research, Verification Contract, and coms.
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.
17
19
 
18
- just fleet team frontend --project af
19
- Start a guarded Hub plus the frontend peer team in one Herdr workspace.
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
20
27
 
21
28
  FLEET CORE — loaded in every Pi mode
22
- Damage Control Continue · local/remote ask_user · Speech-to-Text (Alt+S)
23
- Compact & Continue · BTW side sessions · update checker
24
-
25
- SESSION MODES
26
- just fleet [PI_ARGS...]
27
- Safe interactive Pi without Hub or a coms identity.
28
- Example: just fleet --model openai-codex/gpt-5.6-terra
29
-
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 /af-hub-mode, the native roster, and peer topology.
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
30
76
  just fleet peer <name> [--runner pi|claude-code] [--persona <p>|--no-persona]
31
77
  [--model <m>] [--project <p>] [--extensions a,b]
32
78
  [--browser] [--all-extensions] [--direction right|down]
33
79
  [--here] [--dry-run] [-- PI_ARGS...]
34
- ONE addressable coms peer, in a herdr pane of its own. Inside herdr it
35
- splits the current pane; outside it creates a single-pane workspace;
36
- --here runs it in this terminal instead.
37
- The NAME decides the shape: a name declared in .pi/agents/peers.yaml keeps
38
- its runner/model/extensions/env_file, a name matching agents/<name>.md
39
- becomes that persona peer, and anything else is a plain Fleet Core peer
40
- under that identity. --runner claude-code needs no manifest at all, and
41
- --no-persona forces the plain shape for a name that matches a persona.
42
- Raw pi arguments go after a "--" separator and need the plain shape.
43
- Examples:
44
- just fleet peer code-reviewer --project af
45
- just fleet peer scratch-reviewer --runner claude-code --model opus --project af
46
- just fleet peer web-debugger --browser --project af
47
- just fleet peer nick --here --project af
48
- just fleet peer architect --no-persona --here -- --session /path/to/session.json
49
-
50
- just fleet hub [--solo] [PI_ARGS...]
51
- Agent Hub dispatcher. Embedded coms is on unless --solo is supplied.
52
- Examples:
53
- just fleet hub --project af
54
- just fleet hub --solo
55
-
56
- TEAM MODES — presets: base, full, web, docs, default, debug, frontend,
57
- security, hotfix, release, info, review, plan
58
- just fleet team <preset> [TEAM_ARGS...]
59
- Guarded Hub plus guarded reusable peers in one Herdr workspace.
60
- Example: just fleet team security --project af
61
-
62
- just fleet team <preset> --no-hub [TEAM_ARGS...]
63
- Guarded reusable peers only; no Hub pane.
64
- Example: just fleet team docs --no-hub --project af
65
-
66
- just fleet team <preset> [--no-hub] --dry-run [TEAM_ARGS...]
67
- Print the resolved workspace, panes, and commands without changing Herdr.
68
- Example: just fleet team frontend --dry-run --project af
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.
69
84
 
70
85
  TEAM LIFECYCLE
71
86
  just fleet snapshot <preset> [--project <name>]
72
- Save session references while the workspace keeps running.
73
-
74
87
  just fleet down <preset> [--project <name>]
75
- Snapshot and cleanly close the workspace.
76
-
77
88
  just fleet resume <preset> [--project <name>]
78
- Rebuild the workspace and resume available Pi/Claude sessions.
79
-
80
- Examples:
81
- just fleet snapshot docs --project af
82
- just fleet down docs --project af
83
- just fleet resume docs --project af
89
+ Save session refs, close cleanly, and rebuild available Pi/Claude sessions.
84
90
 
85
91
  HERMES CONDUCTOR
86
92
  just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
87
93
  Start Hermes with a peer team, or preview the layout with --dry-run.
88
- Example: just fleet conductor hermes docs --project af
89
94
 
90
95
  CODEX REMOTE-CONTROL CONDUCTOR
91
96
  just fleet conductor codex <setup|reconfigure> [preset] [ARGS...]
92
97
  just fleet conductor codex <pair|start|status|stop|recover|uninstall>
93
98
  just fleet conductor codex [preset] [--dry-run] [TEAM_ARGS...]
94
99
 
95
- Typical flow:
96
- just fleet conductor codex setup docs --project af
97
- just fleet conductor codex pair
98
- just fleet conductor codex start
99
- just fleet conductor codex docs --project af
100
- just fleet conductor codex status
101
- just fleet conductor codex stop
102
-
103
100
  CAPABILITY FLAGS
104
- --browser
105
- Add interactive Chrome DevTools MCP tools to the main Pi/Hub process.
106
- On a persona peer it adds the chrome-devtools-mcp extension instead.
107
- Example: just fleet hub --browser --project af
108
-
109
- --all-extensions
110
- Also auto-load arbitrary project/global extensions outside Fleet Core.
111
- Not available to persona peers: reusable peers load a deterministic set,
112
- declared per peer via extensions: in .pi/agents/peers.yaml.
113
- Example: just fleet peer debugger --all-extensions --project af
114
-
115
- SETUP
116
- just fleet install
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
117
118
  Install only .pi/extensions and .pi/harnesses Node dependencies.
118
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.
119
133
 
120
134
  HELP
121
135
  just Show this complete command guide.
@@ -123,12 +137,12 @@ HELP
123
137
  just --list Show the intentionally small public recipe surface.
124
138
 
125
139
  Configuration:
126
- Teams: .pi/agents/peers.yaml
127
- Hub teams: .pi/agents/teams.yaml
128
- Overrides: .ai/agent-fleet-overrides.md
129
- STT: .ai/stt.json or ~/.pi/agent/stt.json
130
- Safety: .pi/damage-control-rules.yaml
131
- Full docs: docs/pi-extensions.md and docs/pi-setup.md
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
132
146
  `;
133
147
 
134
148
  function main(): void {
@@ -146,6 +160,9 @@ function main(): void {
146
160
  process.exitCode = 2;
147
161
  return;
148
162
  }
163
+ for (const warning of invocation.warnings ?? []) {
164
+ console.error(`fleet: warning: ${warning}`);
165
+ }
149
166
  // Every mode gets the monitor variables, not just `hub`: a plain `just fleet`
150
167
  // or a `peer` loads no agent-hub and so reads them never, while `hub` and
151
168
  // `team` both reach the hub through a Just recipe that inherits this
@@ -26,6 +26,51 @@ export const IDLE_WAIT_BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
26
26
  /** Longest we will ever wait for a pane to go idle before giving up. */
27
27
  export const IDLE_WAIT_CAP_MS = 120_000;
28
28
 
29
+ /** A bridge process starts before `claude` in the shared shell recipe. */
30
+ export const CLAUDE_STARTUP_REGISTRATION_SLACK_MS = 5_000;
31
+ export const CLAUDE_STARTUP_TIMEOUT_MS = 40_000;
32
+ export const CLAUDE_STARTUP_POLL_MS = 250;
33
+
34
+ export interface ClaudePaneState {
35
+ agent?: unknown;
36
+ agent_status?: unknown;
37
+ }
38
+
39
+ /** Registration is readiness only after Herdr has detected the Claude process. */
40
+ export function isClaudePaneReady(pane: ClaudePaneState): boolean {
41
+ const agent = String(pane.agent ?? "").toLowerCase();
42
+ const status = String(pane.agent_status ?? "unknown").toLowerCase();
43
+ return agent === "claude" && ["idle", "working", "blocked", "done"].includes(status);
44
+ }
45
+
46
+ export async function waitForClaudePaneReady(
47
+ probe: () => Promise<ClaudePaneState>,
48
+ options: {
49
+ timeoutMs?: number;
50
+ pollMs?: number;
51
+ now?: () => number;
52
+ sleep?: (ms: number) => Promise<void>;
53
+ } = {},
54
+ ): Promise<{ ready: boolean; waitedMs: number; last: ClaudePaneState | null }> {
55
+ const timeoutMs = Math.max(0, options.timeoutMs ?? CLAUDE_STARTUP_TIMEOUT_MS);
56
+ const pollMs = Math.max(1, options.pollMs ?? CLAUDE_STARTUP_POLL_MS);
57
+ const now = options.now ?? Date.now;
58
+ const sleep = options.sleep ?? ((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));
59
+ const startedAt = now();
60
+ let last: ClaudePaneState | null = null;
61
+ for (;;) {
62
+ try {
63
+ last = await probe();
64
+ if (isClaudePaneReady(last)) return { ready: true, waitedMs: now() - startedAt, last };
65
+ } catch {
66
+ // Herdr may briefly race pane creation; retry inside the bounded startup window.
67
+ }
68
+ const remaining = timeoutMs - (now() - startedAt);
69
+ if (remaining <= 0) return { ready: false, waitedMs: now() - startedAt, last };
70
+ await sleep(Math.min(pollMs, remaining));
71
+ }
72
+ }
73
+
29
74
  /**
30
75
  * The caller's own deadline wins — it knows how long the work takes — falling
31
76
  * back to the bridge's configured timeout and always clamped to the hard cap.
@@ -1,10 +1,12 @@
1
1
  export interface FleetInvocation {
2
2
  recipe: string;
3
3
  args: string[];
4
+ warnings?: string[];
4
5
  }
5
6
 
6
7
  interface Capabilities {
7
8
  browser: boolean;
9
+ voice: boolean;
8
10
  allExtensions: boolean;
9
11
  rest: string[];
10
12
  }
@@ -12,13 +14,15 @@ interface Capabilities {
12
14
  function capabilities(args: string[]): Capabilities {
13
15
  const rest: string[] = [];
14
16
  let browser = false;
17
+ let voice = false;
15
18
  let allExtensions = false;
16
19
  for (const arg of args) {
17
20
  if (arg === "--browser") browser = true;
21
+ else if (arg === "--voice") voice = true;
18
22
  else if (arg === "--all-extensions") allExtensions = true;
19
23
  else rest.push(arg);
20
24
  }
21
- return { browser, allExtensions, rest };
25
+ return { browser, voice, allExtensions, rest };
22
26
  }
23
27
 
24
28
  function bool(value: boolean): string {
@@ -34,16 +38,157 @@ function withoutFlag(args: string[], flag: string): { present: boolean; rest: st
34
38
  return { present: args.includes(flag), rest: args.filter((arg) => arg !== flag) };
35
39
  }
36
40
 
41
+ interface HubParseDefaults {
42
+ defaultAgents?: string;
43
+ forceHerdr?: boolean;
44
+ forcedPeers?: string;
45
+ legacyAgents?: boolean;
46
+ warnings?: string[];
47
+ }
48
+
49
+ function parseHubInvocation(args: string[], defaults: HubParseDefaults = {}): FleetInvocation {
50
+ let posture: "operator" | "orchestrator" | undefined;
51
+ let agents = defaults.defaultAgents;
52
+ let peers = defaults.forcedPeers;
53
+ let herdr = defaults.forceHerdr ?? false;
54
+ let noComs = false;
55
+ let browser = false;
56
+ let voice = false;
57
+ let allExtensions = false;
58
+ let dryRun = false;
59
+ let projectSeen = false;
60
+ let agentsSeen = false;
61
+ let peersSeen = false;
62
+ let postureSeen = false;
63
+ let herdrSeen = false;
64
+ let noComsSeen = false;
65
+ let browserSeen = false;
66
+ let voiceSeen = false;
67
+ let allExtensionsSeen = false;
68
+ let dryRunSeen = false;
69
+ const rest: string[] = [];
70
+ const warnings = [...(defaults.warnings ?? [])];
71
+
72
+ for (let i = 0; i < args.length; i++) {
73
+ const arg = args[i];
74
+ if (arg === "--") {
75
+ rest.push(...args.slice(i));
76
+ break;
77
+ }
78
+ switch (arg) {
79
+ case "--posture": {
80
+ if (postureSeen) throw new Error("--posture may only be provided once");
81
+ postureSeen = true;
82
+ const value = requireValue(args[++i], "--posture requires operator or orchestrator");
83
+ if (value !== "operator" && value !== "orchestrator") throw new Error("--posture requires operator or orchestrator");
84
+ posture = value;
85
+ break;
86
+ }
87
+ case "--agents":
88
+ if (agentsSeen) throw new Error("--agents may only be provided once");
89
+ agentsSeen = true;
90
+ agents = requireValue(args[++i], "--agents requires a native roster name");
91
+ break;
92
+ case "--peers": {
93
+ if (peersSeen) throw new Error("--peers may only be provided once");
94
+ peersSeen = true;
95
+ const value = requireValue(args[++i], "--peers requires a peer preset name");
96
+ if (defaults.forcedPeers && value !== defaults.forcedPeers) {
97
+ throw new Error(`Compatibility team preset ${defaults.forcedPeers} cannot combine with --peers ${value}`);
98
+ }
99
+ peers = value;
100
+ break;
101
+ }
102
+ case "--herdr":
103
+ if (herdrSeen) throw new Error("--herdr may only be provided once");
104
+ herdrSeen = true;
105
+ herdr = true;
106
+ break;
107
+ case "--no-coms":
108
+ case "--solo":
109
+ if (noComsSeen) throw new Error("--no-coms/--solo may only be provided once");
110
+ noComsSeen = true;
111
+ noComs = true;
112
+ if (arg === "--solo") warnings.push("`--solo` is deprecated; use `--no-coms`.");
113
+ break;
114
+ case "--browser":
115
+ if (browserSeen) throw new Error("--browser may only be provided once");
116
+ browserSeen = true;
117
+ browser = true;
118
+ break;
119
+ case "--voice":
120
+ if (voiceSeen) throw new Error("--voice may only be provided once");
121
+ voiceSeen = true;
122
+ voice = true;
123
+ break;
124
+ case "--all-extensions":
125
+ if (allExtensionsSeen) throw new Error("--all-extensions may only be provided once");
126
+ allExtensionsSeen = true;
127
+ allExtensions = true;
128
+ break;
129
+ case "--dry-run":
130
+ if (dryRunSeen) throw new Error("--dry-run may only be provided once");
131
+ dryRunSeen = true;
132
+ dryRun = true;
133
+ break;
134
+ case "--project":
135
+ if (projectSeen) throw new Error("--project may only be provided once");
136
+ projectSeen = true;
137
+ rest.push(arg, requireValue(args[++i], "--project requires a name"));
138
+ break;
139
+ default:
140
+ rest.push(arg);
141
+ }
142
+ }
143
+
144
+ if (posture === "orchestrator" && !agents) throw new Error("--posture orchestrator requires --agents <roster>");
145
+ const topology = herdr || peers !== undefined;
146
+ if (dryRun && !topology) throw new Error("--dry-run requires --herdr or --peers");
147
+
148
+ let invocation: FleetInvocation;
149
+ if (topology) {
150
+ const forwarded = [
151
+ ...(posture ? ["--posture", posture] : []),
152
+ ...(agents ? [defaults.legacyAgents ? "--legacy-agents" : "--agents", agents] : []),
153
+ ...(noComs ? ["--no-coms"] : []),
154
+ ...(browser ? ["--browser"] : []),
155
+ ...(voice ? ["--voice"] : []),
156
+ ...(allExtensions ? ["--all-extensions"] : []),
157
+ ...rest,
158
+ ];
159
+ invocation = { recipe: dryRun ? "_fleet-hub-team-dry" : "_fleet-hub-team", args: [peers ?? "base", ...forwarded] };
160
+ } else {
161
+ invocation = {
162
+ recipe: "_fleet-hub",
163
+ args: [
164
+ bool(noComs),
165
+ bool(browser),
166
+ bool(voice),
167
+ bool(allExtensions),
168
+ ...(posture ? ["--posture", posture] : []),
169
+ ...(agents ? ["--agent-team", agents] : []),
170
+ ...rest,
171
+ ],
172
+ };
173
+ }
174
+ if (warnings.length > 0) invocation.warnings = warnings;
175
+ return invocation;
176
+ }
177
+
37
178
  const CODEX_LIFECYCLE = new Set(["setup", "reconfigure", "pair", "start", "status", "stop", "recover", "uninstall"]);
38
179
 
39
180
  export function parseFleetCommand(argv: string[]): FleetInvocation {
40
181
  if (argv.length === 0 || argv[0].startsWith("--")) {
41
- const c = capabilities(argv);
42
- return { recipe: "_fleet-core", args: [bool(c.browser), bool(c.allExtensions), ...c.rest] };
182
+ return parseHubInvocation(argv);
43
183
  }
44
184
 
45
185
  const [mode, ...tail] = argv;
46
- if (mode === "install") return { recipe: "_fleet-install", args: tail };
186
+ if (mode === "install") {
187
+ throw new Error("just fleet install was removed; use `just fleet setup` for lifecycle setup or `just fleet deps` for runtime dependencies");
188
+ }
189
+ if (mode === "deps") return { recipe: "_fleet-deps", args: tail };
190
+ if (["setup", "doctor"].includes(mode)) return { recipe: "_fleet-lifecycle", args: [mode, ...tail] };
191
+ if (mode === "uninstall") return { recipe: "_fleet-lifecycle", args: ["uninstall", ...tail] };
47
192
 
48
193
  // One addressable peer, in a pane of its own unless --here. peer-launch.ts
49
194
  // owns the whole flag set (including `--` passthrough to pi), so the tail is
@@ -54,26 +199,36 @@ export function parseFleetCommand(argv: string[]): FleetInvocation {
54
199
  }
55
200
 
56
201
  if (mode === "hub") {
57
- const solo = withoutFlag(tail, "--solo");
58
- const c = capabilities(solo.rest);
59
- return { recipe: "_fleet-hub", args: [bool(solo.present), bool(c.browser), bool(c.allExtensions), ...c.rest] };
202
+ return parseHubInvocation(tail, {
203
+ defaultAgents: "default",
204
+ warnings: ["`just fleet hub` is a compatibility alias; use `just fleet` with canonical flags."],
205
+ });
60
206
  }
61
207
 
62
208
  if (mode === "team") {
63
209
  const team = requireValue(tail[0], "fleet team requires a team preset");
64
210
  const noHub = withoutFlag(tail.slice(1), "--no-hub");
211
+ if (!noHub.present) {
212
+ return parseHubInvocation(noHub.rest, {
213
+ defaultAgents: team === "base" ? undefined : team,
214
+ forceHerdr: true,
215
+ forcedPeers: team,
216
+ legacyAgents: team !== "base",
217
+ warnings: [team === "base"
218
+ ? "`just fleet team base` is a compatibility alias; use `just fleet --herdr`."
219
+ : `\`just fleet team ${team}\` is a compatibility alias; use \`just fleet --agents <roster> --peers ${team}\`.`],
220
+ });
221
+ }
65
222
  const dry = withoutFlag(noHub.rest, "--dry-run");
66
223
  const c = capabilities(dry.rest);
67
- if (noHub.present && (c.browser || c.allExtensions)) {
224
+ if (c.browser || c.allExtensions) {
68
225
  throw new Error("--browser/--all-extensions requires the hub; peer capabilities belong in .pi/agents/peers.yaml");
69
226
  }
70
- const recipe = noHub.present
71
- ? dry.present ? "_fleet-team-up-dry" : "_fleet-team-up"
72
- : dry.present ? "_fleet-hub-team-dry" : "_fleet-hub-team";
73
- const forwarded = [...c.rest];
74
- if (c.browser) forwarded.push("--browser");
75
- if (c.allExtensions) forwarded.push("--all-extensions");
76
- return { recipe, args: [team, ...forwarded] };
227
+ return {
228
+ recipe: dry.present ? "_fleet-team-up-dry" : "_fleet-team-up",
229
+ args: [team, ...c.rest],
230
+ warnings: [`\`just fleet team ${team} --no-hub\` is a compatibility alias; prefer \`just fleet peer\` or a canonical Hub topology.`],
231
+ };
77
232
  }
78
233
 
79
234
  if (mode === "snapshot" || mode === "down" || mode === "resume") {