@chankov/agent-fleet 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (325) hide show
  1. package/.pi/harnesses/agent-hub/README.md +60 -60
  2. package/.pi/harnesses/agent-hub/context-window.js +1 -1
  3. package/.pi/harnesses/agent-hub/drift-watchdog.js +11 -4
  4. package/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  5. package/.pi/harnesses/agent-hub/footer.ts +3 -2
  6. package/.pi/harnesses/agent-hub/hub-state-audit.js +0 -14
  7. package/.pi/harnesses/agent-hub/index.ts +351 -261
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  10. package/.pi/harnesses/agent-hub/run-budget.js +67 -69
  11. package/.pi/harnesses/coms/package.json +1 -1
  12. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  13. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  14. package/.pi/harnesses/lib/fleet-detail-view.ts +39 -4
  15. package/.versions/1.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  16. package/.versions/1.0.3/.pi/agents/model-profiles.yaml +27 -0
  17. package/.versions/1.0.3/.pi/agents/peers.yaml +142 -0
  18. package/.versions/1.0.3/.pi/agents/teams.yaml +41 -0
  19. package/.versions/1.0.3/.pi/damage-control-rules.yaml +297 -0
  20. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  21. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  22. package/.versions/1.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  23. package/.versions/1.0.3/.pi/extensions/btw/README.md +120 -0
  24. package/.versions/1.0.3/.pi/extensions/btw/index.ts +914 -0
  25. package/.versions/1.0.3/.pi/extensions/btw/package.json +6 -0
  26. package/.versions/1.0.3/.pi/extensions/btw/state.js +179 -0
  27. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  28. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  29. package/.versions/1.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  30. package/.versions/1.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  31. package/.versions/1.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  32. package/.versions/1.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  33. package/.versions/1.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  34. package/.versions/1.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  35. package/.versions/1.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  36. package/.versions/1.0.3/.pi/extensions/package-lock.json +1175 -0
  37. package/.versions/1.0.3/.pi/extensions/package.json +9 -0
  38. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  39. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  40. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  41. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  42. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  43. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  44. package/.versions/1.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  45. package/.versions/1.0.3/.pi/harnesses/agent-hub/README.md +1156 -0
  46. package/.versions/1.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  47. package/.versions/1.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  48. package/.versions/1.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  49. package/.versions/1.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  50. package/.versions/1.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  51. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  52. package/.versions/1.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  53. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  54. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  55. package/.versions/1.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  56. package/.versions/1.0.3/.pi/harnesses/agent-hub/delegate.ts +435 -0
  57. package/.versions/1.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  58. package/.versions/1.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  59. package/.versions/1.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  60. package/.versions/1.0.3/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  61. package/.versions/1.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  62. package/.versions/1.0.3/.pi/harnesses/agent-hub/footer.ts +36 -0
  63. package/.versions/1.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  64. package/.versions/1.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  65. package/.versions/1.0.3/.pi/harnesses/agent-hub/index.ts +9999 -0
  66. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  67. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  68. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  69. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  70. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  71. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  72. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  73. package/.versions/1.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  74. package/.versions/1.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  75. package/.versions/1.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  76. package/.versions/1.0.3/.pi/harnesses/agent-hub/posture.ts +158 -0
  77. package/.versions/1.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  78. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-retention.js +34 -0
  79. package/.versions/1.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  80. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  81. package/.versions/1.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  82. package/.versions/1.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  83. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  84. package/.versions/1.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  85. package/.versions/1.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  86. package/.versions/1.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  87. package/.versions/1.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  88. package/.versions/1.0.3/.pi/harnesses/agent-hub/spawn.ts +366 -0
  89. package/.versions/1.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  90. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  91. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  92. package/.versions/1.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  93. package/.versions/1.0.3/.pi/harnesses/coms/README.md +100 -0
  94. package/.versions/1.0.3/.pi/harnesses/coms/index.ts +1767 -0
  95. package/.versions/1.0.3/.pi/harnesses/coms/package.json +7 -0
  96. package/.versions/1.0.3/.pi/harnesses/coms/version.ts +42 -0
  97. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  98. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  99. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  100. package/.versions/1.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  101. package/.versions/1.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  102. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  103. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  104. package/.versions/1.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  105. package/.versions/1.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  106. package/.versions/1.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  107. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  108. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  109. package/.versions/1.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  110. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  111. package/.versions/1.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  112. package/.versions/1.0.3/.pi/harnesses/lib/fleet-detail-view.ts +168 -0
  113. package/.versions/1.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  114. package/.versions/1.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  115. package/.versions/1.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  116. package/.versions/1.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  117. package/.versions/1.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  118. package/.versions/1.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  119. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  120. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  121. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  122. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  123. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  124. package/.versions/1.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  125. package/.versions/1.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  126. package/.versions/1.0.3/.pi/harnesses/package-lock.json +2039 -0
  127. package/.versions/1.0.3/.pi/harnesses/package.json +10 -0
  128. package/.versions/1.0.3/.pi/prompts/af-build.md +24 -0
  129. package/.versions/1.0.3/.pi/prompts/af-code-simplify.md +22 -0
  130. package/.versions/1.0.3/.pi/prompts/af-plan.md +16 -0
  131. package/.versions/1.0.3/.pi/prompts/af-review.md +16 -0
  132. package/.versions/1.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  133. package/.versions/1.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  134. package/.versions/1.0.3/.pi/prompts/af-ship.md +17 -0
  135. package/.versions/1.0.3/.pi/prompts/af-spec.md +15 -0
  136. package/.versions/1.0.3/.pi/prompts/af-test.md +19 -0
  137. package/.versions/1.0.3/.pi/skills/bowser/SKILL.md +145 -0
  138. package/.versions/1.0.3/.version +1 -0
  139. package/.versions/1.0.3/agents/architect.md +25 -0
  140. package/.versions/1.0.3/agents/bowser.md +28 -0
  141. package/.versions/1.0.3/agents/builder.md +55 -0
  142. package/.versions/1.0.3/agents/code-reviewer.md +209 -0
  143. package/.versions/1.0.3/agents/deep-researcher.md +33 -0
  144. package/.versions/1.0.3/agents/documenter.md +19 -0
  145. package/.versions/1.0.3/agents/orchestrator.md +21 -0
  146. package/.versions/1.0.3/agents/plan-reviewer.md +84 -0
  147. package/.versions/1.0.3/agents/planner.md +71 -0
  148. package/.versions/1.0.3/agents/releaser.md +25 -0
  149. package/.versions/1.0.3/agents/researcher.md +29 -0
  150. package/.versions/1.0.3/agents/security-auditor.md +168 -0
  151. package/.versions/1.0.3/agents/test-engineer.md +154 -0
  152. package/.versions/1.0.3/agents/web-debugger.md +44 -0
  153. package/.versions/1.0.3/agents/web-performance-auditor.md +194 -0
  154. package/.versions/1.0.3/bin/catalog/harness-runtime-closure.json +38 -0
  155. package/.versions/1.0.3/codex/CONDUCTOR.md +148 -0
  156. package/.versions/1.0.3/docs/ARCHITECTURE.md +375 -0
  157. package/.versions/1.0.3/docs/agent-fleet-setup.md +468 -0
  158. package/.versions/1.0.3/docs/claude-code-coms-bridge.md +128 -0
  159. package/.versions/1.0.3/docs/codex-remote-conductor.md +170 -0
  160. package/.versions/1.0.3/docs/coms-hermes-bridge.md +189 -0
  161. package/.versions/1.0.3/docs/getting-started.md +98 -0
  162. package/.versions/1.0.3/docs/npm-install.md +292 -0
  163. package/.versions/1.0.3/docs/pi-extensions.md +441 -0
  164. package/.versions/1.0.3/docs/pi-setup.md +74 -0
  165. package/.versions/1.0.3/docs/skill-anatomy.md +150 -0
  166. package/.versions/1.0.3/hermes/README.md +347 -0
  167. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  168. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  169. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  170. package/.versions/1.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  171. package/.versions/1.0.3/hermes/gates/gate-o-capability.md +8 -0
  172. package/.versions/1.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  173. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  174. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  175. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  176. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  177. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  178. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  179. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  180. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  181. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  182. package/.versions/1.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  183. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  184. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  185. package/.versions/1.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  186. package/.versions/1.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  187. package/.versions/1.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  188. package/.versions/1.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  189. package/.versions/1.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  190. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  191. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  192. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  193. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  194. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  195. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  196. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  197. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  198. package/.versions/1.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  199. package/.versions/1.0.3/hermes/watchdog-tests/__init__.py +0 -0
  200. package/.versions/1.0.3/hooks/coms-stop-hook.mjs +84 -0
  201. package/.versions/1.0.3/install-manifest.json +2745 -0
  202. package/.versions/1.0.3/justfile +272 -0
  203. package/.versions/1.0.3/manifest-meta.json +882 -0
  204. package/.versions/1.0.3/references/accessibility-checklist.md +160 -0
  205. package/.versions/1.0.3/references/definition-of-done.md +67 -0
  206. package/.versions/1.0.3/references/fleet-coordination-patterns.md +151 -0
  207. package/.versions/1.0.3/references/observability-checklist.md +91 -0
  208. package/.versions/1.0.3/references/orchestration-patterns.md +370 -0
  209. package/.versions/1.0.3/references/performance-checklist.md +153 -0
  210. package/.versions/1.0.3/references/prompting-patterns.md +380 -0
  211. package/.versions/1.0.3/references/security-checklist.md +179 -0
  212. package/.versions/1.0.3/references/testing-patterns.md +236 -0
  213. package/.versions/1.0.3/scripts/codex-conductor.ts +41 -0
  214. package/.versions/1.0.3/scripts/codex-remote-control.ts +167 -0
  215. package/.versions/1.0.3/scripts/coms-claude-bridge.ts +411 -0
  216. package/.versions/1.0.3/scripts/coms-cli.ts +484 -0
  217. package/.versions/1.0.3/scripts/coms-hermes-bridge.ts +413 -0
  218. package/.versions/1.0.3/scripts/fleet.ts +185 -0
  219. package/.versions/1.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  220. package/.versions/1.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  221. package/.versions/1.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  222. package/.versions/1.0.3/scripts/install-hermes-plugin.sh +180 -0
  223. package/.versions/1.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  224. package/.versions/1.0.3/scripts/lib/codex-conductor.ts +88 -0
  225. package/.versions/1.0.3/scripts/lib/codex-remote-control.ts +480 -0
  226. package/.versions/1.0.3/scripts/lib/coms-envelope.ts +582 -0
  227. package/.versions/1.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  228. package/.versions/1.0.3/scripts/lib/fleet-command.ts +266 -0
  229. package/.versions/1.0.3/scripts/lib/herdr-layout.ts +281 -0
  230. package/.versions/1.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  231. package/.versions/1.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  232. package/.versions/1.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  233. package/.versions/1.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  234. package/.versions/1.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  235. package/.versions/1.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  236. package/.versions/1.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  237. package/.versions/1.0.3/scripts/lib/monitor-env.ts +146 -0
  238. package/.versions/1.0.3/scripts/lib/peer-launch.ts +318 -0
  239. package/.versions/1.0.3/scripts/lib/persona-banner.ts +62 -0
  240. package/.versions/1.0.3/scripts/lib/spawn-stagger.ts +101 -0
  241. package/.versions/1.0.3/scripts/lib/team-project.ts +213 -0
  242. package/.versions/1.0.3/scripts/lib/team-snapshot.ts +147 -0
  243. package/.versions/1.0.3/scripts/peer-banner.ts +40 -0
  244. package/.versions/1.0.3/scripts/peer-launch.ts +259 -0
  245. package/.versions/1.0.3/scripts/team-snapshot.ts +237 -0
  246. package/.versions/1.0.3/scripts/team-up.ts +406 -0
  247. package/.versions/1.0.3/skills/_internal/grilling.md +11 -0
  248. package/.versions/1.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  249. package/.versions/1.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  250. package/.versions/1.0.3/skills/compound-learning/SKILL.md +137 -0
  251. package/.versions/1.0.3/skills/context-engineering/SKILL.md +291 -0
  252. package/.versions/1.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  253. package/.versions/1.0.3/skills/designing-agents/SKILL.md +394 -0
  254. package/.versions/1.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  255. package/.versions/1.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  256. package/.versions/1.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  257. package/.versions/1.0.3/skills/idea-refine/SKILL.md +182 -0
  258. package/.versions/1.0.3/skills/idea-refine/examples.md +238 -0
  259. package/.versions/1.0.3/skills/idea-refine/frameworks.md +99 -0
  260. package/.versions/1.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  261. package/.versions/1.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  262. package/.versions/1.0.3/skills/incremental-implementation/SKILL.md +287 -0
  263. package/.versions/1.0.3/skills/interview-me/SKILL.md +226 -0
  264. package/.versions/1.0.3/skills/orchestration-verification/SKILL.md +181 -0
  265. package/.versions/1.0.3/skills/peer-coms/SKILL.md +90 -0
  266. package/.versions/1.0.3/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/1.0.3/skills/planning-and-task-breakdown/SKILL.md +254 -0
  268. package/.versions/1.0.3/skills/security-and-hardening/SKILL.md +461 -0
  269. package/.versions/1.0.3/skills/spec-driven-development/SKILL.md +257 -0
  270. package/.versions/1.0.3/skills/using-agent-skills/SKILL.md +199 -0
  271. package/.versions/1.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  272. package/.versions/1.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  273. package/.versions/1.0.3/vendor/agent-skills-upstream/README.md +11 -0
  274. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  275. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  276. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  277. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  278. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  279. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  280. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  281. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  282. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  283. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  284. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  285. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  286. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  287. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  288. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  289. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  290. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  291. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  292. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  293. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  294. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  295. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  296. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  297. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  298. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  299. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  300. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  301. package/.versions/1.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  302. package/CHANGELOG.md +6 -0
  303. package/README.md +5 -4
  304. package/agents/architect.md +1 -0
  305. package/agents/bowser.md +1 -0
  306. package/agents/builder.md +1 -0
  307. package/agents/code-reviewer.md +1 -0
  308. package/agents/deep-researcher.md +1 -0
  309. package/agents/documenter.md +1 -0
  310. package/agents/orchestrator.md +1 -0
  311. package/agents/plan-reviewer.md +1 -0
  312. package/agents/planner.md +1 -0
  313. package/agents/releaser.md +1 -0
  314. package/agents/researcher.md +1 -0
  315. package/agents/security-auditor.md +1 -0
  316. package/agents/test-engineer.md +1 -0
  317. package/agents/web-debugger.md +1 -0
  318. package/agents/web-performance-auditor.md +1 -0
  319. package/bin/lib/validate-overrides.js +1 -1
  320. package/docs/ARCHITECTURE.md +25 -19
  321. package/docs/agent-fleet-setup.md +8 -8
  322. package/docs/pi-extensions.md +4 -2
  323. package/install-manifest.json +1 -1
  324. package/package.json +2 -2
  325. package/scripts/fleet.ts +1 -1
@@ -0,0 +1,147 @@
1
+ // scripts/lib/team-snapshot.ts
2
+ //
3
+ // Pure logic for fleet resume (B5): snapshot a running team (peer manifest +
4
+ // per-peer session resume refs harvested from herdr) and rebuild it later.
5
+ // See docs/plans/herdr/b5-resume-notes.md for the decisions: pane exit closes
6
+ // the pane (nothing to re-attach), layout.export cannot target an unfocused
7
+ // workspace, so snapshots store peers + refs and the grid is regenerated with
8
+ // the same builder team-up uses.
9
+ //
10
+ // No sockets, no fs, no process.exit here — the wiring lives in
11
+ // scripts/team-snapshot.ts.
12
+
13
+ import type { Peer } from "./herdr-layout.ts";
14
+ import { DEFAULT_PROJECT, teamWorkspaceLabel, validateProject, validateTeamName } from "./team-project.ts";
15
+
16
+ // Shape of herdr's agent_session (agent.list): pi panes carry
17
+ // {kind:"path", value:<session .jsonl>}, claude panes {kind:"id", value:<uuid>}.
18
+ export interface ResumeRef {
19
+ kind: string;
20
+ value: string;
21
+ }
22
+
23
+ export interface PeerSnapshot extends Peer {
24
+ resume: ResumeRef | null;
25
+ }
26
+
27
+ export interface TeamSnapshot {
28
+ version: 1;
29
+ team: string;
30
+ project: string;
31
+ hub: boolean;
32
+ workspace_label: string;
33
+ taken_at: string;
34
+ peers: PeerSnapshot[];
35
+ }
36
+
37
+ // Minimal shapes of the herdr responses the builder joins over.
38
+ export interface PaneLite {
39
+ pane_id: string;
40
+ label?: string;
41
+ [key: string]: unknown;
42
+ }
43
+ export interface AgentLite {
44
+ pane_id?: string;
45
+ agent?: string;
46
+ agent_session?: { kind?: string; value?: string };
47
+ [key: string]: unknown;
48
+ }
49
+
50
+ // Join: peers.yaml manifest × pane labels (pane label = peer name, set by the
51
+ // layout) × agent sessions (keyed by pane_id). A peer whose pane or session
52
+ // is missing snapshots with resume: null — it will start fresh on resume.
53
+ export function buildSnapshot(opts: {
54
+ team: string;
55
+ hub: boolean;
56
+ peers: Peer[];
57
+ panes: PaneLite[];
58
+ agents: AgentLite[];
59
+ now?: Date;
60
+ project?: string;
61
+ tag?: string;
62
+ }): TeamSnapshot {
63
+ const { team, hub, peers, panes, agents, project = DEFAULT_PROJECT, tag } = opts;
64
+ validateTeamName(team);
65
+ validateProject(project);
66
+ const paneByLabel = new Map<string, string>();
67
+ for (const p of panes) {
68
+ if (p.label) paneByLabel.set(p.label, p.pane_id);
69
+ }
70
+ const sessionByPane = new Map<string, ResumeRef>();
71
+ for (const a of agents) {
72
+ const s = a.agent_session;
73
+ if (a.pane_id && s && typeof s.kind === "string" && typeof s.value === "string") {
74
+ sessionByPane.set(a.pane_id, { kind: s.kind, value: s.value });
75
+ }
76
+ }
77
+ return {
78
+ version: 1,
79
+ team,
80
+ project,
81
+ hub,
82
+ workspace_label: teamWorkspaceLabel(hub ? "hub" : "peers", team, project, tag),
83
+ taken_at: (opts.now ?? new Date()).toISOString(),
84
+ peers: peers.map((peer) => {
85
+ const paneId = peer.name ? paneByLabel.get(peer.name) : undefined;
86
+ const resume = paneId ? sessionByPane.get(paneId) ?? null : null;
87
+ return { ...peer, resume };
88
+ }),
89
+ };
90
+ }
91
+
92
+ // The resume ref usable by this peer's launch recipe, or undefined to start
93
+ // fresh. `refUsable` is injected (fs check for pi paths); refs of kinds the
94
+ // recipes cannot consume yet (e.g. claude ids before the Phase-4 runner
95
+ // lands) resolve undefined with a reason via `onSkip`.
96
+ export function resumeRefForPeer(
97
+ peer: PeerSnapshot,
98
+ refUsable: (ref: ResumeRef) => boolean,
99
+ onSkip?: (peer: PeerSnapshot, reason: string) => void,
100
+ ): string | undefined {
101
+ if (!peer.resume) {
102
+ onSkip?.(peer, "no session ref in snapshot — starting fresh");
103
+ return undefined;
104
+ }
105
+ // pi peers resume by session file path; claude-code peers by session id
106
+ // (herdr reports {kind:"id"} for claude — `claude --resume <id>`).
107
+ const wantKind = peer.runner === "claude-code" ? "id" : "path";
108
+ if (peer.resume.kind !== wantKind) {
109
+ onSkip?.(peer, `unsupported resume kind "${peer.resume.kind}" — starting fresh`);
110
+ return undefined;
111
+ }
112
+ if (!refUsable(peer.resume)) {
113
+ onSkip?.(peer, `session file gone (${peer.resume.value}) — starting fresh`);
114
+ return undefined;
115
+ }
116
+ return peer.resume.value;
117
+ }
118
+
119
+ export function parseSnapshot(raw: string): TeamSnapshot {
120
+ let parsed: unknown;
121
+ try {
122
+ parsed = JSON.parse(raw);
123
+ } catch (err) {
124
+ throw new Error(`Snapshot is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
125
+ }
126
+ const s = parsed as TeamSnapshot;
127
+ if (!s || s.version !== 1 || typeof s.team !== "string" || !Array.isArray(s.peers)) {
128
+ throw new Error("Snapshot has an unexpected shape (want {version:1, team, peers[]}).");
129
+ }
130
+ validateTeamName(s.team);
131
+ if (!("project" in (s as Record<string, unknown>))) {
132
+ (s as { project: string }).project = DEFAULT_PROJECT;
133
+ } else if (typeof (s as { project?: unknown }).project !== "string") {
134
+ throw new Error("Snapshot has an unexpected shape (project must be a string when present).");
135
+ }
136
+ validateProject(s.project);
137
+ return s;
138
+ }
139
+
140
+ export function assertSnapshotProject(snap: TeamSnapshot, requestedProject: string): void {
141
+ validateProject(requestedProject);
142
+ if (snap.project !== requestedProject) {
143
+ throw new Error(
144
+ `Snapshot project mismatch: snapshot is ${JSON.stringify(snap.project)}, requested ${JSON.stringify(requestedProject)}.`,
145
+ );
146
+ }
147
+ }
@@ -0,0 +1,40 @@
1
+ // scripts/peer-banner.ts
2
+ //
3
+ // Print a colored identity banner for a peer pane. Called by the hidden
4
+ // `just _peer`/`_peer-plus` recipes right before exec'ing pi, so every pane
5
+ // announces who lives in it. Never fails the recipe: any problem (missing
6
+ // persona, unreadable file) degrades to a plain banner and exit 0.
7
+ //
8
+ // usage: peer-banner.ts <persona> [<name>]
9
+
10
+ import * as fs from "node:fs";
11
+ import * as path from "node:path";
12
+ import { fileURLToPath } from "node:url";
13
+
14
+ import { parsePersonaFrontmatter, renderBanner } from "./lib/persona-banner.ts";
15
+
16
+ const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
17
+ const REPO_ROOT = path.resolve(SCRIPT_DIR, "..");
18
+
19
+ function main(): void {
20
+ const [persona, nameArg] = process.argv.slice(2);
21
+ if (!persona) return;
22
+ const name = nameArg || persona;
23
+
24
+ let meta = {};
25
+ for (const dir of ["agents", path.join(".pi", "agents")]) {
26
+ const p = path.join(REPO_ROOT, dir, `${persona}.md`);
27
+ try {
28
+ meta = parsePersonaFrontmatter(fs.readFileSync(p, "utf-8"));
29
+ break;
30
+ } catch {
31
+ // try the next location; fall through to a plain banner
32
+ }
33
+ }
34
+
35
+ const width = process.stdout.columns ? Math.min(process.stdout.columns, 100) : 60;
36
+ for (const line of renderBanner(name, meta, width)) console.log(line);
37
+ }
38
+
39
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
40
+ if (isEntry) main();
@@ -0,0 +1,259 @@
1
+ // scripts/peer-launch.ts
2
+ //
3
+ // `just fleet peer <name>` — launch ONE coms peer (pi persona, personaless
4
+ // Fleet Core pi, or Claude Code) without declaring it in a peers.yaml team.
5
+ //
6
+ // Placement:
7
+ // • default, inside a herdr pane (HERDR_ENV=1) → split THIS pane, so the peer
8
+ // lands next to the session that asked for it;
9
+ // • default, outside herdr → create a single-pane workspace labelled
10
+ // <worktree-tag>-peer-<name>, refusing to clobber an existing one;
11
+ // • --here → run in the CALLING terminal, which is what this command did
12
+ // before pane placement existed.
13
+ //
14
+ // Hard rules (same as team-up.ts, for the same reasons):
15
+ // - Entrypoint guard: importing this module must NOT spawn anything.
16
+ // - peers.yaml + the repo root resolve relative to THIS file, not the caller's cwd.
17
+ // - --dry-run prints the plan and exits WITHOUT touching herdr, and never reads
18
+ // env_file values — secrets stay out of terminals and logs.
19
+ // - A split pane gets its argv TYPED at the shell prompt: herdr's pane.split
20
+ // takes no command and silently ignores one (see spawned-peers.js).
21
+
22
+ import { spawnSync } from "node:child_process";
23
+ import * as fs from "node:fs";
24
+ import * as path from "node:path";
25
+ import { fileURLToPath } from "node:url";
26
+
27
+ import { launchPeerInPane, PANE_PROMPT_TIMEOUT_MS, PEER_READY_TIMEOUT_MS, peerReadyDelayMs } from "../.pi/harnesses/lib/spawned-peers.js";
28
+ import { pruneDeadEntries } from "./lib/coms-envelope.ts";
29
+ import { parseEnvFile, resolveEnvFilePath, type LayoutNode } from "./lib/herdr-layout.ts";
30
+ import { buildPeerLaunchPlan, parsePeerArgs, type PeerLaunchPlan } from "./lib/peer-launch.ts";
31
+ import { worktreeTag } from "./lib/team-project.ts";
32
+
33
+ const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
34
+ const REPO_ROOT = fs.realpathSync(path.resolve(SCRIPT_DIR, ".."));
35
+ const PEERS_YAML = path.join(REPO_ROOT, ".pi", "agents", "peers.yaml");
36
+
37
+ const USAGE =
38
+ "usage: just fleet peer <name> [--runner pi|claude-code] [--persona <p>] [--model <m>] [--project <p>]\n" +
39
+ " [--extensions a,b] [--browser] [--all-extensions]\n" +
40
+ " [--direction right|down] [--here] [--dry-run] [-- PI_ARGS…]";
41
+
42
+ function die(msg: string): never {
43
+ console.error(msg);
44
+ process.exit(1);
45
+ }
46
+
47
+ function personaExists(persona: string): boolean {
48
+ return (
49
+ fs.existsSync(path.join(REPO_ROOT, "agents", `${persona}.md`)) ||
50
+ fs.existsSync(path.join(REPO_ROOT, ".pi", "agents", `${persona}.md`))
51
+ );
52
+ }
53
+
54
+ function readIfPresent(file: string): string {
55
+ try {
56
+ return fs.readFileSync(file, "utf-8");
57
+ } catch {
58
+ return "";
59
+ }
60
+ }
61
+
62
+ /** The pane's extra env: only the declaration's env_file, never on the dry-run path. */
63
+ function paneEnv(plan: PeerLaunchPlan): Record<string, string> {
64
+ if (!plan.envFile) return {};
65
+ const abs = resolveEnvFilePath(plan.envFile, REPO_ROOT);
66
+ if (!fs.existsSync(abs)) die(`Peer "${plan.name}": env_file not found: ${plan.envFile} (resolved: ${abs})`);
67
+ return parseEnvFile(fs.readFileSync(abs, "utf-8"), plan.envFile);
68
+ }
69
+
70
+ /** Poll the coms registry until the peer registers, or the budget runs out. */
71
+ async function waitForRegistration(plan: PeerLaunchPlan): Promise<{ found: boolean; waitedMs: number }> {
72
+ const wanted = plan.name.toLowerCase();
73
+ const started = Date.now();
74
+ for (let attempt = 0; ; attempt++) {
75
+ let live: { name: string }[] = [];
76
+ try {
77
+ live = pruneDeadEntries(plan.project);
78
+ } catch {
79
+ // Registry not readable yet; the timeout below bounds the wait.
80
+ }
81
+ if (live.some((entry) => entry.name.toLowerCase() === wanted)) {
82
+ return { found: true, waitedMs: Date.now() - started };
83
+ }
84
+ const remaining = PEER_READY_TIMEOUT_MS - (Date.now() - started);
85
+ if (remaining <= 0) return { found: false, waitedMs: Date.now() - started };
86
+ await new Promise((r) => setTimeout(r, Math.min(peerReadyDelayMs(attempt), remaining)));
87
+ }
88
+ }
89
+
90
+ async function main(): Promise<void> {
91
+ let args;
92
+ try {
93
+ args = parsePeerArgs(process.argv.slice(2));
94
+ } catch (err) {
95
+ console.error(`fleet peer: ${err instanceof Error ? err.message : String(err)}`);
96
+ console.error(USAGE);
97
+ process.exit(2);
98
+ }
99
+
100
+ let plan: PeerLaunchPlan;
101
+ try {
102
+ plan = buildPeerLaunchPlan(args, {
103
+ peersYaml: readIfPresent(args.peersYaml ?? PEERS_YAML),
104
+ personaExists,
105
+ worktreeTag: worktreeTag(REPO_ROOT),
106
+ });
107
+ } catch (err) {
108
+ die(`fleet peer: ${err instanceof Error ? err.message : String(err)}`);
109
+ }
110
+
111
+ const inPane = process.env.HERDR_ENV === "1" ? process.env.HERDR_PANE_ID || null : null;
112
+
113
+ if (args.dryRun) {
114
+ // No herdr calls and no env_file reads on this path.
115
+ const placement =
116
+ plan.placement === "here"
117
+ ? "this terminal"
118
+ : inPane
119
+ ? `split of pane ${inPane} (${plan.direction})`
120
+ : `new workspace "${plan.workspaceLabel}"`;
121
+ const envNote = plan.envFile ? ` [env_file: ${plan.envFile} — values redacted]` : "";
122
+ const source = plan.declared ? "peers.yaml declaration + flags" : "flags only";
123
+ console.log(`# fleet peer (dry run) — "${plan.name}" [${plan.kind}], project "${plan.project}", ${source}`);
124
+ console.log(`# placement: ${placement}`);
125
+ console.log(`${plan.name}\t${plan.command.join(" ")}${envNote}`);
126
+ console.log(JSON.stringify(plan, null, 2));
127
+ return;
128
+ }
129
+
130
+ // --here: become the peer in this terminal. The env_file is applied to our
131
+ // own child rather than to a pane, and there is nothing to wait for — the
132
+ // peer is the foreground process.
133
+ if (plan.placement === "here") {
134
+ const [bin, ...rest] = plan.command;
135
+ const result = spawnSync(bin, rest, {
136
+ stdio: "inherit",
137
+ cwd: REPO_ROOT,
138
+ env: { ...process.env, ...paneEnv(plan) },
139
+ });
140
+ if (result.error) die(`fleet peer: could not run ${bin}: ${result.error.message}`);
141
+ process.exitCode = result.status ?? 1;
142
+ return;
143
+ }
144
+
145
+ const env = paneEnv(plan);
146
+
147
+ // Import lazily so --dry-run and --here never touch the client (or the socket).
148
+ const { herdr, requireHerdr, HerdrUnavailableError } = await import("../.pi/harnesses/lib/herdr-client.ts");
149
+ try {
150
+ await requireHerdr();
151
+ } catch (err) {
152
+ if (err instanceof HerdrUnavailableError) {
153
+ console.error(err.message);
154
+ console.error(`(no herdr? run it in this terminal instead: just fleet peer ${plan.name} --here)`);
155
+ process.exit(1);
156
+ }
157
+ throw err;
158
+ }
159
+
160
+ let paneId: string;
161
+ if (inPane) {
162
+ const { pane } = await herdr.paneSplit({
163
+ target_pane_id: inPane,
164
+ direction: plan.direction,
165
+ cwd: REPO_ROOT,
166
+ ...(Object.keys(env).length > 0 ? { env } : {}),
167
+ focus: false,
168
+ });
169
+ paneId = pane.pane_id;
170
+ try {
171
+ await herdr.paneRename(paneId, plan.name);
172
+ } catch {
173
+ // non-fatal: an unlabelled pane is cosmetic
174
+ }
175
+ // pane.split opens a bare shell — the argv has to be typed into it.
176
+ const launch = await launchPeerInPane(herdr, paneId, plan.command);
177
+ if (!launch.promptSeen) {
178
+ console.error(`⚠ pane ${paneId} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`);
179
+ }
180
+ console.log(`Launched ${plan.name} [${plan.kind}] in pane ${paneId}: ${plan.command.join(" ")}`);
181
+ } else {
182
+ const { workspaces } = await herdr.workspaceList();
183
+ const existing = workspaces.find((w) => w.label === plan.workspaceLabel);
184
+ if (existing) {
185
+ console.error(`herdr workspace "${plan.workspaceLabel}" already exists (${existing.workspace_id}).`);
186
+ console.error(` focus: herdr workspace focus ${existing.workspace_id}`);
187
+ console.error(` close: herdr workspace close ${existing.workspace_id}`);
188
+ process.exit(1);
189
+ }
190
+ const created = await herdr.workspaceCreate({ label: plan.workspaceLabel, cwd: REPO_ROOT, focus: false });
191
+ const wsId = created.workspace.workspace_id;
192
+ const initialTab = created.workspace.active_tab_id ?? created.tab?.tab_id;
193
+ // layout.apply pane nodes DO carry an argv, so no prompt-typing here.
194
+ const root: LayoutNode = {
195
+ type: "pane",
196
+ command: plan.command,
197
+ cwd: REPO_ROOT,
198
+ label: plan.name,
199
+ ...(Object.keys(env).length > 0 ? { env } : {}),
200
+ };
201
+ await herdr.layoutApply({ workspace_id: wsId, root });
202
+ if (initialTab) {
203
+ try {
204
+ await herdr.tabClose(initialTab);
205
+ } catch {
206
+ // non-fatal: an extra empty tab is cosmetic
207
+ }
208
+ }
209
+ // layout.apply assigns the pane id; resolve it by label so the readiness
210
+ // report can quote the pane's own output when the peer never registers.
211
+ paneId = await paneIdByLabel(herdr, wsId, plan.name);
212
+ console.log(`Launched ${plan.name} [${plan.kind}] in herdr workspace "${plan.workspaceLabel}" (${wsId}): ${plan.command.join(" ")}`);
213
+ console.log(`Focus: herdr workspace focus ${wsId}`);
214
+ console.log(`Close: herdr workspace close ${wsId}`);
215
+ }
216
+
217
+ // A peer that never registers is a FAILED start, not a slow one — say so
218
+ // rather than leaving the caller to guess from a pane id.
219
+ const { found, waitedMs } = await waitForRegistration(plan);
220
+ if (found) {
221
+ console.log(
222
+ `Peer "${plan.name}" is ready in pane ${paneId} after ${Math.round(waitedMs / 1000)}s — ` +
223
+ `address it with: node --experimental-strip-types scripts/coms-cli.ts send ${plan.name} "…" --project ${plan.project} --name <you>\n` +
224
+ "It boots idle and does no work until you send.",
225
+ );
226
+ return;
227
+ }
228
+ const tail = (await paneTail(herdr, paneId)).trim();
229
+ console.error(
230
+ `Peer "${plan.name}" did not register in the coms pool within ${Math.round(PEER_READY_TIMEOUT_MS / 1000)}s — ` +
231
+ "assume it failed to start rather than that it is slow. Do not send to it." +
232
+ (tail ? `\n\nLast output of pane ${paneId}:\n${tail}` : ""),
233
+ );
234
+ process.exitCode = 1;
235
+ }
236
+
237
+ /** Pane id of the pane labelled `label` in a workspace; "?" when unresolvable. */
238
+ async function paneIdByLabel(client: { paneList(p: { workspace_id?: string }): Promise<{ panes: { pane_id: string; label?: string }[] }> }, workspaceId: string, label: string): Promise<string> {
239
+ try {
240
+ const { panes } = await client.paneList({ workspace_id: workspaceId });
241
+ return panes.find((p) => p.label === label)?.pane_id ?? panes[0]?.pane_id ?? "?";
242
+ } catch {
243
+ return "?";
244
+ }
245
+ }
246
+
247
+ /** Last lines of a pane, for reporting why a launch failed. Never throws. */
248
+ async function paneTail(client: { paneRead(p: { pane_id: string; lines: number }): Promise<{ read: { text?: string } }> }, paneId: string, lines = 12): Promise<string> {
249
+ if (paneId === "?") return "";
250
+ try {
251
+ const { read } = await client.paneRead({ pane_id: paneId, lines });
252
+ return read?.text ?? "";
253
+ } catch {
254
+ return "";
255
+ }
256
+ }
257
+
258
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
259
+ if (isEntry) void main();
@@ -0,0 +1,237 @@
1
+ // scripts/team-snapshot.ts
2
+ //
3
+ // Fleet resume (B5): snapshot / tear down / rebuild a running peer team.
4
+ // Backs `just fleet snapshot`, `just fleet down`, and `just fleet resume`. herdr is a hard dependency (requireHerdr refuses readably).
5
+ //
6
+ // snapshot <team> — capture peers + per-peer session refs to
7
+ // ~/.pi/team-snapshots/<team>.json (team keeps running)
8
+ // down <team> — snapshot, then workspace.close (peers get SIGTERM →
9
+ // coms clean shutdown removes their registry entries)
10
+ // resume <team> — rebuild the workspace from the snapshot; every pi peer
11
+ // relaunches with `--session <ref>` and continues its
12
+ // conversation; peers whose ref is gone start fresh with
13
+ // a warning
14
+ //
15
+ // Snapshots live OUTSIDE the repo (~/.pi/team-snapshots/) because
16
+ // .pi/agent-sessions/ is wiped at hub session start. Pure logic in
17
+ // scripts/lib/team-snapshot.ts; entrypoint-guarded like team-up.
18
+
19
+ import * as fs from "node:fs";
20
+ import * as os from "node:os";
21
+ import * as path from "node:path";
22
+ import { fileURLToPath } from "node:url";
23
+
24
+ import { buildTeamLayout, parsePeersYaml, type Peer } from "./lib/herdr-layout.ts";
25
+ import { planSpawnDelays } from "./lib/spawn-stagger.ts";
26
+ import { DEFAULT_PROJECT, hubCommand, parseProjectFlag, teamSnapshotPath, teamWorkspaceLabel, validateTeamName, worktreeTag } from "./lib/team-project.ts";
27
+ import {
28
+ assertSnapshotProject,
29
+ buildSnapshot,
30
+ parseSnapshot,
31
+ resumeRefForPeer,
32
+ type PeerSnapshot,
33
+ type TeamSnapshot,
34
+ } from "./lib/team-snapshot.ts";
35
+
36
+ const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
37
+ const REPO_ROOT = path.resolve(SCRIPT_DIR, "..");
38
+ // Must match team-up's tag so down/resume target the workspace it created.
39
+ const WORKTREE_TAG = worktreeTag(REPO_ROOT);
40
+ const PEERS_YAML = path.join(REPO_ROOT, ".pi", "agents", "peers.yaml");
41
+ const SNAPSHOT_DIR = path.join(os.homedir(), ".pi", "team-snapshots");
42
+
43
+ function die(msg: string): never {
44
+ console.error(msg);
45
+ process.exit(1);
46
+ }
47
+
48
+ function snapshotPath(team: string, project = DEFAULT_PROJECT): string {
49
+ try {
50
+ return teamSnapshotPath(SNAPSHOT_DIR, team, project);
51
+ } catch (err) {
52
+ die(err instanceof Error ? err.message : String(err));
53
+ }
54
+ }
55
+
56
+ async function requireClient() {
57
+ const client = await import("../.pi/harnesses/lib/herdr-client.ts");
58
+ try {
59
+ await client.requireHerdr();
60
+ } catch (err) {
61
+ if (err instanceof client.HerdrUnavailableError) die(err.message);
62
+ throw err;
63
+ }
64
+ return client;
65
+ }
66
+
67
+ type Client = Awaited<ReturnType<typeof requireClient>>;
68
+
69
+ async function findTeamWorkspace(client: Client, team: string, project = DEFAULT_PROJECT) {
70
+ let peersLabel: string;
71
+ let hubLabel: string;
72
+ try {
73
+ peersLabel = teamWorkspaceLabel("peers", team, project, WORKTREE_TAG);
74
+ hubLabel = teamWorkspaceLabel("hub", team, project, WORKTREE_TAG);
75
+ } catch (err) {
76
+ die(err instanceof Error ? err.message : String(err));
77
+ }
78
+ const { workspaces } = await client.herdr.workspaceList();
79
+ return workspaces.find((w) => w.label === peersLabel) ?? workspaces.find((w) => w.label === hubLabel) ?? null;
80
+ }
81
+
82
+ async function captureSnapshot(client: Client, team: string, project = DEFAULT_PROJECT): Promise<TeamSnapshot> {
83
+ const peersLabel = teamWorkspaceLabel("peers", team, project, WORKTREE_TAG);
84
+ const hubLabel = teamWorkspaceLabel("hub", team, project, WORKTREE_TAG);
85
+ const ws = await findTeamWorkspace(client, team, project);
86
+ if (!ws) {
87
+ const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
88
+ die(
89
+ `No running workspace "${peersLabel}" or "${hubLabel}" found.\n` +
90
+ `Start one with: just fleet team ${team}${projectArgs} (or add --no-hub for peers only)`,
91
+ );
92
+ }
93
+ if (!fs.existsSync(PEERS_YAML)) die(`peers.yaml not found at ${PEERS_YAML}`);
94
+ const teams = parsePeersYaml(fs.readFileSync(PEERS_YAML, "utf-8"));
95
+ const peers = teams[team];
96
+ if (!peers) die(`Team "${team}" not found in peers.yaml.`);
97
+
98
+ const { panes } = await client.herdr.paneList({ workspace_id: ws.workspace_id });
99
+ const { agents } = await client.herdr.agentList();
100
+ const inWorkspace = agents.filter((a) => (a as { workspace_id?: string }).workspace_id === ws.workspace_id);
101
+
102
+ const snap = buildSnapshot({
103
+ team,
104
+ project,
105
+ hub: ws.label === hubLabel,
106
+ peers,
107
+ panes,
108
+ agents: inWorkspace as Parameters<typeof buildSnapshot>[0]["agents"],
109
+ tag: WORKTREE_TAG,
110
+ });
111
+ const file = snapshotPath(team, project);
112
+ fs.mkdirSync(path.dirname(file), { recursive: true });
113
+ fs.writeFileSync(file, JSON.stringify(snap, null, 2) + "\n");
114
+ const withRef = snap.peers.filter((p) => p.resume).length;
115
+ console.log(`Snapshot: ${file} — ${snap.peers.length} peer(s), ${withRef} with a session ref.`);
116
+ return snap;
117
+ }
118
+
119
+ async function cmdSnapshot(team: string, project = DEFAULT_PROJECT): Promise<void> {
120
+ const client = await requireClient();
121
+ await captureSnapshot(client, team, project);
122
+ }
123
+
124
+ async function cmdDown(team: string, project = DEFAULT_PROJECT): Promise<void> {
125
+ const client = await requireClient();
126
+ await captureSnapshot(client, team, project);
127
+ const ws = await findTeamWorkspace(client, team, project);
128
+ if (ws) {
129
+ await client.herdr.workspaceClose(ws.workspace_id);
130
+ const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
131
+ console.log(`Closed workspace ${ws.workspace_id} ("${ws.label}"). Resume with: just fleet resume ${team}${projectArgs}`);
132
+ }
133
+ }
134
+
135
+ async function cmdResume(team: string, project = DEFAULT_PROJECT): Promise<void> {
136
+ const file = snapshotPath(team, project);
137
+ if (!fs.existsSync(file)) {
138
+ const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
139
+ die(`No snapshot at ${file}.\nTake one while the team runs: just fleet snapshot ${team}${projectArgs} (or just fleet down ${team}${projectArgs}).`);
140
+ }
141
+ const snap = parseSnapshot(fs.readFileSync(file, "utf-8"));
142
+ try {
143
+ assertSnapshotProject(snap, project);
144
+ if (snap.team !== team) throw new Error(`Snapshot team mismatch: snapshot is ${JSON.stringify(snap.team)}, requested ${JSON.stringify(team)}.`);
145
+ } catch (err) {
146
+ die(err instanceof Error ? err.message : String(err));
147
+ }
148
+
149
+ const client = await requireClient();
150
+ const existing = await findTeamWorkspace(client, team, project);
151
+ if (existing) {
152
+ die(
153
+ `Workspace "${existing.label}" (${existing.workspace_id}) is already running.\n` +
154
+ ` focus: herdr workspace focus ${existing.workspace_id}\n` +
155
+ ` close: herdr workspace close ${existing.workspace_id}`,
156
+ );
157
+ }
158
+
159
+ const resumedNames = new Set<string>();
160
+ const resumeFor = (peer: Peer): string | undefined => {
161
+ const ref = resumeRefForPeer(
162
+ peer as PeerSnapshot,
163
+ // path refs must still exist on disk; id refs (claude-code) cannot
164
+ // be pre-checked and are handed to `claude --resume` as-is
165
+ (r) => (r.kind === "id" ? true : fs.existsSync(r.value)),
166
+ (p, reason) => console.warn(` ⚠ ${p.name}: ${reason}`),
167
+ );
168
+ if (ref && peer.name) resumedNames.add(peer.name);
169
+ return ref;
170
+ };
171
+ const workspaceLabel = teamWorkspaceLabel(snap.hub ? "hub" : "peers", snap.team, project, WORKTREE_TAG);
172
+ // Resume relaunches every pane simultaneously, so it needs the same
173
+ // pre-warm/stagger as team-up (see scripts/lib/spawn-stagger.ts).
174
+ let authRaw: string | undefined;
175
+ try {
176
+ authRaw = fs.readFileSync(path.join(os.homedir(), ".pi", "agent", "auth.json"), "utf-8");
177
+ } catch {
178
+ authRaw = undefined;
179
+ }
180
+ const { needed: staggerNeeded, delayForPeer } = planSpawnDelays(snap.peers, snap.hub, authRaw);
181
+ if (staggerNeeded) {
182
+ console.log("Stale pi OAuth token detected — staggering pane starts so one pane can refresh it first.");
183
+ }
184
+ const layout = buildTeamLayout({
185
+ team: snap.team,
186
+ peers: snap.peers,
187
+ repoRoot: REPO_ROOT,
188
+ resumeForPeer: resumeFor,
189
+ delayForPeer,
190
+ project,
191
+ ...(snap.hub ? { hub: { command: hubCommand(project), label: "hub", ratio: 0.4 } } : {}),
192
+ });
193
+
194
+ const created = await client.herdr.workspaceCreate({
195
+ label: workspaceLabel,
196
+ cwd: REPO_ROOT,
197
+ focus: false,
198
+ });
199
+ const wsId = created.workspace.workspace_id;
200
+ const initialTab = created.workspace.active_tab_id ?? created.tab?.tab_id;
201
+ await client.herdr.layoutApply({ workspace_id: wsId, root: layout });
202
+ if (initialTab) {
203
+ try {
204
+ await client.herdr.tabClose(initialTab);
205
+ } catch {
206
+ // cosmetic
207
+ }
208
+ }
209
+ console.log(`Resumed team "${snap.team}" in workspace "${workspaceLabel}" (${wsId}):`);
210
+ for (const p of snap.peers) {
211
+ console.log(` • ${p.name}${p.name && resumedNames.has(p.name) ? " (session resumed)" : " (fresh)"}`);
212
+ }
213
+ console.log(`Focus: herdr workspace focus ${wsId}`);
214
+ }
215
+
216
+ async function main(): Promise<void> {
217
+ const argv = process.argv.slice(2);
218
+ const [cmd, team] = argv;
219
+ if (!cmd || !team) {
220
+ console.error("usage: team-snapshot.ts <snapshot|down|resume> <team> [--project <name>]");
221
+ process.exit(2);
222
+ }
223
+ let project = DEFAULT_PROJECT;
224
+ try {
225
+ validateTeamName(team);
226
+ project = parseProjectFlag(argv.slice(2));
227
+ } catch (err) {
228
+ die(err instanceof Error ? err.message : String(err));
229
+ }
230
+ if (cmd === "snapshot") return cmdSnapshot(team, project);
231
+ if (cmd === "down") return cmdDown(team, project);
232
+ if (cmd === "resume") return cmdResume(team, project);
233
+ die(`Unknown command "${cmd}" (want snapshot | down | resume).`);
234
+ }
235
+
236
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
237
+ if (isEntry) void main();