@chankov/agent-fleet 0.0.8 → 0.0.10

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 (682) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +12 -7
  2. package/.claude/commands/setup-agent-fleet.md +7 -15
  3. package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
  4. package/.opencode/commands/af-setup-agent-fleet.md +8 -6
  5. package/.pi/agents/model-profiles.yaml +9 -2
  6. package/.pi/agents/peers.yaml +12 -16
  7. package/.pi/agents/teams.yaml +4 -2
  8. package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
  9. package/.pi/extensions/btw/README.md +2 -2
  10. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
  11. package/.pi/extensions/compact-and-continue/README.md +3 -3
  12. package/.pi/extensions/mcp-bridge/README.md +1 -1
  13. package/.pi/harnesses/agent-hub/README.md +159 -15
  14. package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  15. package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  16. package/.pi/harnesses/agent-hub/footer.ts +4 -2
  17. package/.pi/harnesses/agent-hub/index.ts +552 -50
  18. package/.pi/harnesses/agent-hub/package.json +1 -1
  19. package/.pi/harnesses/agent-hub/review-findings.js +102 -0
  20. package/.pi/harnesses/agent-hub/run-budget.js +302 -4
  21. package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  22. package/.pi/harnesses/agent-hub/version.ts +25 -1
  23. package/.pi/harnesses/coms/README.md +8 -1
  24. package/.pi/harnesses/coms/package.json +1 -1
  25. package/.pi/harnesses/coms/version.ts +25 -1
  26. package/.pi/harnesses/damage-control-continue/README.md +8 -1
  27. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  28. package/.pi/harnesses/damage-control-continue/version.ts +25 -1
  29. package/.pi/harnesses/lib/herdr-client.ts +10 -1
  30. package/.pi/harnesses/lib/spawned-peers.js +190 -0
  31. package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
  32. package/.pi/prompts/af-setup-agent-fleet.md +7 -15
  33. package/.versions/0.0.10/.claude/commands/build.md +44 -0
  34. package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
  35. package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
  36. package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
  37. package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
  38. package/.versions/0.0.10/.claude/commands/plan.md +16 -0
  39. package/.versions/0.0.10/.claude/commands/prime.md +22 -0
  40. package/.versions/0.0.10/.claude/commands/review.md +16 -0
  41. package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
  42. package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
  43. package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
  44. package/.versions/0.0.10/.claude/commands/ship.md +72 -0
  45. package/.versions/0.0.10/.claude/commands/spec.md +15 -0
  46. package/.versions/0.0.10/.claude/commands/test.md +19 -0
  47. package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
  48. package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
  49. package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
  50. package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
  51. package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
  52. package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
  53. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
  54. package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
  55. package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
  56. package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
  57. package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
  58. package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
  59. package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  60. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
  61. package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
  62. package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
  63. package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
  64. package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
  65. package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
  66. package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  67. package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
  68. package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
  69. package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
  70. package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
  71. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  72. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  73. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  74. package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
  75. package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
  76. package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
  77. package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
  78. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  79. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  80. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  81. package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  82. package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  83. package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  84. package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  85. package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  86. package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  87. package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
  88. package/.versions/0.0.10/.pi/extensions/package.json +9 -0
  89. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
  90. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  91. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  92. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  93. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  94. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  95. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  96. package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
  97. package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  98. package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  99. package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  100. package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  101. package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  102. package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
  103. package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  104. package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  105. package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  106. package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  107. package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
  108. package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
  109. package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
  110. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  111. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  112. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  113. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  114. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  115. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  116. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  117. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  118. package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  119. package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  120. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
  121. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  122. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
  123. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  124. package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  125. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
  126. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  127. package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  128. package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  129. package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  130. package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
  131. package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  132. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
  133. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
  134. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  135. package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
  136. package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
  137. package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
  138. package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
  139. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
  140. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
  141. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  142. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  143. package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  144. package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  145. package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  146. package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  147. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  148. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  150. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  152. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  154. package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
  155. package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
  156. package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
  157. package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
  158. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
  159. package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
  160. package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
  161. package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  162. package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  163. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
  164. package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
  165. package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
  166. package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
  167. package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
  168. package/.versions/0.0.10/.version +1 -0
  169. package/.versions/0.0.10/agents/architect.md +24 -0
  170. package/.versions/0.0.10/agents/bowser.md +27 -0
  171. package/.versions/0.0.10/agents/builder.md +54 -0
  172. package/.versions/0.0.10/agents/code-reviewer.md +208 -0
  173. package/.versions/0.0.10/agents/deep-researcher.md +32 -0
  174. package/.versions/0.0.10/agents/documenter.md +18 -0
  175. package/.versions/0.0.10/agents/orchestrator.md +72 -0
  176. package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
  177. package/.versions/0.0.10/agents/planner.md +70 -0
  178. package/.versions/0.0.10/agents/releaser.md +24 -0
  179. package/.versions/0.0.10/agents/researcher.md +28 -0
  180. package/.versions/0.0.10/agents/security-auditor.md +167 -0
  181. package/.versions/0.0.10/agents/test-engineer.md +153 -0
  182. package/.versions/0.0.10/agents/web-debugger.md +43 -0
  183. package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
  184. package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
  185. package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
  186. package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
  187. package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
  188. package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
  189. package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
  190. package/.versions/0.0.10/docs/getting-started.md +254 -0
  191. package/.versions/0.0.10/docs/npm-install.md +514 -0
  192. package/.versions/0.0.10/docs/opencode-setup.md +281 -0
  193. package/.versions/0.0.10/docs/pi-extensions.md +363 -0
  194. package/.versions/0.0.10/docs/pi-setup.md +571 -0
  195. package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
  196. package/.versions/0.0.10/hermes/README.md +347 -0
  197. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  198. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  199. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  200. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  201. package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
  202. package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
  203. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  204. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  205. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  206. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  207. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  208. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  209. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  210. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  211. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  212. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  213. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  214. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  215. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  216. package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
  217. package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
  218. package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
  219. package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
  220. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  221. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  222. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  223. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  224. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  225. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  226. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  227. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  228. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  229. package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
  230. package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
  231. package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
  232. package/.versions/0.0.10/hooks/hooks.json +14 -0
  233. package/.versions/0.0.10/hooks/session-start.sh +74 -0
  234. package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
  235. package/.versions/0.0.10/install-manifest.json +3615 -0
  236. package/.versions/0.0.10/justfile +254 -0
  237. package/.versions/0.0.10/manifest-meta.json +472 -0
  238. package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
  239. package/.versions/0.0.10/references/definition-of-done.md +67 -0
  240. package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
  241. package/.versions/0.0.10/references/observability-checklist.md +91 -0
  242. package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
  243. package/.versions/0.0.10/references/performance-checklist.md +153 -0
  244. package/.versions/0.0.10/references/prompting-patterns.md +380 -0
  245. package/.versions/0.0.10/references/security-checklist.md +179 -0
  246. package/.versions/0.0.10/references/testing-patterns.md +236 -0
  247. package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
  248. package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
  249. package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
  250. package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
  251. package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
  252. package/.versions/0.0.10/scripts/fleet.ts +168 -0
  253. package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
  254. package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
  255. package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
  256. package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
  257. package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
  258. package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
  259. package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
  260. package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
  261. package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
  262. package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
  263. package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
  264. package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
  265. package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
  266. package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
  267. package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
  268. package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
  269. package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
  270. package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
  271. package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
  272. package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
  273. package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
  274. package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
  275. package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
  276. package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
  277. package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
  278. package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
  279. package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
  280. package/.versions/0.0.10/scripts/team-up.ts +360 -0
  281. package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
  282. package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  283. package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
  284. package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
  285. package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
  286. package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
  287. package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
  288. package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  289. package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  290. package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  291. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
  292. package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
  293. package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
  294. package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
  295. package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
  299. package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
  300. package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
  301. package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
  302. package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
  303. package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
  304. package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
  305. package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
  306. package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
  307. package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  308. package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  309. package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
  310. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  311. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  312. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  313. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  314. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  315. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  316. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  317. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  318. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  319. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  320. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  321. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  322. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  323. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  324. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  325. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  326. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  327. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  328. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  329. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  330. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  331. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  332. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  333. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  334. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  335. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  336. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  337. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  338. package/.versions/0.0.9/.claude/commands/build.md +44 -0
  339. package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
  340. package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
  341. package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
  342. package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
  343. package/.versions/0.0.9/.claude/commands/plan.md +16 -0
  344. package/.versions/0.0.9/.claude/commands/prime.md +22 -0
  345. package/.versions/0.0.9/.claude/commands/review.md +16 -0
  346. package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
  347. package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
  348. package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
  349. package/.versions/0.0.9/.claude/commands/ship.md +72 -0
  350. package/.versions/0.0.9/.claude/commands/spec.md +15 -0
  351. package/.versions/0.0.9/.claude/commands/test.md +19 -0
  352. package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
  353. package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
  354. package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
  355. package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
  356. package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
  357. package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
  358. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  359. package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
  360. package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
  361. package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
  362. package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
  363. package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
  364. package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  365. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
  366. package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
  367. package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
  368. package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
  369. package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
  370. package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
  371. package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  372. package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
  373. package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
  374. package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
  375. package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
  376. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  377. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  378. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  379. package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
  380. package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
  381. package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
  382. package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
  383. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  384. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  385. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  386. package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  387. package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  388. package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  389. package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  390. package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  391. package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  392. package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
  393. package/.versions/0.0.9/.pi/extensions/package.json +9 -0
  394. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
  395. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  396. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  397. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  398. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  399. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  400. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  401. package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
  402. package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  403. package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  404. package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  405. package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  406. package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  407. package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
  408. package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  409. package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  410. package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
  411. package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
  412. package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
  413. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  414. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  415. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  416. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  417. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  418. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  419. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  420. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  421. package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  422. package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  423. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
  424. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  425. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  426. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  427. package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
  428. package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  429. package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  430. package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  431. package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
  432. package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  433. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
  434. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
  435. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  436. package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
  437. package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
  438. package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
  439. package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
  440. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
  441. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
  442. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  443. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  444. package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  445. package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  446. package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  447. package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  448. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  449. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  450. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  451. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  452. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  453. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  454. package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  455. package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
  456. package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
  457. package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
  458. package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
  459. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  460. package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
  461. package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
  462. package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  463. package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  464. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
  465. package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
  466. package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
  467. package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
  468. package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
  469. package/.versions/0.0.9/.version +1 -0
  470. package/.versions/0.0.9/agents/architect.md +24 -0
  471. package/.versions/0.0.9/agents/bowser.md +27 -0
  472. package/.versions/0.0.9/agents/builder.md +54 -0
  473. package/.versions/0.0.9/agents/code-reviewer.md +204 -0
  474. package/.versions/0.0.9/agents/deep-researcher.md +32 -0
  475. package/.versions/0.0.9/agents/documenter.md +18 -0
  476. package/.versions/0.0.9/agents/orchestrator.md +66 -0
  477. package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
  478. package/.versions/0.0.9/agents/planner.md +70 -0
  479. package/.versions/0.0.9/agents/releaser.md +24 -0
  480. package/.versions/0.0.9/agents/researcher.md +28 -0
  481. package/.versions/0.0.9/agents/security-auditor.md +167 -0
  482. package/.versions/0.0.9/agents/test-engineer.md +153 -0
  483. package/.versions/0.0.9/agents/web-debugger.md +43 -0
  484. package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
  485. package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
  486. package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
  487. package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
  488. package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
  489. package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
  490. package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
  491. package/.versions/0.0.9/docs/getting-started.md +231 -0
  492. package/.versions/0.0.9/docs/npm-install.md +337 -0
  493. package/.versions/0.0.9/docs/opencode-setup.md +249 -0
  494. package/.versions/0.0.9/docs/pi-extensions.md +356 -0
  495. package/.versions/0.0.9/docs/pi-setup.md +476 -0
  496. package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
  497. package/.versions/0.0.9/hermes/README.md +347 -0
  498. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  499. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  500. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  501. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  502. package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
  503. package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
  504. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  505. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  506. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  507. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  508. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  509. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  510. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  511. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  512. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  513. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  514. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  515. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  516. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  517. package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
  518. package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
  519. package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
  520. package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
  521. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  522. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  523. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  524. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  525. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  526. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  527. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  528. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  529. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  530. package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
  531. package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
  532. package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
  533. package/.versions/0.0.9/hooks/hooks.json +14 -0
  534. package/.versions/0.0.9/hooks/session-start.sh +74 -0
  535. package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
  536. package/.versions/0.0.9/justfile +254 -0
  537. package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
  538. package/.versions/0.0.9/references/definition-of-done.md +67 -0
  539. package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
  540. package/.versions/0.0.9/references/observability-checklist.md +91 -0
  541. package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
  542. package/.versions/0.0.9/references/performance-checklist.md +153 -0
  543. package/.versions/0.0.9/references/prompting-patterns.md +380 -0
  544. package/.versions/0.0.9/references/security-checklist.md +179 -0
  545. package/.versions/0.0.9/references/testing-patterns.md +236 -0
  546. package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
  547. package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
  548. package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
  549. package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
  550. package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
  551. package/.versions/0.0.9/scripts/fleet.ts +168 -0
  552. package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
  553. package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
  554. package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
  555. package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
  556. package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
  557. package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
  558. package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
  559. package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
  560. package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
  561. package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
  562. package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
  563. package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
  564. package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
  565. package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
  566. package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
  567. package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
  568. package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
  569. package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
  570. package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
  571. package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
  572. package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
  573. package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
  574. package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
  575. package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
  576. package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
  577. package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
  578. package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
  579. package/.versions/0.0.9/scripts/team-up.ts +360 -0
  580. package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
  581. package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
  582. package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
  583. package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
  584. package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
  585. package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
  586. package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
  587. package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  588. package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  589. package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  590. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
  591. package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
  592. package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
  593. package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
  594. package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
  595. package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  596. package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  597. package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
  598. package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
  599. package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
  600. package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
  601. package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
  602. package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
  603. package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
  604. package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
  605. package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
  606. package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  607. package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  608. package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
  609. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  610. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  611. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  612. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  613. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  614. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  615. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  616. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  617. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  618. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  619. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  620. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  621. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  622. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  623. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  624. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  625. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  626. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  627. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  628. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  629. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  630. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  631. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  632. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  633. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  634. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  635. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  636. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  637. package/CHANGELOG.md +141 -0
  638. package/README.md +22 -5
  639. package/agents/architect.md +1 -0
  640. package/agents/bowser.md +1 -0
  641. package/agents/builder.md +1 -0
  642. package/agents/code-reviewer.md +8 -5
  643. package/agents/deep-researcher.md +2 -1
  644. package/agents/orchestrator.md +8 -1
  645. package/agents/plan-reviewer.md +25 -2
  646. package/agents/planner.md +3 -2
  647. package/agents/security-auditor.md +1 -0
  648. package/agents/test-engineer.md +3 -1
  649. package/agents/web-debugger.md +1 -0
  650. package/agents/web-performance-auditor.md +1 -0
  651. package/bin/build-manifest.js +68 -0
  652. package/bin/cli.js +679 -49
  653. package/bin/lib/apply.js +641 -0
  654. package/bin/lib/manifest.js +731 -0
  655. package/bin/lib/merge-forms.js +106 -0
  656. package/bin/lib/plan.js +569 -0
  657. package/bin/lib/state.js +213 -0
  658. package/bin/lib/verify.js +576 -0
  659. package/bin/snapshot-version.js +5 -0
  660. package/docs/ARCHITECTURE.md +53 -12
  661. package/docs/agent-fleet-setup.md +59 -48
  662. package/docs/getting-started.md +29 -6
  663. package/docs/npm-install.md +208 -31
  664. package/docs/opencode-setup.md +32 -0
  665. package/docs/pi-extensions.md +83 -13
  666. package/docs/pi-setup.md +164 -69
  667. package/install-manifest.json +3615 -0
  668. package/justfile +10 -1
  669. package/manifest-meta.json +472 -0
  670. package/package.json +8 -3
  671. package/scripts/fleet.ts +22 -3
  672. package/scripts/lib/fleet-command.ts +5 -3
  673. package/scripts/lib/herdr-layout.ts +18 -0
  674. package/scripts/lib/peer-launch.ts +314 -0
  675. package/scripts/lib/team-project.ts +3 -1
  676. package/scripts/peer-launch.ts +259 -0
  677. package/skills/browser-testing-with-devtools/SKILL.md +3 -4
  678. package/skills/guided-workspace-setup/SKILL.md +172 -490
  679. package/skills/guided-workspace-setup/companion-manifest.json +2 -0
  680. package/skills/planning-and-task-breakdown/SKILL.md +18 -0
  681. package/skills/spec-driven-development/SKILL.md +12 -0
  682. package/.pi/harnesses/agent-hub/spawned-peers.js +0 -74
@@ -60,9 +60,11 @@ same CLI flags would abort startup with duplicate registrations. So the harnesse
60
60
  - through the unified `justfile` interface — `just fleet`, `just fleet hub`, `just fleet peer <name>`, `just fleet team <preset>`, …
61
61
  - or directly — `pi -e .pi/harnesses/<name>/index.ts` (advanced use; you must compose safety/utilities yourself)
62
62
 
63
- When you consume this repo from another project, point `pi -e` at the harness file you
64
- want, or symlink that one directory into *its* `.pi/harnesses/` — never drop the harnesses
65
- into `.pi/extensions/`, and never load all of them at once. The supported multi-harness
63
+ When you consume this repo from another project, install the harness you want into
64
+ *its* `.pi/harnesses/` (`agent-fleet install --agent pi --items pi-harness:agent-hub`,
65
+ or the `pi-fleet-core` profile for the whole stack) and load it via that project's
66
+ `justfile` region, or point `pi -e` at the harness file directly — never drop the
67
+ harnesses into `.pi/extensions/`, and never load all of them at once. The supported multi-harness
66
68
  exception is loading `damage-control-continue` and `ask-user-remote` before `agent-hub` for a guarded hub session (see
67
69
  [pi-setup.md](pi-setup.md#optional-pi-extensions)).
68
70
 
@@ -75,16 +77,21 @@ just fleet install # one-time runtime deps only; starts no Pi/harness
75
77
  just fleet # guarded Pi + STT and core utilities
76
78
  just fleet hub # guarded multi-agent hub
77
79
  just fleet team docs # hub + guarded Herdr peer team
80
+ just fleet peer code-reviewer --project af # ONE peer in its own Herdr pane, no team
78
81
  just fleet help # unified command grammar
79
82
  just --list # shows the single public `fleet` entry point
80
83
  ```
81
84
 
82
85
  `just install` runs `npm install` for both dependency roots: `.pi/extensions/` for the
83
86
  utilities (`@modelcontextprotocol/sdk`, `typebox`) and `.pi/harnesses/` for the harnesses
84
- (`@sinclair/typebox`, `yaml`). The extension dependencies are also root production dependencies
85
- of the published `@chankov/agent-fleet` package. This is intentional: npm does not install a
86
- nested `.pi/extensions/package.json`, and Node resolves symlinked extensions from their real path
87
- inside the package. The `@mariozechner/pi-*` packages are provided by the pi runtime itself.
87
+ (`@sinclair/typebox`, `yaml`). That is the **clone** path. In a target workspace the
88
+ installer handles it: the manifests are copied in as companions, and `agent-fleet install
89
+ --allow-exec` runs `npm ci --prefix .pi/extensions` and `npm ci --prefix .pi/harnesses`
90
+ for you (without `--allow-exec` those two steps are printed in the plan and skipped, for
91
+ you to run by hand). The extension dependencies are also root production dependencies of
92
+ the published `@chankov/agent-fleet` package, so a pi-package install resolves them from
93
+ the package's real path. The `@mariozechner/pi-*` packages are provided by the pi runtime
94
+ itself.
88
95
 
89
96
  ---
90
97
 
@@ -92,7 +99,7 @@ inside the package. The `@mariozechner/pi-*` packages are provided by the pi run
92
99
 
93
100
  | Extension | Category | What it does | Run |
94
101
  |-----------|----------|--------------|-----|
95
- | [agent-hub](../.pi/harnesses/agent-hub/README.md) | Orchestration | Supported multi-agent hub: Fleet Core guardrails, dispatcher grid, specialist delegation, research helpers, persona gate, embedded coms, `/af-handoff`, peer-as-subagent, and footer `v<version> · <model><thinking> · <team>` — plus, inside a [herdr](https://herdr.dev) pane, fleet tools (`herdr_spawn_peer` / `herdr_read_pane` / `herdr_close_pane` with human confirmation / `herdr_notify`) | `just fleet hub` |
102
+ | [agent-hub](../.pi/harnesses/agent-hub/README.md) | Orchestration | Supported multi-agent hub: Fleet Core guardrails, dispatcher grid, specialist delegation, research helpers, persona gate, embedded coms, `/af-handoff`, peer-as-subagent, and footer `agent fleet v<version> · <model><thinking> · <team>` — plus, inside a [herdr](https://herdr.dev) pane, fleet tools (`herdr_spawn_peer` / `herdr_read_pane` / `herdr_close_pane` with human confirmation / `herdr_notify`) | `just fleet hub` |
96
103
  | [ask-user-remote](../.pi/harnesses/ask-user-remote/README.md) | Orchestration | Captures stock `pi-ask-user` and registers the default `ask_user`; with `user-remote` live it races local UI against the Hermes bridge, otherwise it is stock local behavior | Fleet Core (`just fleet`) |
97
104
  | [damage-control-continue](../.pi/harnesses/damage-control-continue/README.md) | Safety | Fleet Core safety harness; guards default Pi, Hub, native children, and Herdr Pi peers. Blocks feed back without aborting the turn; protected paths support explicit approval, while dangerous command patterns remain non-exemptible | `just fleet` |
98
105
  | [coms](../.pi/harnesses/coms/README.md) | Messaging | Peer-to-peer messaging between agents on one machine, composed with Fleet Core safety and utilities | `just fleet peer <name>` |
@@ -104,22 +111,32 @@ surface, requirements, and per-extension upstream changes.
104
111
  ### Migration: retired hard-stop harness
105
112
 
106
113
  The former `.pi/harnesses/damage-control/` hard-stop harness and its standalone recipe
107
- are retired. Refresh pi harnesses with guided setup: it removes only an unchanged,
108
- setup-recorded copy (or an agent-fleet source symlink), preserves user-modified/unowned copies,
109
- and refreshes the managed `justfile` region. Use `damage-control-continue` for standalone and
114
+ are retired. Refresh pi harnesses with `agent-fleet upgrade` (or guided setup, which
115
+ calls it): removal is bound by the ownership rule, so only an unchanged, recorded copy
116
+ goes — user-modified and unowned copies are preserved, and the managed `justfile` region
117
+ is refreshed without touching recipes outside the sentinels. Use `damage-control-continue` for standalone and
110
118
  Agent Hub safety; missing child safety now fails closed instead of falling back or spawning
111
119
  unguarded.
112
120
 
113
121
  ### Harness version footer and provenance
114
122
 
115
123
  The three persistent-UI harnesses — `agent-hub`, `coms`, and
116
- `damage-control-continue` — each register `v<version>` on one shared status key. In pi's
124
+ `damage-control-continue` — each register `agent fleet v<version>` on one shared status key. In pi's
117
125
  default status footer, that shared key gives a supported stack exactly one version instead of one
118
126
  copy per harness. `agent-hub` replaces the default footer: it does **not** consume that status
119
127
  key. Its custom footer reads its own adjacent stamped manifest and renders one local version
120
- first — `v<version> · <model><thinking> · <team>` — so an agent-hub stack also displays the
128
+ first — `agent fleet v<version> · <model><thinking> · <team>` — so an agent-hub stack also displays the
121
129
  version exactly once.
122
130
 
131
+ The `agent fleet` half of that label is an [OSC 8](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda)
132
+ terminal hyperlink to the project homepage, so a click in a terminal that supports hyperlinks
133
+ (Ghostty, iTerm2, WezTerm, Kitty, VS Code, GNOME Terminal, tmux 3.4+) opens the repository. It is a
134
+ terminal-level link, not a TUI control: pi has no mouse tracking, so a click cannot open an
135
+ in-process overlay — the URL goes to the OS opener. Terminals without OSC 8 support render the
136
+ label unchanged, and pi's `visibleWidth`/`truncateToWidth` strip OSC sequences, so the link costs no
137
+ footer columns. Set `AGENT_FLEET_NO_LINKS=1` to fall back to a plain label on multiplexers that
138
+ mangle unknown OSC sequences (GNU screen, tmux before 3.4).
139
+
123
140
  The shared version status is independent of mutable owner status: for example, a
124
141
  Damage-Control violation can replace its own safety message without overwriting the version
125
142
  entry. The canonical value is the root `package.json` version. During a release,
@@ -199,6 +216,59 @@ This repo ships **two** ways to drive a browser from a pi agent. They are comple
199
216
 
200
217
  Why `web-debugger` is a coms peer and not a dispatchable subagent: its `chrome_devtools__*` tools come from the always-on `chrome-devtools-mcp` extension, and agent-hub spawns subagents with `--no-extensions`, so a dispatched child would not have those tools. A coms peer is its own pi process that loads the extension explicitly (via the `extensions:` field in `.pi/agents/peers.yaml`, routed through the `_peer-plus` recipe), and a long-lived peer maps naturally onto one persistent live browser. `bowser` has no such constraint because it only needs Bash + the `playwright-cli` binary on PATH.
201
218
 
219
+ ## One peer at a time — `just fleet peer`
220
+
221
+ `just fleet team <preset>` is the right tool for a *known* set of collaborators, but it
222
+ requires every peer to be declared in `.pi/agents/peers.yaml` and it builds a whole
223
+ workspace. When you want **one** more agent — often a Claude Code reviewer — next to
224
+ what you already have:
225
+
226
+ ```bash
227
+ just fleet peer code-reviewer --project af # peers.yaml decides the runner
228
+ just fleet peer scratch-reviewer --runner claude-code --model opus --project af
229
+ just fleet peer researcher --model openai-codex/gpt-5.6-luna --project af
230
+ just fleet peer web-debugger --browser --project af # persona peer + devtools MCP
231
+ just fleet peer nick --here --project af # this terminal, not a pane
232
+ just fleet peer anything --runner claude-code --dry-run # print the plan, touch nothing
233
+ ```
234
+
235
+ **The name decides the shape of the peer** — one verb, three launchers:
236
+
237
+ | The name… | Peer | Recipe |
238
+ |---|---|---|
239
+ | is declared in `peers.yaml` | whatever it declares (`runner`, `model`, `extensions`, `env_file`) | per declaration |
240
+ | matches `agents/<name>.md` | that guarded persona peer | `_peer` / `_peer-plus` |
241
+ | matches nothing | Fleet Core + coms under that identity, no persona | `_fleet-peer` |
242
+ | `--runner claude-code` | interactive Claude Code + its coms bridge in one pane | `_claude-peer` |
243
+
244
+ The third row is what this command meant before pane placement existed, and it is the
245
+ only shape that accepts raw pi arguments — everything after `--` goes to pi verbatim
246
+ (`just fleet peer nick --here -- --session /path/to/session.json`). Note that the
247
+ persona-by-name rule can change what an existing invocation means: `agents/architect.md`
248
+ exists, so `just fleet peer architect` is now the architect persona peer. `--no-persona`
249
+ forces the plain Fleet Core shape back.
250
+
251
+ - **Placement** — by default the peer gets its own pane: run inside a herdr pane and it
252
+ splits *that* pane (`--direction right|down`); run outside herdr and it creates a
253
+ single-pane workspace labelled `<worktree-tag>-peer-<name>`, refusing to clobber an
254
+ existing one. `--here` runs it in the calling terminal instead.
255
+ - **Field resolution** — explicit flag → the `peers.yaml` declaration for that *name*
256
+ (searched across every team) → a convention default. A name the fleet already defines
257
+ keeps its declared fields; a name it does not need no manifest entry at all.
258
+ - **Nothing is silently dropped** — a flag that cannot apply to the resolved shape is an
259
+ error, not a no-op: `--all-extensions` on a persona peer, `--persona` on a Claude Code
260
+ peer, a mistyped flag, or a pi flag that forgot its `--` separator.
261
+ - **`--project` matters** — same rule as teams: the flag form is `--project af`;
262
+ `project=af` is a `just` variable override and is silently ignored, leaving the peer
263
+ in the shared `default` pool.
264
+ - **Readiness** — a pane launch waits (bounded) for the peer to register in the coms pool
265
+ and exits non-zero with the pane's last output if it never does. A peer that missed
266
+ the window has failed to start, not started slowly.
267
+
268
+ Pure logic in `scripts/lib/peer-launch.ts` (under `node --test`); the herdr wiring is
269
+ `scripts/peer-launch.ts`. Inside a hub session the equivalent is the `herdr_spawn_peer`
270
+ tool, which shares the same command builder and readiness policy.
271
+
202
272
  ## Environment variables
203
273
 
204
274
  The `justfile` sets `dotenv-load`, so a `.env` file at the repo root is auto-loaded
package/docs/pi-setup.md CHANGED
@@ -29,7 +29,7 @@ No plugin, wrapper, or custom system prompt is required for the core workflow.
29
29
 
30
30
  Agent Fleet owns the lowercase `/af-*` namespace on Pi. This keeps its prompt-template and harness commands distinct from Pi built-ins such as `/model` and `/settings`, skill invocations under `/skill:<name>`, and commands contributed by other installed packages. Examples: `/af-spec`, `/af-agents-list`, and `/af-allow`.
31
31
 
32
- **Recommended companion packages:** [`pi-ask-user`](https://github.com/edlsh/pi-ask-user) adds an interactive `ask_user` tool and bundles an `ask-user` skill. It is bundled automatically when you install `@chankov/agent-fleet` as a pi package; clone/symlink setups should install it separately. `pi-codex-image-gen` is an optional suggested npm/pi extension for image generation; guided setup can offer it when package installation is available, but it is not bundled or required.
32
+ **Recommended companion packages:** [`pi-ask-user`](https://github.com/edlsh/pi-ask-user) adds an interactive `ask_user` tool and bundles an `ask-user` skill. It is bundled automatically when you install `@chankov/agent-fleet` as a pi package; clone setups should install it separately. `pi-codex-image-gen` is an optional suggested npm/pi extension for image generation; guided setup can offer it when package installation is available, but it is not bundled or required.
33
33
 
34
34
  **Experimental phone conductor:** Linux users may pair Codex CLI `0.144.x` with ChatGPT Android to perform human-confirmed outbound delegation to live coms peers. Guided setup installs the repository assets when pi harnesses are selected, but deliberately never changes systemd, Codex auth/config, pairing, or service state. Host setup remains an explicit operator flow; see [Codex Remote-Control Conductor](codex-remote-conductor.md).
35
35
 
@@ -37,9 +37,61 @@ Agent Fleet owns the lowercase `/af-*` namespace on Pi. This keeps its prompt-te
37
37
 
38
38
  ## Installation
39
39
 
40
- There are two supported pi paths.
40
+ There are three pi paths: the CLI installer (everything, per workspace), the
41
+ first-class pi package (skills + prompts, package-native), and a clone for
42
+ contributors. They compose — most pi users run the first two together.
41
43
 
42
- ### First-class pi package (recommended for users)
44
+ ### The `agent-fleet` CLI (recommended — this is what installs the fleet)
45
+
46
+ The CLI is the whole installer: it decides the paths, computes per-item state,
47
+ does the three-way merge, and performs every write. A complete install needs no
48
+ coding agent and no model.
49
+
50
+ ```bash
51
+ cd /path/to/your-project
52
+
53
+ # Guided: bootstraps the installer command, then run /af-setup-agent-fleet in pi
54
+ npx @chankov/agent-fleet init --agent pi
55
+
56
+ # Or straight to it — no agent, no model, no prompts:
57
+ npx @chankov/agent-fleet install --agent pi --profile recommended --yes
58
+ npx @chankov/agent-fleet install --agent pi --profile pi-fleet-core --yes # the harness stack
59
+ npx @chankov/agent-fleet verify --agent pi
60
+ ```
61
+
62
+ Where it writes, for pi:
63
+
64
+ | Artifact | Target | Item id prefix |
65
+ |---|---|---|
66
+ | Skills | `.pi/skills/<name>/` | `skill:` |
67
+ | Lifecycle prompts | `.pi/prompts/af-<name>.md` | `command:` |
68
+ | Personas | `agents/<name>.md` (canonical, copied unchanged) | `persona:` |
69
+ | pi runtime skills | `.pi/skills/<name>/` | `pi-runtime-skill:` |
70
+ | Utility extensions | `.pi/extensions/<name>/` | `pi-extension:` |
71
+ | Session harnesses | `.pi/harnesses/<name>/` + the `justfile` managed region | `pi-harness:` |
72
+
73
+ Profiles: `minimal`, `recommended`, `full`, `pi-fleet-core` (`agent-hub`,
74
+ `damage-control-continue`, `ask-user-remote`, `coms`, plus the utilities the hub
75
+ expects), `hermes-plugins` and `codex-bridge` (both **operator-applied** — the plan
76
+ prints the exact commands for a human and the engine touches nothing outside the
77
+ workspace). Narrow any of them with `--items pi-harness:agent-hub,pi-extension:btw`,
78
+ and preview with `--dry-run`.
79
+
80
+ **Artifacts install as copies.** Keep them current with `agent-fleet upgrade`: it
81
+ three-way merges the version recorded in `.ai/agent-fleet-state.json` against the
82
+ installed copy and the current package, so a file you edited is preserved, and a
83
+ file that moved on both sides is a conflict — the incoming version is written as
84
+ `<file>.new`, yours is untouched, and the run exits `3`. `agent-fleet doctor --fix`
85
+ repairs missing or dangling items through the same write path a fresh install uses.
86
+
87
+ Removing a harness or extension is `agent-fleet uninstall --items pi-harness:coms`;
88
+ it refuses to strip something another installed item depends on (you cannot remove
89
+ `damage-control-continue` while `agent-hub` is installed), and removing the last pi
90
+ harness also strips the `agent-fleet:harnesses` region from the `justfile`.
91
+
92
+ Full CLI reference — every flag, every exit code, CI usage: [npm-install.md](npm-install.md).
93
+
94
+ ### First-class pi package (skills and prompts, package-native)
43
95
 
44
96
  Install this package directly with pi:
45
97
 
@@ -55,37 +107,43 @@ The npm pi package includes this repo's core skills, pi runtime skills, lifecycl
55
107
 
56
108
  This package's pi manifest is intentionally conservative: it exposes skills, `.pi/skills`, `.pi/prompts`, and bundled `pi-ask-user` resources. It does **not** auto-expose this repo's `.pi/extensions` or harnesses, because those have their own runtime dependency setup and should still be installed explicitly through guided setup or the manual extension steps below. It also does **not** bundle or require `pi-codex-image-gen`; guided setup may suggest installing that external package with `pi install -l npm:pi-codex-image-gen` only when package installation is available and the user selects it.
57
109
 
58
- ### Clone / symlink setup (recommended for contributors)
59
-
60
- The manual clone install is **project-scoped using symlinks**:
110
+ ### Clone setup (for contributors)
61
111
 
62
- - `.agents/skills/` exposes the skills.
63
- - `.pi/prompts/` exposes the lifecycle slash commands.
112
+ Clone when you want to **edit** the skills, personas, prompts, and harnesses
113
+ themselves. The clone is both the working tree and the install source: run its
114
+ own CLI and it installs from that checkout instead of from a published tarball.
64
115
 
65
- pi walks upward from the current working directory looking for project configuration, so once the symlinks exist, every pi session started from inside (or below) the repo picks up the skills and commands automatically. The `AGENTS.md` at the repo root is loaded the same way.
66
-
67
- 1. Clone the repository somewhere stable:
116
+ 1. Clone the repository somewhere stable and install its runtime deps:
68
117
 
69
118
  ```bash
70
119
  git clone https://github.com/chankov/agent-fleet.git /path/to/agent-fleet
120
+ cd /path/to/agent-fleet
121
+ just install # npm install for .pi/extensions/ and .pi/harnesses/
71
122
  ```
72
123
 
73
- 2. From the project where you want to use the skills, symlink `skills/` into a pi-discoverable path:
124
+ 2. Install from the clone into a target project — same engine, same install
125
+ record, just a local source root:
74
126
 
75
127
  ```bash
76
- cd /path/to/your-project
77
- mkdir -p .agents
78
- ln -s /path/to/agent-fleet/skills .agents/skills
128
+ node /path/to/agent-fleet/bin/cli.js install \
129
+ --workspace /path/to/your-project --agent pi --profile recommended --yes
79
130
  ```
80
131
 
81
- 3. From the same project, symlink the pi-native lifecycle commands into pi's prompt-template directory:
132
+ 3. After editing the clone (or a `git pull`), push the changes out:
82
133
 
83
134
  ```bash
84
- mkdir -p .pi
85
- ln -s /path/to/agent-fleet/.pi/prompts .pi/prompts
135
+ node /path/to/agent-fleet/bin/cli.js upgrade --workspace /path/to/your-project
86
136
  ```
87
137
 
88
- This exposes:
138
+ **Inside the clone itself**, `--method symlink` is available — that is the one
139
+ workspace where editing an installed artifact is *meant* to edit the source.
140
+ Everywhere else it is refused: a link target can never move again, an npx cache
141
+ clean breaks every link at once, a `git pull` silently rewrites artifacts the
142
+ project never agreed to change, and Windows needs Developer Mode. A workspace
143
+ that recorded symlinks before this restriction is re-materialised as real files
144
+ on its next `install` or `upgrade`.
145
+
146
+ Whichever way you install, the prompts land in `.pi/prompts/` and expose:
89
147
 
90
148
  ```text
91
149
  /af-spec
@@ -97,19 +155,11 @@ This exposes:
97
155
  /af-ship
98
156
  ```
99
157
 
100
- If `.pi/prompts` already exists as a real directory, keep it and symlink the individual command files instead:
158
+ An existing `.pi/prompts/` directory is not a problem — the installer writes one
159
+ file per selected command and never replaces the directory. Anything it did not
160
+ write is not recorded, and therefore never removed or overwritten.
101
161
 
102
- ```bash
103
- ln -s /path/to/agent-fleet/.pi/prompts/af-spec.md .pi/prompts/af-spec.md
104
- ln -s /path/to/agent-fleet/.pi/prompts/af-plan.md .pi/prompts/af-plan.md
105
- ln -s /path/to/agent-fleet/.pi/prompts/af-build.md .pi/prompts/af-build.md
106
- ln -s /path/to/agent-fleet/.pi/prompts/af-test.md .pi/prompts/af-test.md
107
- ln -s /path/to/agent-fleet/.pi/prompts/af-review.md .pi/prompts/af-review.md
108
- ln -s /path/to/agent-fleet/.pi/prompts/af-code-simplify.md .pi/prompts/af-code-simplify.md
109
- ln -s /path/to/agent-fleet/.pi/prompts/af-ship.md .pi/prompts/af-ship.md
110
- ```
111
-
112
- 4. Install the recommended `pi-ask-user` pi package separately (clone/symlink setup only):
162
+ 4. Install the recommended `pi-ask-user` pi package separately (clone setup only):
113
163
 
114
164
  ```bash
115
165
  # Project-scoped; records the companion package in .pi/settings.json
@@ -119,7 +169,7 @@ pi install -l npm:pi-ask-user
119
169
  pi install npm:pi-ask-user
120
170
  ```
121
171
 
122
- Skip this step if `pi list` already shows `pi-ask-user`, or if you installed `@chankov/agent-fleet` via `pi install npm:@chankov/agent-fleet` (it bundles `pi-ask-user`). This companion is a pi package, not a file copied from this repo.
172
+ Skip this step if `pi list` already shows `pi-ask-user`, or if you installed `@chankov/agent-fleet` via `pi install npm:@chankov/agent-fleet` (it bundles `pi-ask-user`). This companion is a pi package, not a file copied from this repo — the installer records it under `externalPackages` and tells you to run the command; it never runs a package install for you.
123
173
 
124
174
  Optional image generation: guided setup can offer `pi-codex-image-gen` as a suggested external pi package when package installation is available, or you can install it manually:
125
175
 
@@ -150,32 +200,34 @@ This repo also ships pi **extensions** under `.pi/extensions/`. Extensions are T
150
200
 
151
201
  The always-on utilities:
152
202
 
153
- - `mcp-bridge/` — a reusable factory that turns any stdio MCP server into a pi extension. This is a library consumed by wrapper extensions. Symlink it alongside wrappers so relative imports resolve; when pi discovers it directly, it intentionally registers no tools or commands by itself.
203
+ - `mcp-bridge/` — a reusable factory that turns any stdio MCP server into a pi extension. This is a library consumed by wrapper extensions; it is installed alongside the wrappers so relative imports resolve, and when pi discovers it directly it intentionally registers no tools or commands by itself.
154
204
  - `chrome-devtools-mcp/` — bridges the [`chrome-devtools-mcp`](https://www.npmjs.com/package/chrome-devtools-mcp) server into pi as native tools, unlocking the `browser-testing-with-devtools` skill on pi.
155
205
  - `compact-and-continue/` — registers the `request_compaction` tool that queues pi context compaction to run after the current agent turn ends, optionally resuming work from a self-contained continuation prompt. Used by `/af-build` to offer a "Compact & continue" option at slice-approval time.
156
206
  - `agent-fleet-update-check/` — surfaces an "update available" banner once per session when `@chankov/agent-fleet` has a newer published version than the one recorded in `.ai/agent-fleet-setup.md`. Never blocks startup (soft 3s check); honors `AGENT_SKILLS_NO_UPDATE_CHECK` / `NO_UPDATE_NOTIFIER` / `CI` opt-outs.
157
207
  - `btw/` — adds the `/af-btw <task>` prompt command (and `Alt+'` shortcut): forks the current session into an in-process sub-session that inherits the full conversation as context, runs in the same cwd, and streams into a live modal with a follow-up composer. A compact result card lands in the main transcript at idle (kept out of the main agent's LLM context). See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
158
208
 
159
- To install, symlink the directories into your project's `.pi/extensions/`:
209
+ Install them with the CLI — each is one item id:
160
210
 
161
211
  ```bash
162
- mkdir -p .pi/extensions
163
- ln -s /path/to/agent-fleet/.pi/extensions/mcp-bridge .pi/extensions/mcp-bridge
164
- ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chrome-devtools-mcp
165
- ln -s /path/to/agent-fleet/.pi/extensions/compact-and-continue .pi/extensions/compact-and-continue
166
- ln -s /path/to/agent-fleet/.pi/extensions/agent-fleet-update-check .pi/extensions/agent-fleet-update-check
167
- ln -s /path/to/agent-fleet/.pi/extensions/btw .pi/extensions/btw
212
+ npx @chankov/agent-fleet install --agent pi --allow-exec --yes \
213
+ --items pi-extension:mcp-bridge,pi-extension:chrome-devtools-mcp,pi-extension:compact-and-continue,pi-extension:btw,pi-extension:agent-fleet-update-check
168
214
  ```
169
215
 
170
- Install the shared runtime dependencies used by the symlinked extensions once in the `agent-fleet` clone:
216
+ The extensions are copied into the project's own `.pi/extensions/`. Select
217
+ `mcp-bridge` explicitly whenever you take `chrome-devtools-mcp` — the wrapper
218
+ imports it by relative path, so the bridge has to sit beside it. A companion
219
+ carries the runtime dependencies: `.pi/extensions/package.json` +
220
+ `package-lock.json` are copied in, and `npm ci --prefix .pi/extensions` is run —
221
+ but only with **`--allow-exec`**, because running a command is a separate consent
222
+ class from writing files. Without that flag the plan lists the `npm ci` step and
223
+ skips it; run it yourself afterwards:
171
224
 
172
225
  ```bash
173
- cd /path/to/agent-fleet/.pi/extensions
174
- npm ci
175
- # If this clone does not have package-lock.json yet, run: npm install
226
+ npm ci --prefix .pi/extensions
176
227
  ```
177
228
 
178
- Because the project extensions are symlinks into the clone, these dependencies are reused by every project that links the same extension directories.
229
+ Each project gets its own copy and its own `node_modules`, so a `git pull` in some
230
+ other checkout can no longer change what this project loads.
179
231
 
180
232
  Verify by starting `pi` and running `/af-chrome_devtools-status` — expect `Chrome DevTools MCP connected. Registered N tool(s).`
181
233
 
@@ -187,7 +239,20 @@ This repo ships **3 supported session harnesses** ported or consolidated from [d
187
239
  - **Safety** — `damage-control-continue` (fail-closed blocks feed back so the agent can report or safely adapt)
188
240
  - **Pi-to-Pi messaging** — `coms` (launched guarded via `just fleet peer <name>`, and embedded in `just fleet hub`)
189
241
 
190
- Unlike the utilities above, each harness reshapes the entire pi session, and most are loaded one per session rather than all at once. The supported stack loads `damage-control-continue` and `ask-user-remote` before `agent-hub`; the hub then re-loads continue into every native specialist, research helper, and nested delegate. Protected-path blocks can escalate for explicit approval, while dangerous command patterns remain non-exemptible. Missing child safety refuses dispatch. pi auto-discovers and loads *everything* under `.pi/extensions/`, so the harnesses deliberately live in a separate directory — **`.pi/harnesses/`** — which pi does *not* auto-discover. **Never copy or symlink a harness into `.pi/extensions/`**: that would load it on every plain `pi` run, and stacking all harnesses aborts startup (harnesses that register the same CLI flags clash). Load a harness recipe explicitly instead — there is nothing to symlink:
242
+ Unlike the utilities above, each harness reshapes the entire pi session, and most are loaded one per session rather than all at once. The supported stack loads `damage-control-continue` and `ask-user-remote` before `agent-hub`; the hub then re-loads continue into every native specialist, research helper, and nested delegate. Protected-path blocks can escalate for explicit approval, while dangerous command patterns remain non-exemptible. Missing child safety refuses dispatch. pi auto-discovers and loads *everything* under `.pi/extensions/`, so the harnesses deliberately live in a separate directory — **`.pi/harnesses/`** — which pi does *not* auto-discover. **Never copy or symlink a harness into `.pi/extensions/`**: that would load it on every plain `pi` run, and stacking all harnesses aborts startup (harnesses that register the same CLI flags clash). The installer already places them correctly:
243
+
244
+ ```bash
245
+ npx @chankov/agent-fleet install --agent pi --profile pi-fleet-core --allow-exec --yes
246
+ ```
247
+
248
+ That one profile pulls in `agent-hub`, its required `damage-control-continue` and
249
+ `ask-user-remote`, `coms`, and the utilities the hub expects — plus the
250
+ `agent-fleet:harnesses` region in the workspace `justfile` and the `.pi/agents/`
251
+ configs (`teams.yaml`, `peers.yaml`, `dispatch-policy.yaml`). Recipes you wrote
252
+ outside those sentinels are never touched. The one thing it does *not* do for you
253
+ is `pi-voice-stt`'s configuration: the extension is installed, and the plan prints
254
+ the operator steps (write `.ai/stt.json`, put the key in a gitignored `.env`) for
255
+ you to perform. Then load a harness explicitly:
191
256
 
192
257
  ```bash
193
258
  # from the agent-fleet clone, via the bundled justfile
@@ -204,12 +269,13 @@ pi -e /path/to/agent-fleet/.pi/harnesses/damage-control-continue/index.ts -e /pa
204
269
  ```
205
270
 
206
271
  **Upgrading from the retired hard-stop harness:** `.pi/harnesses/damage-control/` and
207
- the old standalone damage-control recipes are no longer shipped. Re-run guided setup to
208
- remove only an unchanged setup-owned copy (or source symlink) and refresh the managed
209
- `justfile` region; user-modified and unowned copies are preserved. Use `just fleet` for a
210
- standalone guarded session.
272
+ the old standalone damage-control recipes are no longer shipped. Run
273
+ `npx @chankov/agent-fleet upgrade` (or re-run guided setup, which calls it): only an
274
+ unchanged, recorded copy is removed and the managed `justfile` region is refreshed —
275
+ user-modified and unowned copies are preserved. Use `just fleet` for a standalone
276
+ guarded session.
211
277
 
212
- The harnesses have their own runtime dependencies (`yaml`, `@sinclair/typebox`) declared in `.pi/harnesses/package.json` — separate from the extension deps above. Install both at once with `just install` from the clone, or run `npm ci` in `.pi/harnesses/` as well. The [pi extension catalog](pi-extensions.md) has the full list, per-extension `README.md` pointers, required environment variables (for `chrome-devtools-mcp`), and what changed from upstream.
278
+ The harnesses have their own runtime dependencies (`yaml`, `@sinclair/typebox`) declared in `.pi/harnesses/package.json` — separate from the extension deps above. `--allow-exec` runs `npm ci --prefix .pi/harnesses` for you as part of the install; without it, run that yourself (or `just install` from a clone, which does both roots). The [pi extension catalog](pi-extensions.md) has the full list, per-extension `README.md` pointers, required environment variables (for `chrome-devtools-mcp`), and what changed from upstream.
213
279
 
214
280
  Each extension — utility or harness — has its own `README.md` describing what it provides.
215
281
 
@@ -217,16 +283,36 @@ Each extension — utility or harness — has its own `README.md` describing wha
217
283
 
218
284
  ### Keeping skills up to date
219
285
 
220
- Because `.agents/skills`, `.pi/prompts`, and `.pi/extensions` are symlinks into the cloned `agent-fleet` repo, running `git pull` in that clone updates every skill, lifecycle command, and extension in place — no re-copy required.
286
+ Everything the CLI installs is a copy, so refreshing is a command rather than a
287
+ `git pull` side effect:
288
+
289
+ ```bash
290
+ npx @chankov/agent-fleet upgrade --dry-run # what would change
291
+ npx @chankov/agent-fleet upgrade --yes
292
+ ```
293
+
294
+ `upgrade` acts only on what the workspace already has — it never widens the
295
+ install. A newly catalogued skill or harness shows up as *available* in `verify`
296
+ and is added only by an explicit `install`. It also never eats a local edit: if
297
+ only the source moved you get a clean refresh, if only your copy moved it is
298
+ kept, and if both moved the incoming version lands as `<file>.new` and the run
299
+ exits `3` for you to resolve. Resolve non-interactively with `--accept-theirs`
300
+ or `--accept-ours`.
301
+
302
+ From a clone, the same thing with the clone as source root:
303
+
304
+ ```bash
305
+ node /path/to/agent-fleet/bin/cli.js upgrade --workspace /path/to/your-project
306
+ ```
221
307
 
222
308
  ### Alternative scopes
223
309
 
224
- - **Global install** — symlink skills into `~/.pi/agent/skills/` and prompts into `~/.pi/agent/prompts/` to make them available in every pi session on the machine, regardless of cwd. You may also symlink `AGENTS.md` into `~/.pi/agent/AGENTS.md` for global workflow context.
225
- - **Copy instead of symlink** — use `cp -R /path/to/agent-fleet/skills .agents/skills` and `cp -R /path/to/agent-fleet/.pi/prompts .pi/prompts` if you're on a platform where symlinks are awkward (e.g. plain Windows without developer mode). You'll need to re-copy after updates.
310
+ - **pi package, global** — `pi install npm:@chankov/agent-fleet` exposes the skills, `.pi/skills`, and lifecycle prompts to every pi session on the machine, regardless of cwd. This is the supported global path; the CLI installer is deliberately per-workspace and writes nothing to `~/.pi/`.
311
+ - **Global context file** — copy `AGENTS.md` to `~/.pi/agent/AGENTS.md` for machine-wide workflow context. pi concatenates context files, so this is additive to each project's own.
226
312
 
227
313
  ### Recommended companion packages
228
314
 
229
- If you use clone/symlink setup, install `pi-ask-user` with `pi install -l npm:pi-ask-user` unless `pi list` already shows it. If you installed `@chankov/agent-fleet` as a pi package, `pi-ask-user` is already bundled and exposed by this package. In both cases, pi discovers its bundled `ask-user` skill from a pi package, not from vendored files in this repo. This is a strong complement to `agent-fleet` because it gives the agent a structured way to stop and ask for an explicit decision before:
315
+ If you use clone setup, install `pi-ask-user` with `pi install -l npm:pi-ask-user` unless `pi list` already shows it. If you installed `@chankov/agent-fleet` as a pi package, `pi-ask-user` is already bundled and exposed by this package. In both cases, pi discovers its bundled `ask-user` skill from a pi package, not from vendored files in this repo. This is a strong complement to `agent-fleet` because it gives the agent a structured way to stop and ask for an explicit decision before:
230
316
 
231
317
  - architectural or API trade-offs
232
318
  - destructive or costly-to-reverse changes
@@ -401,22 +487,30 @@ After installing, confirm the integration works:
401
487
  5. Ask: *"fix this bug"* — confirm pi invokes `debugging-and-error-recovery`, or run `/af-test` to start a TDD/debugging workflow explicitly.
402
488
  6. Give pi an ambiguous or high-stakes request and confirm it can use the `ask_user` tool / `ask-user` skill to request an explicit decision.
403
489
 
404
- If skill autocomplete is empty, check that `.agents/skills` points to a directory containing `<skill-name>/SKILL.md` files and that pi was not started with `--no-skills`.
490
+ Start any diagnosis with the installer's own read-only report — it compares what
491
+ is recorded, what is on disk, and what the package ships, and exits `2` when
492
+ something is broken:
493
+
494
+ ```bash
495
+ npx @chankov/agent-fleet verify --agent pi
496
+ npx @chankov/agent-fleet doctor --fix # repair missing/dangling items
497
+ ```
498
+
499
+ If skill autocomplete is empty, check that `.pi/skills/` contains `<skill-name>/SKILL.md` directories and that pi was not started with `--no-skills`.
405
500
 
406
- If lifecycle command autocomplete is empty, check that `.pi/prompts` points to a directory containing the command Markdown files and run `/reload` or restart pi.
501
+ If lifecycle command autocomplete is empty, check that `.pi/prompts/` contains the command Markdown files and run `/reload` or restart pi.
407
502
 
408
503
  If `/af-chrome_devtools-status` reports `Cannot find module '@modelcontextprotocol/sdk/client/index.js'`, the MCP extension loaded but its runtime initialization failed. An `[Extensions]` startup entry alone does not prove its tools registered.
409
504
 
410
- For a cloned or copied install, run:
505
+ The fix is the dependency install that `--allow-exec` would have run:
411
506
 
412
507
  ```bash
413
- cd /path/to/agent-fleet/.pi/extensions
414
- npm ci
508
+ npm ci --prefix .pi/extensions
415
509
  ```
416
510
 
417
- For extensions symlinked into a published `@chankov/agent-fleet` package, update to a package version that declares the extension dependencies at its root, then restart/reload pi. Do not rely on installing only the target workspace's `.pi/extensions/node_modules`: Node may resolve the symlink to the package's real path. Verify the repair with `/af-chrome_devtools-status`; it must report `connected` and a non-zero registered tool count.
511
+ Verify the repair with `/af-chrome_devtools-status`; it must report `connected` and a non-zero registered tool count. An `[Extensions]` startup entry alone does not prove the tools registered.
418
512
 
419
- The harnesses install separately — if a harness reports `Cannot find module 'yaml'` or `'@sinclair/typebox'`, run `npm ci` in `.pi/harnesses/` as well (or `just install` from the clone, which does both).
513
+ The harnesses install separately — if a harness reports `Cannot find module 'yaml'` or `'@sinclair/typebox'`, run `npm ci --prefix .pi/harnesses` as well (or `just install` from a clone, which does both).
420
514
 
421
515
  Then run `/reload` or restart pi.
422
516
 
@@ -426,7 +520,7 @@ Then run `/reload` or restart pi.
426
520
 
427
521
  - Automatic skill loading depends on the underlying model's compliance with `AGENTS.md` rules.
428
522
  - Prompt-template commands expand into instructions; they do not mechanically execute `/skill:<name>`. The pi-specific prompt templates therefore explicitly tell the agent which skills to load and follow.
429
- - Windows without developer mode may not support symlinks — use the copy variant instead.
523
+ - The CLI installs per workspace only; a machine-wide install means the pi package (`pi install npm:@chankov/agent-fleet`), which carries skills and prompts but not the extensions or harnesses.
430
524
  - Global `AGENTS.md` applies to every project when using the global-install alternative; pi concatenates context files, so this is usually additive, not destructive, but be aware of it.
431
525
 
432
526
  ---
@@ -465,12 +559,13 @@ Or invoke individual skills directly when you want precise control:
465
559
 
466
560
  pi integration works by leveraging pi's **native** Agent Fleet and prompt-template support:
467
561
 
468
- - Symlink `skills/` into `.agents/skills/`
469
- - Symlink `.pi/prompts/` into the target project's `.pi/prompts/`
470
- - Install `@chankov/agent-fleet` as a pi package for bundled `ask_user`, or install `pi-ask-user` separately for clone/symlink setup
471
- - Let pi auto-load `AGENTS.md` from the repo root
472
- - Use `/skill:<name>`, lifecycle commands like `/af-spec`, or natural language to trigger workflows
562
+ - `npx @chankov/agent-fleet install --agent pi --profile recommended --yes` writes the skills to `.pi/skills/` and the lifecycle commands to `.pi/prompts/`
563
+ - add `--profile pi-fleet-core --allow-exec` for the harness stack, its `justfile` region, and its runtime dependencies
564
+ - install `@chankov/agent-fleet` as a pi package for bundled `ask_user`, or install `pi-ask-user` separately for clone setup
565
+ - let pi auto-load `AGENTS.md` from the repo root
566
+ - use `/skill:<name>`, lifecycle commands like `/af-spec`, or natural language to trigger workflows
567
+ - keep it current with `agent-fleet upgrade`, check it with `agent-fleet verify`, repair it with `agent-fleet doctor --fix`
473
568
 
474
569
  Guided setup can additionally offer the optional `pi-codex-image-gen` package when pi package installation is available, but it is not part of the minimal path.
475
570
 
476
- The result is a fully agent-driven, production-grade engineering workflow — with minimal setup: one symlink for this repo's skills, one symlink for lifecycle commands, plus bundled or separately installed `pi-ask-user` for interactive decision gating.
571
+ The result is a fully agent-driven, production-grade engineering workflow — from one CLI command, with no coding agent and no model needed to install it.