@chankov/agent-fleet 0.0.7 → 0.0.9

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 (636) hide show
  1. package/.pi/agents/model-profiles.yaml +9 -2
  2. package/.pi/agents/peers.yaml +12 -16
  3. package/.pi/agents/teams.yaml +4 -2
  4. package/.pi/harnesses/agent-hub/README.md +20 -5
  5. package/.pi/harnesses/agent-hub/footer.ts +4 -2
  6. package/.pi/harnesses/agent-hub/index.ts +104 -11
  7. package/.pi/harnesses/agent-hub/package.json +1 -1
  8. package/.pi/harnesses/agent-hub/version.ts +25 -1
  9. package/.pi/harnesses/coms/README.md +8 -1
  10. package/.pi/harnesses/coms/package.json +1 -1
  11. package/.pi/harnesses/coms/version.ts +25 -1
  12. package/.pi/harnesses/damage-control-continue/README.md +8 -1
  13. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  14. package/.pi/harnesses/damage-control-continue/version.ts +25 -1
  15. package/.pi/harnesses/lib/herdr-client.ts +10 -1
  16. package/.pi/harnesses/lib/spawned-peers.js +190 -0
  17. package/.versions/0.0.8/.claude/commands/build.md +44 -0
  18. package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
  19. package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
  20. package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
  21. package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
  22. package/.versions/0.0.8/.claude/commands/plan.md +16 -0
  23. package/.versions/0.0.8/.claude/commands/prime.md +22 -0
  24. package/.versions/0.0.8/.claude/commands/review.md +16 -0
  25. package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
  26. package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
  27. package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
  28. package/.versions/0.0.8/.claude/commands/ship.md +72 -0
  29. package/.versions/0.0.8/.claude/commands/spec.md +15 -0
  30. package/.versions/0.0.8/.claude/commands/test.md +19 -0
  31. package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
  32. package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
  33. package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
  34. package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
  35. package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
  36. package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
  37. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  38. package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
  39. package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
  40. package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
  41. package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
  42. package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
  43. package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  44. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
  45. package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
  46. package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
  47. package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
  48. package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
  49. package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
  50. package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  51. package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
  52. package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
  53. package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
  54. package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
  55. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  56. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  57. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  58. package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
  59. package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
  60. package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
  61. package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
  62. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  63. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  64. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  65. package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  66. package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  67. package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  68. package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  69. package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  70. package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  71. package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
  72. package/.versions/0.0.8/.pi/extensions/package.json +9 -0
  73. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
  74. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  75. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  76. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  77. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  78. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  79. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  80. package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
  81. package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  82. package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  83. package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  84. package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  85. package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  86. package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
  87. package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  88. package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  89. package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
  90. package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
  91. package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
  92. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  93. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  94. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  95. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  96. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  97. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  98. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  99. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  100. package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  101. package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  102. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
  103. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  104. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  105. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  106. package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
  107. package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  108. package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  109. package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  110. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
  111. package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
  112. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
  113. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
  114. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  115. package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
  116. package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
  117. package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
  118. package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
  119. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
  120. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
  121. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  122. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
  123. package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  124. package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  125. package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
  126. package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  127. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  128. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  129. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  130. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  131. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  132. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  133. package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
  134. package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
  135. package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
  136. package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
  137. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  138. package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
  139. package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
  140. package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  141. package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  142. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
  143. package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
  144. package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
  145. package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
  146. package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
  147. package/.versions/0.0.8/.version +1 -0
  148. package/.versions/0.0.8/agents/architect.md +23 -0
  149. package/.versions/0.0.8/agents/bowser.md +26 -0
  150. package/.versions/0.0.8/agents/builder.md +53 -0
  151. package/.versions/0.0.8/agents/code-reviewer.md +205 -0
  152. package/.versions/0.0.8/agents/deep-researcher.md +31 -0
  153. package/.versions/0.0.8/agents/documenter.md +18 -0
  154. package/.versions/0.0.8/agents/orchestrator.md +65 -0
  155. package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
  156. package/.versions/0.0.8/agents/planner.md +69 -0
  157. package/.versions/0.0.8/agents/releaser.md +24 -0
  158. package/.versions/0.0.8/agents/researcher.md +28 -0
  159. package/.versions/0.0.8/agents/security-auditor.md +166 -0
  160. package/.versions/0.0.8/agents/test-engineer.md +151 -0
  161. package/.versions/0.0.8/agents/web-debugger.md +42 -0
  162. package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
  163. package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
  164. package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
  165. package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
  166. package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
  167. package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
  168. package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
  169. package/.versions/0.0.8/docs/getting-started.md +231 -0
  170. package/.versions/0.0.8/docs/npm-install.md +337 -0
  171. package/.versions/0.0.8/docs/opencode-setup.md +249 -0
  172. package/.versions/0.0.8/docs/pi-extensions.md +293 -0
  173. package/.versions/0.0.8/docs/pi-setup.md +476 -0
  174. package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
  175. package/.versions/0.0.8/hermes/README.md +347 -0
  176. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  177. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  178. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  179. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  180. package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
  181. package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
  182. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  183. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  184. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  185. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  186. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  187. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  188. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  189. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  190. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  191. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  192. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  193. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  194. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  195. package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
  196. package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
  197. package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
  198. package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
  199. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  200. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  201. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  202. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  203. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  204. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  205. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  206. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  207. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  208. package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
  209. package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
  210. package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
  211. package/.versions/0.0.8/hooks/hooks.json +14 -0
  212. package/.versions/0.0.8/hooks/session-start.sh +74 -0
  213. package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
  214. package/.versions/0.0.8/justfile +245 -0
  215. package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
  216. package/.versions/0.0.8/references/definition-of-done.md +67 -0
  217. package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
  218. package/.versions/0.0.8/references/observability-checklist.md +91 -0
  219. package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
  220. package/.versions/0.0.8/references/performance-checklist.md +153 -0
  221. package/.versions/0.0.8/references/prompting-patterns.md +380 -0
  222. package/.versions/0.0.8/references/security-checklist.md +179 -0
  223. package/.versions/0.0.8/references/testing-patterns.md +236 -0
  224. package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
  225. package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
  226. package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
  227. package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
  228. package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
  229. package/.versions/0.0.8/scripts/fleet.ts +149 -0
  230. package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
  231. package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
  232. package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
  233. package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
  234. package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
  235. package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
  236. package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
  237. package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
  238. package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
  239. package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
  240. package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
  241. package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
  242. package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
  243. package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
  244. package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
  245. package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
  246. package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
  247. package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
  248. package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
  249. package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
  250. package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
  251. package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
  252. package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
  253. package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
  254. package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
  255. package/.versions/0.0.8/scripts/team-up.ts +360 -0
  256. package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
  257. package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
  258. package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
  259. package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
  260. package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
  261. package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
  262. package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
  263. package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  264. package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  265. package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  266. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
  267. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
  268. package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
  269. package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
  270. package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
  271. package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  272. package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  273. package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
  274. package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
  275. package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
  276. package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
  277. package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
  278. package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
  279. package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
  280. package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
  281. package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
  282. package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  283. package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  284. package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
  285. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  286. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  287. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  288. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  289. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  290. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  291. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  292. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  293. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  294. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  295. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  296. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  297. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  298. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  299. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  300. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  301. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  302. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  303. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  304. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  305. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  306. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  307. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  308. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  309. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  310. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  311. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  312. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  313. package/.versions/0.0.9/.claude/commands/build.md +44 -0
  314. package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
  315. package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
  316. package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
  317. package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
  318. package/.versions/0.0.9/.claude/commands/plan.md +16 -0
  319. package/.versions/0.0.9/.claude/commands/prime.md +22 -0
  320. package/.versions/0.0.9/.claude/commands/review.md +16 -0
  321. package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
  322. package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
  323. package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
  324. package/.versions/0.0.9/.claude/commands/ship.md +72 -0
  325. package/.versions/0.0.9/.claude/commands/spec.md +15 -0
  326. package/.versions/0.0.9/.claude/commands/test.md +19 -0
  327. package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
  328. package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
  329. package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
  330. package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
  331. package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
  332. package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
  333. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  334. package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
  335. package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
  336. package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
  337. package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
  338. package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
  339. package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  340. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
  341. package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
  342. package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
  343. package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
  344. package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
  345. package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
  346. package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  347. package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
  348. package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
  349. package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
  350. package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
  351. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  352. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  353. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  354. package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
  355. package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
  356. package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
  357. package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
  358. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  359. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  360. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  361. package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  362. package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  363. package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  364. package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  365. package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  366. package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  367. package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
  368. package/.versions/0.0.9/.pi/extensions/package.json +9 -0
  369. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
  370. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  371. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  372. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  373. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  374. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  375. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  376. package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
  377. package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  378. package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  379. package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  380. package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  381. package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  382. package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
  383. package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  384. package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  385. package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
  386. package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
  387. package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
  388. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  389. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  390. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  391. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  392. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  393. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  394. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  395. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  396. package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  397. package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  398. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
  399. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  400. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  401. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  402. package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
  403. package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  404. package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  405. package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  406. package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
  407. package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  408. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
  409. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
  410. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  411. package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
  412. package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
  413. package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
  414. package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
  415. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
  416. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
  417. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  418. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  419. package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  420. package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  421. package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  422. package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  423. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  424. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  425. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  426. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  427. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  428. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  429. package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  430. package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
  431. package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
  432. package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
  433. package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
  434. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  435. package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
  436. package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
  437. package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  438. package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  439. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
  440. package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
  441. package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
  442. package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
  443. package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
  444. package/.versions/0.0.9/.version +1 -0
  445. package/.versions/0.0.9/agents/architect.md +24 -0
  446. package/.versions/0.0.9/agents/bowser.md +27 -0
  447. package/.versions/0.0.9/agents/builder.md +54 -0
  448. package/.versions/0.0.9/agents/code-reviewer.md +204 -0
  449. package/.versions/0.0.9/agents/deep-researcher.md +32 -0
  450. package/.versions/0.0.9/agents/documenter.md +18 -0
  451. package/.versions/0.0.9/agents/orchestrator.md +66 -0
  452. package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
  453. package/.versions/0.0.9/agents/planner.md +70 -0
  454. package/.versions/0.0.9/agents/releaser.md +24 -0
  455. package/.versions/0.0.9/agents/researcher.md +28 -0
  456. package/.versions/0.0.9/agents/security-auditor.md +167 -0
  457. package/.versions/0.0.9/agents/test-engineer.md +153 -0
  458. package/.versions/0.0.9/agents/web-debugger.md +43 -0
  459. package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
  460. package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
  461. package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
  462. package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
  463. package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
  464. package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
  465. package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
  466. package/.versions/0.0.9/docs/getting-started.md +231 -0
  467. package/.versions/0.0.9/docs/npm-install.md +337 -0
  468. package/.versions/0.0.9/docs/opencode-setup.md +249 -0
  469. package/.versions/0.0.9/docs/pi-extensions.md +356 -0
  470. package/.versions/0.0.9/docs/pi-setup.md +476 -0
  471. package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
  472. package/.versions/0.0.9/hermes/README.md +347 -0
  473. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  474. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  475. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  476. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  477. package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
  478. package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
  479. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  480. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  481. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  482. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  483. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  484. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  485. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  486. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  487. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  488. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  489. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  490. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  491. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  492. package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
  493. package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
  494. package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
  495. package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
  496. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  497. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  498. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  499. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  500. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  501. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  502. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  503. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  504. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  505. package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
  506. package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
  507. package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
  508. package/.versions/0.0.9/hooks/hooks.json +14 -0
  509. package/.versions/0.0.9/hooks/session-start.sh +74 -0
  510. package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
  511. package/.versions/0.0.9/justfile +254 -0
  512. package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
  513. package/.versions/0.0.9/references/definition-of-done.md +67 -0
  514. package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
  515. package/.versions/0.0.9/references/observability-checklist.md +91 -0
  516. package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
  517. package/.versions/0.0.9/references/performance-checklist.md +153 -0
  518. package/.versions/0.0.9/references/prompting-patterns.md +380 -0
  519. package/.versions/0.0.9/references/security-checklist.md +179 -0
  520. package/.versions/0.0.9/references/testing-patterns.md +236 -0
  521. package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
  522. package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
  523. package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
  524. package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
  525. package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
  526. package/.versions/0.0.9/scripts/fleet.ts +168 -0
  527. package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
  528. package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
  529. package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
  530. package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
  531. package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
  532. package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
  533. package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
  534. package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
  535. package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
  536. package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
  537. package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
  538. package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
  539. package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
  540. package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
  541. package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
  542. package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
  543. package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
  544. package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
  545. package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
  546. package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
  547. package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
  548. package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
  549. package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
  550. package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
  551. package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
  552. package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
  553. package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
  554. package/.versions/0.0.9/scripts/team-up.ts +360 -0
  555. package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
  556. package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
  557. package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
  558. package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
  559. package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
  560. package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
  561. package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
  562. package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  563. package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  564. package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  565. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
  566. package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
  567. package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
  568. package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
  569. package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
  570. package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  571. package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  572. package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
  573. package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
  574. package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
  575. package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
  576. package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
  577. package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
  578. package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
  579. package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
  580. package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
  581. package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  582. package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  583. package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
  584. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  585. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  586. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  587. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  588. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  589. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  590. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  591. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  592. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  593. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  594. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  595. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  596. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  597. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  598. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  599. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  600. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  601. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  602. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  603. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  604. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  605. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  606. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  607. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  608. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  609. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  610. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  611. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  612. package/CHANGELOG.md +44 -0
  613. package/agents/architect.md +1 -0
  614. package/agents/bowser.md +1 -0
  615. package/agents/builder.md +1 -0
  616. package/agents/code-reviewer.md +4 -5
  617. package/agents/deep-researcher.md +2 -1
  618. package/agents/orchestrator.md +1 -0
  619. package/agents/plan-reviewer.md +3 -1
  620. package/agents/planner.md +3 -2
  621. package/agents/security-auditor.md +1 -0
  622. package/agents/test-engineer.md +3 -1
  623. package/agents/web-debugger.md +1 -0
  624. package/agents/web-performance-auditor.md +1 -0
  625. package/docs/ARCHITECTURE.md +1 -1
  626. package/docs/pi-extensions.md +66 -3
  627. package/justfile +10 -1
  628. package/package.json +2 -2
  629. package/scripts/fleet.ts +22 -3
  630. package/scripts/lib/fleet-command.ts +5 -3
  631. package/scripts/lib/herdr-layout.ts +18 -0
  632. package/scripts/lib/peer-launch.ts +314 -0
  633. package/scripts/lib/team-project.ts +3 -1
  634. package/scripts/peer-launch.ts +259 -0
  635. package/skills/guided-workspace-setup/companion-manifest.json +3 -0
  636. /package/{.pi → .versions/0.0.8/.pi}/harnesses/agent-hub/spawned-peers.js +0 -0
@@ -4,14 +4,21 @@
4
4
  #
5
5
  # Profiles only switch the personas they list; everyone else keeps their
6
6
  # current model. They never touch delegate-children (`subagents:`) models.
7
- max:
7
+ mix-max:
8
+ code-reviewer: github-copilot/claude-opus-5
9
+ builder: openai-codex/gpt-5.6-sol
10
+ planner: github-copilot/claude-fable-5
11
+ plan-reviewer: openai-codex/gpt-5.6-sol
12
+ security-auditor: xai/grok-4.5
13
+ test-engineer: xai/grok-4.5
14
+ sol:
8
15
  code-reviewer: openai-codex/gpt-5.6-sol
9
16
  builder: openai-codex/gpt-5.6-sol
10
17
  planner: openai-codex/gpt-5.6-sol
11
18
  plan-reviewer: openai-codex/gpt-5.6-sol
12
19
  security-auditor: openai-codex/gpt-5.6-sol
13
20
  test-engineer: openai-codex/gpt-5.6-sol
14
- budget:
21
+ terra:
15
22
  code-reviewer: openai-codex/gpt-5.6-terra
16
23
  builder: openai-codex/gpt-5.6-terra
17
24
  planner: openai-codex/gpt-5.6-terra
@@ -4,6 +4,12 @@
4
4
  # (requires a running herdr server — https://herdr.dev),
5
5
  # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
6
  #
7
+ # A team is NOT required to launch a single peer: `just fleet peer <name>` puts
8
+ # one peer (pi or `--runner claude-code`) in its own pane — splitting the current
9
+ # pane inside Herdr, else creating a one-pane workspace, or `--here` for the
10
+ # calling terminal. A name declared below keeps its runner/model/extensions/
11
+ # env_file; an undeclared name works too.
12
+ #
7
13
  # Each peer entry:
8
14
  # name — coms identity (the addressable peer name); overrides persona frontmatter
9
15
  # persona — file under agents/ (without .md); its body is the role, its
@@ -37,10 +43,10 @@ full:
37
43
  extensions: chrome-devtools-mcp
38
44
  - name: documenter
39
45
  persona: documenter
40
- model: openai-codex/gpt-5.6-terra
46
+ model: openai-codex/gpt-5.6-terra
41
47
  - name: researcher
42
48
  persona: researcher
43
- model: openai-codex/gpt-5.6-luna
49
+ model: openai-codex/gpt-5.6-luna
44
50
 
45
51
  web:
46
52
  - name: web-debugger
@@ -58,22 +64,12 @@ docs:
58
64
 
59
65
  # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
60
66
  default:
61
- - name: planner
62
- persona: planner
63
- model: openai-codex/gpt-5.6-sol
64
- - name: plan-reviewer
65
- runner: claude-code
66
- - name: builder
67
- persona: builder
68
- model: openai-codex/gpt-5.6-terra
69
- - name: test-engineer
70
- persona: test-engineer
71
- model: openai-codex/gpt-5.6-terra
72
67
  - name: code-reviewer
73
68
  runner: claude-code
74
- - name: documenter
75
- persona: documenter
69
+ - name: web-debugger
70
+ persona: web-debugger
76
71
  model: openai-codex/gpt-5.6-terra
72
+ extensions: chrome-devtools-mcp
77
73
 
78
74
  debug:
79
75
  - name: test-engineer
@@ -143,4 +139,4 @@ plan:
143
139
  - name: planner
144
140
  runner: claude-code
145
141
  - name: code-reviewer
146
- runner: claude-code
142
+ runner: claude-code
@@ -2,13 +2,15 @@
2
2
  # researcher / deep-researcher are not listed — they are always available through spawn_research.
3
3
 
4
4
  default:
5
- - planner
6
- - plan-reviewer
7
5
  - builder
8
6
  - test-engineer
9
7
  - code-reviewer
10
8
  - documenter
11
9
 
10
+ plan:
11
+ - planner
12
+ - plan-reviewer
13
+
12
14
  debug:
13
15
  - test-engineer
14
16
  - builder
@@ -282,7 +282,7 @@ the input box) and back. The current mode and binding are shown in the footer
282
282
  ### Version footer
283
283
 
284
284
  `agent-hub` renders its local harness version first in its custom footer:
285
- `v<version> · <model><thinking> · <team>`. It replaces pi's default footer, so it does **not**
285
+ `agent fleet v<version> · <model><thinking> · <team>`. It replaces pi's default footer, so it does **not**
286
286
  consume or render the shared version status; it reads its own adjacent stamped manifest directly.
287
287
  The three persistent-UI harnesses (`agent-hub`, `coms`, and
288
288
  `damage-control-continue`) still register that one shared key, which gives default footers one
@@ -294,6 +294,13 @@ by `bin/sync-harness-versions.js`. Its local `version.ts` reader intentionally s
294
294
  harness for copied or symlinked installs, but those installs still need the pre-existing full
295
295
  `.pi/harnesses/` dependency installation.
296
296
 
297
+ The `agent fleet` half of the label is an OSC 8 terminal hyperlink to the project homepage —
298
+ clickable in terminals that support hyperlinks, ignored (rendered as plain text) elsewhere, and
299
+ free of footer columns because pi strips OSC sequences before measuring width. It opens the
300
+ repository in a browser, not a TUI panel: pi has no mouse tracking, so a click never reaches the
301
+ harness. `AGENT_FLEET_NO_LINKS=1` restores the plain label on multiplexers that mangle OSC 8
302
+ (GNU screen, tmux before 3.4).
303
+
297
304
  ### Voice dictation indicator
298
305
 
299
306
  The custom footer renders the optional [`pi-voice-stt`](../../extensions/pi-voice-stt/README.md)
@@ -548,10 +555,18 @@ Inside a [herdr](https://herdr.dev) pane with a live server, the dispatcher's to
548
555
  surface additionally gets (absent otherwise, like coms):
549
556
 
550
557
  - `herdr_spawn_peer` — stand up a persona peer (joins the coms pool via `just _peer`) or a
551
- raw command pane in the current workspace. A persona peer **boots idle** and does nothing until
552
- a `coms_send` reaches it, so the call waits (bounded, ~45s) for it to register and returns
553
- `peer_ready` plus its coms name instead of a bare pane id. Peers spawned but never addressed are
554
- named at turn end and in `/af-hub-report` with a close suggestion — closing stays the human's call
558
+ raw command pane in the current workspace. The peer joins **this session's `--project` pool**, and
559
+ a name declared in `.pi/agents/peers.yaml` keeps its declared `runner:`/`extensions:`/`env_file:`,
560
+ so a spawn by name is the same agent a team launch would produce. A persona peer **boots idle**
561
+ and does nothing until a `coms_send` reaches it, so the call waits (bounded, ~45s) for it to
562
+ register and returns `peer_ready` plus its coms name instead of a bare pane id; on failure it
563
+ returns the pane's last output, which means the peer did not start rather than that it is slow.
564
+ Peers spawned but never addressed are named at turn end and in `/af-hub-report` with a close
565
+ suggestion — closing stays the human's call.
566
+ Mechanism: herdr's `pane.split` takes **no command** — it opens a shell — so the spawn splits,
567
+ waits for the pane's prompt, and types the argv (text and Enter sent separately, because bash
568
+ bracketed paste would swallow a newline). Only `layout.apply` pane nodes carry an argv, which is
569
+ why `just fleet team` was never affected by this
555
570
  - `herdr_read_pane` — bounded `pane.read` (≤200 lines), read-to-decide on workers/tools;
556
571
  messaging still goes through coms, and peer busy state comes from `coms_list`, not from
557
572
  reading the screen
@@ -1,3 +1,5 @@
1
+ import { formatVersionLabel } from "./version.ts";
2
+
1
3
  type FooterTheme = {
2
4
  fg(color: string, text: string): string;
3
5
  };
@@ -8,7 +10,7 @@ export function composeHubFooterLeft(
8
10
  thinkingSuffix: string,
9
11
  team: string,
10
12
  ): string {
11
- return [version ? `v${version}` : "", `${model}${thinkingSuffix}`, team]
13
+ return [version ? formatVersionLabel(version) : "", `${model}${thinkingSuffix}`, team]
12
14
  .filter(Boolean)
13
15
  .join(" · ");
14
16
  }
@@ -20,7 +22,7 @@ export function renderHubFooterLeft(
20
22
  thinkingSuffix: string,
21
23
  team: string,
22
24
  ): string {
23
- const metadata = [version ? `v${version}` : "", `${model}${thinkingSuffix}`]
25
+ const metadata = [version ? formatVersionLabel(version) : "", `${model}${thinkingSuffix}`]
24
26
  .filter(Boolean)
25
27
  .join(" · ");
26
28
  const dimMetadata = theme.fg("dim", ` ${metadata}`);
@@ -92,7 +92,15 @@ import { applyModelOverride, clampDelegateDepth, DELEGATE_TREE_SPAWN_BUDGET, fal
92
92
  import { DEFAULT_HUB_MODE, DEFAULT_TASK_TIER, HUB_MODES, TASK_TIERS, budgetStatusLine, checkTurnBudget, contextOverflowDiagnostic, normalizeHubMode, normalizeTaskTier, resolveTurnBudget, shouldRecycleSession } from "./run-budget.js";
93
93
  import { MAX_OPEN_ASSERTIONS, validateAssertionBatch } from "./assertion-ledger.js";
94
94
  import { DEFAULT_PROVIDER_LIMITS, createProviderSemaphore, parseProviderLimits } from "./provider-semaphore.js";
95
- import { PEER_READY_TIMEOUT_MS, peerReadyDelayMs, peerReadyVerdict, unaddressedPeerSweep } from "./spawned-peers.js";
95
+ import {
96
+ PANE_PROMPT_TIMEOUT_MS,
97
+ PEER_READY_TIMEOUT_MS,
98
+ launchPeerInPane,
99
+ peerReadyDelayMs,
100
+ peerReadyVerdict,
101
+ spawnStaggerSeconds,
102
+ unaddressedPeerSweep,
103
+ } from "../lib/spawned-peers.js";
96
104
  import { contextPct, estimatePromptTokens, overWindowDiagnostic, resolveContextWindow, shouldRecycleBeforeSpawn } from "./context-window.js";
97
105
  import { DEFAULT_WATCHDOG_SETTING, WATCHDOG_SETTINGS, buildJudgePrompt, createDriftMonitor, hubOwnedScopeGlobs, normalizeWatchdogSetting, parseJudgeVerdict, resolveWatchdogActive } from "./drift-watchdog.js";
98
106
  import { forceQuarantineSession, isCorruptSessionExit, quarantineIfUnusable } from "./session-health.js";
@@ -116,7 +124,9 @@ import {
116
124
  } from "../lib/herdr-presence.ts";
117
125
  import { herdr as herdrApi, herdrAvailable } from "../lib/herdr-client.ts";
118
126
  import { buildLiveRegistryEntry, type ComsRegistryEntry } from "../lib/coms-registry-entry.ts";
119
- import { peerCommand } from "../../../scripts/lib/herdr-layout.ts";
127
+ import { findPeerByName, parseEnvFile, parsePeersYaml, peerCommand, resolveEnvFilePath } from "../../../scripts/lib/herdr-layout.ts";
128
+ import { DEFAULT_PROJECT } from "../../../scripts/lib/team-project.ts";
129
+ import { STAGGER_ENV_VAR, WARMUP_SECONDS, oauthNeedsWarmup } from "../../../scripts/lib/spawn-stagger.ts";
120
130
  import { join, resolve } from "path";
121
131
  import * as net from "node:net";
122
132
  import * as fs from "node:fs";
@@ -5963,11 +5973,56 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
5963
5973
  }
5964
5974
  }
5965
5975
 
5976
+ /** When the last hub-spawned pi peer was launched — input to the stale-token stagger. */
5977
+ let lastHubPiSpawnAt: number | null = null;
5978
+
5979
+ /** Last lines of a pane, for reporting why a spawn failed. Never throws. */
5980
+ async function paneTail(paneId: string, lines = 12): Promise<string> {
5981
+ try {
5982
+ const { read } = await herdrApi.paneRead({ pane_id: paneId, lines });
5983
+ return read?.text ?? "";
5984
+ } catch {
5985
+ return "";
5986
+ }
5987
+ }
5988
+
5989
+ /**
5990
+ * The peers.yaml declaration for a peer name, when the repo has one. A hub
5991
+ * spawn is handed a bare name, but the fleet may define that name as a
5992
+ * `runner: claude-code` peer or one that needs extra extensions — launching
5993
+ * a plain pi peer instead would silently produce a different agent.
5994
+ */
5995
+ function declaredPeer(name: string): ReturnType<typeof findPeerByName> {
5996
+ const cwd = currentCtx?.cwd ?? process.cwd();
5997
+ try {
5998
+ const raw = fs.readFileSync(path.join(cwd, ".pi", "agents", "peers.yaml"), "utf-8");
5999
+ return findPeerByName(parsePeersYaml(raw), name);
6000
+ } catch {
6001
+ return undefined;
6002
+ }
6003
+ }
6004
+
6005
+ /** Seconds this spawn should sleep before launching pi (stale-OAuth lock race). */
6006
+ function spawnDelaySeconds(): number {
6007
+ let authRaw: string | undefined;
6008
+ try {
6009
+ authRaw = fs.readFileSync(path.join(os.homedir(), ".pi", "agent", "auth.json"), "utf-8");
6010
+ } catch {
6011
+ authRaw = undefined;
6012
+ }
6013
+ return spawnStaggerSeconds({
6014
+ needed: oauthNeedsWarmup(authRaw),
6015
+ lastSpawnAt: lastHubPiSpawnAt,
6016
+ now: Date.now(),
6017
+ warmupSeconds: WARMUP_SECONDS,
6018
+ });
6019
+ }
6020
+
5966
6021
  pi.registerTool({
5967
6022
  name: "herdr_spawn_peer",
5968
6023
  label: "Herdr Spawn Peer",
5969
6024
  description:
5970
- "Spawn a pane in the CURRENT herdr workspace: either a peers.yaml-style coms peer (persona [+ name/model], launched via `just _peer`) or a raw command pane. A persona peer boots IDLE and does nothing until you coms_send to it — spawning delivers no work. The call waits (bounded) for the peer to register and returns `peer_ready` plus its coms name, or `peer_ready: false` with the wait stated. Spawn one only immediately before the first message you will send it; a peer that receives no work is named in the session digest.",
6025
+ "Spawn a pane in the CURRENT herdr workspace: either a peers.yaml-style coms peer (persona [+ name/model], launched via `just _peer`) or a raw command pane. The peer joins THIS session's coms project pool, and a name declared in .pi/agents/peers.yaml keeps its declared runner/extensions. A persona peer boots IDLE and does nothing until you coms_send to it — spawning delivers no work. The call waits (bounded) for the peer to register and returns `peer_ready` plus its coms name, or `peer_ready: false` with the pane's last output — treat that as a failed start, not a slow one. Spawn one only immediately before the first message you will send it; a peer that receives no work is named in the session digest.",
5971
6026
  parameters: Type.Object({
5972
6027
  persona: Type.Optional(Type.String({ description: "Persona under agents/ (e.g. researcher). Omit for a raw command pane." })),
5973
6028
  name: Type.String({ description: "Pane label; for persona peers also the coms peer name." }),
@@ -5984,37 +6039,72 @@ Finish with the artifact-relative path plus a digest of no more than 10 lines. I
5984
6039
  return { content: [{ type: "text" as const, text: "not inside a herdr pane." }], details: { error: "no pane" } };
5985
6040
  }
5986
6041
  try {
6042
+ const cwd = currentCtx?.cwd ?? process.cwd();
6043
+ const env: Record<string, string> = {};
5987
6044
  let argv: string[];
5988
6045
  if (params.persona) {
5989
- argv = peerCommand({ persona: params.persona, name: params.name, model: params.model }, "hub-spawned");
6046
+ // The peer joins THIS hub's coms pool. Defaulting to "default"
6047
+ // (as this once did) puts it in a pool the hub cannot see, so it
6048
+ // never registers no matter how long the readiness wait runs.
6049
+ const declared = declaredPeer(params.name);
6050
+ argv = peerCommand(
6051
+ {
6052
+ persona: params.persona,
6053
+ name: params.name,
6054
+ model: params.model ?? declared?.model,
6055
+ extensions: declared?.extensions,
6056
+ runner: declared?.runner,
6057
+ },
6058
+ "hub-spawned",
6059
+ undefined,
6060
+ identity?.project ?? DEFAULT_PROJECT,
6061
+ );
6062
+ if (declared?.env_file) {
6063
+ Object.assign(env, parseEnvFile(fs.readFileSync(resolveEnvFilePath(declared.env_file, cwd), "utf-8"), declared.env_file));
6064
+ }
6065
+ const delay = declared?.runner === "claude-code" ? 0 : spawnDelaySeconds();
6066
+ if (delay > 0) env[STAGGER_ENV_VAR] = String(delay);
5990
6067
  } else if (params.command) {
5991
6068
  argv = ["bash", "-lc", params.command];
5992
6069
  } else {
5993
6070
  return { content: [{ type: "text" as const, text: "pass persona (peer) or command (raw pane)." }], details: { error: "bad args" } };
5994
6071
  }
6072
+ // pane.split takes no command — it opens a shell in `cwd`.
5995
6073
  const { pane } = await herdrApi.paneSplit({
5996
6074
  target_pane_id: ownPane,
5997
6075
  direction: params.direction ?? "right",
5998
- command: argv,
5999
- cwd: currentCtx?.cwd ?? process.cwd(),
6076
+ cwd,
6077
+ ...(Object.keys(env).length > 0 ? { env } : {}),
6000
6078
  focus: false,
6001
6079
  });
6002
6080
  try { await herdrApi.paneRename(pane.pane_id, params.name); } catch { /* cosmetic */ }
6081
+ // …so the argv is typed into that shell once it shows a prompt.
6082
+ const launch = await launchPeerInPane(herdrApi, pane.pane_id, argv);
6083
+ if (params.persona) lastHubPiSpawnAt = Date.now();
6084
+ const promptNote = launch.promptSeen
6085
+ ? ""
6086
+ : `\n⚠ pane ${pane.pane_id} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`;
6003
6087
  // A raw command pane is not a coms peer — nothing to wait for and
6004
6088
  // nothing to sweep. A persona peer is only useful once addressable,
6005
6089
  // so report that verdict instead of a bare pane id.
6006
6090
  if (!params.persona) {
6007
6091
  return {
6008
- content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}` }],
6009
- details: { pane_id: pane.pane_id, name: params.name },
6092
+ content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}${promptNote}` }],
6093
+ details: { pane_id: pane.pane_id, name: params.name, prompt_seen: launch.promptSeen },
6010
6094
  };
6011
6095
  }
6012
6096
  hubSpawnedPeers.set(params.name.toLowerCase(), { name: params.name, paneId: pane.pane_id, addressed: false });
6013
6097
  const { found, waitedMs } = await waitForPeerRegistration(params.name);
6014
- const verdict = peerReadyVerdict({ name: params.name, paneId: pane.pane_id, found, waitedMs });
6098
+ const verdict = peerReadyVerdict({
6099
+ name: params.name,
6100
+ paneId: pane.pane_id,
6101
+ found,
6102
+ waitedMs,
6103
+ paneTail: found ? undefined : await paneTail(pane.pane_id),
6104
+ });
6015
6105
  return {
6016
- content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}\n\n${verdict.message}` }],
6017
- details: { pane_id: pane.pane_id, name: params.name, ...verdict },
6106
+ content: [{ type: "text" as const, text: `spawned pane ${pane.pane_id} (${params.name}): ${argv.join(" ")}${promptNote}\n\n${verdict.message}` }],
6107
+ details: { pane_id: pane.pane_id, name: params.name, prompt_seen: launch.promptSeen, ...verdict },
6018
6108
  };
6019
6109
  } catch (err) {
6020
6110
  const m = err instanceof Error ? err.message : String(err);
@@ -7882,6 +7972,9 @@ This session runs inside a herdr workspace and can drive panes:
7882
7972
  ready" and never addressed is an empty pane named like a worker. If you sent it no work
7883
7973
  by the end of the turn, say so and offer to close it; the hub names unaddressed
7884
7974
  hub-spawned peers in the session digest.
7975
+ - \`peer_ready: false\` is a FAILED start, not a slow one. The result carries the pane's last
7976
+ output — read it, then fix the cause or close the pane and spawn again. Never \`coms_send\`
7977
+ to a name that never registered, and never spawn a second peer to route around the first.
7885
7978
  - \`herdr_read_pane\` is read-to-decide: peek at a worker/tool pane's recent output before
7886
7979
  acting on it. It is NOT a messaging channel and NOT a status poll — \`coms_list\` already
7887
7980
  reports each peer's \`pane_id\` and \`status\` (idle | working | booting), so check that
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.7"
6
+ "version": "0.0.9"
7
7
  }
@@ -1,6 +1,30 @@
1
1
  import { readFileSync } from "node:fs";
2
2
 
3
3
  export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+ export const VERSION_LABEL = "agent fleet";
5
+ export const VERSION_LABEL_URL = "https://github.com/chankov/agent-fleet";
6
+
7
+ /**
8
+ * Wrap `text` in an OSC 8 hyperlink. Terminals that support it make the label
9
+ * clickable and hand the URL to the OS opener; terminals that don't ignore the
10
+ * sequence and render `text` unchanged. pi's TUI strips OSC sequences before
11
+ * measuring (`visibleWidth`) and truncating, so a linked label costs no footer
12
+ * columns. Multiplexers that mangle unknown OSC (GNU screen, tmux before 3.4)
13
+ * are the reason for the AGENT_FLEET_NO_LINKS opt-out below.
14
+ */
15
+ export function linkify(text: string, url: string): string {
16
+ return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
17
+ }
18
+
19
+ function linksEnabled(): boolean {
20
+ const optOut = process.env.AGENT_FLEET_NO_LINKS;
21
+ return !optOut || optOut === "0" || optOut === "false";
22
+ }
23
+
24
+ export function formatVersionLabel(version: string): string {
25
+ const label = linksEnabled() ? linkify(VERSION_LABEL, VERSION_LABEL_URL) : VERSION_LABEL;
26
+ return `${label} v${version}`;
27
+ }
4
28
 
5
29
  function readAdjacentVersion(): string | null {
6
30
  try {
@@ -14,5 +38,5 @@ function readAdjacentVersion(): string | null {
14
38
  export const HARNESS_VERSION = readAdjacentVersion();
15
39
 
16
40
  export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
17
- if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
41
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, formatVersionLabel(HARNESS_VERSION));
18
42
  }
@@ -15,7 +15,7 @@ clean shutdown lifecycle.
15
15
 
16
16
  ## Version footer and provenance
17
17
 
18
- This persistent-UI harness shows `v<version>` below the prompt. It shares one common-key
18
+ This persistent-UI harness shows `agent fleet v<version>` below the prompt. It shares one common-key
19
19
  status with `agent-hub` and `damage-control-continue`, so a stack renders the
20
20
  version once. The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes
21
21
  its value into this adjacent manifest. The local `version.ts` reader is retained so a copied or
@@ -23,6 +23,13 @@ symlinked harness resolves its own adjacent stamp, not the launch directory. Tha
23
23
  pair does not carry dependencies: copy/symlink targets still require the existing full
24
24
  `.pi/harnesses/` dependency installation.
25
25
 
26
+ The `agent fleet` half of the label is an OSC 8 terminal hyperlink to the project homepage —
27
+ clickable in terminals that support hyperlinks, ignored (rendered as plain text) elsewhere, and
28
+ free of footer columns because pi strips OSC sequences before measuring width. It opens the
29
+ repository in a browser, not a TUI panel: pi has no mouse tracking, so a click never reaches the
30
+ harness. `AGENT_FLEET_NO_LINKS=1` restores the plain label on multiplexers that mangle OSC 8
31
+ (GNU screen, tmux before 3.4).
32
+
26
33
  ## Presence backends: herdr vs files
27
34
 
28
35
  Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.7"
6
+ "version": "0.0.9"
7
7
  }
@@ -1,6 +1,30 @@
1
1
  import { readFileSync } from "node:fs";
2
2
 
3
3
  export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+ export const VERSION_LABEL = "agent fleet";
5
+ export const VERSION_LABEL_URL = "https://github.com/chankov/agent-fleet";
6
+
7
+ /**
8
+ * Wrap `text` in an OSC 8 hyperlink. Terminals that support it make the label
9
+ * clickable and hand the URL to the OS opener; terminals that don't ignore the
10
+ * sequence and render `text` unchanged. pi's TUI strips OSC sequences before
11
+ * measuring (`visibleWidth`) and truncating, so a linked label costs no footer
12
+ * columns. Multiplexers that mangle unknown OSC (GNU screen, tmux before 3.4)
13
+ * are the reason for the AGENT_FLEET_NO_LINKS opt-out below.
14
+ */
15
+ export function linkify(text: string, url: string): string {
16
+ return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
17
+ }
18
+
19
+ function linksEnabled(): boolean {
20
+ const optOut = process.env.AGENT_FLEET_NO_LINKS;
21
+ return !optOut || optOut === "0" || optOut === "false";
22
+ }
23
+
24
+ export function formatVersionLabel(version: string): string {
25
+ const label = linksEnabled() ? linkify(VERSION_LABEL, VERSION_LABEL_URL) : VERSION_LABEL;
26
+ return `${label} v${version}`;
27
+ }
4
28
 
5
29
  function readAdjacentVersion(): string | null {
6
30
  try {
@@ -14,5 +38,5 @@ function readAdjacentVersion(): string | null {
14
38
  export const HARNESS_VERSION = readAdjacentVersion();
15
39
 
16
40
  export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
17
- if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
41
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, formatVersionLabel(HARNESS_VERSION));
18
42
  }
@@ -18,7 +18,7 @@ approval/exemption paths below; inherently dangerous command patterns never can.
18
18
 
19
19
  ## Version footer and provenance
20
20
 
21
- This persistent-UI harness shows `v<version>` below the prompt. It shares one common-key
21
+ This persistent-UI harness shows `agent fleet v<version>` below the prompt. It shares one common-key
22
22
  status with `agent-hub` and `coms`, so a stack renders the version once. Its
23
23
  version remains separate from the mutable `damage-control` status: active-rule and
24
24
  last-violation feedback never replaces it. The root `package.json` is canonical;
@@ -27,6 +27,13 @@ last-violation feedback never replaces it. The root `package.json` is canonical;
27
27
  stamp, but those targets still require the pre-existing full `.pi/harnesses/` dependency
28
28
  installation.
29
29
 
30
+ The `agent fleet` half of the label is an OSC 8 terminal hyperlink to the project homepage —
31
+ clickable in terminals that support hyperlinks, ignored (rendered as plain text) elsewhere, and
32
+ free of footer columns because pi strips OSC sequences before measuring width. It opens the
33
+ repository in a browser, not a TUI panel: pi has no mouse tracking, so a click never reaches the
34
+ harness. `AGENT_FLEET_NO_LINKS=1` restores the plain label on multiplexers that mangle OSC 8
35
+ (GNU screen, tmux before 3.4).
36
+
30
37
  ## Exemptions — allow access per turn or per session
31
38
 
32
39
  Runtime allowances layered on top of the rules file (which is never modified).
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.7"
6
+ "version": "0.0.9"
7
7
  }
@@ -1,6 +1,30 @@
1
1
  import { readFileSync } from "node:fs";
2
2
 
3
3
  export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+ export const VERSION_LABEL = "agent fleet";
5
+ export const VERSION_LABEL_URL = "https://github.com/chankov/agent-fleet";
6
+
7
+ /**
8
+ * Wrap `text` in an OSC 8 hyperlink. Terminals that support it make the label
9
+ * clickable and hand the URL to the OS opener; terminals that don't ignore the
10
+ * sequence and render `text` unchanged. pi's TUI strips OSC sequences before
11
+ * measuring (`visibleWidth`) and truncating, so a linked label costs no footer
12
+ * columns. Multiplexers that mangle unknown OSC (GNU screen, tmux before 3.4)
13
+ * are the reason for the AGENT_FLEET_NO_LINKS opt-out below.
14
+ */
15
+ export function linkify(text: string, url: string): string {
16
+ return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
17
+ }
18
+
19
+ function linksEnabled(): boolean {
20
+ const optOut = process.env.AGENT_FLEET_NO_LINKS;
21
+ return !optOut || optOut === "0" || optOut === "false";
22
+ }
23
+
24
+ export function formatVersionLabel(version: string): string {
25
+ const label = linksEnabled() ? linkify(VERSION_LABEL, VERSION_LABEL_URL) : VERSION_LABEL;
26
+ return `${label} v${version}`;
27
+ }
4
28
 
5
29
  function readAdjacentVersion(): string | null {
6
30
  try {
@@ -14,5 +38,5 @@ function readAdjacentVersion(): string | null {
14
38
  export const HARNESS_VERSION = readAdjacentVersion();
15
39
 
16
40
  export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
17
- if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
41
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, formatVersionLabel(HARNESS_VERSION));
18
42
  }
@@ -351,6 +351,16 @@ export const herdr = {
351
351
 
352
352
  // NOTE: the target field is `target_pane_id` — `pane_id` would be silently
353
353
  // ignored and the FOCUSED pane split instead (spike finding).
354
+ //
355
+ // There is NO `command` param: a split always opens a plain interactive
356
+ // shell in `cwd`. Verified against herdr 0.7.5 — `PaneSplitParams` is
357
+ // {target_pane_id, direction, ratio, cwd, env, focus} and `herdr pane split
358
+ // --help` exposes no command flag. Only `layout.apply` pane nodes carry
359
+ // `command: [argv…]`. This type used to advertise `command?: string[]`;
360
+ // because unknown params are silently ignored, callers got a bare shell
361
+ // pane and a success response. To launch something in a split pane, send
362
+ // the command line as input once the pane is at its shell prompt
363
+ // (paneSendText) — see the herdr_spawn_peer tool in agent-hub.
354
364
  paneSplit: (
355
365
  params: {
356
366
  target_pane_id: string;
@@ -359,7 +369,6 @@ export const herdr = {
359
369
  cwd?: string;
360
370
  env?: Record<string, string>;
361
371
  focus?: boolean;
362
- command?: string[];
363
372
  },
364
373
  opts?: HerdrClientOptions,
365
374
  ) => request<{ pane: PaneInfo }>("pane.split", params, opts),