@chankov/agent-fleet 2.0.4 → 2.0.5

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 (449) hide show
  1. package/.pi/agents/model-profiles.yaml +39 -34
  2. package/.pi/harnesses/agent-hub/README.md +11 -32
  3. package/.pi/harnesses/agent-hub/context/agent-state.ts +1 -1
  4. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  5. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +1 -0
  6. package/.pi/harnesses/agent-hub/dispatch-native.ts +31 -19
  7. package/.pi/harnesses/agent-hub/dispatch-observability.ts +6 -1
  8. package/.pi/harnesses/agent-hub/footer.ts +2 -2
  9. package/.pi/harnesses/agent-hub/index.ts +69 -42
  10. package/.pi/harnesses/agent-hub/input/shortcuts.ts +0 -29
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +59 -3
  13. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  14. package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -0
  15. package/.pi/harnesses/agent-hub/tools/action-executors.ts +5 -4
  16. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +34 -1
  17. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +4 -2
  18. package/.pi/harnesses/agent-hub/types.ts +1 -0
  19. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  20. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +4 -2
  21. package/.pi/harnesses/agent-hub/ui/grid.ts +16 -118
  22. package/.pi/harnesses/agent-hub/ui/pool.ts +1 -6
  23. package/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  24. package/.pi/harnesses/coms/package.json +1 -1
  25. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  26. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +0 -5
  27. package/.pi/harnesses/lib/fleet-dashboard-view.ts +8 -2
  28. package/.versions/2.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  29. package/.versions/2.0.5/.pi/agents/model-profiles.yaml +83 -0
  30. package/.versions/2.0.5/.pi/agents/peers.yaml +145 -0
  31. package/.versions/2.0.5/.pi/agents/teams.yaml +41 -0
  32. package/.versions/2.0.5/.pi/agents/voices.yaml +13 -0
  33. package/.versions/2.0.5/.pi/damage-control-rules.yaml +297 -0
  34. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  35. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  36. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  37. package/.versions/2.0.5/.pi/extensions/btw/README.md +120 -0
  38. package/.versions/2.0.5/.pi/extensions/btw/index.ts +914 -0
  39. package/.versions/2.0.5/.pi/extensions/btw/package.json +6 -0
  40. package/.versions/2.0.5/.pi/extensions/btw/state.js +179 -0
  41. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  42. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  43. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  44. package/.versions/2.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  45. package/.versions/2.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  46. package/.versions/2.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  47. package/.versions/2.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  48. package/.versions/2.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  49. package/.versions/2.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  50. package/.versions/2.0.5/.pi/extensions/package-lock.json +1175 -0
  51. package/.versions/2.0.5/.pi/extensions/package.json +9 -0
  52. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/README.md +205 -0
  53. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  54. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  55. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  56. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  57. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  58. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  59. package/.versions/2.0.5/.pi/harnesses/agent-hub/README.md +1139 -0
  60. package/.versions/2.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  61. package/.versions/2.0.5/.pi/harnesses/agent-hub/artifacts.js +146 -0
  62. package/.versions/2.0.5/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  63. package/.versions/2.0.5/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  64. package/.versions/2.0.5/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  65. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  66. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  67. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  68. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  69. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  70. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  71. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  72. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  73. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  74. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  75. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  76. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  77. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  78. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  79. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  80. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  81. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  82. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  83. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  84. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  85. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  86. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  87. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  88. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  89. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  90. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  91. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  92. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  93. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  94. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  95. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  96. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  97. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  98. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  99. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  100. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-window.js +106 -0
  101. package/.versions/2.0.5/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  102. package/.versions/2.0.5/.pi/harnesses/agent-hub/delegate.ts +446 -0
  103. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  104. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  105. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  106. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  107. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  108. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-types.ts +208 -0
  109. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native.ts +199 -0
  110. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  111. package/.versions/2.0.5/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  112. package/.versions/2.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  113. package/.versions/2.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  114. package/.versions/2.0.5/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  115. package/.versions/2.0.5/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  116. package/.versions/2.0.5/.pi/harnesses/agent-hub/footer.ts +30 -0
  117. package/.versions/2.0.5/.pi/harnesses/agent-hub/helpers.ts +266 -0
  118. package/.versions/2.0.5/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  119. package/.versions/2.0.5/.pi/harnesses/agent-hub/index.ts +2115 -0
  120. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  121. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  122. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  123. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  124. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  125. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  126. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  127. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  128. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  129. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  130. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  131. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  132. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  133. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  134. package/.versions/2.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  135. package/.versions/2.0.5/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  136. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  137. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  138. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  139. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  140. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  141. package/.versions/2.0.5/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  142. package/.versions/2.0.5/.pi/harnesses/agent-hub/presentation.ts +48 -0
  143. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  144. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  145. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  146. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  147. package/.versions/2.0.5/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  148. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  149. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/runtime.ts +177 -0
  150. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/spawn-run.ts +148 -0
  151. package/.versions/2.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  152. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-contract.js +293 -0
  153. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-extract.js +75 -0
  154. package/.versions/2.0.5/.pi/harnesses/agent-hub/review-findings.js +102 -0
  155. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-budget.js +537 -0
  156. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  157. package/.versions/2.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  158. package/.versions/2.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  159. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-health.js +110 -0
  160. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-start.ts +42 -0
  161. package/.versions/2.0.5/.pi/harnesses/agent-hub/spawn.ts +404 -0
  162. package/.versions/2.0.5/.pi/harnesses/agent-hub/timeline.ts +54 -0
  163. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  164. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  165. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  166. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  167. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +232 -0
  168. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  169. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  170. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  171. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  172. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  173. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  174. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  175. package/.versions/2.0.5/.pi/harnesses/agent-hub/types.ts +62 -0
  176. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  177. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  178. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  179. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  180. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  181. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  182. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  183. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/pool.ts +98 -0
  184. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  185. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  186. package/.versions/2.0.5/.pi/harnesses/agent-hub/version.ts +42 -0
  187. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  188. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  189. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/README.md +53 -0
  190. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/index.ts +532 -0
  191. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  192. package/.versions/2.0.5/.pi/harnesses/coms/README.md +100 -0
  193. package/.versions/2.0.5/.pi/harnesses/coms/index.ts +276 -0
  194. package/.versions/2.0.5/.pi/harnesses/coms/package.json +7 -0
  195. package/.versions/2.0.5/.pi/harnesses/coms/version.ts +42 -0
  196. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/README.md +124 -0
  197. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  198. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  199. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/version.ts +42 -0
  200. package/.versions/2.0.5/.pi/harnesses/lib/coms-core-io.ts +385 -0
  201. package/.versions/2.0.5/.pi/harnesses/lib/coms-core.ts +577 -0
  202. package/.versions/2.0.5/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  203. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  204. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  205. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-view.ts +107 -0
  206. package/.versions/2.0.5/.pi/harnesses/lib/context-budget.ts +114 -0
  207. package/.versions/2.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  208. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  209. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  210. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  211. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  212. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  213. package/.versions/2.0.5/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  214. package/.versions/2.0.5/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  215. package/.versions/2.0.5/.pi/harnesses/lib/fleet-panel.ts +34 -0
  216. package/.versions/2.0.5/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  217. package/.versions/2.0.5/.pi/harnesses/lib/fleet-selection.ts +24 -0
  218. package/.versions/2.0.5/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  219. package/.versions/2.0.5/.pi/harnesses/lib/herdr-client.ts +472 -0
  220. package/.versions/2.0.5/.pi/harnesses/lib/herdr-presence.ts +399 -0
  221. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  222. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  223. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  224. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  225. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  226. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  227. package/.versions/2.0.5/.pi/harnesses/lib/spawned-peers.js +190 -0
  228. package/.versions/2.0.5/.pi/harnesses/package-lock.json +2039 -0
  229. package/.versions/2.0.5/.pi/harnesses/package.json +10 -0
  230. package/.versions/2.0.5/.pi/prompts/af-build.md +24 -0
  231. package/.versions/2.0.5/.pi/prompts/af-code-simplify.md +22 -0
  232. package/.versions/2.0.5/.pi/prompts/af-plan.md +17 -0
  233. package/.versions/2.0.5/.pi/prompts/af-review.md +16 -0
  234. package/.versions/2.0.5/.pi/prompts/af-set-hermes-telegram.md +15 -0
  235. package/.versions/2.0.5/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  236. package/.versions/2.0.5/.pi/prompts/af-ship.md +17 -0
  237. package/.versions/2.0.5/.pi/prompts/af-spec.md +15 -0
  238. package/.versions/2.0.5/.pi/prompts/af-test.md +19 -0
  239. package/.versions/2.0.5/.pi/skills/bowser/SKILL.md +145 -0
  240. package/.versions/2.0.5/.version +1 -0
  241. package/.versions/2.0.5/agents/architect.md +25 -0
  242. package/.versions/2.0.5/agents/bowser.md +28 -0
  243. package/.versions/2.0.5/agents/builder.md +56 -0
  244. package/.versions/2.0.5/agents/code-reviewer.md +210 -0
  245. package/.versions/2.0.5/agents/deep-researcher.md +33 -0
  246. package/.versions/2.0.5/agents/documenter.md +23 -0
  247. package/.versions/2.0.5/agents/orchestrator.md +23 -0
  248. package/.versions/2.0.5/agents/plan-reviewer.md +84 -0
  249. package/.versions/2.0.5/agents/planner.md +106 -0
  250. package/.versions/2.0.5/agents/releaser.md +25 -0
  251. package/.versions/2.0.5/agents/researcher.md +31 -0
  252. package/.versions/2.0.5/agents/security-auditor.md +168 -0
  253. package/.versions/2.0.5/agents/test-engineer.md +154 -0
  254. package/.versions/2.0.5/agents/web-debugger.md +44 -0
  255. package/.versions/2.0.5/agents/web-performance-auditor.md +194 -0
  256. package/.versions/2.0.5/bin/catalog/harness-runtime-closure.json +36 -0
  257. package/.versions/2.0.5/codex/CONDUCTOR.md +148 -0
  258. package/.versions/2.0.5/docs/ARCHITECTURE.md +407 -0
  259. package/.versions/2.0.5/docs/agent-fleet-setup.md +561 -0
  260. package/.versions/2.0.5/docs/claude-code-coms-bridge.md +133 -0
  261. package/.versions/2.0.5/docs/codex-remote-conductor.md +170 -0
  262. package/.versions/2.0.5/docs/coms-hermes-bridge.md +189 -0
  263. package/.versions/2.0.5/docs/getting-started.md +124 -0
  264. package/.versions/2.0.5/docs/npm-install.md +299 -0
  265. package/.versions/2.0.5/docs/pi-extensions.md +446 -0
  266. package/.versions/2.0.5/docs/pi-setup.md +74 -0
  267. package/.versions/2.0.5/docs/skill-anatomy.md +150 -0
  268. package/.versions/2.0.5/hermes/README.md +347 -0
  269. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  270. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  271. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  272. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  273. package/.versions/2.0.5/hermes/gates/gate-o-capability.md +8 -0
  274. package/.versions/2.0.5/hermes/gates/gate-o-validator-fixtures.json +1 -0
  275. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  276. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  277. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  278. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  279. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  280. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  281. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  282. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  283. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  284. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  285. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  286. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  287. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  288. package/.versions/2.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  289. package/.versions/2.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  290. package/.versions/2.0.5/hermes/skills/hub-watchdog/SKILL.md +76 -0
  291. package/.versions/2.0.5/hermes/skills/hub-watchdog/manifest.json +1 -0
  292. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  293. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  294. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  295. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  296. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  297. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  298. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  299. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  300. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  301. package/.versions/2.0.5/hermes/watchdog-tests/__init__.py +0 -0
  302. package/.versions/2.0.5/hooks/coms-stop-hook.mjs +84 -0
  303. package/.versions/2.0.5/install-manifest.json +2942 -0
  304. package/.versions/2.0.5/justfile +289 -0
  305. package/.versions/2.0.5/manifest-meta.json +969 -0
  306. package/.versions/2.0.5/references/accessibility-checklist.md +160 -0
  307. package/.versions/2.0.5/references/communication-contract.md +26 -0
  308. package/.versions/2.0.5/references/definition-of-done.md +67 -0
  309. package/.versions/2.0.5/references/fleet-coordination-patterns.md +171 -0
  310. package/.versions/2.0.5/references/observability-checklist.md +91 -0
  311. package/.versions/2.0.5/references/orchestration-patterns.md +370 -0
  312. package/.versions/2.0.5/references/performance-checklist.md +153 -0
  313. package/.versions/2.0.5/references/prompting-patterns.md +380 -0
  314. package/.versions/2.0.5/references/security-checklist.md +179 -0
  315. package/.versions/2.0.5/references/testing-patterns.md +236 -0
  316. package/.versions/2.0.5/references/workflow-authoring.md +304 -0
  317. package/.versions/2.0.5/scripts/claude-code-preflight.ts +70 -0
  318. package/.versions/2.0.5/scripts/codex-conductor.ts +41 -0
  319. package/.versions/2.0.5/scripts/codex-remote-control.ts +167 -0
  320. package/.versions/2.0.5/scripts/coms-claude-bridge.ts +411 -0
  321. package/.versions/2.0.5/scripts/coms-cli.ts +484 -0
  322. package/.versions/2.0.5/scripts/coms-hermes-bridge.ts +413 -0
  323. package/.versions/2.0.5/scripts/fleet.ts +222 -0
  324. package/.versions/2.0.5/scripts/flow.ts +137 -0
  325. package/.versions/2.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  326. package/.versions/2.0.5/scripts/hermes-monitor-scenario.ts +474 -0
  327. package/.versions/2.0.5/scripts/hermes-watchdog-capability-probe.ts +45 -0
  328. package/.versions/2.0.5/scripts/install-hermes-plugin.sh +180 -0
  329. package/.versions/2.0.5/scripts/lib/claude-bridge-core.ts +210 -0
  330. package/.versions/2.0.5/scripts/lib/codex-conductor.ts +88 -0
  331. package/.versions/2.0.5/scripts/lib/codex-remote-control.ts +482 -0
  332. package/.versions/2.0.5/scripts/lib/coms-envelope.ts +582 -0
  333. package/.versions/2.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  334. package/.versions/2.0.5/scripts/lib/fleet-command.ts +270 -0
  335. package/.versions/2.0.5/scripts/lib/flow-command.ts +93 -0
  336. package/.versions/2.0.5/scripts/lib/flow-maintenance.ts +230 -0
  337. package/.versions/2.0.5/scripts/lib/herdr-layout.ts +281 -0
  338. package/.versions/2.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  339. package/.versions/2.0.5/scripts/lib/hermes-monitor-events.ts +1 -0
  340. package/.versions/2.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  341. package/.versions/2.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  342. package/.versions/2.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  343. package/.versions/2.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  344. package/.versions/2.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  345. package/.versions/2.0.5/scripts/lib/monitor-env.ts +146 -0
  346. package/.versions/2.0.5/scripts/lib/peer-launch.ts +318 -0
  347. package/.versions/2.0.5/scripts/lib/persona-banner.ts +62 -0
  348. package/.versions/2.0.5/scripts/lib/runtime-dependencies.js +124 -0
  349. package/.versions/2.0.5/scripts/lib/spawn-stagger.ts +101 -0
  350. package/.versions/2.0.5/scripts/lib/team-project.ts +213 -0
  351. package/.versions/2.0.5/scripts/lib/team-snapshot.ts +147 -0
  352. package/.versions/2.0.5/scripts/package-lock.json +35 -0
  353. package/.versions/2.0.5/scripts/package.json +9 -0
  354. package/.versions/2.0.5/scripts/peer-banner.ts +40 -0
  355. package/.versions/2.0.5/scripts/peer-launch.ts +285 -0
  356. package/.versions/2.0.5/scripts/team-snapshot.ts +237 -0
  357. package/.versions/2.0.5/scripts/team-up.ts +406 -0
  358. package/.versions/2.0.5/scripts/workflows/lib/agent-phase.ts +133 -0
  359. package/.versions/2.0.5/scripts/workflows/lib/changes.ts +61 -0
  360. package/.versions/2.0.5/scripts/workflows/lib/debate.ts +149 -0
  361. package/.versions/2.0.5/scripts/workflows/lib/env.ts +34 -0
  362. package/.versions/2.0.5/scripts/workflows/lib/envelopes.ts +169 -0
  363. package/.versions/2.0.5/scripts/workflows/lib/gates.ts +81 -0
  364. package/.versions/2.0.5/scripts/workflows/lib/git.ts +96 -0
  365. package/.versions/2.0.5/scripts/workflows/lib/merge.ts +95 -0
  366. package/.versions/2.0.5/scripts/workflows/lib/model-profile.ts +22 -0
  367. package/.versions/2.0.5/scripts/workflows/lib/model-visibility.ts +92 -0
  368. package/.versions/2.0.5/scripts/workflows/lib/permissions.ts +130 -0
  369. package/.versions/2.0.5/scripts/workflows/lib/personas.ts +57 -0
  370. package/.versions/2.0.5/scripts/workflows/lib/poll.ts +86 -0
  371. package/.versions/2.0.5/scripts/workflows/lib/quality.ts +64 -0
  372. package/.versions/2.0.5/scripts/workflows/lib/run.ts +108 -0
  373. package/.versions/2.0.5/scripts/workflows/lib/trace.ts +34 -0
  374. package/.versions/2.0.5/scripts/workflows/lib/voices.ts +128 -0
  375. package/.versions/2.0.5/scripts/workflows/lib/writer-lease.ts +112 -0
  376. package/.versions/2.0.5/scripts/workflows/tsconfig.json +22 -0
  377. package/.versions/2.0.5/scripts/workflows/wf-build-test.ts +61 -0
  378. package/.versions/2.0.5/scripts/workflows/wf-debate.ts +87 -0
  379. package/.versions/2.0.5/scripts/workflows/wf-document.ts +50 -0
  380. package/.versions/2.0.5/scripts/workflows/wf-poll.ts +95 -0
  381. package/.versions/2.0.5/scripts/workflows/wf-quality.ts +20 -0
  382. package/.versions/2.0.5/scripts/workflows/wf-scout.ts +38 -0
  383. package/.versions/2.0.5/skills/_internal/grilling.md +59 -0
  384. package/.versions/2.0.5/skills/browser-testing-with-devtools/SKILL.md +351 -0
  385. package/.versions/2.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  386. package/.versions/2.0.5/skills/compound-learning/SKILL.md +137 -0
  387. package/.versions/2.0.5/skills/context-engineering/SKILL.md +291 -0
  388. package/.versions/2.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  389. package/.versions/2.0.5/skills/designing-agents/SKILL.md +394 -0
  390. package/.versions/2.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  391. package/.versions/2.0.5/skills/drafting-workflows/SKILL.md +143 -0
  392. package/.versions/2.0.5/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  393. package/.versions/2.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  394. package/.versions/2.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  395. package/.versions/2.0.5/skills/idea-refine/SKILL.md +182 -0
  396. package/.versions/2.0.5/skills/idea-refine/examples.md +238 -0
  397. package/.versions/2.0.5/skills/idea-refine/frameworks.md +99 -0
  398. package/.versions/2.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  399. package/.versions/2.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  400. package/.versions/2.0.5/skills/incremental-implementation/SKILL.md +298 -0
  401. package/.versions/2.0.5/skills/interview-me/SKILL.md +226 -0
  402. package/.versions/2.0.5/skills/orchestration-verification/SKILL.md +181 -0
  403. package/.versions/2.0.5/skills/peer-coms/SKILL.md +90 -0
  404. package/.versions/2.0.5/skills/performance-optimization/SKILL.md +350 -0
  405. package/.versions/2.0.5/skills/planning-and-task-breakdown/SKILL.md +265 -0
  406. package/.versions/2.0.5/skills/security-and-hardening/SKILL.md +461 -0
  407. package/.versions/2.0.5/skills/spec-driven-development/SKILL.md +256 -0
  408. package/.versions/2.0.5/skills/using-agent-skills/SKILL.md +197 -0
  409. package/.versions/2.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  410. package/.versions/2.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  411. package/.versions/2.0.5/vendor/agent-skills-upstream/README.md +11 -0
  412. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  413. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  414. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  415. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  416. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  417. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  418. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  419. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  420. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  421. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  422. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  423. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  424. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  425. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  426. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  427. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  428. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  429. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  430. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  431. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  432. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  433. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  434. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  435. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  436. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  437. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  438. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  439. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  440. package/CHANGELOG.md +6 -0
  441. package/README.md +1 -1
  442. package/agents/builder.md +2 -2
  443. package/agents/documenter.md +2 -1
  444. package/agents/planner.md +2 -1
  445. package/agents/releaser.md +2 -2
  446. package/docs/agent-fleet-setup.md +28 -14
  447. package/docs/pi-extensions.md +3 -4
  448. package/install-manifest.json +1 -1
  449. package/package.json +2 -2
@@ -0,0 +1,299 @@
1
+ # Install and lifecycle
2
+
3
+ `@chankov/agent-fleet` is a deterministic pi workspace installer. It needs no
4
+ coding agent or model: `setup`, `doctor`, and `uninstall` are the public
5
+ lifecycle commands.
6
+
7
+ - [First install](#first-install) — a repository that has never had Agent Fleet
8
+ - [Updating an existing install](#updating-an-existing-install) — a new version shipped
9
+ - [What reconcile does to each file](#what-reconcile-does-to-each-file) — **read this before your first update**
10
+ - [Doctor and uninstall](#doctor-and-uninstall)
11
+
12
+ ## First install
13
+
14
+ Run the package command from the target repository. There is no `just fleet`
15
+ recipe yet — the managed justfile region is one of the things setup *writes* —
16
+ so the first install always goes through `npx`:
17
+
18
+ ```bash
19
+ cd ~/projects/my-app
20
+ npx @chankov/agent-fleet@latest setup
21
+ ```
22
+
23
+ In a real TTY this opens the installer: pick **Default** or **Full**, add
24
+ optional comma-separated features, read the exact reconciliation plan, and
25
+ confirm once to apply. For automation, name the selection and consent up front:
26
+
27
+ ```bash
28
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
29
+ ```
30
+
31
+ Pin the exact version when the run has to be reproducible:
32
+
33
+ ```bash
34
+ npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
35
+ ```
36
+
37
+ **Default** is the launchable, stable Fleet Core and creates neither `.claude/`
38
+ nor voice configuration. **Full** selects every stable, platform-applicable
39
+ catalogue root; it may install the recorded Claude Code coms bridge. Features
40
+ are additive named capabilities (`browser`, `voice`, `hermes`, `telegram`,
41
+ `claude-bridge`, and the experimental `codex-remote`), not an arbitrary
42
+ package-entry mode — `setup --help` lists them.
43
+
44
+ ### Then install the runtime dependencies
45
+
46
+ Setup writes files; it does not run commands for you. The three `npm` steps for
47
+ `.pi/extensions`, `.pi/harnesses`, and `scripts` are planned as `skip` with the
48
+ reason *"runs a command — re-run with `--allow-exec` to include it"*. **A
49
+ workspace is not launchable until they run.** Either let setup run them:
50
+
51
+ ```bash
52
+ npx @chankov/agent-fleet@latest setup --preset default --features none --allow-exec --yes
53
+ ```
54
+
55
+ …or run them afterwards through the recipe setup just installed:
56
+
57
+ ```bash
58
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
59
+ just fleet doctor # confirm the workspace is whole
60
+ ```
61
+
62
+ `doctor` runs `npm ls --depth=0` against each installed root. Missing or invalid
63
+ runtime trees are launch-blocking findings (exit `2`) with the same two
64
+ remediation paths above; `doctor --fix` deliberately does not infer consent to
65
+ run a new npm install. The `just fleet` launcher performs the same check before
66
+ starting Pi, so an extension import failure cannot be misreported as an unknown
67
+ flag such as `--project`.
68
+
69
+ ### Verify the result
70
+
71
+ ```bash
72
+ just fleet doctor # exit 0 = nothing to repair, 2 = repairable findings
73
+ just fleet # Hub in operator work mode, empty native roster
74
+ ```
75
+
76
+ From here on `just fleet setup`, `just fleet doctor`, and `just fleet uninstall`
77
+ are available as thin wrappers over `npx @chankov/agent-fleet@latest`. They are
78
+ a convenience for a workspace that already has the justfile — never the
79
+ first-install path.
80
+
81
+ ### Source checkout
82
+
83
+ Inside an Agent Fleet checkout, use the local CLI instead of the published
84
+ package:
85
+
86
+ ```bash
87
+ node bin/cli.js setup --workspace ~/projects/my-app --preset default --features none --yes
88
+ ```
89
+
90
+ ## Updating an existing install
91
+
92
+ ### 1. Notice there is one
93
+
94
+ A pi session started from a workspace with an install record prints a one-line
95
+ banner on its first turn (`pi-extension:agent-fleet-update-check`, installed by
96
+ Default):
97
+
98
+ ```
99
+ agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest setup" to reconcile the workspace.
100
+ ```
101
+
102
+ To ask directly, without a session — it prints one line when an update exists
103
+ and stays silent when you are current:
104
+
105
+ ```bash
106
+ npx @chankov/agent-fleet check-update
107
+ ```
108
+
109
+ `pi update --extensions` updates pi's own extensions. It does **not** update
110
+ this installer or anything it wrote.
111
+
112
+ ### 2. Preview the reconcile
113
+
114
+ Always worth it, always free — `--dry-run` writes nothing and needs no consent:
115
+
116
+ ```bash
117
+ just fleet setup --dry-run
118
+ # or, without the justfile recipe:
119
+ npx @chankov/agent-fleet@latest setup --dry-run
120
+ ```
121
+
122
+ The plan names every action and its reason. What you are reading for:
123
+
124
+ | Line in the plan | Means |
125
+ |---|---|
126
+ | `create` | New in this version, or a feature you added |
127
+ | `refresh … source is newer; the local copy is unmodified` | Clean update. Safe. |
128
+ | `refresh … locally modified — selecting it overwrites your edits` | **Your edit is about to be lost.** See below. |
129
+ | `conflict … changed both locally and upstream` | The run will exit `3` and write nothing until you choose a policy |
130
+ | `keep` | Unchanged, or installed but outside this selection |
131
+ | `remove` | Retired upstream and recorded as ours |
132
+ | `skip … runs a command` | The `npm` steps — follow with `just fleet deps` |
133
+
134
+ ### 3. Apply it
135
+
136
+ ```bash
137
+ just fleet setup # interactive: shows the plan, asks once
138
+ just fleet setup --yes # non-interactive
139
+ just fleet deps # if the plan skipped the exec steps
140
+ just fleet doctor # verify
141
+ ```
142
+
143
+ Your `--preset` / `--features` selection is **remembered**. `.ai/agent-fleet.json`
144
+ is the desired state, so a plain `setup` reconciles to whatever that file says —
145
+ you do not restate the preset on every update. Flags passed on an update are
146
+ ephemeral for that run only unless you add `--save-desired`:
147
+
148
+ ```bash
149
+ just fleet setup --features voice,browser --yes # this run only
150
+ just fleet setup --features voice,browser --save-desired --yes # persisted
151
+ ```
152
+
153
+ ### 4. Handle a conflict
154
+
155
+ A conflict is *both* sides changing: you edited an installed file **and** the new
156
+ version changed the same file. Setup refuses to guess — it exits `3` before
157
+ writing anything:
158
+
159
+ ```
160
+ conflict skill:code-review-and-quality changed both locally and upstream
161
+ exit 3
162
+ ```
163
+
164
+ Resolve by naming a policy for the run:
165
+
166
+ ```bash
167
+ just fleet setup --on-conflict theirs --yes # take the package version
168
+ just fleet setup --on-conflict ours --yes # keep your copy
169
+ ```
170
+
171
+ `theirs` writes the incoming file and your version is gone; `ours` keeps your
172
+ file and this item stays behind the package until you reconcile it by hand. To
173
+ keep a local edit *and* pick up the new upstream content, copy your edit out
174
+ first, take `theirs`, then re-apply it.
175
+
176
+ ### Keeping local edits across updates
177
+
178
+ If you have customized an installed artifact — a skill under `.pi/skills/`, a
179
+ persona under `agents/` — understand that `setup` is a **reconcile to the
180
+ package**, not a merge in your favour. A file you edited where upstream did not
181
+ change is refreshed and your edit is overwritten, without a conflict and without
182
+ a prompt. `--dry-run` is what makes this visible before it happens.
183
+
184
+ The durable ways to customize:
185
+
186
+ - **`.ai/agent-fleet-overrides.md`** — human-owned, never overwritten. Spec/plan
187
+ paths, dev server, branch policy, per-persona models, dispatcher language.
188
+ See [agent-fleet-setup.md](agent-fleet-setup.md). This is the intended door.
189
+ - **Your own artifacts** — a skill under a name Agent Fleet does not ship is not
190
+ in the catalogue, so no lifecycle command touches it.
191
+ - **Deselect the item** — `setup` never removes what falls outside the current
192
+ selection, so a narrower preset leaves an item installed and frozen (`keep …
193
+ installed but not in this selection`).
194
+
195
+ Editing a shipped artifact in place is the one approach the lifecycle actively
196
+ works against.
197
+
198
+ ## What reconcile does to each file
199
+
200
+ The engine classifies every recorded file by comparing three things: the copy on
201
+ disk, the current package source, and the *baseline* — the same file as it
202
+ shipped in the version recorded in `.ai/agent-fleet-state.json`, read from the
203
+ package's `.versions/<x.y.z>/` snapshot tree.
204
+
205
+ | Disk vs source vs baseline | State | `setup` does |
206
+ |---|---|---|
207
+ | Disk matches source | `up-to-date` | `keep` |
208
+ | Disk matches baseline, source moved | `outdated` | `refresh` — clean update |
209
+ | Source matches baseline, disk moved | `modified` | **`refresh` — overwrites your edit** |
210
+ | Disk and source both moved, differently | `conflict` | exits `3` unless `--on-conflict` |
211
+ | Recorded, but no source in this version | `gone` | `keep` (the deprecated `upgrade` proposes removal) |
212
+ | Recorded, missing or mis-linked on disk | breakage | `repair`, regardless of selection |
213
+
214
+ Two things narrow this. If the `.versions/` snapshot for the recorded version is
215
+ missing (an unpublished local build, or a version older than retention), there is
216
+ no baseline: the comparison degrades to two-way, an edited file reads as
217
+ `modified`, and no `conflict` can be detected. And `keep`-on-local-edit is the
218
+ behaviour of the **deprecated `upgrade` verb**, not of `setup` — if you have
219
+ relied on `upgrade` preserving your edits, that is the difference to plan for.
220
+
221
+ ## Desired state and migration
222
+
223
+ The desired selection lives in `.ai/agent-fleet.json` — human-owned, meant to be
224
+ committed. Command-line preset and feature flags are ephemeral over an existing
225
+ file unless `--save-desired` is passed. When the file is missing, setup writes
226
+ the selected desired state in the same transaction as its artifacts.
227
+
228
+ The first major-release migration, from a workspace that predates the state
229
+ file, is deliberately strict:
230
+
231
+ ```bash
232
+ # Preview is safe and does not require consent.
233
+ npx @chankov/agent-fleet@latest setup --migrate --dry-run
234
+
235
+ # Automation must name the desired state and explicitly consent to migration.
236
+ npx @chankov/agent-fleet@latest setup --migrate --preset default --features none --yes
237
+ ```
238
+
239
+ Migration lists each exact removal before consent and removes only unchanged,
240
+ state-owned legacy artifacts. Foreign or locally modified files survive.
241
+
242
+ `init`, `install`, `upgrade`, and `update` are deprecated. `init` and `update`
243
+ dispatch to `setup`; `install` and `upgrade` keep their historical selection and
244
+ three-way-merge semantics and warn. New scripts should use `setup`.
245
+
246
+ ## Doctor and uninstall
247
+
248
+ ```bash
249
+ npx @chankov/agent-fleet doctor # read-only; never prompts
250
+ npx @chankov/agent-fleet doctor --fix
251
+ npx @chankov/agent-fleet uninstall --all --yes
252
+ npx @chankov/agent-fleet uninstall --all --purge-config --yes
253
+ ```
254
+
255
+ Uninstall removes only paths recorded in `.ai/agent-fleet-state.json`, and
256
+ preserves any recorded path whose bytes no longer match what we wrote. It also
257
+ preserves human configuration by default: `.ai/agent-fleet.json`,
258
+ `.ai/agent-fleet-overrides.md`, `.ai/stt.json`, and environment files.
259
+ `--purge-config` is the separate destructive gate for the three human config
260
+ files; environment files are never removed.
261
+
262
+ A self-hosted workspace may use `just fleet uninstall --yes`. It removes ordinary
263
+ owned artifacts first, then the managed justfile region and launcher scripts,
264
+ and finally lifecycle state/journal data; the already-running command prints its
265
+ final report from memory. Because that removes `just fleet`, reinstall with the
266
+ package CLI, then use `just fleet` again:
267
+
268
+ ```bash
269
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
270
+ just fleet doctor
271
+ ```
272
+
273
+ ## Package-native pi install
274
+
275
+ ```bash
276
+ pi install -l npm:@chankov/agent-fleet
277
+ ```
278
+
279
+ This exposes package-native skills and prompts. Do not also copy the same skills
280
+ and prompts into `.pi/`; `doctor` reports that ownership overlap as a read-only
281
+ `pi-package-ownership` advisory. Harness-only composition is supported:
282
+ package-native skills/prompts with copied Fleet Core harnesses.
283
+
284
+ ## Safety contract
285
+
286
+ All lifecycle commands support `--dry-run`; JSON output requires either
287
+ `--dry-run` or `--yes`. Files outside state ownership are never adopted for
288
+ removal. A failed file transaction rolls back rather than reporting success, and
289
+ `.ai/agent-fleet-transaction.json` is the crash-recovery journal `doctor --fix`
290
+ reads.
291
+
292
+ | Exit | Meaning |
293
+ |---|---|
294
+ | `0` | Success, or nothing to do |
295
+ | `1` | Could not run |
296
+ | `2` | `doctor` found repairable or launch-blocking manual-action issues |
297
+ | `3` | `setup` hit unresolved conflicts and wrote nothing |
298
+
299
+ See [Migration](MIGRATION-agent-fleet.md) for the full major-release matrix.