@chankov/agent-fleet 1.0.1 → 1.0.2

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 (316) hide show
  1. package/.pi/extensions/package-lock.json +77 -45
  2. package/.pi/harnesses/agent-hub/README.md +109 -18
  3. package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  4. package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  5. package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  6. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  7. package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  8. package/.pi/harnesses/agent-hub/hub-state-audit.js +18 -0
  9. package/.pi/harnesses/agent-hub/index.ts +988 -422
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  12. package/.pi/harnesses/agent-hub/run-budget.js +12 -13
  13. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  14. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  15. package/.pi/harnesses/coms/package.json +1 -1
  16. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  17. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  18. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  19. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  20. package/.pi/harnesses/lib/context-budget.ts +114 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
  22. package/.pi/harnesses/package-lock.json +73 -80
  23. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  25. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  26. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  27. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  28. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  29. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  30. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  31. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  32. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  33. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  34. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  35. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  36. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  37. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  38. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  39. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  40. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  41. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  42. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  43. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  44. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  45. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  46. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  47. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  48. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  49. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  50. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  51. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  52. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  53. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  54. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  55. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  56. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  57. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  58. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  59. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  60. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  61. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  62. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  63. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  64. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  65. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  66. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  67. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  68. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  69. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  70. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  71. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  72. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  73. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  74. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  75. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  76. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  77. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  78. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  79. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  80. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  81. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  82. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  83. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  84. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  85. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  86. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  87. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  88. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  89. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  90. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  91. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  92. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  93. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  94. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  95. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  96. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  97. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  98. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  99. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  100. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  101. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  102. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  103. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  104. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  105. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  106. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  107. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  108. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  109. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  110. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  111. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  112. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  113. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  114. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  115. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  116. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  117. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  118. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  119. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  120. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  121. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  122. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  123. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  124. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  125. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  126. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  127. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  128. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  129. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  130. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  131. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  132. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  133. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  134. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  135. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  136. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  137. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  138. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  139. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  140. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  141. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  142. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  143. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  144. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  145. package/.versions/1.0.2/.version +1 -0
  146. package/.versions/1.0.2/agents/architect.md +24 -0
  147. package/.versions/1.0.2/agents/bowser.md +27 -0
  148. package/.versions/1.0.2/agents/builder.md +54 -0
  149. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  150. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  151. package/.versions/1.0.2/agents/documenter.md +18 -0
  152. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  153. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  154. package/.versions/1.0.2/agents/planner.md +70 -0
  155. package/.versions/1.0.2/agents/releaser.md +24 -0
  156. package/.versions/1.0.2/agents/researcher.md +28 -0
  157. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  158. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  159. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  160. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  161. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  162. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  163. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  164. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  165. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  166. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  167. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  168. package/.versions/1.0.2/docs/getting-started.md +98 -0
  169. package/.versions/1.0.2/docs/npm-install.md +292 -0
  170. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  171. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  172. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  173. package/.versions/1.0.2/hermes/README.md +347 -0
  174. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  175. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  176. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  177. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  178. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  179. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  180. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  181. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  182. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  183. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  184. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  185. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  186. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  187. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  188. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  189. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  190. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  191. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  192. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  193. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  194. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  195. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  196. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  197. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  198. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  199. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  200. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  201. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  202. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  203. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  204. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  205. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  206. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  207. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  208. package/.versions/1.0.2/install-manifest.json +2745 -0
  209. package/.versions/1.0.2/justfile +272 -0
  210. package/.versions/1.0.2/manifest-meta.json +882 -0
  211. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  212. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  213. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  214. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  215. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  216. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  217. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  218. package/.versions/1.0.2/references/security-checklist.md +179 -0
  219. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  220. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  221. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  222. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  223. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  224. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  225. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  226. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  227. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  228. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  229. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  230. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  231. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  232. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  233. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  234. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  235. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  236. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  237. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  238. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  239. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  240. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  241. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  242. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  243. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  244. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  245. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  246. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  247. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  248. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  249. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  250. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  251. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  252. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  253. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  254. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  255. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  256. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  257. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  258. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  259. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  260. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  261. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  262. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  263. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  264. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  265. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  266. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  267. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  268. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  269. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  270. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  271. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  272. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  273. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  274. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  275. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  276. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  277. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  278. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  279. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  280. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  281. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  282. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  283. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  284. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  285. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  286. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  287. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  288. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  289. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  290. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  291. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  292. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  293. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  294. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  295. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  299. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  300. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  301. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  302. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  303. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  304. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  305. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  306. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  307. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  308. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  309. package/CHANGELOG.md +9 -0
  310. package/README.md +4 -2
  311. package/agents/orchestrator.md +4 -56
  312. package/docs/ARCHITECTURE.md +48 -16
  313. package/docs/agent-fleet-setup.md +33 -2
  314. package/docs/pi-extensions.md +29 -2
  315. package/install-manifest.json +2 -2
  316. package/package.json +2 -2
@@ -0,0 +1,266 @@
1
+ export interface FleetInvocation {
2
+ recipe: string;
3
+ args: string[];
4
+ warnings?: string[];
5
+ }
6
+
7
+ interface Capabilities {
8
+ browser: boolean;
9
+ voice: boolean;
10
+ allExtensions: boolean;
11
+ rest: string[];
12
+ }
13
+
14
+ function capabilities(args: string[]): Capabilities {
15
+ const rest: string[] = [];
16
+ let browser = false;
17
+ let voice = false;
18
+ let allExtensions = false;
19
+ for (const arg of args) {
20
+ if (arg === "--browser") browser = true;
21
+ else if (arg === "--voice") voice = true;
22
+ else if (arg === "--all-extensions") allExtensions = true;
23
+ else rest.push(arg);
24
+ }
25
+ return { browser, voice, allExtensions, rest };
26
+ }
27
+
28
+ function bool(value: boolean): string {
29
+ return value ? "true" : "false";
30
+ }
31
+
32
+ function requireValue(value: string | undefined, message: string): string {
33
+ if (!value || value.startsWith("--")) throw new Error(message);
34
+ return value;
35
+ }
36
+
37
+ function withoutFlag(args: string[], flag: string): { present: boolean; rest: string[] } {
38
+ return { present: args.includes(flag), rest: args.filter((arg) => arg !== flag) };
39
+ }
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
+
178
+ const CODEX_LIFECYCLE = new Set(["setup", "reconfigure", "pair", "start", "status", "stop", "recover", "uninstall"]);
179
+
180
+ export function parseFleetCommand(argv: string[]): FleetInvocation {
181
+ if (argv.length === 0 || argv[0].startsWith("--")) {
182
+ return parseHubInvocation(argv);
183
+ }
184
+
185
+ const [mode, ...tail] = argv;
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] };
192
+
193
+ // One addressable peer, in a pane of its own unless --here. peer-launch.ts
194
+ // owns the whole flag set (including `--` passthrough to pi), so the tail is
195
+ // forwarded verbatim rather than pre-chewed the way core/hub capabilities are.
196
+ if (mode === "peer") {
197
+ requireValue(tail[0], "fleet peer requires a peer name");
198
+ return { recipe: "_fleet-peer-launch", args: tail };
199
+ }
200
+
201
+ if (mode === "hub") {
202
+ return parseHubInvocation(tail, {
203
+ defaultAgents: "default",
204
+ warnings: ["`just fleet hub` is a compatibility alias; use `just fleet` with canonical flags."],
205
+ });
206
+ }
207
+
208
+ if (mode === "team") {
209
+ const team = requireValue(tail[0], "fleet team requires a team preset");
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
+ }
222
+ const dry = withoutFlag(noHub.rest, "--dry-run");
223
+ const c = capabilities(dry.rest);
224
+ if (c.browser || c.allExtensions) {
225
+ throw new Error("--browser/--all-extensions requires the hub; peer capabilities belong in .pi/agents/peers.yaml");
226
+ }
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
+ };
232
+ }
233
+
234
+ if (mode === "snapshot" || mode === "down" || mode === "resume") {
235
+ const team = requireValue(tail[0], `fleet ${mode} requires a team preset`);
236
+ return { recipe: `_fleet-team-${mode === "snapshot" ? "snapshot" : mode}`, args: [team, ...tail.slice(1)] };
237
+ }
238
+
239
+ if (mode === "conductor") {
240
+ const backend = requireValue(tail[0], "fleet conductor requires hermes or codex");
241
+ if (backend !== "hermes" && backend !== "codex") throw new Error(`Unknown conductor backend: ${backend}`);
242
+ const rest = tail.slice(1);
243
+ if (backend === "hermes") {
244
+ const team = rest[0] && !rest[0].startsWith("--") ? rest[0] : "full";
245
+ const afterTeam = rest[0] === team ? rest.slice(1) : rest;
246
+ const dry = withoutFlag(afterTeam, "--dry-run");
247
+ return { recipe: dry.present ? "_fleet-conductor-dry" : "_fleet-conductor", args: [team, ...dry.rest] };
248
+ }
249
+
250
+ const action = rest[0];
251
+ if (action && CODEX_LIFECYCLE.has(action)) {
252
+ if (action === "setup" || action === "reconfigure") {
253
+ const team = rest[1] && !rest[1].startsWith("--") ? rest[1] : "full";
254
+ const afterTeam = rest[1] === team ? rest.slice(2) : rest.slice(1);
255
+ return { recipe: `_fleet-conductor-codex-${action}`, args: [team, ...afterTeam] };
256
+ }
257
+ return { recipe: `_fleet-conductor-codex-${action}`, args: rest.slice(1) };
258
+ }
259
+ const team = action && !action.startsWith("--") ? action : "full";
260
+ const afterTeam = action === team ? rest.slice(1) : rest;
261
+ const dry = withoutFlag(afterTeam, "--dry-run");
262
+ return { recipe: dry.present ? "_fleet-conductor-codex-dry" : "_fleet-conductor-codex", args: [team, ...dry.rest] };
263
+ }
264
+
265
+ throw new Error(`Unknown fleet mode: ${mode}`);
266
+ }
@@ -0,0 +1,281 @@
1
+ // scripts/lib/herdr-layout.ts
2
+ //
3
+ // Pure logic for the herdr fleet recipes: peers.yaml parsing, peer→command
4
+ // construction, and peers.yaml team → herdr declarative layout tree (BSP
5
+ // splits, one pane per peer). No pi imports, no sockets, no process.exit —
6
+ // everything throws plain Errors so callers decide how to die. Testable
7
+ // under node --test; the wiring (requireHerdr, workspace.create,
8
+ // layout.apply) lives in scripts/team-up.ts.
9
+
10
+ import { resolve as resolvePath } from "node:path";
11
+
12
+ import type { LayoutNode } from "../../.pi/harnesses/lib/herdr-client.ts";
13
+ import { STAGGER_ENV_VAR } from "./spawn-stagger.ts";
14
+ import { DEFAULT_PROJECT, validateProject } from "./team-project.ts";
15
+
16
+ export type { LayoutNode };
17
+
18
+ // Safe charset for any value spliced into a command line or layout — the
19
+ // peers.yaml file is user-edited, so every manifest value is validated.
20
+ export const SAFE = /^[A-Za-z0-9._/,-]+$/;
21
+
22
+ export interface Peer {
23
+ name?: string;
24
+ persona?: string;
25
+ model?: string;
26
+ // Optional comma-separated extension names under .pi/extensions/ to load into
27
+ // this peer (routes it through `just _peer-plus` instead of `just _peer`).
28
+ extensions?: string;
29
+ // Optional repo-relative KEY=VALUE file injected as the pane's env at spawn
30
+ // (herdr injects it before the command runs — no shell `source`).
31
+ env_file?: string;
32
+ // Optional runner. Default (absent) is a pi peer via `_peer`/`_peer-plus`;
33
+ // "claude-code" spawns an interactive Claude Code plus its coms bridge in
34
+ // the pane via `_claude-peer` (model → `claude --model`).
35
+ runner?: string;
36
+ }
37
+
38
+ function stripQuotes(v: string): string {
39
+ if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
40
+ return v.slice(1, -1);
41
+ }
42
+ return v;
43
+ }
44
+
45
+ // Minimal parser for the specific peers.yaml shape (team → list of {name,persona,model}).
46
+ // Not a general YAML parser; tolerant of comments and blank lines only.
47
+ export function parsePeersYaml(raw: string): Record<string, Peer[]> {
48
+ const teams: Record<string, Peer[]> = {};
49
+ let currentTeam: string | null = null;
50
+ let currentPeer: Peer | null = null;
51
+
52
+ for (const rawLine of raw.split("\n")) {
53
+ const line = rawLine.replace(/\s+$/, "");
54
+ if (line.trim() === "" || /^\s*#/.test(line)) continue;
55
+ const indent = line.length - line.trimStart().length;
56
+ const content = line.trim();
57
+
58
+ if (indent === 0) {
59
+ const m = content.match(/^([A-Za-z0-9_-]+):\s*$/);
60
+ if (m) {
61
+ currentTeam = m[1];
62
+ teams[currentTeam] = [];
63
+ currentPeer = null;
64
+ }
65
+ continue;
66
+ }
67
+ if (!currentTeam) continue;
68
+
69
+ const itemM = content.match(/^-\s*([A-Za-z0-9_]+):\s*(.+)$/);
70
+ if (itemM) {
71
+ currentPeer = {};
72
+ teams[currentTeam].push(currentPeer);
73
+ (currentPeer as Record<string, string>)[itemM[1]] = stripQuotes(itemM[2]);
74
+ continue;
75
+ }
76
+ const fieldM = content.match(/^([A-Za-z0-9_]+):\s*(.+)$/);
77
+ if (fieldM && currentPeer) {
78
+ (currentPeer as Record<string, string>)[fieldM[1]] = stripQuotes(fieldM[2]);
79
+ }
80
+ }
81
+ return teams;
82
+ }
83
+
84
+ /**
85
+ * The peers.yaml declaration for a peer name, searched across every team
86
+ * (first match wins; the same name in two teams is the same peer). Used by
87
+ * one-off spawns that are handed only a name — without this they would ignore
88
+ * `runner:`/`extensions:`/`env_file:` and launch a bare pi peer under a name
89
+ * the fleet defines as something else (e.g. a `runner: claude-code` reviewer).
90
+ */
91
+ export function findPeerByName(teams: Record<string, Peer[]>, name: string): Peer | undefined {
92
+ const wanted = String(name ?? "").toLowerCase();
93
+ if (!wanted) return undefined;
94
+ for (const peers of Object.values(teams)) {
95
+ for (const peer of peers) {
96
+ if (String(peer.name ?? "").toLowerCase() === wanted) return peer;
97
+ }
98
+ }
99
+ return undefined;
100
+ }
101
+
102
+ // Validate a peer's fields and build its launch argv. `just` recipe params are
103
+ // POSITIONAL (persona name model session) — bare positional args, never
104
+ // key=value. A peer with `extensions:` routes through `_peer-plus
105
+ // <extensions> <persona> <name> [<model>] [<session>]`; otherwise plain
106
+ // `_peer <persona> <name> [<model>] [<session>]`. `resumeRef` (a pi session
107
+ // path for `pi --session`) fills the trailing session positional — when the
108
+ // peer has no model, an empty-string placeholder keeps the positions aligned.
109
+ export function peerCommand(p: Peer, team: string, resumeRef?: string, project = DEFAULT_PROJECT): string[] {
110
+ validateProject(project);
111
+ if (p.runner !== undefined && p.runner !== "claude-code") {
112
+ throw new Error(`Unknown runner "${p.runner}" for peer "${p.name}" in team "${team}" (supported: claude-code).`);
113
+ }
114
+ if (!p.persona && p.runner !== "claude-code") {
115
+ throw new Error(`Peer "${p.name ?? "(unnamed)"}" in team "${team}" is missing a persona.`);
116
+ }
117
+ if (!p.name) {
118
+ throw new Error(`Peer with persona "${p.persona}" in team "${team}" is missing a name.`);
119
+ }
120
+ for (const [k, v] of Object.entries(p)) {
121
+ // Only string fields can reach a command line; extra non-string fields
122
+ // (e.g. a snapshot's `resume` object) are never spliced into argv.
123
+ if (typeof v === "string" && !SAFE.test(v)) {
124
+ throw new Error(`Unsafe value for ${k} in team "${team}": ${JSON.stringify(v)} (allowed: ${SAFE})`);
125
+ }
126
+ }
127
+ if (resumeRef !== undefined && !SAFE.test(resumeRef)) {
128
+ throw new Error(`Unsafe resume ref for ${p.name}: ${JSON.stringify(resumeRef)} (allowed: ${SAFE})`);
129
+ }
130
+ if (p.runner === "claude-code" && p.extensions) {
131
+ throw new Error(`Peer "${p.name}": extensions: are pi-only and cannot combine with runner: claude-code.`);
132
+ }
133
+ const parts =
134
+ p.runner === "claude-code"
135
+ ? ["just", "_claude-peer", p.name]
136
+ : p.extensions
137
+ ? ["just", "_peer-plus", p.extensions, p.persona, p.name]
138
+ : ["just", "_peer", p.persona, p.name];
139
+ if (p.model) parts.push(p.model);
140
+ if (resumeRef !== undefined) {
141
+ if (!p.model) parts.push(""); // keep the model positional aligned
142
+ parts.push(resumeRef);
143
+ }
144
+ if (project !== DEFAULT_PROJECT) {
145
+ if (!p.model && resumeRef === undefined) parts.push("");
146
+ if (resumeRef === undefined) parts.push("");
147
+ parts.push(project);
148
+ }
149
+ return parts;
150
+ }
151
+
152
+ // Parse a KEY=VALUE env file (B3): no shell evaluation, no expansion.
153
+ // Blank lines and #-comments are skipped; values may be single- or
154
+ // double-quoted (quotes stripped, contents taken literally).
155
+ export function parseEnvFile(raw: string, sourceName = "env file"): Record<string, string> {
156
+ const env: Record<string, string> = {};
157
+ const lines = raw.split("\n");
158
+ for (let i = 0; i < lines.length; i++) {
159
+ const line = lines[i].trim();
160
+ if (line === "" || line.startsWith("#")) continue;
161
+ const m = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
162
+ if (!m) {
163
+ throw new Error(`${sourceName}:${i + 1}: not a KEY=VALUE line: ${JSON.stringify(line)}`);
164
+ }
165
+ env[m[1]] = stripQuotes(m[2].trim());
166
+ }
167
+ return env;
168
+ }
169
+
170
+ // Resolve a peer's env_file to an absolute path inside the repo. The SAFE
171
+ // charset (enforced on every peer field) already excludes shell metacharacters;
172
+ // this adds the traversal guard: repo-relative, no escaping the repo root.
173
+ export function resolveEnvFilePath(envFile: string, repoRoot: string): string {
174
+ if (!SAFE.test(envFile)) {
175
+ throw new Error(`Unsafe env_file path: ${JSON.stringify(envFile)} (allowed: ${SAFE})`);
176
+ }
177
+ if (envFile.startsWith("/")) {
178
+ throw new Error(`env_file must be repo-relative, got absolute path: ${envFile}`);
179
+ }
180
+ const abs = resolvePath(repoRoot, envFile);
181
+ if (abs !== repoRoot && !abs.startsWith(repoRoot + "/")) {
182
+ throw new Error(`env_file escapes the repo root: ${envFile}`);
183
+ }
184
+ return abs;
185
+ }
186
+
187
+ export interface TeamLayoutOptions {
188
+ team: string;
189
+ peers: Peer[];
190
+ repoRoot: string;
191
+ // B3 hook: resolve a peer's extra env (e.g. from its env_file). Returning
192
+ // undefined means no extra env for that peer.
193
+ envForPeer?: (peer: Peer) => Record<string, string> | undefined;
194
+ // B5 hook: resume ref (pi session path) for a peer being restored from a
195
+ // team snapshot. Returning undefined starts the peer fresh.
196
+ resumeForPeer?: (peer: Peer) => string | undefined;
197
+ // Pre-warm/stagger hook (see spawn-stagger.ts): seconds this pane should
198
+ // sleep before launching pi, injected as AGENT_FLEET_SPAWN_DELAY in the
199
+ // pane env. undefined or 0 launches immediately.
200
+ delayForPeer?: (peer: Peer) => number | undefined;
201
+ // B2 hook: when set, the hub occupies a larger root pane (ratio of the
202
+ // horizontal split) and the team tiles in the remaining space.
203
+ // Coms project scope shared by all panes in this layout. The default keeps
204
+ // existing argv shapes; non-default projects are appended to hidden recipe
205
+ // positional args after model/session.
206
+ project?: string;
207
+ hub?: { command: string[]; label: string; ratio?: number; cwd?: string; env?: Record<string, string> };
208
+ }
209
+
210
+ function paneNode(
211
+ peer: Peer,
212
+ team: string,
213
+ repoRoot: string,
214
+ envForPeer?: TeamLayoutOptions["envForPeer"],
215
+ resumeForPeer?: TeamLayoutOptions["resumeForPeer"],
216
+ project = DEFAULT_PROJECT,
217
+ delayForPeer?: TeamLayoutOptions["delayForPeer"],
218
+ ): LayoutNode {
219
+ validateProject(project);
220
+ const env = { ...envForPeer?.(peer) };
221
+ const delay = delayForPeer?.(peer);
222
+ if (delay !== undefined) {
223
+ if (!Number.isFinite(delay) || delay < 0) {
224
+ throw new Error(`Invalid spawn delay for peer "${peer.name}": ${delay}`);
225
+ }
226
+ if (delay > 0) env[STAGGER_ENV_VAR] = String(Math.round(delay));
227
+ }
228
+ return {
229
+ type: "pane",
230
+ command: peerCommand(peer, team, resumeForPeer?.(peer), project),
231
+ cwd: repoRoot,
232
+ label: peer.name as string,
233
+ ...(Object.keys(env).length > 0 ? { env } : {}),
234
+ };
235
+ }
236
+
237
+ // Balanced BSP over a list of panes: split the list in half, alternating
238
+ // split direction by depth — the herdr equivalent of tmux's tiled layout.
239
+ function bsp(nodes: LayoutNode[], depth: number): LayoutNode {
240
+ if (nodes.length === 1) return nodes[0];
241
+ const mid = Math.ceil(nodes.length / 2);
242
+ return {
243
+ type: "split",
244
+ direction: depth % 2 === 0 ? "right" : "down",
245
+ ratio: mid / nodes.length,
246
+ first: bsp(nodes.slice(0, mid), depth + 1),
247
+ second: bsp(nodes.slice(mid), depth + 1),
248
+ };
249
+ }
250
+
251
+ // peers.yaml team → herdr layout tree for layout.apply.
252
+ export function buildTeamLayout(opts: TeamLayoutOptions): LayoutNode {
253
+ const { team, peers, repoRoot, envForPeer, resumeForPeer, delayForPeer, hub, project = DEFAULT_PROJECT } = opts;
254
+ validateProject(project);
255
+ if (peers.length === 0) {
256
+ if (!hub) throw new Error(`Team "${team}" has no peers.`);
257
+ return {
258
+ type: "pane",
259
+ command: hub.command,
260
+ cwd: hub.cwd ?? repoRoot,
261
+ label: hub.label,
262
+ ...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
263
+ };
264
+ }
265
+ const panes = peers.map((p) => paneNode(p, team, repoRoot, envForPeer, resumeForPeer, project, delayForPeer));
266
+ const grid = bsp(panes, hub ? 1 : 0);
267
+ if (!hub) return grid;
268
+ return {
269
+ type: "split",
270
+ direction: "right",
271
+ ratio: hub.ratio ?? 0.4,
272
+ first: {
273
+ type: "pane",
274
+ command: hub.command,
275
+ cwd: hub.cwd ?? repoRoot,
276
+ label: hub.label,
277
+ ...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
278
+ },
279
+ second: grid,
280
+ };
281
+ }