@chankov/agent-fleet 0.0.11 → 1.0.0

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 (494) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +26 -25
  3. package/.pi/extensions/btw/index.ts +80 -83
  4. package/.pi/extensions/pi-voice-stt/README.md +4 -3
  5. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  6. package/.pi/harnesses/agent-hub/README.md +106 -54
  7. package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
  8. package/.pi/harnesses/agent-hub/footer.ts +4 -0
  9. package/.pi/harnesses/agent-hub/helpers.ts +18 -0
  10. package/.pi/harnesses/agent-hub/index.ts +537 -369
  11. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  14. package/.pi/harnesses/agent-hub/posture.ts +103 -0
  15. package/.pi/harnesses/ask-user-remote/README.md +37 -3
  16. package/.pi/harnesses/ask-user-remote/index.ts +173 -17
  17. package/.pi/harnesses/coms/package.json +1 -1
  18. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  19. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  20. package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  22. package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  23. package/.pi/harnesses/lib/fleet-panel.ts +34 -0
  24. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  25. package/.pi/harnesses/lib/fleet-selection.ts +24 -0
  26. package/.pi/harnesses/package-lock.json +2011 -0
  27. package/.pi/harnesses/package.json +1 -0
  28. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  29. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
  30. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
  31. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  32. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
  33. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
  34. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
  35. package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
  36. package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
  37. package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
  38. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
  39. package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
  40. package/.versions/0.0.11/docs/getting-started.md +26 -237
  41. package/.versions/0.0.11/docs/npm-install.md +60 -478
  42. package/.versions/0.0.11/docs/pi-extensions.md +4 -4
  43. package/.versions/0.0.11/docs/pi-setup.md +37 -551
  44. package/.versions/0.0.11/hermes/README.md +1 -1
  45. package/.versions/0.0.11/install-manifest.json +375 -1247
  46. package/.versions/0.0.11/justfile +13 -6
  47. package/.versions/0.0.11/manifest-meta.json +543 -134
  48. package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
  49. package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
  50. package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
  51. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
  52. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  53. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  54. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  55. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  56. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  57. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  58. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  59. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  60. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  74. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  75. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  83. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  84. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  85. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  86. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  87. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  88. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  89. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  90. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  91. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  92. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  93. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  94. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  95. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  96. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  97. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  98. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  99. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  100. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  101. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  102. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  103. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  104. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  105. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  106. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  107. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  108. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  109. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  110. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  111. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  112. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  113. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  114. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  115. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  116. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  117. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  118. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  119. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  120. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  121. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  122. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  123. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  124. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  125. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  126. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  127. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  128. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  129. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  130. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  131. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  132. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  133. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  134. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  135. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  136. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  137. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  138. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  139. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  140. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  141. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  142. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  143. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  144. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  145. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  146. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  147. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  148. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  149. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  150. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  151. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  152. package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
  153. package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
  154. package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
  155. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  156. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  157. package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
  158. package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
  159. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  160. package/.versions/1.0.0/.version +1 -0
  161. package/.versions/1.0.0/agents/architect.md +24 -0
  162. package/.versions/1.0.0/agents/bowser.md +27 -0
  163. package/.versions/1.0.0/agents/builder.md +54 -0
  164. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  165. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  166. package/.versions/1.0.0/agents/documenter.md +18 -0
  167. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  168. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  169. package/.versions/1.0.0/agents/planner.md +70 -0
  170. package/.versions/1.0.0/agents/releaser.md +24 -0
  171. package/.versions/1.0.0/agents/researcher.md +28 -0
  172. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  173. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  174. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  175. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  176. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  177. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  178. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  179. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  180. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  181. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  182. package/.versions/1.0.0/docs/getting-started.md +98 -0
  183. package/.versions/1.0.0/docs/npm-install.md +292 -0
  184. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  185. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  186. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  187. package/.versions/1.0.0/hermes/README.md +347 -0
  188. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  189. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  190. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  191. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  192. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  193. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  194. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  195. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  196. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  197. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  198. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  199. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  200. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  201. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  202. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  203. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  204. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  205. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  206. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  207. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  208. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  209. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  210. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  211. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  212. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  213. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  214. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  215. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  216. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  217. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  218. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  219. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  220. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  221. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  222. package/.versions/1.0.0/install-manifest.json +2745 -0
  223. package/.versions/1.0.0/justfile +272 -0
  224. package/.versions/1.0.0/manifest-meta.json +882 -0
  225. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  226. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  227. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  228. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  229. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  230. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  231. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  232. package/.versions/1.0.0/references/security-checklist.md +179 -0
  233. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  234. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  235. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  236. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  237. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  238. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  239. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  240. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  241. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  242. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  243. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  244. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  245. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  246. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  247. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  248. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  249. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  250. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  251. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  252. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  253. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  254. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  255. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  256. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  257. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  258. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  259. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  260. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  261. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  262. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  263. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  264. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  265. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  266. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  267. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  268. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  269. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  270. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  271. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  272. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  273. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  274. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  275. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  276. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  278. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  279. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  280. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  284. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  285. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  286. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  287. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  288. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  289. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  290. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  291. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  292. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  293. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  294. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  295. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  296. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  297. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  298. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  299. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  300. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  301. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  302. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  303. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  304. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  305. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  306. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  307. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  308. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  309. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  310. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  311. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  312. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  313. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  314. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  315. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  316. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  317. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  318. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  319. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  320. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  321. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  322. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  323. package/CHANGELOG.md +142 -0
  324. package/README.md +117 -79
  325. package/agents/orchestrator.md +1 -1
  326. package/bin/cli.js +289 -359
  327. package/bin/force-patch-changesets.js +18 -2
  328. package/bin/lib/apply.js +86 -32
  329. package/bin/lib/desired.js +87 -0
  330. package/bin/lib/detect-agent.js +22 -38
  331. package/bin/lib/doctor.js +283 -33
  332. package/bin/lib/features.js +78 -0
  333. package/bin/lib/manifest.js +127 -48
  334. package/bin/lib/overrides.js +35 -0
  335. package/bin/lib/personas.js +37 -0
  336. package/bin/lib/plan.js +18 -9
  337. package/bin/lib/purge.js +11 -0
  338. package/bin/lib/reconcile.js +68 -0
  339. package/bin/lib/scan.js +24 -0
  340. package/bin/lib/state.js +25 -1
  341. package/bin/lib/stt-wizard.js +33 -0
  342. package/bin/lib/transaction.js +149 -0
  343. package/bin/lib/tui.js +71 -0
  344. package/bin/lib/verify.js +9 -26
  345. package/bin/snapshot-version.js +3 -6
  346. package/docs/ARCHITECTURE.md +55 -21
  347. package/docs/MIGRATION-agent-fleet.md +222 -0
  348. package/docs/agent-fleet-setup.md +124 -64
  349. package/docs/claude-code-coms-bridge.md +21 -2
  350. package/docs/coms-hermes-bridge.md +1 -1
  351. package/docs/getting-started.md +61 -217
  352. package/docs/npm-install.md +207 -429
  353. package/docs/pi-extensions.md +85 -41
  354. package/docs/pi-setup.md +48 -545
  355. package/hermes/README.md +1 -1
  356. package/install-manifest.json +385 -1255
  357. package/justfile +45 -27
  358. package/manifest-meta.json +544 -134
  359. package/node_modules/pi-ask-user/README.md +43 -5
  360. package/node_modules/pi-ask-user/index.ts +630 -75
  361. package/node_modules/pi-ask-user/package.json +1 -1
  362. package/package.json +5 -11
  363. package/scripts/coms-claude-bridge.ts +10 -0
  364. package/scripts/fleet.ts +107 -90
  365. package/scripts/lib/claude-bridge-core.ts +45 -0
  366. package/scripts/lib/fleet-command.ts +170 -15
  367. package/scripts/lib/monitor-env.ts +18 -6
  368. package/scripts/lib/peer-launch.ts +6 -2
  369. package/scripts/lib/team-project.ts +24 -4
  370. package/scripts/team-up.ts +57 -11
  371. package/skills/designing-agents/SKILL.md +1 -1
  372. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  373. package/.claude/commands/build.md +0 -44
  374. package/.claude/commands/design-agent.md +0 -14
  375. package/.claude/commands/doctor-agent-fleet.md +0 -22
  376. package/.claude/commands/orchestrate.md +0 -112
  377. package/.claude/commands/prime.md +0 -22
  378. package/.claude/commands/review.md +0 -16
  379. package/.claude/commands/set-hermes-telegram.md +0 -15
  380. package/.claude/commands/set-hermes-watchdog.md +0 -6
  381. package/.claude/commands/setup-agent-fleet.md +0 -17
  382. package/.claude/commands/ship.md +0 -72
  383. package/.claude/commands/spec.md +0 -15
  384. package/.claude/commands/test.md +0 -19
  385. package/.claude/commands/webperf.md +0 -32
  386. package/.claude/orchestrate-teams.yaml +0 -24
  387. package/.opencode/commands/af-build.md +0 -17
  388. package/.opencode/commands/af-code-simplify.md +0 -16
  389. package/.opencode/commands/af-compound.md +0 -16
  390. package/.opencode/commands/af-design-agent.md +0 -15
  391. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  392. package/.opencode/commands/af-orchestrate.md +0 -112
  393. package/.opencode/commands/af-plan.md +0 -16
  394. package/.opencode/commands/af-prime.md +0 -22
  395. package/.opencode/commands/af-review.md +0 -15
  396. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  397. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  398. package/.opencode/commands/af-ship.md +0 -16
  399. package/.opencode/commands/af-spec.md +0 -16
  400. package/.opencode/commands/af-test.md +0 -21
  401. package/.opencode/commands/af-webperf.md +0 -32
  402. package/.opencode/orchestrate-teams.yaml +0 -24
  403. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  404. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  405. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  406. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  407. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  408. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  409. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  410. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  411. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  412. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  413. package/.versions/0.0.11/.claude/commands/build.md +0 -44
  414. package/.versions/0.0.11/.claude/commands/code-simplify.md +0 -22
  415. package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
  416. package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
  417. package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
  418. package/.versions/0.0.11/.claude/commands/plan.md +0 -16
  419. package/.versions/0.0.11/.claude/commands/prime.md +0 -22
  420. package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
  421. package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
  422. package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
  423. package/.versions/0.0.11/.claude/commands/ship.md +0 -72
  424. package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
  425. package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
  426. package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
  427. package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
  428. package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
  429. package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
  430. package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  431. package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
  432. package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
  433. package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
  434. package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
  435. package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +0 -15
  436. package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  437. package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
  438. package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
  439. package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
  440. package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
  441. package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
  442. package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
  443. package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  444. package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
  445. package/.versions/0.0.11/docs/opencode-setup.md +0 -281
  446. package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
  447. package/.versions/0.0.11/hooks/hooks.json +0 -14
  448. package/.versions/0.0.11/hooks/session-start.sh +0 -74
  449. package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
  450. package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
  451. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  452. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  453. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  454. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  455. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  456. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  457. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  458. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  459. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  460. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  461. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  462. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  463. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  464. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  465. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  466. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  467. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  468. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  469. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  470. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  471. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  472. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  473. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  474. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  475. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  476. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
  477. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  478. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  479. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  480. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  481. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  482. package/bin/lib/bootstrap.js +0 -323
  483. package/bin/lib/transform-persona.js +0 -180
  484. package/docs/opencode-setup.md +0 -281
  485. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  486. package/hooks/hooks.json +0 -14
  487. package/hooks/session-start.sh +0 -74
  488. package/hooks/simplify-ignore.sh +0 -302
  489. package/skills/guided-workspace-setup/SKILL.md +0 -226
  490. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  491. /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  492. /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  493. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
  494. /package/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
@@ -0,0 +1,222 @@
1
+ # Major-release migration guide
2
+
3
+ This is a large major release. Four independent changes land together, and each
4
+ one breaks something different:
5
+
6
+ | # | Change | Who it breaks | Section |
7
+ |---|---|---|---|
8
+ | 1 | Guided LLM setup replaced by deterministic `setup`/`doctor`/`uninstall` | Anyone who installed or updated with the old guided flow | [Lifecycle](#1-the-lifecycle-is-deterministic-now) |
9
+ | 2 | Claude Code removed as a coding-agent install target | Workspaces installed with `--agent claude-code` | [Claude Code](#2-claude-code-is-a-coms-peer-only) |
10
+ | 3 | OpenCode support removed entirely | Workspaces installed with `--agent opencode` | [OpenCode](#3-opencode-is-gone) |
11
+ | 4 | Pi Fleet startup unified behind one guarded Agent Hub runtime | Scripts and habits built on `just fleet hub` / `just fleet team` | [Fleet runtime](#4-one-unified-just-fleet-runtime) |
12
+
13
+ If you read only one thing: **update with `just fleet setup --dry-run` first.**
14
+ The plan names every file it will overwrite, and this release changes enough
15
+ that reading it once is worth the minute.
16
+
17
+ ---
18
+
19
+ ## 1. The lifecycle is deterministic now
20
+
21
+ The conversational setup layer is gone. `setup`, `doctor`, and `uninstall` are
22
+ the public commands, they need no coding agent or model, and every mutation is
23
+ planned before it is applied.
24
+
25
+ **What was removed:** the guided setup skill and its two prompts, the installer
26
+ self-removal command, and the raw `--items` / `--profile` selectors on `setup`
27
+ (use `--preset <default|full>` and `--features <name[,name]|none>`).
28
+
29
+ **Compatibility aliases:** `init` and `update` dispatch to `setup`. `install`
30
+ and `upgrade` keep their historical selection and three-way-merge semantics and
31
+ emit a deprecation warning — they are not replacements for deterministic
32
+ automation and do not restore retired prompt or skill surfaces.
33
+
34
+ ### The command matrix
35
+
36
+ | Situation | Command | Result / gate |
37
+ | --- | --- | --- |
38
+ | **First install, any repository** | `npx @chankov/agent-fleet@latest setup` | Interactive in a TTY. A repository without Agent Fleet has no justfile — setup writes it — so `just fleet setup` is not available yet. |
39
+ | Fresh Default automation | `npx @chankov/agent-fleet@<exact-version> setup --preset default --features none --yes` | Reproducible stable Fleet Core, no voice configuration or `.claude/`. |
40
+ | Fresh Full automation | `npx @chankov/agent-fleet@<exact-version> setup --preset full --features none --yes` | All stable, platform-applicable catalogue roots; experimental Codex Remote stays excluded. |
41
+ | Finish the install | `just fleet deps` (or `setup --allow-exec`) | Setup writes files and runs no commands. The `npm` steps are planned as `skip`; the workspace is not launchable until they run. |
42
+ | **Routine update** | `just fleet setup --dry-run`, then `just fleet setup` | Reconciles to the desired state already in `.ai/agent-fleet.json`; no flags needed. |
43
+ | Stable features | `... setup --preset default --features voice,browser --yes` | `hermes`, `telegram` (requires `hermes`), and `claude-bridge` are stable; `codex-remote` is an explicit experimental opt-in. |
44
+ | Existing desired state | `... setup --preset full --features none --yes` | Flags are ephemeral; existing `.ai/agent-fleet.json` is unchanged. Add `--save-desired` to persist. |
45
+ | First legacy migration preview | `... setup --migrate --dry-run` | Lists exact state-owned removals; no consent or writes. |
46
+ | First legacy migration mutation | `... setup --migrate --preset default --features none --yes` | Automation requires all three gates: `--migrate`, explicit preset/features, and `--yes`; only unchanged owned extras are removed. |
47
+ | Legacy record without state | `... setup --migrate --dry-run` | Preview first; do not assume unrecorded files are owned or removable. |
48
+ | Conflict | `... setup --on-conflict theirs` or `--on-conflict ours` | Without a policy setup exits `3` before writes. `ours` keeps the local copy; `theirs` takes the package version. |
49
+ | Read-only diagnosis | `... doctor` | Never prompts or writes; actionable findings exit `2`, advisory-only output exits `0`. |
50
+ | Repair | `... doctor --fix` | Recovers interrupted transactions and pending runtime repairs. If a transaction backup was reaped, doctor reports the unrecoverable journal; `--fix` safely discards that installer-owned journal because restoration is impossible. |
51
+ | Normal removal | `... uninstall --all --yes` | Removes only recorded, unchanged artifacts; desired/override/STT configuration and environment files remain. |
52
+ | Config purge | `... uninstall --all --purge-config --yes` | The separate destructive gate removes desired/override/STT config; environment files remain. |
53
+ | Self-hosted removal | `just fleet uninstall --yes` | Removes ordinary content, then launcher/managed region, then state; its in-memory report still completes. |
54
+ | Self-hosted reinstall | `npx @chankov/agent-fleet@latest setup --preset default --features none --yes` | Restores `just fleet`; then run `just fleet doctor`. |
55
+
56
+ `just fleet install` was removed; use `just fleet setup` or `just fleet deps`.
57
+ `pi update --extensions` updates pi extensions only, never the npm installer.
58
+ Published-package commands use `npx`; source-checkout development uses
59
+ `node bin/cli.js setup` with equivalent flags.
60
+
61
+ ### The behaviour change most likely to surprise you
62
+
63
+ `setup` reconciles the workspace **toward the package**. If you edited a shipped
64
+ artifact in place and upstream did not change it, `setup` refreshes the file and
65
+ your edit is gone — no conflict, no prompt. The old `upgrade` verb preserved
66
+ such edits; `setup` does not.
67
+
68
+ ```bash
69
+ just fleet setup --dry-run
70
+ # refresh skill:code-review-and-quality
71
+ # locally modified — selecting it overwrites your edits ← your edit dies here
72
+ ```
73
+
74
+ Customize through `.ai/agent-fleet-overrides.md` (human-owned, never touched by
75
+ any lifecycle command), through artifacts under names Agent Fleet does not ship,
76
+ or by leaving the item out of your selection — `setup` never removes what it
77
+ does not select, so an unselected item stays installed and frozen.
78
+
79
+ Full per-state table: [npm-install.md](npm-install.md#what-reconcile-does-to-each-file).
80
+
81
+ ### Ownership and configuration rules
82
+
83
+ The state file is the only deletion authority. Unknown extensions, hooks,
84
+ settings, recipes, and files are not adopted. Desired state belongs to
85
+ `.ai/agent-fleet.json`; project overrides and STT configuration are human
86
+ configuration and survive a normal uninstall. Secrets are referenced by
87
+ environment-variable name only and are never written to state, journals, desired
88
+ state, or `.ai/stt.json`. The installer-owned `.ai/agent-fleet-transaction.json`
89
+ is a crash-recovery journal — removed on success or recovery, never a user
90
+ configuration file.
91
+
92
+ ---
93
+
94
+ ## 2. Claude Code is a coms peer only
95
+
96
+ pi is the only agent the installer writes for. Claude Code stays in the fleet as
97
+ a **coms peer** and nothing else.
98
+
99
+ **Gone:** `.claude/commands/` (15 slash commands, including `/orchestrate`) and
100
+ `.claude/orchestrate-teams.yaml`; `.claude-plugin/` — Agent Fleet is no longer
101
+ published as a Claude Code plugin, and npm is the only distribution channel;
102
+ `hooks/session-start.sh`, `hooks/simplify-ignore*.sh`, `hooks/SIMPLIFY-IGNORE.md`,
103
+ `hooks/hooks.json`; `agent-fleet transform-persona` and its install strategy; the
104
+ `references-hooks` manifest group; and the interactive "which coding agent?"
105
+ prompt.
106
+
107
+ **Replaced by:** `--agent` is still accepted and validated, defaults to `pi`, and
108
+ is never asked for. References moved from `.claude/references/` to
109
+ `.pi/references/` and are no longer a standalone menu section — each is a
110
+ **companion of the skills that cite it**, so installing `code-review-and-quality`
111
+ brings `security-checklist.md` and `performance-checklist.md` with it, and
112
+ uninstall refuses to strand a skill without its checklists. A new `coms-bridge`
113
+ manifest group holds `skill:peer-coms` and its companion `hook:coms-stop-hook`;
114
+ the hook still installs to `.claude/hooks/` under the **pi** agent, because the
115
+ pane reading it is a Claude Code process. Registering it in `.claude/settings.json`
116
+ remains a manual step — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
117
+
118
+ **Unchanged:** the bridge itself — `scripts/coms-claude-bridge.ts`,
119
+ `scripts/lib/claude-bridge-core.ts`, `skills/peer-coms/`, the `_claude-peer`
120
+ recipe, `runner: claude-code` peers in `.pi/agents/peers.yaml`, and the
121
+ `dispatch-policy.yaml` routing that lets a bridged pane serve a team member's
122
+ dispatch. Cross-model review through a standing Claude session works as before.
123
+
124
+ ### Migrating a `claude-code` workspace
125
+
126
+ Not automatic. Those `.claude/` artifacts left the catalogue, so `verify` will
127
+ not claim them and `uninstall` will not remove them — the ownership rule cuts
128
+ both ways.
129
+
130
+ ```bash
131
+ # 1. Reinstall for pi.
132
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
133
+ just fleet deps
134
+
135
+ # 2. See what the installer now considers yours.
136
+ just fleet doctor
137
+
138
+ # 3. Remove the orphaned Claude Code install by hand, after reviewing it.
139
+ # Keep .claude/hooks/ if you use the coms bridge.
140
+ rm -rf .claude/commands .claude/skills .claude/agents .claude/references
141
+ rm -f .claude/orchestrate-teams.yaml
142
+ rm -rf .claude-plugin
143
+ ```
144
+
145
+ Review before deleting — `.claude/` may hold your own settings and hooks that
146
+ Agent Fleet never wrote.
147
+
148
+ ---
149
+
150
+ ## 3. OpenCode is gone
151
+
152
+ OpenCode is no longer a recognized agent for any skill, persona, command, or
153
+ harness. `--agent opencode` is rejected by every CLI verb, and the installer no
154
+ longer knows the `.opencode/` paths — so it can neither install into nor clean
155
+ up an OpenCode workspace.
156
+
157
+ `detect-agent`, `manifest`, `bootstrap`, and `doctor` dropped every `.opencode/`
158
+ target path and the OpenCode persona transform. `.opencode/` and
159
+ `docs/opencode-setup.md` left the package, and the `opencode` keyword left
160
+ `package.json`. `/compound` is gone as an installable command — it only ever
161
+ shipped as an OpenCode command file; pi keeps `/af-compound` via the `agent-hub`
162
+ harness.
163
+
164
+ ### Migrating an OpenCode workspace
165
+
166
+ Delete it by hand **before** you upgrade, then install for pi:
167
+
168
+ ```bash
169
+ rm -rf .opencode/agent .opencode/skills .opencode/commands
170
+ rm -f .opencode/orchestrate-teams.yaml
171
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
172
+ just fleet deps
173
+ ```
174
+
175
+ `.versions/<x.y.z>/` snapshots are left untouched — they are the record of what
176
+ each past release actually shipped, and reconciliation diffs against them.
177
+
178
+ ---
179
+
180
+ ## 4. One unified `just fleet` runtime
181
+
182
+ Pi Fleet startup is now a single guarded Agent Hub runtime. Bare `just fleet`
183
+ loads Fleet Core plus Agent Hub in **operator** posture: direct coding tools
184
+ preserved, native roster empty. Execution posture, native specialists, workspace
185
+ topology, project scope, and communication capabilities are now selected
186
+ independently:
187
+
188
+ ```bash
189
+ just fleet # operator, empty native roster
190
+ just fleet --agents frontend # native roster; orchestrator inferred
191
+ just fleet --posture operator --agents frontend # direct work plus the same roster
192
+ just fleet --no-coms # direct/native work, no peer messaging
193
+ just fleet --herdr --project af # one Hub pane, no standing peers
194
+ just fleet --agents frontend --peers frontend --project af
195
+ ```
196
+
197
+ New in the same change: live `/af-posture` switching, on-demand native roster
198
+ growth (`/af-agents-add`), deterministic `dispatch_agent` routing through
199
+ `backend: auto|native|coms`, and same-project dynamic Pi or Claude Code peer
200
+ spawning through Herdr.
201
+
202
+ ### Deprecated forms — accepted for one migration release
203
+
204
+ | Old | New |
205
+ |---|---|
206
+ | `just fleet hub` | `just fleet` |
207
+ | `just fleet hub --solo` | `just fleet --no-coms` |
208
+ | `just fleet team <preset>` | `just fleet --agents <roster> --peers <preset>` |
209
+ | `just fleet team <preset> --no-hub` | legacy peers-only topology; no canonical replacement |
210
+
211
+ Each old form still runs and prints its canonical replacement. Legacy peer-only
212
+ presets (`full`, `web`, `docs`) retain the default native roster. Update scripts
213
+ during this release — the aliases are removed in the next one.
214
+
215
+ ---
216
+
217
+ ## Retired surfaces
218
+
219
+ The retired installer implementation and its two setup/doctor prompts are
220
+ intentionally absent. All other `af-*` lifecycle and operational prompts remain
221
+ public. Historical changelog and planning text may mention retired surfaces as
222
+ history only.
@@ -6,12 +6,14 @@ different readers and different lifetimes, so they are kept separate.
6
6
  | File | Read by | When |
7
7
  |------|---------|------|
8
8
  | `.ai/agent-fleet-overrides.md` | `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`, `git-workflow-and-versioning`, `compound-learning` (the `rules:`/`docs:` keys of `## agent-hub`), `agent-hub` pi harness | Every run of those skills / every session start of the harness |
9
- | `.ai/agent-fleet-state.json` | the `agent-fleet` CLI (`install`, `upgrade`, `uninstall`, `verify`, `doctor`) | Every plan and every apply |
10
- | `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every apply |
9
+ | `.ai/agent-fleet.json` | the deterministic `agent-fleet` lifecycle (`setup`) — human-owned desired state (preset/features); intended to be committed | Every setup plan; created/updated when setup persists desired state or migrates legacy installs |
10
+ | `.ai/agent-fleet-state.json` | the deterministic `agent-fleet` lifecycle (`setup`, `doctor`, `uninstall`) | Every lifecycle plan and apply |
11
+ | `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
12
+ | `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
11
13
  | `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
12
14
 
13
15
  The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
14
- extension has been configured (by guided setup or by hand). Like the overrides file it holds
16
+ extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
15
17
  **no secrets** — it names the env vars (`apiKeyEnv`, plus the Azure endpoint var) whose values
16
18
  live in a gitignored root `.env`. See [pi-voice-stt config](#ai-sttjson) below.
17
19
 
@@ -19,6 +21,76 @@ Keep them split: the overrides file is loaded into context constantly, so it
19
21
  must stay minimal; the install record is read only by the CLI, so it can be
20
22
  large.
21
23
 
24
+ ## Unified Fleet runtime configuration
25
+
26
+ A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
27
+ plus Agent Hub in **operator** posture, in the current terminal, with no native
28
+ specialists active:
29
+
30
+ ```bash
31
+ just fleet
32
+ just fleet --project af
33
+ ```
34
+
35
+ Posture, native roster, and peer topology are separate controls:
36
+
37
+ ```bash
38
+ # Direct tools plus an available native roster.
39
+ just fleet --posture operator --agents frontend --project af
40
+
41
+ # A roster implies orchestrator when posture is not explicit.
42
+ just fleet --agents frontend --project af
43
+
44
+ # Herdr Hub-only and Hub-plus-peer topologies.
45
+ just fleet --herdr --project af
46
+ just fleet --agents frontend --peers frontend --project af
47
+ ```
48
+
49
+ Startup precedence is deterministic: explicit `--posture` wins; otherwise an
50
+ explicit `--agents` roster implies `orchestrator`; otherwise posture is
51
+ `operator`. An orchestrator startup must name a roster. `--herdr` affects only
52
+ placement, while `--peers <preset>` implies Herdr and starts the selected peer
53
+ preset. Neither topology option selects a native roster.
54
+
55
+ `--project <name>` selects one coms namespace for the Hub and every standing or
56
+ dynamically spawned peer. Dynamic peer tools deliberately expose no project
57
+ override, so an agent cannot cross that boundary. The default project is
58
+ `default`; use an explicit project when multiple fleets share a machine.
59
+
60
+ The configuration files have distinct ownership:
61
+
62
+ | File | Controls |
63
+ | --- | --- |
64
+ | `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
65
+ | `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
66
+ | `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
67
+ | `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budgets, mode, watchdog, and related execution policy. It does not choose startup posture or topology. |
68
+
69
+ For deterministic routing, `backend: "native"` always starts the local Pi
70
+ specialist even if a same-name peer is visible. `backend: "coms"` requires a
71
+ visible same-name peer and refuses without native fallback. The default
72
+ `backend: "auto"` follows `dispatch-policy.yaml` and preserves its configured
73
+ fallback behavior.
74
+
75
+ Capability flags and runtime gates fail closed:
76
+
77
+ - `--no-coms` keeps operator direct tools and native dispatch available, but
78
+ peer dispatch, `coms_send`/`coms_await`, and `/af-handoff` refuse actionably.
79
+ - `--herdr` and `--peers` require a running [Herdr](https://herdr.dev) server.
80
+ Without Herdr, bare Fleet still works and dynamic pane tools stay inactive.
81
+ - `--browser` adds the browser extension surface and `--all-extensions` opts
82
+ into the complete approved extension set. Missing optional dependencies do
83
+ not grant tools merely because a flag was supplied.
84
+ - Hub-owned slash commands remain registered in both postures. A missing coms
85
+ runtime, Herdr connection, target peer, or native roster produces a
86
+ capability refusal rather than a missing command.
87
+
88
+ During the migration release, `just fleet hub`, `just fleet team <preset>`,
89
+ `just fleet team <preset> --no-hub`, and `--solo` remain accepted and print a
90
+ canonical replacement. New automation should use `just fleet` with
91
+ `--agents`, `--peers`, `--herdr`, and `--no-coms`; compatibility does not imply
92
+ that the deprecated grammar will remain indefinitely.
93
+
22
94
  ## The overrides file — `.ai/agent-fleet-overrides.md`
23
95
 
24
96
  Some skills and pi harnesses need facts specific to each project — where specs
@@ -93,7 +165,7 @@ override files keep working unchanged. When both sections are present their keys
93
165
  with later lines winning.
94
166
 
95
167
  The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
96
- skill (and the `/compound` Claude Code / `/af-compound` OpenCode commands built on it) resolves them as the
168
+ skill (and the `/af-compound` agent-hub command built on it) resolves them as the
97
169
  targets an end-of-session compound pass writes lessons to.
98
170
 
99
171
  | Key | Default | Meaning |
@@ -159,8 +231,9 @@ the environment nor declared in the workspace root `.env`.
159
231
 
160
232
  ### Per-peer env files (`env_file:` in peers.yaml)
161
233
 
162
- Fleet peers spawned by `just fleet team` can carry their own
163
- environment: an `env_file:` entry in `.pi/agents/peers.yaml` names a
234
+ Fleet peers spawned through `--peers`, `just fleet peer`, or the Hub's
235
+ constrained dynamic peer tool can carry their own environment: an `env_file:`
236
+ entry in `.pi/agents/peers.yaml` names a
164
237
  **repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
165
238
  that herdr injects into the peer's pane before the command runs — no `source`,
166
239
  no leaking into sibling panes. The file must exist at spawn (team-up refuses
@@ -185,7 +258,7 @@ replaced the prose ownership rule the setup skill used to carry.
185
258
  | State-file field | Meaning |
186
259
  |---|---|
187
260
  | `agent`, `method`, `sourceRoot` | How and from where this workspace was installed |
188
- | `packageVersion` | The version that performed the last apply — the merge base for the next `upgrade` |
261
+ | `packageVersion` | The version that performed the last apply — provenance for reconciliation and legacy three-way compatibility |
189
262
  | `items` | One entry per installed artifact: strategy, method, files with hashes, JSON key paths |
190
263
  | `externalPackages` | Packages the user was told to install; recorded, never installed for them |
191
264
  | `events` | Last few applies (verb, version, action count, conflicts) |
@@ -195,75 +268,62 @@ replaced the prose ownership rule the setup skill used to carry.
195
268
 
196
269
  ### The recorded version and the three-way merge
197
270
 
198
- `packageVersion` drives `upgrade`. For each installed artifact the engine
199
- compares three sides: *source@recorded* from the package's `.versions/<x.y.z>/`
200
- snapshot tree, the installed copy on disk, and *source@current*.
271
+ The recorded `packageVersion` gives every comparison a baseline. For each
272
+ recorded artifact, the engine compares *source@recorded* from the package's
273
+ `.versions/<x.y.z>/` snapshot tree, the installed copy on disk, and
274
+ *source@current*. Deterministic `setup` is the public reconciliation command.
201
275
 
202
- | Outcome | What happens |
276
+ | Outcome | What `setup` does |
203
277
  |---|---|
278
+ | Neither moved | Kept |
204
279
  | Only the source moved | Clean refresh |
205
- | Only your copy moved | Kept — `upgrade` never eats a local edit |
206
- | Both moved, to different content | **Conflict**: the incoming version is written as `<file>.new`, your file is untouched, the run exits `3` |
207
- | Retired upstream | Proposed for removal by name, subject to the ownership rule |
280
+ | Only your copy moved | **Refreshed — your edit is overwritten.** Reported in the plan as *"locally modified — selecting it overwrites your edits"*, so `--dry-run` shows it before it happens |
281
+ | Both moved, to different content | **Conflict**: the run exits `3` before writing anything. Resolve with `--on-conflict theirs` or `--on-conflict ours` |
282
+ | Retired upstream | Kept by `setup`; the deprecated `upgrade` proposes removal by name, subject to the ownership rule |
283
+
284
+ Reconciling toward the package is the point of `setup`: the workspace is meant
285
+ to match the version it records. That is why editing a shipped artifact in place
286
+ is not a supported customization route — use `.ai/agent-fleet-overrides.md`, add
287
+ artifacts under names Agent Fleet does not ship, or leave the item out of the
288
+ selection (`setup` never removes what it does not select, so an unselected item
289
+ stays installed and frozen). The deprecated `upgrade` verb preserves local edits
290
+ instead of overwriting them; if you have relied on that, it is the behavioural
291
+ difference to plan for.
208
292
 
209
293
  If the snapshot is missing (an unpublished local build, or a version older than
210
294
  `.versions/` retention), the comparison degrades to two-way, the installed copy
211
- is treated as canonical, and `verify` says so as an advisory finding rather than
212
- pretending a diff exists.
295
+ is treated as canonical, and the read-only auxiliary `verify` command reports it
296
+ as an advisory finding rather than pretending a diff exists.
213
297
 
214
298
  ### Pre-engine workspaces
215
299
 
216
300
  A workspace with only `.ai/agent-fleet-setup.md` and no state file predates the
217
- installer engine. `verify` reads what it can from the markdown (`agent:`,
218
- `version:`), reports `stateSource: "legacy-record"`, and `upgrade` says plainly
219
- that ownership cannot be read back — run `install` once to reconstruct the state
220
- file first. A workspace with no `version:` at all is pre-versioning: there is no
221
- recorded baseline, so no three-way merge is attempted.
301
+ installer engine. `setup --migrate --dry-run` previews what it can infer from
302
+ that markdown (`agent:`, `version:`) without adopting unrecorded paths. To
303
+ mutate a legacy workspace, use `setup --migrate` with an explicit preset,
304
+ features, and `--yes`. A workspace with no `version:` at all has no recorded
305
+ baseline, so no three-way merge is attempted.
222
306
 
223
307
  Commit these files if the team should share install state — keep paths relative
224
308
  so they stay portable. A self-referencing checkout (agent-fleet itself) may
225
309
  instead `.gitignore` them, since their recorded paths are local to one machine.
226
310
 
227
- ## The `/orchestrate` command and its team config
228
-
229
- `/orchestrate` turns the main session (Claude Code) or primary agent (OpenCode)
230
- into an **orchestrator** that drives a config-defined team of installed
231
- subagents — subagents cannot nest, so all dispatching is the main session's job.
232
- The default team is `planner` + `builder` (no reviewer); the orchestrator routes
233
- the team as a **runtime roster, not a fixed `researcher → planner → builder`
234
- pipeline** — it skips planning when a plan already exists, re-runs `researcher`
235
- at any point, and loops back to `planner` when the build surfaces a wrong plan.
236
- It honours the existing subagent handoff markers: `PLAN_FILE: <path>` from the
237
- planner, and `NEEDS_RESEARCH: <question>` from planner/builder (which dispatches a
238
- read-only `researcher` and resumes the paused persona with the findings inlined).
239
-
240
- The named teams live in a per-agent config that mirrors pi's
241
- `.pi/agents/teams.yaml` (a map of team-name → ordered persona list, first key =
242
- default; `researcher`/`deep-researcher` deliberately unlisted but always
243
- available). The reader differs by runtime: pi's harness parses its YAML, while
244
- `/orchestrate` has the **command's instructions** read the YAML via the Read tool
245
- (no harness runtime in claude-code/opencode):
246
-
247
- | | Config file | Command |
248
- |---|---|---|
249
- | claude-code | `.claude/orchestrate-teams.yaml` | `/orchestrate` |
250
- | opencode | `.opencode/orchestrate-teams.yaml` | `/af-orchestrate` |
251
- | pi | `.pi/agents/teams.yaml` | via the `agent-hub` harness (no `/orchestrate`) |
252
-
253
- Switch teams at runtime with `/orchestrate <team> "<task>"` (parallel of pi's
254
- `/af-agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
255
- task text starts with a word that collides with a team key.
256
-
257
- **Guided-setup behaviour.** `guided-workspace-setup` offers `/orchestrate`
258
- **`★`-recommended** for claude-code + opencode (hidden for pi via the existing
259
- source-availability filter — there is no `.pi/prompts/af-orchestrate.md`), and
260
- installs the agent's `orchestrate-teams.yaml` as a **companion** of the command
261
- (a user-edited config is preserved on uninstall, never silently clobbered).
262
- Two artifacts stay **claude-only**: the lifecycle **hooks** (they register into
263
- `.claude/settings.json`, which opencode/pi have no install path for) and the
264
- **`AskUserQuestion` questionnaire menu mode** (the primary menu interaction on
265
- claude-code). The orchestrate command and its team config are *not* claude-only —
266
- they ship for opencode too.
311
+ ## Coms-backed team members
312
+
313
+ A team member the `agent-hub` harness dispatches (`.pi/agents/teams.yaml`) can be
314
+ served by a live coms peer of the same name instead of a freshly spawned native
315
+ subagent. With the default `backend: "auto"`,
316
+ `.pi/agents/dispatch-policy.yaml` decides that per member at dispatch time;
317
+ explicit `native` bypasses substitution, while explicit `coms` requires the
318
+ peer and never falls back. `.pi/agents/peers.yaml` decides *how* each peer runs.
319
+ A peer with `runner: claude-code` is an interactive Claude Code pane plus its
320
+ bridge — the one way Claude Code takes part in a fleet. See
321
+ [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
322
+
323
+ Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
324
+ is what gives a bridged pane exact turn text instead of scraped output.
325
+ Registering that hook in `.claude/settings.json` stays the user's step — the
326
+ installer writes files, and another tool's settings file is not its to merge.
267
327
 
268
328
  ## Templates
269
329
 
@@ -324,11 +384,11 @@ Edit the workspace, not this file — the next apply overwrites it.
324
384
  ```markdown
325
385
  # Agent Fleet — Workspace Setup
326
386
  #
327
- # Generated from .ai/agent-fleet-state.json by `agent-fleet install`.
387
+ # Generated from .ai/agent-fleet-state.json by `agent-fleet setup`.
328
388
  # Edit the workspace, not this file: it is rewritten on every apply.
329
389
 
330
390
  ## workspace-summary
331
- agent: claude-code
391
+ agent: pi
332
392
  method: copy
333
393
  version: 1.4.2
334
394
  source: /home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet
@@ -344,7 +404,7 @@ external: []
344
404
  updated: 2026-05-22
345
405
 
346
406
  ## verification
347
- - 21 item(s) recorded; run `agent-fleet verify` to check them against disk.
407
+ - 21 item(s) recorded; run `agent-fleet doctor` for diagnostics.
348
408
  - No secrets are stored in this file or in .ai/agent-fleet-state.json.
349
409
  ```
350
410
 
@@ -6,6 +6,14 @@ Code itself asks pi peers questions mid-task via `coms-cli`. Requires a running
6
6
  [herdr](https://herdr.dev) server (the bridge drives the Claude pane through herdr's
7
7
  socket API).
8
8
 
9
+ > **This is the only role Claude Code has in Agent Fleet.** It is not a coding-agent
10
+ > install target: deterministic `agent-fleet setup` targets pi and nothing else, there are no
11
+ > `.claude/` skills, commands, or personas, and no Claude Code plugin. What a bridged
12
+ > pane gets is what this page describes — the `peer-coms` skill and the Stop hook,
13
+ > both installed under the pi agent because the *fleet* is what needs them. A Claude
14
+ > Code peer contributes review, research, and analysis turns over coms; it does not run
15
+ > the lifecycle commands or orchestrate anything.
16
+
9
17
  ```
10
18
  pi hub ── coms envelope ──▶ coms-claude-bridge ── pane.send_text ──▶ Claude Code (pane)
11
19
  pi hub ◀── response ─────── coms-claude-bridge ◀── Stop hook file ─── (turn ends)
@@ -24,6 +32,16 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
24
32
 
25
33
  ## Setup
26
34
 
35
+ The stable `claude-bridge` setup feature selects `peer-coms` and its
36
+ `coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
37
+ claude-bridge --yes` (or select it interactively); it puts both halves in place:
38
+ `.pi/skills/peer-coms/` and `.claude/hooks/coms-stop-hook.mjs`. The hook file lands under
39
+ `.claude/` deliberately — that is where the Claude Code process in the pane looks for it.
40
+
41
+ **Registering the hook stays a manual step.** The installer writes the file; it does not
42
+ touch `.claude/settings.json`, because that file is the user's own Claude Code
43
+ configuration and merging into it is not something a pi install should decide.
44
+
27
45
  1. **Hook (recommended):** add to the project's (or user's) Claude Code `settings.json`:
28
46
 
29
47
  ```json
@@ -39,8 +57,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
39
57
  `<<COMS_DONE:msg_id>>` sentinel and scraping the pane — it works, but replies can
40
58
  carry TUI noise (tool-status lines). The hook returns exact text.
41
59
 
42
- 2. **Skill:** install `peer-coms` via the normal per-agent flow so Claude Code knows it
43
- is a peer and how to use `coms-cli`.
60
+ 2. **Skill:** install `peer-coms` so the bridged session knows it is a peer and how to
61
+ use `coms-cli`. Point Claude Code at it the way you normally load project skills —
62
+ a `CLAUDE.md` reference to `.pi/skills/peer-coms/SKILL.md` is enough.
44
63
 
45
64
  3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
46
65
  `just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
@@ -113,7 +113,7 @@ The live recipe reuses `scripts/team-up.ts --conductor`: it creates a normal her
113
113
 
114
114
  ### Telegram bridge control command
115
115
 
116
- The outbound `hermes send` path needs a configured Telegram channel but no skill. Full reply round-trip additionally needs Agent Fleet's `hub-liaison` skill in the profile that owns the running Telegram gateway. Pi and OpenCode use the namespaced command:
116
+ The outbound `hermes send` path needs a configured Telegram channel but no skill. Full reply round-trip additionally needs Agent Fleet's `hub-liaison` skill in the profile that owns the running Telegram gateway. Pi uses the namespaced command:
117
117
 
118
118
  ```text
119
119
  /af-set-hermes-telegram status --profile default