@chankov/agent-fleet 0.0.10 → 0.0.11

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/btw/README.md +3 -2
  2. package/.pi/extensions/pi-voice-stt/README.md +3 -0
  3. package/.pi/harnesses/agent-hub/README.md +3 -0
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/coms/package.json +1 -1
  6. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  7. package/.versions/0.0.11/.claude/commands/build.md +44 -0
  8. package/.versions/0.0.11/.claude/commands/code-simplify.md +22 -0
  9. package/.versions/0.0.11/.claude/commands/design-agent.md +14 -0
  10. package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +22 -0
  11. package/.versions/0.0.11/.claude/commands/orchestrate.md +112 -0
  12. package/.versions/0.0.11/.claude/commands/plan.md +16 -0
  13. package/.versions/0.0.11/.claude/commands/prime.md +22 -0
  14. package/.versions/0.0.11/.claude/commands/review.md +16 -0
  15. package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +15 -0
  16. package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +6 -0
  17. package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +17 -0
  18. package/.versions/0.0.11/.claude/commands/ship.md +72 -0
  19. package/.versions/0.0.11/.claude/commands/spec.md +15 -0
  20. package/.versions/0.0.11/.claude/commands/test.md +19 -0
  21. package/.versions/0.0.11/.claude/commands/webperf.md +32 -0
  22. package/.versions/0.0.11/.claude/orchestrate-teams.yaml +24 -0
  23. package/.versions/0.0.11/.opencode/commands/af-build.md +17 -0
  24. package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +16 -0
  25. package/.versions/0.0.11/.opencode/commands/af-compound.md +16 -0
  26. package/.versions/0.0.11/.opencode/commands/af-design-agent.md +15 -0
  27. package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +22 -0
  28. package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +112 -0
  29. package/.versions/0.0.11/.opencode/commands/af-plan.md +16 -0
  30. package/.versions/0.0.11/.opencode/commands/af-prime.md +22 -0
  31. package/.versions/0.0.11/.opencode/commands/af-review.md +15 -0
  32. package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +15 -0
  33. package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  34. package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +17 -0
  35. package/.versions/0.0.11/.opencode/commands/af-ship.md +16 -0
  36. package/.versions/0.0.11/.opencode/commands/af-spec.md +16 -0
  37. package/.versions/0.0.11/.opencode/commands/af-test.md +21 -0
  38. package/.versions/0.0.11/.opencode/commands/af-webperf.md +32 -0
  39. package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +24 -0
  40. package/.versions/0.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  41. package/.versions/0.0.11/.pi/agents/model-profiles.yaml +27 -0
  42. package/.versions/0.0.11/.pi/agents/peers.yaml +142 -0
  43. package/.versions/0.0.11/.pi/agents/teams.yaml +41 -0
  44. package/.versions/0.0.11/.pi/damage-control-rules.yaml +297 -0
  45. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  46. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  47. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  48. package/.versions/0.0.11/.pi/extensions/btw/README.md +119 -0
  49. package/.versions/0.0.11/.pi/extensions/btw/index.ts +917 -0
  50. package/.versions/0.0.11/.pi/extensions/btw/package.json +6 -0
  51. package/.versions/0.0.11/.pi/extensions/btw/state.js +179 -0
  52. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  53. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  54. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  55. package/.versions/0.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  56. package/.versions/0.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  57. package/.versions/0.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  58. package/.versions/0.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  59. package/.versions/0.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  60. package/.versions/0.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  61. package/.versions/0.0.11/.pi/extensions/package-lock.json +1143 -0
  62. package/.versions/0.0.11/.pi/extensions/package.json +9 -0
  63. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +204 -0
  64. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  65. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  66. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  67. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  68. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  69. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  70. package/.versions/0.0.11/.pi/harnesses/agent-hub/README.md +1004 -0
  71. package/.versions/0.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  72. package/.versions/0.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  73. package/.versions/0.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  74. package/.versions/0.0.11/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  75. package/.versions/0.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  76. package/.versions/0.0.11/.pi/harnesses/agent-hub/delegate.ts +435 -0
  77. package/.versions/0.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  78. package/.versions/0.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  79. package/.versions/0.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  80. package/.versions/0.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  81. package/.versions/0.0.11/.pi/harnesses/agent-hub/footer.ts +31 -0
  82. package/.versions/0.0.11/.pi/harnesses/agent-hub/helpers.ts +248 -0
  83. package/.versions/0.0.11/.pi/harnesses/agent-hub/index.ts +9111 -0
  84. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  85. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  86. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  87. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  88. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  89. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  90. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  91. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  92. package/.versions/0.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  93. package/.versions/0.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  94. package/.versions/0.0.11/.pi/harnesses/agent-hub/research-retention.js +34 -0
  95. package/.versions/0.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  96. package/.versions/0.0.11/.pi/harnesses/agent-hub/return-contract.js +293 -0
  97. package/.versions/0.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  98. package/.versions/0.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  99. package/.versions/0.0.11/.pi/harnesses/agent-hub/run-budget.js +479 -0
  100. package/.versions/0.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  101. package/.versions/0.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  102. package/.versions/0.0.11/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  103. package/.versions/0.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  104. package/.versions/0.0.11/.pi/harnesses/agent-hub/spawn.ts +354 -0
  105. package/.versions/0.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  106. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +19 -0
  107. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +321 -0
  108. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  109. package/.versions/0.0.11/.pi/harnesses/coms/README.md +100 -0
  110. package/.versions/0.0.11/.pi/harnesses/coms/index.ts +1767 -0
  111. package/.versions/0.0.11/.pi/harnesses/coms/package.json +7 -0
  112. package/.versions/0.0.11/.pi/harnesses/coms/version.ts +42 -0
  113. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/README.md +124 -0
  114. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/index.ts +536 -0
  115. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  116. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  117. package/.versions/0.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  118. package/.versions/0.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  119. package/.versions/0.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  120. package/.versions/0.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  121. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  122. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  123. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  124. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  125. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  126. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  127. package/.versions/0.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  128. package/.versions/0.0.11/.pi/harnesses/package-lock.json +35 -0
  129. package/.versions/0.0.11/.pi/harnesses/package.json +9 -0
  130. package/.versions/0.0.11/.pi/prompts/af-build.md +24 -0
  131. package/.versions/0.0.11/.pi/prompts/af-code-simplify.md +22 -0
  132. package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +22 -0
  133. package/.versions/0.0.11/.pi/prompts/af-plan.md +16 -0
  134. package/.versions/0.0.11/.pi/prompts/af-review.md +16 -0
  135. package/.versions/0.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  136. package/.versions/0.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  137. package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +19 -0
  138. package/.versions/0.0.11/.pi/prompts/af-ship.md +17 -0
  139. package/.versions/0.0.11/.pi/prompts/af-spec.md +15 -0
  140. package/.versions/0.0.11/.pi/prompts/af-test.md +19 -0
  141. package/.versions/0.0.11/.pi/skills/bowser/SKILL.md +145 -0
  142. package/.versions/0.0.11/.version +1 -0
  143. package/.versions/0.0.11/agents/architect.md +24 -0
  144. package/.versions/0.0.11/agents/bowser.md +27 -0
  145. package/.versions/0.0.11/agents/builder.md +54 -0
  146. package/.versions/0.0.11/agents/code-reviewer.md +208 -0
  147. package/.versions/0.0.11/agents/deep-researcher.md +32 -0
  148. package/.versions/0.0.11/agents/documenter.md +18 -0
  149. package/.versions/0.0.11/agents/orchestrator.md +72 -0
  150. package/.versions/0.0.11/agents/plan-reviewer.md +83 -0
  151. package/.versions/0.0.11/agents/planner.md +70 -0
  152. package/.versions/0.0.11/agents/releaser.md +24 -0
  153. package/.versions/0.0.11/agents/researcher.md +28 -0
  154. package/.versions/0.0.11/agents/security-auditor.md +167 -0
  155. package/.versions/0.0.11/agents/test-engineer.md +153 -0
  156. package/.versions/0.0.11/agents/web-debugger.md +43 -0
  157. package/.versions/0.0.11/agents/web-performance-auditor.md +193 -0
  158. package/.versions/0.0.11/codex/CONDUCTOR.md +148 -0
  159. package/.versions/0.0.11/docs/ARCHITECTURE.md +303 -0
  160. package/.versions/0.0.11/docs/agent-fleet-setup.md +377 -0
  161. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +109 -0
  162. package/.versions/0.0.11/docs/codex-remote-conductor.md +170 -0
  163. package/.versions/0.0.11/docs/coms-hermes-bridge.md +189 -0
  164. package/.versions/0.0.11/docs/getting-started.md +254 -0
  165. package/.versions/0.0.11/docs/npm-install.md +514 -0
  166. package/.versions/0.0.11/docs/opencode-setup.md +281 -0
  167. package/.versions/0.0.11/docs/pi-extensions.md +368 -0
  168. package/.versions/0.0.11/docs/pi-setup.md +571 -0
  169. package/.versions/0.0.11/docs/skill-anatomy.md +150 -0
  170. package/.versions/0.0.11/hermes/README.md +347 -0
  171. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  172. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  173. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  174. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  175. package/.versions/0.0.11/hermes/gates/gate-o-capability.md +8 -0
  176. package/.versions/0.0.11/hermes/gates/gate-o-validator-fixtures.json +1 -0
  177. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  178. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  179. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  180. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  181. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  182. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  183. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  184. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  185. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  186. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  187. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  188. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  189. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  190. package/.versions/0.0.11/hermes/skills/hub-conductor/SKILL.md +84 -0
  191. package/.versions/0.0.11/hermes/skills/hub-liaison/SKILL.md +84 -0
  192. package/.versions/0.0.11/hermes/skills/hub-watchdog/SKILL.md +76 -0
  193. package/.versions/0.0.11/hermes/skills/hub-watchdog/manifest.json +1 -0
  194. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  195. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  196. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  197. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  198. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  199. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  200. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  201. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  202. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  203. package/.versions/0.0.11/hermes/watchdog-tests/__init__.py +0 -0
  204. package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +90 -0
  205. package/.versions/0.0.11/hooks/coms-stop-hook.mjs +84 -0
  206. package/.versions/0.0.11/hooks/hooks.json +14 -0
  207. package/.versions/0.0.11/hooks/session-start.sh +74 -0
  208. package/.versions/0.0.11/hooks/simplify-ignore.sh +302 -0
  209. package/.versions/0.0.11/install-manifest.json +3615 -0
  210. package/.versions/0.0.11/justfile +254 -0
  211. package/.versions/0.0.11/manifest-meta.json +472 -0
  212. package/.versions/0.0.11/references/accessibility-checklist.md +160 -0
  213. package/.versions/0.0.11/references/definition-of-done.md +67 -0
  214. package/.versions/0.0.11/references/fleet-coordination-patterns.md +151 -0
  215. package/.versions/0.0.11/references/observability-checklist.md +91 -0
  216. package/.versions/0.0.11/references/orchestration-patterns.md +370 -0
  217. package/.versions/0.0.11/references/performance-checklist.md +153 -0
  218. package/.versions/0.0.11/references/prompting-patterns.md +380 -0
  219. package/.versions/0.0.11/references/security-checklist.md +179 -0
  220. package/.versions/0.0.11/references/testing-patterns.md +236 -0
  221. package/.versions/0.0.11/scripts/codex-conductor.ts +41 -0
  222. package/.versions/0.0.11/scripts/codex-remote-control.ts +167 -0
  223. package/.versions/0.0.11/scripts/coms-claude-bridge.ts +401 -0
  224. package/.versions/0.0.11/scripts/coms-cli.ts +484 -0
  225. package/.versions/0.0.11/scripts/coms-hermes-bridge.ts +413 -0
  226. package/.versions/0.0.11/scripts/fleet.ts +168 -0
  227. package/.versions/0.0.11/scripts/hermes-monitor-capability-runner.ts +25 -0
  228. package/.versions/0.0.11/scripts/hermes-monitor-scenario.ts +474 -0
  229. package/.versions/0.0.11/scripts/hermes-watchdog-capability-probe.ts +45 -0
  230. package/.versions/0.0.11/scripts/install-hermes-plugin.sh +180 -0
  231. package/.versions/0.0.11/scripts/lib/claude-bridge-core.ts +165 -0
  232. package/.versions/0.0.11/scripts/lib/codex-conductor.ts +88 -0
  233. package/.versions/0.0.11/scripts/lib/codex-remote-control.ts +480 -0
  234. package/.versions/0.0.11/scripts/lib/coms-envelope.ts +582 -0
  235. package/.versions/0.0.11/scripts/lib/fake-herdr-server.ts +88 -0
  236. package/.versions/0.0.11/scripts/lib/fleet-command.ts +111 -0
  237. package/.versions/0.0.11/scripts/lib/herdr-layout.ts +281 -0
  238. package/.versions/0.0.11/scripts/lib/hermes-bridge-core.ts +241 -0
  239. package/.versions/0.0.11/scripts/lib/hermes-monitor-events.ts +1 -0
  240. package/.versions/0.0.11/scripts/lib/hermes-monitor-herdr.ts +2 -0
  241. package/.versions/0.0.11/scripts/lib/hermes-monitor-model.ts +3 -0
  242. package/.versions/0.0.11/scripts/lib/hermes-monitor-registry.ts +2 -0
  243. package/.versions/0.0.11/scripts/lib/hermes-monitor-socket.ts +2 -0
  244. package/.versions/0.0.11/scripts/lib/hermes-monitor-store.ts +2 -0
  245. package/.versions/0.0.11/scripts/lib/monitor-env.ts +134 -0
  246. package/.versions/0.0.11/scripts/lib/peer-launch.ts +314 -0
  247. package/.versions/0.0.11/scripts/lib/persona-banner.ts +62 -0
  248. package/.versions/0.0.11/scripts/lib/spawn-stagger.ts +101 -0
  249. package/.versions/0.0.11/scripts/lib/team-project.ts +193 -0
  250. package/.versions/0.0.11/scripts/lib/team-snapshot.ts +147 -0
  251. package/.versions/0.0.11/scripts/peer-banner.ts +40 -0
  252. package/.versions/0.0.11/scripts/peer-launch.ts +259 -0
  253. package/.versions/0.0.11/scripts/team-snapshot.ts +237 -0
  254. package/.versions/0.0.11/scripts/team-up.ts +360 -0
  255. package/.versions/0.0.11/skills/_internal/grilling.md +11 -0
  256. package/.versions/0.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  257. package/.versions/0.0.11/skills/code-review-and-quality/SKILL.md +381 -0
  258. package/.versions/0.0.11/skills/compound-learning/SKILL.md +137 -0
  259. package/.versions/0.0.11/skills/context-engineering/SKILL.md +291 -0
  260. package/.versions/0.0.11/skills/deprecation-and-migration/SKILL.md +206 -0
  261. package/.versions/0.0.11/skills/designing-agents/SKILL.md +394 -0
  262. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  263. package/.versions/0.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  264. package/.versions/0.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  265. package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +226 -0
  266. package/.versions/0.0.11/skills/guided-workspace-setup/companion-manifest.json +38 -0
  267. package/.versions/0.0.11/skills/idea-refine/SKILL.md +182 -0
  268. package/.versions/0.0.11/skills/idea-refine/examples.md +238 -0
  269. package/.versions/0.0.11/skills/idea-refine/frameworks.md +99 -0
  270. package/.versions/0.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  271. package/.versions/0.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  272. package/.versions/0.0.11/skills/incremental-implementation/SKILL.md +287 -0
  273. package/.versions/0.0.11/skills/interview-me/SKILL.md +226 -0
  274. package/.versions/0.0.11/skills/orchestration-verification/SKILL.md +181 -0
  275. package/.versions/0.0.11/skills/peer-coms/SKILL.md +90 -0
  276. package/.versions/0.0.11/skills/performance-optimization/SKILL.md +350 -0
  277. package/.versions/0.0.11/skills/planning-and-task-breakdown/SKILL.md +254 -0
  278. package/.versions/0.0.11/skills/security-and-hardening/SKILL.md +461 -0
  279. package/.versions/0.0.11/skills/spec-driven-development/SKILL.md +257 -0
  280. package/.versions/0.0.11/skills/using-agent-skills/SKILL.md +199 -0
  281. package/.versions/0.0.11/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  282. package/.versions/0.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  283. package/.versions/0.0.11/vendor/agent-skills-upstream/README.md +11 -0
  284. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  285. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  286. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  287. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  288. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  289. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  290. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  291. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  292. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  293. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  294. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  295. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  296. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  297. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  298. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  299. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  300. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  301. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  302. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  303. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  304. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  305. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  306. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  307. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  308. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  309. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  310. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  311. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  312. package/CHANGELOG.md +7 -0
  313. package/docs/pi-extensions.md +5 -0
  314. package/install-manifest.json +1 -1
  315. package/package.json +1 -1
  316. package/scripts/lib/monitor-env.ts +15 -1
@@ -0,0 +1,134 @@
1
+ /**
2
+ * The two variables that decide whether a hub is monitored at all.
3
+ *
4
+ * `monitorLifecycleConfig()` (.pi/harnesses/agent-hub/monitor-lifecycle.ts)
5
+ * returns `null` unless BOTH `AGENT_FLEET_PROFILE_ID` and an absolute
6
+ * `AGENT_FLEET_MONITOR_RUNTIME_DIR` are in the hub's environment. Until this
7
+ * module existed the only thing that set them was a manual `export` copied out
8
+ * of hermes/README.md, so in practice the monitor never started and its whole
9
+ * transport — task tree, live output, per-generation cancel — was dead code
10
+ * with a test suite.
11
+ *
12
+ * Two rules the rest of the file exists to hold:
13
+ *
14
+ * 1. An operator who already exported the variables wins. This never
15
+ * overwrites a value that is already set, so the README recipe and a
16
+ * systemd unit keep working exactly as documented.
17
+ * 2. A runtime directory we cannot make private is not used. The Python
18
+ * reader refuses any root that is not mode 0700 (adapter.py), and it is
19
+ * right to: the directory holds one bearer token per live hub. Rather
20
+ * than hand it a path it will reject, `resolveMonitorEnv` returns null
21
+ * and the hub runs unmonitored — the pre-existing behaviour, reached
22
+ * honestly.
23
+ */
24
+
25
+ import * as fs from "node:fs";
26
+ import * as os from "node:os";
27
+ import * as path from "node:path";
28
+
29
+ /** Mirrors the profile-ID class in monitor-lifecycle.ts and adapter.py. All
30
+ * three must agree, because the runtime namespace is `sha256(profileId)` and a
31
+ * value one end accepts and another rejects is an empty directory listing with
32
+ * no error anywhere. */
33
+ export const PROFILE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
34
+
35
+ /** The Hermes profile the fleet plugins are installed in. `dev` rather than
36
+ * `default` by the 2026-07-27 decision recorded in the observability plan —
37
+ * the panel is a dev-profile tool, and the monitor has to land in the same
38
+ * profile or the discovery glob looks in the wrong namespace. */
39
+ export const DEFAULT_PROFILE_ID = "dev";
40
+
41
+ export const RUNTIME_DIR_NAME = "agent-fleet-monitor";
42
+ export const MAX_MONITOR_SOCKET_PATH_BYTES = 103;
43
+
44
+ const SOCKET_NAMESPACE_BYTES = 32;
45
+
46
+ function monitorSocketPathFits(runtimeDir: string): boolean {
47
+ const longestSocketPath = path.join(runtimeDir, "s", "a".repeat(SOCKET_NAMESPACE_BYTES), "s");
48
+ return Buffer.byteLength(longestSocketPath) <= MAX_MONITOR_SOCKET_PATH_BYTES;
49
+ }
50
+
51
+ export interface MonitorEnv {
52
+ AGENT_FLEET_PROFILE_ID: string;
53
+ AGENT_FLEET_MONITOR_RUNTIME_DIR: string;
54
+ }
55
+
56
+ /** Where the runtime root goes, before anything is created.
57
+ *
58
+ * `XDG_RUNTIME_DIR` is the right answer and the one the README documents: it
59
+ * is already per-user, already 0700, and already cleaned up at logout. The
60
+ * tmpdir fallback exists for the sessions that have no such variable (a bare
61
+ * ssh login, a container), and carries the uid in its name so two users on one
62
+ * machine never race for the same path. */
63
+ export function monitorRuntimeRoot(env: NodeJS.ProcessEnv = process.env): string {
64
+ const xdg = env.XDG_RUNTIME_DIR;
65
+ if (xdg && path.isAbsolute(xdg)) return path.join(xdg, RUNTIME_DIR_NAME);
66
+ const uid = typeof process.getuid === "function" ? process.getuid() : 0;
67
+ // macOS gives each process a long /var/folders/... temp path. Adding the
68
+ // monitor's 32-byte namespace to it exceeds sockaddr_un.sun_path (104 bytes,
69
+ // including its terminator), so libuv binds a truncated name that chmod
70
+ // cannot find. The child under /tmp is still created and verified mode 0700.
71
+ const tempRoot = process.platform === "darwin" ? "/tmp" : os.tmpdir();
72
+
73
+ return path.join(tempRoot, `${RUNTIME_DIR_NAME}-${uid}`);
74
+ }
75
+
76
+ /** Create the runtime root 0700, or say why it cannot be trusted.
77
+ *
78
+ * The mode is re-asserted on a directory that already exists because the
79
+ * `mode` argument to mkdir is a no-op for an existing path and is masked by
80
+ * umask for a new one — checking after the fact is the only way to know. A
81
+ * symlink is refused outright rather than followed: the whole point of the
82
+ * directory is that its contents are only reachable by this user, and a
83
+ * symlink means somebody else chose the destination. */
84
+ export function ensureMonitorRuntimeDir(dir: string, io: {
85
+ mkdirSync?: typeof fs.mkdirSync;
86
+ lstatSync?: typeof fs.lstatSync;
87
+ chmodSync?: typeof fs.chmodSync;
88
+ } = {}): string | null {
89
+ const mkdir = io.mkdirSync ?? fs.mkdirSync;
90
+ const lstat = io.lstatSync ?? fs.lstatSync;
91
+ const chmod = io.chmodSync ?? fs.chmodSync;
92
+ if (!path.isAbsolute(dir)) return null;
93
+ try {
94
+ mkdir(dir, { recursive: true, mode: 0o700 });
95
+ const stat = lstat(dir);
96
+ if (stat.isSymbolicLink() || !stat.isDirectory()) return null;
97
+ if ((stat.mode & 0o777) !== 0o700) {
98
+ chmod(dir, 0o700);
99
+ if ((lstat(dir).mode & 0o777) !== 0o700) return null;
100
+ }
101
+
102
+ return dir;
103
+ } catch {
104
+ return null;
105
+ }
106
+ }
107
+
108
+ /** The variables to add to a hub's environment, or null to leave it unmonitored.
109
+ *
110
+ * Null is a normal outcome, not a failure: `AGENT_FLEET_MONITOR=0` is the
111
+ * documented opt-out, and an unusable runtime directory reaches the same
112
+ * result. Callers merge the answer and carry on either way — a hub that
113
+ * cannot be monitored still orchestrates. */
114
+ export function resolveMonitorEnv(
115
+ env: NodeJS.ProcessEnv = process.env,
116
+ ensure: (dir: string) => string | null = ensureMonitorRuntimeDir,
117
+ ): MonitorEnv | null {
118
+ if (env.AGENT_FLEET_MONITOR === "0") return null;
119
+
120
+ const profileId = env.AGENT_FLEET_PROFILE_ID?.trim() || DEFAULT_PROFILE_ID;
121
+ if (!PROFILE_ID_RE.test(profileId) || profileId.includes("..")) return null;
122
+
123
+ const requested = env.AGENT_FLEET_MONITOR_RUNTIME_DIR?.trim();
124
+ // An explicit path is honoured as given — including a rejection, which is
125
+ // louder than silently relocating somebody's deliberate choice.
126
+ const root = requested ? (path.isAbsolute(requested) ? requested : null) : monitorRuntimeRoot(env);
127
+ if (!root) return null;
128
+ if (!monitorSocketPathFits(root)) return null;
129
+
130
+ const runtimeDir = ensure(root);
131
+ if (!runtimeDir) return null;
132
+
133
+ return { AGENT_FLEET_PROFILE_ID: profileId, AGENT_FLEET_MONITOR_RUNTIME_DIR: runtimeDir };
134
+ }
@@ -0,0 +1,314 @@
1
+ // scripts/lib/peer-launch.ts
2
+ //
3
+ // Pure logic for `just fleet peer <name>` — ONE addressable coms peer, in its
4
+ // own herdr pane by default, with no peers.yaml team involved.
5
+ //
6
+ // One verb, three shapes of peer, two placements:
7
+ //
8
+ // runner: claude-code → `just _claude-peer …` (Claude + its coms bridge)
9
+ // runner: pi, persona resolved → `just _peer[-plus] …` (guarded reusable persona peer)
10
+ // runner: pi, no persona → `just _fleet-peer …` (Fleet Core + coms, no persona)
11
+ //
12
+ // default → the command runs in a pane of its own
13
+ // --here → the command takes over the CALLING terminal
14
+ //
15
+ // The third shape is what `just fleet peer <name>` meant before pane placement
16
+ // existed, so `--here` reproduces the old behavior exactly while the same
17
+ // invocation without it now opens a pane.
18
+ //
19
+ // Resolution order for every field: explicit CLI flag → the peers.yaml
20
+ // declaration for that NAME (searched across all teams, see findPeerByName) →
21
+ // a convention default. So `just fleet peer code-reviewer` gets the
22
+ // `runner: claude-code` the fleet declares, and `--runner claude-code` needs no
23
+ // manifest entry at all.
24
+ //
25
+ // No sockets, no process.exit, no fs — callers supply the manifest text and a
26
+ // persona-existence probe, and every failure is a plain Error.
27
+
28
+ import { findPeerByName, parsePeersYaml, peerCommand, type Peer } from "./herdr-layout.ts";
29
+ import { DEFAULT_PROJECT, teamWorkspaceLabel, validateProject } from "./team-project.ts";
30
+
31
+ /** Synthetic team name used in peerCommand errors for a peer that has no team. */
32
+ export const ADHOC_TEAM = "ad-hoc";
33
+
34
+ /** The extension `--browser` adds to a pi persona peer (the `_peer-plus` route). */
35
+ export const BROWSER_EXTENSION = "chrome-devtools-mcp";
36
+
37
+ /**
38
+ * Pane label + coms identity charset. Stricter than herdr-layout's SAFE, which
39
+ * also permits `.`, `/` and `,` — fine inside a model spec, wrong for a name
40
+ * that becomes a pane label, a workspace label segment, and a coms address.
41
+ */
42
+ export const PEER_NAME_SAFE = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
43
+
44
+ export type PeerRunner = "pi" | "claude-code";
45
+ /** Which hidden recipe launches this peer — see the header table. */
46
+ export type PeerKind = "persona-peer" | "core-peer" | "claude-peer";
47
+
48
+ export interface PeerLaunchOptions {
49
+ name: string;
50
+ /** --runner; omit to inherit the peers.yaml declaration, else defaults to pi. */
51
+ runner?: string;
52
+ /** --persona; omit to inherit the declaration, else the same-named persona. */
53
+ persona?: string;
54
+ /**
55
+ * --no-persona: force the identity-only Fleet Core peer even when the name
56
+ * resolves to a persona. The escape hatch for raw pi arguments and
57
+ * --all-extensions under a name that happens to match `agents/<name>.md`.
58
+ */
59
+ noPersona?: boolean;
60
+ model?: string;
61
+ project?: string;
62
+ extensions?: string;
63
+ /** --browser: an extra extension for a persona peer, a capability flag for a core peer. */
64
+ browser?: boolean;
65
+ /** --all-extensions: core peers only — persona peers are deliberately deterministic. */
66
+ allExtensions?: boolean;
67
+ /** Raw pi arguments after `--`; core peers only. */
68
+ piArgs?: string[];
69
+ direction?: "right" | "down";
70
+ /** --here: run in the calling terminal instead of a pane. */
71
+ here?: boolean;
72
+ }
73
+
74
+ export interface PeerLaunchContext {
75
+ /** Raw .pi/agents/peers.yaml, or "" when the repo has none. */
76
+ peersYaml: string;
77
+ /** True when `agents/<persona>.md` or `.pi/agents/<persona>.md` exists. */
78
+ personaExists(persona: string): boolean;
79
+ /** worktreeTag(REPO_ROOT) — scopes the standalone workspace label. */
80
+ worktreeTag: string;
81
+ }
82
+
83
+ export interface PeerLaunchPlan {
84
+ name: string;
85
+ runner: PeerRunner;
86
+ kind: PeerKind;
87
+ persona?: string;
88
+ model?: string;
89
+ extensions?: string;
90
+ /** Repo-relative env_file inherited from the declaration, if any. */
91
+ envFile?: string;
92
+ project: string;
93
+ /** argv for the pane (or for this terminal under --here). */
94
+ command: string[];
95
+ placement: "pane" | "here";
96
+ direction: "right" | "down";
97
+ /** Workspace label used only when launching a pane outside a herdr pane. */
98
+ workspaceLabel: string;
99
+ /** True when peers.yaml declares this name (its fields seeded the plan). */
100
+ declared: boolean;
101
+ }
102
+
103
+ function validateName(name: string): string {
104
+ if (!PEER_NAME_SAFE.test(name)) {
105
+ throw new Error(
106
+ `Invalid peer name: ${JSON.stringify(name)} (letters, numbers, underscores and hyphens; must start alphanumeric)`,
107
+ );
108
+ }
109
+ return name;
110
+ }
111
+
112
+ function normalizeRunner(runner: string | undefined, source: string): PeerRunner | undefined {
113
+ if (runner === undefined) return undefined;
114
+ if (runner === "pi" || runner === "claude-code") return runner;
115
+ throw new Error(`Unknown runner ${JSON.stringify(runner)} from ${source} (supported: pi, claude-code)`);
116
+ }
117
+
118
+ function mergeExtensions(...values: (string | undefined)[]): string | undefined {
119
+ const names = values
120
+ .flatMap((v) => (v ?? "").split(","))
121
+ .map((v) => v.trim())
122
+ .filter((v) => v !== "");
123
+ return names.length > 0 ? [...new Set(names)].join(",") : undefined;
124
+ }
125
+
126
+ /**
127
+ * The pre-pane-placement `just fleet peer <name>` command: Fleet Core + coms
128
+ * under the given identity, with no persona and arbitrary pi arguments. Its
129
+ * positionals are `<name> <browser> <all_extensions>` followed by raw pi args,
130
+ * so `--project` travels as an ordinary pi flag rather than a placeholder slot.
131
+ */
132
+ function corePeerCommand(name: string, opts: PeerLaunchOptions, project: string): string[] {
133
+ const command = ["just", "_fleet-peer", name, opts.browser ? "true" : "false", opts.allExtensions ? "true" : "false"];
134
+ if (project !== DEFAULT_PROJECT) command.push("--project", project);
135
+ for (const arg of opts.piArgs ?? []) {
136
+ // A pane launch types this argv at a shell prompt one line at a time, so
137
+ // an embedded newline would execute half of it as a separate command.
138
+ if (/[\r\n]/.test(arg)) throw new Error(`pi argument contains a line break: ${JSON.stringify(arg)}`);
139
+ command.push(arg);
140
+ }
141
+ return command;
142
+ }
143
+
144
+ /**
145
+ * Merge CLI options with the peers.yaml declaration for the same name and
146
+ * produce the launch argv. Nothing is silently dropped: a flag that cannot
147
+ * apply to the resolved runner is an error, not a no-op.
148
+ */
149
+ export function buildPeerLaunchPlan(opts: PeerLaunchOptions, ctx: PeerLaunchContext): PeerLaunchPlan {
150
+ const name = validateName(opts.name);
151
+ const project = validateProject(opts.project ?? DEFAULT_PROJECT);
152
+ const teams = ctx.peersYaml ? parsePeersYaml(ctx.peersYaml) : {};
153
+ const declared: Peer | undefined = findPeerByName(teams, name);
154
+
155
+ const runner =
156
+ normalizeRunner(opts.runner, "--runner") ??
157
+ normalizeRunner(declared?.runner, `peers.yaml peer "${name}"`) ??
158
+ "pi";
159
+
160
+ const model = opts.model ?? declared?.model;
161
+ const common = {
162
+ name,
163
+ runner,
164
+ ...(model ? { model } : {}),
165
+ ...(declared?.env_file ? { envFile: declared.env_file } : {}),
166
+ project,
167
+ placement: (opts.here ? "here" : "pane") as "here" | "pane",
168
+ direction: opts.direction ?? ("right" as const),
169
+ workspaceLabel: teamWorkspaceLabel("peer", name, project, ctx.worktreeTag),
170
+ declared: declared !== undefined,
171
+ };
172
+
173
+ if (runner === "claude-code") {
174
+ if (opts.persona) throw new Error("--persona is pi-only; a claude-code peer carries no pi persona.");
175
+ if (opts.extensions || opts.browser || opts.allExtensions) {
176
+ throw new Error("--extensions/--browser/--all-extensions are pi-only and cannot combine with --runner claude-code.");
177
+ }
178
+ if (opts.piArgs?.length) throw new Error("arguments after `--` are pi arguments and cannot combine with --runner claude-code.");
179
+ return {
180
+ ...common,
181
+ kind: "claude-peer",
182
+ command: peerCommand({ name, ...(model ? { model } : {}), runner }, ADHOC_TEAM, undefined, project),
183
+ };
184
+ }
185
+
186
+ if (opts.noPersona && opts.persona) throw new Error("--no-persona and --persona are contradictory.");
187
+ const persona = opts.noPersona
188
+ ? undefined
189
+ : opts.persona ?? declared?.persona ?? (ctx.personaExists(name) ? name : undefined);
190
+
191
+ // No persona anywhere → the identity-only Fleet Core peer, which is exactly
192
+ // what this command did before pane placement existed. Not an error: it is
193
+ // the third shape of peer, and the only one that takes raw pi arguments.
194
+ if (!persona) {
195
+ if (opts.extensions) {
196
+ throw new Error(
197
+ `--extensions needs a persona peer. Pass --persona <name>, add agents/${name}.md, ` +
198
+ "or use --all-extensions / raw pi flags after `--`.",
199
+ );
200
+ }
201
+ return { ...common, kind: "core-peer", command: corePeerCommand(name, opts, project) };
202
+ }
203
+
204
+ if (!ctx.personaExists(persona)) throw new Error(`Persona "${persona}" not found under agents/ or .pi/agents/.`);
205
+ if (opts.allExtensions) {
206
+ throw new Error(
207
+ `--all-extensions is not available to persona peer "${name}": reusable peers load a deterministic set. ` +
208
+ "Use --extensions <names>, declare extensions: in .pi/agents/peers.yaml, or --no-persona for a plain Fleet Core peer.",
209
+ );
210
+ }
211
+ if (opts.piArgs?.length) {
212
+ throw new Error(
213
+ `arguments after \`--\` need a personaless core peer; persona peer "${name}" builds its own pi command line. ` +
214
+ `Add --no-persona to launch "${name}" as a plain Fleet Core peer instead.`,
215
+ );
216
+ }
217
+ const extensions = mergeExtensions(opts.extensions ?? declared?.extensions, opts.browser ? BROWSER_EXTENSION : undefined);
218
+
219
+ return {
220
+ ...common,
221
+ kind: "persona-peer",
222
+ persona,
223
+ ...(extensions ? { extensions } : {}),
224
+ command: peerCommand(
225
+ { name, persona, ...(model ? { model } : {}), ...(extensions ? { extensions } : {}) },
226
+ ADHOC_TEAM,
227
+ undefined,
228
+ project,
229
+ ),
230
+ };
231
+ }
232
+
233
+ export interface ParsedPeerArgs extends PeerLaunchOptions {
234
+ dryRun: boolean;
235
+ /** --peers: alternate manifest path (tests use it). */
236
+ peersYaml?: string;
237
+ }
238
+
239
+ function takeValue(argv: string[], i: number, flag: string): string {
240
+ const value = argv[i + 1];
241
+ if (value === undefined || value.startsWith("--")) throw new Error(`${flag} requires a value`);
242
+ return value;
243
+ }
244
+
245
+ /**
246
+ * `<name> [--runner r] [--persona p|--no-persona] [--model m] [--project p]
247
+ * [--extensions a,b] [--browser] [--all-extensions] [--direction right|down]
248
+ * [--here] [--dry-run] [--peers path] [-- PI_ARGS…]`
249
+ *
250
+ * The peer name is the only positional and everything after `--` goes to pi
251
+ * verbatim. An unrecognized flag BEFORE `--` is an error rather than silently
252
+ * dropped argv — the failure mode `project=af` already taught this fleet about.
253
+ */
254
+ export function parsePeerArgs(argv: string[]): ParsedPeerArgs {
255
+ const out: ParsedPeerArgs = { name: "", dryRun: false };
256
+ let name: string | undefined;
257
+ for (let i = 0; i < argv.length; i++) {
258
+ const arg = argv[i];
259
+ if (arg === "--") {
260
+ out.piArgs = argv.slice(i + 1);
261
+ break;
262
+ }
263
+ switch (arg) {
264
+ case "--dry-run":
265
+ out.dryRun = true;
266
+ break;
267
+ case "--here":
268
+ out.here = true;
269
+ break;
270
+ case "--browser":
271
+ out.browser = true;
272
+ break;
273
+ case "--all-extensions":
274
+ out.allExtensions = true;
275
+ break;
276
+ case "--runner":
277
+ out.runner = takeValue(argv, i++, arg);
278
+ break;
279
+ case "--persona":
280
+ out.persona = takeValue(argv, i++, arg);
281
+ break;
282
+ case "--no-persona":
283
+ out.noPersona = true;
284
+ break;
285
+ case "--model":
286
+ out.model = takeValue(argv, i++, arg);
287
+ break;
288
+ case "--project":
289
+ out.project = takeValue(argv, i++, arg);
290
+ break;
291
+ case "--extensions":
292
+ out.extensions = takeValue(argv, i++, arg);
293
+ break;
294
+ case "--peers":
295
+ out.peersYaml = takeValue(argv, i++, arg);
296
+ break;
297
+ case "--direction": {
298
+ const value = takeValue(argv, i++, arg);
299
+ if (value !== "right" && value !== "down") throw new Error(`--direction expects right or down, got ${JSON.stringify(value)}`);
300
+ out.direction = value;
301
+ break;
302
+ }
303
+ default:
304
+ if (arg.startsWith("-")) {
305
+ throw new Error(`Unknown flag: ${arg} — pass pi flags after \`--\` (e.g. just fleet peer ${name ?? "<name>"} -- ${arg})`);
306
+ }
307
+ if (name !== undefined) throw new Error(`fleet peer takes one peer name, got ${JSON.stringify(name)} and ${JSON.stringify(arg)}`);
308
+ name = arg;
309
+ }
310
+ }
311
+ if (!name) throw new Error("fleet peer requires a peer name");
312
+ out.name = name;
313
+ return out;
314
+ }
@@ -0,0 +1,62 @@
1
+ // scripts/lib/persona-banner.ts
2
+ //
3
+ // Pure logic for the per-pane identity banner (`just _peer`/`_peer-plus`
4
+ // print it before exec'ing pi): persona frontmatter → colored ANSI banner.
5
+ // Frontmatter parsing mirrors the coms harness convention (name /
6
+ // description / color, quoted values allowed). Backend-agnostic — works in
7
+ // any terminal, inside or outside herdr.
8
+
9
+ export interface PersonaMeta {
10
+ name?: string;
11
+ description?: string;
12
+ color?: string;
13
+ }
14
+
15
+ export function parsePersonaFrontmatter(raw: string): PersonaMeta {
16
+ const match = raw.match(/^---\n([\s\S]*?)\n---\n?/);
17
+ if (!match) return {};
18
+ const fm: Record<string, string> = {};
19
+ for (const line of match[1].split("\n")) {
20
+ const idx = line.indexOf(":");
21
+ if (idx > 0) {
22
+ const key = line.slice(0, idx).trim();
23
+ let val = line.slice(idx + 1).trim();
24
+ if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
25
+ val = val.slice(1, -1);
26
+ }
27
+ fm[key] = val;
28
+ }
29
+ }
30
+ return { name: fm.name, description: fm.description, color: fm.color };
31
+ }
32
+
33
+ export function isValidHex(hex: string): boolean {
34
+ return /^#[0-9a-fA-F]{6}$/.test(hex);
35
+ }
36
+
37
+ function hexFg(hex: string, s: string): string {
38
+ const r = parseInt(hex.slice(1, 3), 16);
39
+ const g = parseInt(hex.slice(3, 5), 16);
40
+ const b = parseInt(hex.slice(5, 7), 16);
41
+ return `\x1b[38;2;${r};${g};${b}m${s}\x1b[0m`;
42
+ }
43
+
44
+ const DEFAULT_COLOR = "#36F9F6";
45
+
46
+ // Colored banner lines for a peer pane: name in the persona color, purpose
47
+ // dimmed below, framed by a rule in the same color. `width` caps the rule so
48
+ // narrow panes don't wrap.
49
+ export function renderBanner(
50
+ peerName: string,
51
+ meta: PersonaMeta,
52
+ width = 60,
53
+ ): string[] {
54
+ const color = meta.color && isValidHex(meta.color) ? meta.color : DEFAULT_COLOR;
55
+ const purpose = (meta.description ?? "").trim();
56
+ const rule = hexFg(color, "━".repeat(Math.max(8, Math.min(width, 100))));
57
+ const title = hexFg(color, `● ${peerName}`);
58
+ const lines = [rule, title];
59
+ if (purpose) lines.push(`\x1b[2m${purpose}\x1b[0m`);
60
+ lines.push(rule);
61
+ return lines;
62
+ }
@@ -0,0 +1,101 @@
1
+ // scripts/lib/spawn-stagger.ts
2
+ //
3
+ // Pre-warm/stagger for simultaneous pi pane spawns (team-up, hub-team,
4
+ // team-resume). pi's credential store (~/.pi/agent/auth.json) is loaded once
5
+ // at boot under a short-retry file lock; when a stale OAuth token forces one
6
+ // pane to refresh it over the network WHILE holding that lock, sibling panes
7
+ // booting in the same instant lose the lock race and come up with an empty
8
+ // credential store — every provider shows "unconfigured". The fix is local:
9
+ // when a stale OAuth credential is detected, one pi pane starts immediately
10
+ // (the warmer — it refreshes the token) and every other pi pane sleeps a few
11
+ // seconds before launching. Fresh tokens mean zero delay everywhere.
12
+ //
13
+ // Pure logic only — no fs, no sockets, no process.exit. Callers read
14
+ // auth.json themselves (lock-free, same as pi's readStoredCredential) and
15
+ // inject delays into pane env; the `_peer`/`_peer-plus` recipes honor
16
+ // AGENT_FLEET_SPAWN_DELAY with a plain `sleep`.
17
+
18
+ /** Env var the justfile peer recipes read: seconds to sleep before launching pi. */
19
+ export const STAGGER_ENV_VAR = "AGENT_FLEET_SPAWN_DELAY";
20
+
21
+ /** Delay for the first staggered pane — long enough for the warmer's token refresh round-trip. */
22
+ export const WARMUP_SECONDS = 4;
23
+
24
+ /** Extra spacing between subsequent staggered panes. */
25
+ export const STEP_SECONDS = 1;
26
+
27
+ /** Treat tokens expiring within this window as stale — pane boot takes seconds. */
28
+ export const EXPIRY_MARGIN_MS = 60_000;
29
+
30
+ /**
31
+ * Does auth.json hold an OAuth credential that a booting pi would refresh?
32
+ * `raw` is the file's contents (undefined when unreadable/absent). Missing or
33
+ * malformed files never stagger: with no stored credential there is nothing
34
+ * to refresh, so there is no long lock hold to dodge.
35
+ */
36
+ export function oauthNeedsWarmup(raw: string | undefined, now = Date.now()): boolean {
37
+ if (!raw) return false;
38
+ let data: unknown;
39
+ try {
40
+ data = JSON.parse(raw);
41
+ } catch {
42
+ return false;
43
+ }
44
+ if (typeof data !== "object" || data === null) return false;
45
+ for (const credential of Object.values(data)) {
46
+ if (typeof credential !== "object" || credential === null) continue;
47
+ const { type, expires } = credential as { type?: unknown; expires?: unknown };
48
+ if (type !== "oauth" || typeof expires !== "number") continue;
49
+ if (expires <= now + EXPIRY_MARGIN_MS) return true;
50
+ }
51
+ return false;
52
+ }
53
+
54
+ export interface StaggerOptions {
55
+ /** Per-peer flag, in spawn order: does this pane boot a pi process? */
56
+ peerIsPi: boolean[];
57
+ /** Does the root pane (hub) boot a pi process? The hub warms when present. */
58
+ rootIsPi: boolean;
59
+ /** Result of oauthNeedsWarmup — false short-circuits to all-zero delays. */
60
+ needed: boolean;
61
+ warmupSeconds?: number;
62
+ stepSeconds?: number;
63
+ }
64
+
65
+ /**
66
+ * Per-peer delay seconds (spawn order). Exactly one pi process — the hub when
67
+ * present, otherwise the first pi peer — starts at 0 and refreshes the stale
68
+ * token; every other pi peer starts after the warm-up window. Non-pi panes
69
+ * (runner: claude-code) never wait: they do not touch pi's credential store.
70
+ */
71
+ export function staggerDelays(opts: StaggerOptions): number[] {
72
+ const { peerIsPi, rootIsPi, needed, warmupSeconds = WARMUP_SECONDS, stepSeconds = STEP_SECONDS } = opts;
73
+ if (!needed) return peerIsPi.map(() => 0);
74
+ let staggered = 0;
75
+ let warmerAssigned = rootIsPi;
76
+ return peerIsPi.map((isPi) => {
77
+ if (!isPi) return 0;
78
+ if (!warmerAssigned) {
79
+ warmerAssigned = true;
80
+ return 0;
81
+ }
82
+ return warmupSeconds + staggered++ * stepSeconds;
83
+ });
84
+ }
85
+
86
+ /**
87
+ * Convenience for the team entrypoints: auth.json contents + peers → a
88
+ * `delayForPeer` hook for buildTeamLayout. Structural peer type avoids a
89
+ * circular import with herdr-layout.ts.
90
+ */
91
+ export function planSpawnDelays<P extends { runner?: string }>(
92
+ peers: P[],
93
+ rootIsPi: boolean,
94
+ authJsonRaw: string | undefined,
95
+ now = Date.now(),
96
+ ): { needed: boolean; delayForPeer: (peer: P) => number | undefined } {
97
+ const needed = oauthNeedsWarmup(authJsonRaw, now);
98
+ const delays = staggerDelays({ peerIsPi: peers.map((p) => p.runner !== "claude-code"), rootIsPi, needed });
99
+ const byPeer = new Map<P, number>(peers.map((p, i) => [p, delays[i]]));
100
+ return { needed, delayForPeer: (peer) => byPeer.get(peer) };
101
+ }