@chankov/agent-fleet 0.0.8 → 0.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (682) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +12 -7
  2. package/.claude/commands/setup-agent-fleet.md +7 -15
  3. package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
  4. package/.opencode/commands/af-setup-agent-fleet.md +8 -6
  5. package/.pi/agents/model-profiles.yaml +9 -2
  6. package/.pi/agents/peers.yaml +12 -16
  7. package/.pi/agents/teams.yaml +4 -2
  8. package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
  9. package/.pi/extensions/btw/README.md +2 -2
  10. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
  11. package/.pi/extensions/compact-and-continue/README.md +3 -3
  12. package/.pi/extensions/mcp-bridge/README.md +1 -1
  13. package/.pi/harnesses/agent-hub/README.md +159 -15
  14. package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  15. package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  16. package/.pi/harnesses/agent-hub/footer.ts +4 -2
  17. package/.pi/harnesses/agent-hub/index.ts +552 -50
  18. package/.pi/harnesses/agent-hub/package.json +1 -1
  19. package/.pi/harnesses/agent-hub/review-findings.js +102 -0
  20. package/.pi/harnesses/agent-hub/run-budget.js +302 -4
  21. package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  22. package/.pi/harnesses/agent-hub/version.ts +25 -1
  23. package/.pi/harnesses/coms/README.md +8 -1
  24. package/.pi/harnesses/coms/package.json +1 -1
  25. package/.pi/harnesses/coms/version.ts +25 -1
  26. package/.pi/harnesses/damage-control-continue/README.md +8 -1
  27. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  28. package/.pi/harnesses/damage-control-continue/version.ts +25 -1
  29. package/.pi/harnesses/lib/herdr-client.ts +10 -1
  30. package/.pi/harnesses/lib/spawned-peers.js +190 -0
  31. package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
  32. package/.pi/prompts/af-setup-agent-fleet.md +7 -15
  33. package/.versions/0.0.10/.claude/commands/build.md +44 -0
  34. package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
  35. package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
  36. package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
  37. package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
  38. package/.versions/0.0.10/.claude/commands/plan.md +16 -0
  39. package/.versions/0.0.10/.claude/commands/prime.md +22 -0
  40. package/.versions/0.0.10/.claude/commands/review.md +16 -0
  41. package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
  42. package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
  43. package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
  44. package/.versions/0.0.10/.claude/commands/ship.md +72 -0
  45. package/.versions/0.0.10/.claude/commands/spec.md +15 -0
  46. package/.versions/0.0.10/.claude/commands/test.md +19 -0
  47. package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
  48. package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
  49. package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
  50. package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
  51. package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
  52. package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
  53. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
  54. package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
  55. package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
  56. package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
  57. package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
  58. package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
  59. package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  60. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
  61. package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
  62. package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
  63. package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
  64. package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
  65. package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
  66. package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  67. package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
  68. package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
  69. package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
  70. package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
  71. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  72. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  73. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  74. package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
  75. package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
  76. package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
  77. package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
  78. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  79. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  80. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  81. package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  82. package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  83. package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  84. package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  85. package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  86. package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  87. package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
  88. package/.versions/0.0.10/.pi/extensions/package.json +9 -0
  89. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
  90. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  91. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  92. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  93. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  94. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  95. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  96. package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
  97. package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  98. package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  99. package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  100. package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  101. package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  102. package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
  103. package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  104. package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  105. package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  106. package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  107. package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
  108. package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
  109. package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
  110. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  111. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  112. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  113. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  114. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  115. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  116. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  117. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  118. package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  119. package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  120. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
  121. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  122. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
  123. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  124. package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  125. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
  126. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  127. package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  128. package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  129. package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  130. package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
  131. package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  132. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
  133. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
  134. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  135. package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
  136. package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
  137. package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
  138. package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
  139. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
  140. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
  141. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  142. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  143. package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  144. package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  145. package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  146. package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  147. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  148. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  150. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  152. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  154. package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
  155. package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
  156. package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
  157. package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
  158. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
  159. package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
  160. package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
  161. package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  162. package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  163. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
  164. package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
  165. package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
  166. package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
  167. package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
  168. package/.versions/0.0.10/.version +1 -0
  169. package/.versions/0.0.10/agents/architect.md +24 -0
  170. package/.versions/0.0.10/agents/bowser.md +27 -0
  171. package/.versions/0.0.10/agents/builder.md +54 -0
  172. package/.versions/0.0.10/agents/code-reviewer.md +208 -0
  173. package/.versions/0.0.10/agents/deep-researcher.md +32 -0
  174. package/.versions/0.0.10/agents/documenter.md +18 -0
  175. package/.versions/0.0.10/agents/orchestrator.md +72 -0
  176. package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
  177. package/.versions/0.0.10/agents/planner.md +70 -0
  178. package/.versions/0.0.10/agents/releaser.md +24 -0
  179. package/.versions/0.0.10/agents/researcher.md +28 -0
  180. package/.versions/0.0.10/agents/security-auditor.md +167 -0
  181. package/.versions/0.0.10/agents/test-engineer.md +153 -0
  182. package/.versions/0.0.10/agents/web-debugger.md +43 -0
  183. package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
  184. package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
  185. package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
  186. package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
  187. package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
  188. package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
  189. package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
  190. package/.versions/0.0.10/docs/getting-started.md +254 -0
  191. package/.versions/0.0.10/docs/npm-install.md +514 -0
  192. package/.versions/0.0.10/docs/opencode-setup.md +281 -0
  193. package/.versions/0.0.10/docs/pi-extensions.md +363 -0
  194. package/.versions/0.0.10/docs/pi-setup.md +571 -0
  195. package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
  196. package/.versions/0.0.10/hermes/README.md +347 -0
  197. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  198. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  199. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  200. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  201. package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
  202. package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
  203. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  204. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  205. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  206. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  207. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  208. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  209. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  210. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  211. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  212. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  213. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  214. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  215. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  216. package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
  217. package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
  218. package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
  219. package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
  220. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  221. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  222. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  223. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  224. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  225. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  226. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  227. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  228. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  229. package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
  230. package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
  231. package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
  232. package/.versions/0.0.10/hooks/hooks.json +14 -0
  233. package/.versions/0.0.10/hooks/session-start.sh +74 -0
  234. package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
  235. package/.versions/0.0.10/install-manifest.json +3615 -0
  236. package/.versions/0.0.10/justfile +254 -0
  237. package/.versions/0.0.10/manifest-meta.json +472 -0
  238. package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
  239. package/.versions/0.0.10/references/definition-of-done.md +67 -0
  240. package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
  241. package/.versions/0.0.10/references/observability-checklist.md +91 -0
  242. package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
  243. package/.versions/0.0.10/references/performance-checklist.md +153 -0
  244. package/.versions/0.0.10/references/prompting-patterns.md +380 -0
  245. package/.versions/0.0.10/references/security-checklist.md +179 -0
  246. package/.versions/0.0.10/references/testing-patterns.md +236 -0
  247. package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
  248. package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
  249. package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
  250. package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
  251. package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
  252. package/.versions/0.0.10/scripts/fleet.ts +168 -0
  253. package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
  254. package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
  255. package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
  256. package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
  257. package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
  258. package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
  259. package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
  260. package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
  261. package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
  262. package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
  263. package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
  264. package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
  265. package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
  266. package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
  267. package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
  268. package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
  269. package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
  270. package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
  271. package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
  272. package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
  273. package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
  274. package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
  275. package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
  276. package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
  277. package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
  278. package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
  279. package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
  280. package/.versions/0.0.10/scripts/team-up.ts +360 -0
  281. package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
  282. package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  283. package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
  284. package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
  285. package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
  286. package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
  287. package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
  288. package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  289. package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  290. package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  291. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
  292. package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
  293. package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
  294. package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
  295. package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
  299. package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
  300. package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
  301. package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
  302. package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
  303. package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
  304. package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
  305. package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
  306. package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
  307. package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  308. package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  309. package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
  310. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  311. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  312. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  313. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  314. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  315. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  316. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  317. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  318. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  319. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  320. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  321. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  322. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  323. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  324. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  325. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  326. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  327. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  328. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  329. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  330. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  331. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  332. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  333. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  334. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  335. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  336. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  337. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  338. package/.versions/0.0.9/.claude/commands/build.md +44 -0
  339. package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
  340. package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
  341. package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
  342. package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
  343. package/.versions/0.0.9/.claude/commands/plan.md +16 -0
  344. package/.versions/0.0.9/.claude/commands/prime.md +22 -0
  345. package/.versions/0.0.9/.claude/commands/review.md +16 -0
  346. package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
  347. package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
  348. package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
  349. package/.versions/0.0.9/.claude/commands/ship.md +72 -0
  350. package/.versions/0.0.9/.claude/commands/spec.md +15 -0
  351. package/.versions/0.0.9/.claude/commands/test.md +19 -0
  352. package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
  353. package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
  354. package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
  355. package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
  356. package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
  357. package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
  358. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  359. package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
  360. package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
  361. package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
  362. package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
  363. package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
  364. package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  365. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
  366. package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
  367. package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
  368. package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
  369. package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
  370. package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
  371. package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  372. package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
  373. package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
  374. package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
  375. package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
  376. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  377. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  378. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  379. package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
  380. package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
  381. package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
  382. package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
  383. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  384. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  385. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  386. package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  387. package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  388. package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  389. package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  390. package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  391. package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  392. package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
  393. package/.versions/0.0.9/.pi/extensions/package.json +9 -0
  394. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
  395. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  396. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  397. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  398. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  399. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  400. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  401. package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
  402. package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  403. package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  404. package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  405. package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  406. package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  407. package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
  408. package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  409. package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  410. package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
  411. package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
  412. package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
  413. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  414. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  415. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  416. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  417. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  418. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  419. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  420. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  421. package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  422. package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  423. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
  424. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  425. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  426. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  427. package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
  428. package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  429. package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  430. package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  431. package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
  432. package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  433. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
  434. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
  435. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  436. package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
  437. package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
  438. package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
  439. package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
  440. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
  441. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
  442. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  443. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  444. package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  445. package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  446. package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  447. package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  448. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  449. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  450. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  451. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  452. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  453. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  454. package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  455. package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
  456. package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
  457. package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
  458. package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
  459. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  460. package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
  461. package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
  462. package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  463. package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  464. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
  465. package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
  466. package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
  467. package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
  468. package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
  469. package/.versions/0.0.9/.version +1 -0
  470. package/.versions/0.0.9/agents/architect.md +24 -0
  471. package/.versions/0.0.9/agents/bowser.md +27 -0
  472. package/.versions/0.0.9/agents/builder.md +54 -0
  473. package/.versions/0.0.9/agents/code-reviewer.md +204 -0
  474. package/.versions/0.0.9/agents/deep-researcher.md +32 -0
  475. package/.versions/0.0.9/agents/documenter.md +18 -0
  476. package/.versions/0.0.9/agents/orchestrator.md +66 -0
  477. package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
  478. package/.versions/0.0.9/agents/planner.md +70 -0
  479. package/.versions/0.0.9/agents/releaser.md +24 -0
  480. package/.versions/0.0.9/agents/researcher.md +28 -0
  481. package/.versions/0.0.9/agents/security-auditor.md +167 -0
  482. package/.versions/0.0.9/agents/test-engineer.md +153 -0
  483. package/.versions/0.0.9/agents/web-debugger.md +43 -0
  484. package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
  485. package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
  486. package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
  487. package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
  488. package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
  489. package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
  490. package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
  491. package/.versions/0.0.9/docs/getting-started.md +231 -0
  492. package/.versions/0.0.9/docs/npm-install.md +337 -0
  493. package/.versions/0.0.9/docs/opencode-setup.md +249 -0
  494. package/.versions/0.0.9/docs/pi-extensions.md +356 -0
  495. package/.versions/0.0.9/docs/pi-setup.md +476 -0
  496. package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
  497. package/.versions/0.0.9/hermes/README.md +347 -0
  498. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  499. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  500. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  501. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  502. package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
  503. package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
  504. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  505. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  506. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  507. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  508. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  509. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  510. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  511. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  512. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  513. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  514. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  515. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  516. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  517. package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
  518. package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
  519. package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
  520. package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
  521. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  522. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  523. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  524. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  525. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  526. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  527. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  528. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  529. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  530. package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
  531. package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
  532. package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
  533. package/.versions/0.0.9/hooks/hooks.json +14 -0
  534. package/.versions/0.0.9/hooks/session-start.sh +74 -0
  535. package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
  536. package/.versions/0.0.9/justfile +254 -0
  537. package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
  538. package/.versions/0.0.9/references/definition-of-done.md +67 -0
  539. package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
  540. package/.versions/0.0.9/references/observability-checklist.md +91 -0
  541. package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
  542. package/.versions/0.0.9/references/performance-checklist.md +153 -0
  543. package/.versions/0.0.9/references/prompting-patterns.md +380 -0
  544. package/.versions/0.0.9/references/security-checklist.md +179 -0
  545. package/.versions/0.0.9/references/testing-patterns.md +236 -0
  546. package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
  547. package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
  548. package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
  549. package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
  550. package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
  551. package/.versions/0.0.9/scripts/fleet.ts +168 -0
  552. package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
  553. package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
  554. package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
  555. package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
  556. package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
  557. package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
  558. package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
  559. package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
  560. package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
  561. package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
  562. package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
  563. package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
  564. package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
  565. package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
  566. package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
  567. package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
  568. package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
  569. package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
  570. package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
  571. package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
  572. package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
  573. package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
  574. package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
  575. package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
  576. package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
  577. package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
  578. package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
  579. package/.versions/0.0.9/scripts/team-up.ts +360 -0
  580. package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
  581. package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
  582. package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
  583. package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
  584. package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
  585. package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
  586. package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
  587. package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  588. package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  589. package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  590. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
  591. package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
  592. package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
  593. package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
  594. package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
  595. package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  596. package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  597. package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
  598. package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
  599. package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
  600. package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
  601. package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
  602. package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
  603. package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
  604. package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
  605. package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
  606. package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  607. package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  608. package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
  609. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  610. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  611. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  612. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  613. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  614. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  615. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  616. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  617. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  618. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  619. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  620. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  621. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  622. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  623. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  624. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  625. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  626. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  627. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  628. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  629. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  630. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  631. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  632. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  633. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  634. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  635. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  636. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  637. package/CHANGELOG.md +141 -0
  638. package/README.md +22 -5
  639. package/agents/architect.md +1 -0
  640. package/agents/bowser.md +1 -0
  641. package/agents/builder.md +1 -0
  642. package/agents/code-reviewer.md +8 -5
  643. package/agents/deep-researcher.md +2 -1
  644. package/agents/orchestrator.md +8 -1
  645. package/agents/plan-reviewer.md +25 -2
  646. package/agents/planner.md +3 -2
  647. package/agents/security-auditor.md +1 -0
  648. package/agents/test-engineer.md +3 -1
  649. package/agents/web-debugger.md +1 -0
  650. package/agents/web-performance-auditor.md +1 -0
  651. package/bin/build-manifest.js +68 -0
  652. package/bin/cli.js +679 -49
  653. package/bin/lib/apply.js +641 -0
  654. package/bin/lib/manifest.js +731 -0
  655. package/bin/lib/merge-forms.js +106 -0
  656. package/bin/lib/plan.js +569 -0
  657. package/bin/lib/state.js +213 -0
  658. package/bin/lib/verify.js +576 -0
  659. package/bin/snapshot-version.js +5 -0
  660. package/docs/ARCHITECTURE.md +53 -12
  661. package/docs/agent-fleet-setup.md +59 -48
  662. package/docs/getting-started.md +29 -6
  663. package/docs/npm-install.md +208 -31
  664. package/docs/opencode-setup.md +32 -0
  665. package/docs/pi-extensions.md +83 -13
  666. package/docs/pi-setup.md +164 -69
  667. package/install-manifest.json +3615 -0
  668. package/justfile +10 -1
  669. package/manifest-meta.json +472 -0
  670. package/package.json +8 -3
  671. package/scripts/fleet.ts +22 -3
  672. package/scripts/lib/fleet-command.ts +5 -3
  673. package/scripts/lib/herdr-layout.ts +18 -0
  674. package/scripts/lib/peer-launch.ts +314 -0
  675. package/scripts/lib/team-project.ts +3 -1
  676. package/scripts/peer-launch.ts +259 -0
  677. package/skills/browser-testing-with-devtools/SKILL.md +3 -4
  678. package/skills/guided-workspace-setup/SKILL.md +172 -490
  679. package/skills/guided-workspace-setup/companion-manifest.json +2 -0
  680. package/skills/planning-and-task-breakdown/SKILL.md +18 -0
  681. package/skills/spec-driven-development/SKILL.md +12 -0
  682. package/.pi/harnesses/agent-hub/spawned-peers.js +0 -74
package/bin/cli.js CHANGED
@@ -22,6 +22,11 @@ import { createInterface } from "node:readline/promises";
22
22
  import { stdin, stdout, exit } from "node:process";
23
23
 
24
24
  import { runDoctor } from "./lib/doctor.js";
25
+ import { loadManifest } from "./lib/manifest.js";
26
+ import { runVerify, hasDrift } from "./lib/verify.js";
27
+ import { buildPlan, hasConflicts, isNoop } from "./lib/plan.js";
28
+ import { applyPlan } from "./lib/apply.js";
29
+ import { readState, readLegacyRecord, isAgentFleetCheckout, STATE_REL_PATH } from "./lib/state.js";
25
30
  import { listPersonas, transformPersona } from "./lib/transform-persona.js";
26
31
  import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
27
32
  import { checkAndNotify } from "./lib/update-notifier.js";
@@ -61,6 +66,13 @@ const parsed = (() => {
61
66
  force: { type: "boolean" },
62
67
  restart: { type: "boolean" },
63
68
  "dry-run": { type: "boolean" },
69
+ json: { type: "boolean" },
70
+ "no-doctor": { type: "boolean" },
71
+ items: { type: "string" },
72
+ "allow-exec": { type: "boolean" },
73
+ "accept-theirs": { type: "boolean" },
74
+ "accept-ours": { type: "boolean" },
75
+ fix: { type: "boolean" },
64
76
  launch: { type: "boolean" },
65
77
  all: { type: "boolean" },
66
78
  list: { type: "boolean" },
@@ -86,13 +98,20 @@ if (opts.help) {
86
98
  // the banner prints to stderr before the command output. If the cache is
87
99
  // stale, a background fetch refreshes it for the next invocation.
88
100
  // `update` skips this since it has its own version-delta reporting.
89
- if (sub !== "update" && sub !== "check-update") {
101
+ // `verify` stays out of it as well: it is a machine contract (exit codes +
102
+ // --json), and a banner racing onto the stream helps nobody scripting it.
103
+ // `install` and `upgrade` join it for the same reason.
104
+ if (!["update", "check-update", "verify", "install", "upgrade", "uninstall", "doctor"].includes(sub)) {
90
105
  checkAndNotify(pkg.version);
91
106
  }
92
107
 
93
108
  switch (sub) {
94
109
  case "init": await cmdInit(); break;
95
110
  case "doctor": await cmdDoctor(); break;
111
+ case "verify": await cmdVerify(); break;
112
+ case "install": await cmdPlanVerb("install"); break;
113
+ case "upgrade": await cmdPlanVerb("upgrade"); break;
114
+ case "uninstall": await cmdPlanVerb("uninstall"); break;
96
115
  case "update": await cmdUpdate(); break;
97
116
  case "check-update": await cmdCheckUpdate(); break;
98
117
  case "cleanup-installer": await cmdCleanupInstaller(); break;
@@ -177,10 +196,7 @@ async function cmdInit() {
177
196
  const agent = await chooseAgent(opts.agent);
178
197
  console.log(`Coding agent: ${agentLabel(agent)}`);
179
198
 
180
- const method = opts.method ?? "copy";
181
- if (!["copy", "symlink"].includes(method)) {
182
- fail(`--method must be "copy" or "symlink" (got "${method}")`);
183
- }
199
+ const method = resolveMethod(opts.method);
184
200
 
185
201
  // Bootstrap the installer artifacts (setup + doctor + the skill they invoke).
186
202
  // Without this, the agent has no setup command to hand off to. The command itself
@@ -219,64 +235,571 @@ async function cmdInit() {
219
235
  }
220
236
  }
221
237
 
238
+ // Doctor has two repair sources, and the split is deliberate:
239
+ //
240
+ // • the engine — for every item the state file records. Repair is `plan()`
241
+ // narrowed to the three breakage states and `apply()` executing it, so a
242
+ // file the doctor restores is byte-identical to one `install` writes. That
243
+ // is the guarantee the whole plan exists for: setup and repair cannot drift.
244
+ // • the legacy scan — for what the state file cannot own: broken links in a
245
+ // pre-engine workspace, and stale persona names inside YAML the manifest
246
+ // does not manage. These need rename heuristics, not a manifest lookup.
247
+ //
248
+ // Everything else the scan reports (overrides problems, malformed peer entries)
249
+ // is advisory: printed, never auto-fixed, because the fix is always a hand edit.
222
250
  async function cmdDoctor() {
223
251
  await mustBeDirectory(workspace, "workspace");
224
252
 
225
- printBanner(`agent-fleet v${pkg.version} — doctor scan`);
226
- console.log(`Workspace: ${workspace}`);
227
- console.log();
253
+ const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape"]);
254
+ const plan = buildRepairPlan();
255
+ const repairs = plan?.actions ?? [];
228
256
 
229
- const findings = await runDoctor({ workspace, sourceRoot: pkgRoot });
257
+ // The two scans overlap on a broken link that the state file also records.
258
+ // The engine's repair wins — it rebuilds the item in the exact form the
259
+ // manifest declares, where the scan can only guess a replacement from the
260
+ // filename. Letting both fire would have the second collide with the first.
261
+ const enginePaths = new Set(
262
+ repairs.flatMap((a) => [a.target, ...(a.files ?? []).map((f) => f.path)]).filter(Boolean),
263
+ );
264
+ const findings = (await runDoctor({ workspace, sourceRoot: pkgRoot }))
265
+ .filter((f) => !(f.type === "broken-symlink" && enginePaths.has(f.path)));
230
266
 
231
- if (findings.length === 0) {
232
- console.log("✓ No broken symlinks, stale persona references, malformed peer entries, or overrides-file problems found.");
233
- exit(0);
267
+ const fixable = findings.filter((f) => !ADVISORY_FINDING_TYPES.has(f.type));
268
+ const advisory = findings.length - fixable.length;
269
+ const outstanding = repairs.length + fixable.length;
270
+
271
+ // The report comes first, then the question. Asking "apply 7 fixes?" before
272
+ // naming them is asking for a blind yes.
273
+ if (!opts.json) {
274
+ printBanner(`agent-fleet v${pkg.version} — doctor`);
275
+ console.log(`Workspace: ${workspace}`);
276
+ if (!plan) console.log(`Recorded: ${repairPlanNote}`);
277
+
278
+ if (repairs.length > 0) {
279
+ printSection(`Recorded items to repair (${repairs.length})`);
280
+ for (const a of repairs) console.log(` ${a.id} — ${a.reason}`);
281
+ }
282
+ if (findings.length > 0) {
283
+ printSection(`Scan findings (${findings.length})`);
284
+ console.log(formatFindingsTable(findings));
285
+ if (advisory > 0) {
286
+ console.log(`\n(${advisory} advisory — fix by hand per the suggestions above; never auto-applied)`);
287
+ }
288
+ }
289
+ }
290
+
291
+ // --fix is the documented flag; -y stays an alias for the pre-engine muscle
292
+ // memory, and a bare interactive run still asks.
293
+ const wantsFix = Boolean(opts.fix || opts.yes);
294
+ const willFix = outstanding > 0 && !opts["dry-run"] &&
295
+ (wantsFix || (!opts.json && stdin.isTTY && await confirm(
296
+ `\nApply the ${outstanding} suggested fix(es) now? [y/N] `,
297
+ )));
298
+
299
+ let applied = null;
300
+ let scanRepair = null;
301
+ if (willFix) {
302
+ if (repairs.length > 0) applied = applyPlan({ plan, manifest: loadManifest(pkgRoot) });
303
+ if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true });
304
+ }
305
+
306
+ const report = {
307
+ schemaVersion: 1,
308
+ verb: "doctor",
309
+ workspace,
310
+ agent: plan?.agent ?? null,
311
+ packageVersion: pkg.version,
312
+ repairs,
313
+ findings,
314
+ planNote: plan ? null : repairPlanNote,
315
+ applied,
316
+ scanRepair: scanRepair && {
317
+ repaired: scanRepair.repaired, deleted: scanRepair.deleted, skipped: scanRepair.skipped,
318
+ },
319
+ summary: {
320
+ repairs: repairs.length,
321
+ fixable: fixable.length,
322
+ advisories: advisory,
323
+ fixed: willFix ? outstanding - (scanRepair?.skipped ?? 0) - (applied?.summary.failed ?? 0) : 0,
324
+ outstanding: willFix ? (scanRepair?.skipped ?? 0) + (applied?.summary.failed ?? 0) : outstanding,
325
+ },
326
+ };
327
+
328
+ if (opts.json) {
329
+ process.stdout.write(JSON.stringify(report, null, 2) + "\n");
330
+ exit(report.summary.outstanding > 0 ? 2 : 0);
331
+ }
332
+
333
+ if (outstanding === 0) {
334
+ console.log("\n✓ Nothing to repair: no broken recorded items, no broken symlinks, no stale persona references.");
335
+ exit(findings.length > 0 ? 2 : 0);
234
336
  }
235
337
 
236
- console.log(`Found ${findings.length} issue(s):\n`);
237
- console.log(formatFindingsTable(findings));
238
338
  console.log();
339
+ if (!willFix) {
340
+ console.log(
341
+ opts["dry-run"]
342
+ ? `${outstanding} repairable issue(s) found (--dry-run: nothing was written).`
343
+ : `${outstanding} repairable issue(s) found. Re-run with --fix to apply them.`,
344
+ );
345
+ exit(2);
346
+ }
239
347
 
240
- // Overrides and yaml-shape findings are advisory: reported above, but the
241
- // fix is always a hand edit of the flagged file — never applied by the doctor.
242
- const ADVISORY_TYPES = new Set(["overrides", "yaml-shape"]);
243
- const fixable = findings.filter((f) => !ADVISORY_TYPES.has(f.type));
244
- const advisory = findings.length - fixable.length;
245
- if (advisory > 0) {
246
- console.log(`(${advisory} advisory finding(s) — fix by hand per the suggestions above)`);
348
+ if (applied) {
349
+ printSection("Repaired");
350
+ for (const r of applied.results) {
351
+ console.log(` ${r.status.padEnd(8)} ${r.id}${r.detail ? ` — ${r.detail}` : ""}`);
352
+ }
353
+ console.log(` state: ${applied.statePath}`);
247
354
  }
248
- if (fixable.length === 0) {
249
- exit(0);
355
+ if (scanRepair) {
356
+ console.log(
357
+ `\nScan fixes — repaired ${scanRepair.repaired}, deleted ${scanRepair.deleted}, skipped ${scanRepair.skipped}.`,
358
+ );
250
359
  }
360
+ console.log(
361
+ report.summary.outstanding > 0
362
+ ? `\n✗ ${report.summary.outstanding} issue(s) could not be repaired — see above.`
363
+ : "\n✓ Doctor finished. Run `agent-fleet verify` to confirm.",
364
+ );
365
+ exit(report.summary.outstanding > 0 ? 2 : 0);
366
+ }
251
367
 
252
- if (opts["dry-run"]) {
253
- console.log("(--dry-run set: no fixes applied)");
254
- exit(0);
368
+ let repairPlanNote = null;
369
+
370
+ /**
371
+ * The engine half of `doctor`. Returns null (with a note) rather than failing
372
+ * when there is nothing to plan against — a workspace with no install record is
373
+ * not broken, it is simply not ours, and the scan still has something to say.
374
+ */
375
+ function buildRepairPlan() {
376
+ try {
377
+ return buildPlan({
378
+ workspace,
379
+ sourceRoot: pkgRoot,
380
+ packageVersion: pkg.version,
381
+ manifest: loadManifest(pkgRoot),
382
+ verb: "repair",
383
+ agent: opts.agent && AGENTS.includes(opts.agent) ? opts.agent : null,
384
+ });
385
+ } catch (err) {
386
+ repairPlanNote = err.message;
387
+ return null;
255
388
  }
389
+ }
390
+
391
+ async function cmdVerify() {
392
+ // Read-only inspection: manifest × state × disk. Never writes, never fixes.
393
+ // Exit 0 = clean, 2 = findings or broken items, 1 = could not run.
394
+ await mustBeDirectory(workspace, "workspace");
256
395
 
257
- const apply = opts.yes
258
- ? true
259
- : await confirm(`Apply the ${fixable.length} suggested fix(es) now? [y/N] `);
396
+ let manifest;
397
+ try { manifest = loadManifest(pkgRoot); }
398
+ catch (err) { fail(err.message); }
260
399
 
261
- if (!apply) {
262
- console.log("No changes made. Re-run without --dry-run to apply.");
263
- exit(0);
400
+ if (opts.agent && !AGENTS.includes(opts.agent)) {
401
+ fail(`--agent must be one of: ${AGENTS.join(", ")} (got "${opts.agent}")`);
264
402
  }
265
403
 
266
- const { repaired, deleted, skipped } = await runDoctor({
404
+ const agent = opts.agent
405
+ ?? readState(workspace)?.agent
406
+ ?? readLegacyRecord(workspace)?.agent
407
+ ?? detectAgent({ workspace, env: process.env, preferWorkspaceHints: true })
408
+ ?? null;
409
+
410
+ const report = await runVerify({
267
411
  workspace,
268
412
  sourceRoot: pkgRoot,
269
- apply: true,
413
+ packageVersion: pkg.version,
414
+ manifest,
415
+ agent: AGENTS.includes(agent) ? agent : null,
416
+ includeDoctor: !opts["no-doctor"],
270
417
  });
271
418
 
419
+ if (opts.json) {
420
+ process.stdout.write(JSON.stringify(report, null, 2) + "\n");
421
+ exit(hasDrift(report) ? 2 : 0);
422
+ }
423
+
424
+ printBanner(`agent-fleet v${pkg.version} — verify`);
425
+ console.log(`Workspace: ${report.workspace}`);
426
+ console.log(`Agent: ${report.agent ? agentLabel(report.agent) : "(unknown)"}`);
427
+ console.log(
428
+ `State: ${
429
+ report.stateSource === "state-file" ? `${STATE_REL_PATH} (recorded v${report.recordedVersion})`
430
+ : report.stateSource === "legacy-record" ? `.ai/agent-fleet-setup.md (pre-engine, recorded v${report.recordedVersion ?? "unknown"})`
431
+ : "none — this workspace has no agent-fleet install record"
432
+ }`,
433
+ );
434
+
435
+ const s = report.summary;
436
+ console.log(
437
+ `\nItems: ${s.total} catalogued · ${s.installed} recorded · ${s.present} present on disk` +
438
+ `${s.upgradable ? ` · ${s.upgradable} outdated` : ""}${s.broken ? ` · ${s.broken} broken` : ""}`,
439
+ );
440
+
441
+ const notable = report.items.filter(
442
+ (i) => !["absent", "not-applicable", "up-to-date", "linked", "unchecked"].includes(i.state),
443
+ );
444
+ if (notable.length > 0) {
445
+ printSection("Items needing attention");
446
+ const width = Math.max(...notable.map((i) => i.state.length));
447
+ for (const item of notable) {
448
+ // The per-file note is the specific one ("link target does not exist");
449
+ // the item note is the general one ("not recorded"). Specific wins.
450
+ const detail = item.files?.[0]?.detail
451
+ ?? item.detail
452
+ ?? (item.changedCount ? `${item.changedCount} file(s) differ` : null);
453
+ console.log(` ${item.state.padEnd(width)} ${item.id}${detail ? ` — ${detail}` : ""}`);
454
+ }
455
+ }
456
+
457
+ if (report.findings.length > 0) {
458
+ printSection(`Findings (${s.problems} problem(s), ${s.advisories} advisory)`);
459
+ console.log(formatFindingsTable(report.findings));
460
+ if (s.advisories > 0) {
461
+ console.log("\n(advisories are reported but never fail the run)");
462
+ }
463
+ }
464
+
465
+ if (s.versionDrift) {
466
+ console.log(
467
+ `\nRecorded v${report.recordedVersion} → package v${report.packageVersion}: an upgrade is available.`,
468
+ );
469
+ }
470
+
471
+ console.log();
472
+ if (hasDrift(report)) {
473
+ console.log(`✗ ${s.broken} broken item(s), ${s.problems} problem finding(s).`);
474
+ exit(2);
475
+ }
476
+ console.log(
477
+ s.advisories > 0
478
+ ? `✓ No broken items and no problems (${s.advisories} advisory).`
479
+ : "✓ No broken items and no findings.",
480
+ );
481
+ }
482
+
483
+ // `install`, `upgrade`, and `uninstall` differ only in which action classes
484
+ // they admit, so they share one command: build a plan, show it, gate on one
485
+ // confirmation, apply it. Every difference between them lives in the planner's
486
+ // decision table, not here.
487
+ async function cmdPlanVerb(verb) {
488
+ await mustBeDirectory(workspace, "workspace");
489
+
490
+ let manifest;
491
+ try { manifest = loadManifest(pkgRoot); }
492
+ catch (err) { fail(err.message); }
493
+
494
+ if (opts.agent && !AGENTS.includes(opts.agent)) {
495
+ fail(`--agent must be one of: ${AGENTS.join(", ")} (got "${opts.agent}")`);
496
+ }
497
+ if (opts.method) resolveMethod(opts.method); // refuses symlink outside a checkout
498
+ if (opts["accept-theirs"] && opts["accept-ours"]) {
499
+ fail("--accept-theirs and --accept-ours are mutually exclusive");
500
+ }
501
+ if (verb === "upgrade" && (opts.profile || opts.items)) {
502
+ fail("upgrade acts on what is already installed — use `install` to add items");
503
+ }
504
+ if (verb === "uninstall" && opts.profile) {
505
+ fail("uninstall names items, not profiles — use --items <id[,id]> or --all");
506
+ }
507
+
508
+ let profiles = splitList(opts.profile);
509
+ const requested = splitList(opts.items);
510
+ if (verb === "uninstall" && requested.length === 0 && !opts.all) {
511
+ // Removal is the one verb where an empty selection could plausibly mean
512
+ // "everything". It must be said out loud.
513
+ fail("uninstall needs --items <id[,id]> or an explicit --all");
514
+ }
515
+ if (verb === "install" && profiles.length === 0 && requested.length === 0) {
516
+ // A terminal can be asked; a pipe cannot. Guessing a profile for someone
517
+ // scripting this would install a catalogue they never chose.
518
+ if (!stdin.isTTY || opts.yes || opts.json) {
519
+ fail(
520
+ "install needs a selection: --profile <name[,name]> or --items <id[,id]>.\n" +
521
+ `Available profiles: ${Object.keys(manifest.profiles ?? {}).join(", ")}`,
522
+ );
523
+ }
524
+ profiles = [await askProfile(manifest)];
525
+ }
526
+
527
+ const agent = opts.agent
528
+ ?? readState(workspace)?.agent
529
+ ?? readLegacyRecord(workspace)?.agent
530
+ ?? detectAgent({ workspace, env: process.env, preferWorkspaceHints: true })
531
+ ?? null;
532
+
533
+ let plan;
534
+ try {
535
+ plan = buildPlan({
536
+ workspace,
537
+ sourceRoot: pkgRoot,
538
+ packageVersion: pkg.version,
539
+ manifest,
540
+ verb,
541
+ agent: AGENTS.includes(agent) ? agent : null,
542
+ method: opts.method ?? null,
543
+ profiles,
544
+ items: requested,
545
+ all: Boolean(opts.all),
546
+ allowExec: Boolean(opts["allow-exec"]),
547
+ accept: opts["accept-theirs"] ? "theirs" : opts["accept-ours"] ? "ours" : null,
548
+ });
549
+ } catch (err) { fail(err.message); }
550
+
551
+ if (opts["dry-run"]) {
552
+ if (opts.json) {
553
+ process.stdout.write(JSON.stringify(plan, null, 2) + "\n");
554
+ exit(hasConflicts(plan) ? 3 : 0);
555
+ }
556
+ printPlan(plan);
557
+ exit(hasConflicts(plan) ? 3 : 0);
558
+ }
559
+
560
+ // Nothing to do is a success, not a prompt.
561
+ if (isNoop(plan)) {
562
+ if (opts.json) {
563
+ process.stdout.write(JSON.stringify({ plan, applied: null }, null, 2) + "\n");
564
+ exit(0);
565
+ }
566
+ printPlan(plan);
567
+ exit(0);
568
+ }
569
+
570
+ // The single gate. Past this point apply() runs straight through without
571
+ // asking again — the plan above is what the user is agreeing to.
572
+ if (!opts.yes) {
573
+ if (opts.json) fail("--json requires --yes (or --dry-run): there is nobody to answer the prompt");
574
+ printPlan(plan);
575
+ const overwrites = plan.summary.overwrites;
576
+ const ok = await confirm(
577
+ verb === "uninstall"
578
+ ? `\nRemove ${plan.summary.remove} item(s)? Files you have edited are kept. [y/N] `
579
+ : `\nApply ${plan.summary.changes} change(s)` +
580
+ `${overwrites ? `, overwriting local edits in ${overwrites} item(s)` : ""}? [y/N] `,
581
+ );
582
+ if (!ok) { console.log("Aborted — nothing was written."); exit(0); }
583
+ }
584
+
585
+ const applied = applyPlan({ plan, manifest, allowExec: Boolean(opts["allow-exec"]) });
586
+
587
+ if (opts.json) {
588
+ process.stdout.write(JSON.stringify({ plan, applied }, null, 2) + "\n");
589
+ exit(applied.summary.failed ? 1 : hasConflicts(plan) ? 3 : 0);
590
+ }
591
+
592
+ printApplied(plan, applied);
593
+ exit(applied.summary.failed ? 1 : hasConflicts(plan) ? 3 : 0);
594
+ }
595
+
596
+ function printApplied(plan, applied) {
597
+ const s = applied.summary;
598
+ printBanner(`agent-fleet v${pkg.version} — ${plan.verb}`);
599
+ console.log(`Workspace: ${applied.workspace}`);
600
+ console.log(`Agent: ${agentLabel(applied.agent)} Method: ${applied.method}`);
601
+
602
+ const notable = applied.results.filter(
603
+ (r) => !["unchanged", "not-reached"].includes(r.status),
604
+ );
605
+ if (notable.length > 0) {
606
+ printSection("Applied");
607
+ const width = Math.max(...notable.map((r) => r.status.length));
608
+ for (const r of notable) {
609
+ console.log(` ${r.status.padEnd(width)} ${r.id}${r.detail ? ` — ${r.detail}` : ""}`);
610
+ }
611
+ }
612
+
613
+ if (applied.conflictFiles.length > 0) {
614
+ printSection("Conflicts — your files were NOT changed");
615
+ for (const path of applied.conflictFiles) console.log(` ${path}`);
616
+ console.log(
617
+ "\nEach `.new` file is the incoming version. Compare, merge what you want,\n" +
618
+ "delete the `.new`, or re-run with --accept-theirs / --accept-ours.",
619
+ );
620
+ }
621
+
622
+ printOperatorSteps(plan.actions);
623
+
624
+ printSection("Summary");
272
625
  console.log(
273
- `\n✓ Doctor finished — repaired ${repaired}, deleted ${deleted}, skipped ${skipped}.`,
626
+ ` ${s.applied} applied · ${s.adopted} adopted · ${s.removed} removed · ` +
627
+ `${s.skipped} skipped · ${s.unchanged} unchanged`,
274
628
  );
629
+ console.log(` State: ${applied.statePath}`);
630
+ console.log(` Record: ${applied.recordPath}`);
631
+
632
+ console.log();
633
+ if (applied.failure) {
634
+ console.log(
635
+ `✗ Stopped at ${applied.failure.id}: ${applied.failure.detail}\n` +
636
+ ` ${s.notReached} action(s) not reached. What was applied is recorded — fix the cause and re-run.`,
637
+ );
638
+ return;
639
+ }
640
+ if (applied.conflictFiles.length > 0) {
641
+ console.log(`✓ Applied, with ${s.conflicts} conflict(s) left for you to resolve.`);
642
+ return;
643
+ }
644
+ console.log("✓ Applied. Run `agent-fleet verify` to confirm.");
645
+ }
646
+
647
+ function printPlan(plan) {
648
+ const s = plan.summary;
649
+ printBanner(`agent-fleet v${pkg.version} — ${plan.verb} (dry run)`);
650
+ console.log(`Workspace: ${plan.workspace}`);
651
+ console.log(`Agent: ${agentLabel(plan.agent)} Method: ${plan.method}`);
652
+ if (plan.verb === "install") {
653
+ const picked = [
654
+ plan.selection.profiles.length ? `profiles: ${plan.selection.profiles.join(", ")}` : null,
655
+ plan.selection.requested.length ? `items: ${plan.selection.requested.length}` : null,
656
+ ].filter(Boolean).join(" ");
657
+ console.log(`Selection: ${picked} → ${plan.selection.resolved.length} item(s) after closure`);
658
+ } else if (plan.verb === "uninstall") {
659
+ console.log(
660
+ `Removing: ${plan.selection.resolved.length} recorded item(s)` +
661
+ `${plan.selection.requested.length ? "" : " (--all)"}`,
662
+ );
663
+ } else {
664
+ console.log(
665
+ `Version: recorded v${plan.recordedVersion ?? "unknown"} → package v${plan.packageVersion}` +
666
+ `${plan.baseAvailable ? "" : " (no merge base — two-way comparison)"}`,
667
+ );
668
+ }
669
+
670
+ if (plan.selection.unknown.length > 0) {
671
+ printSection("Unknown selectors (ignored)");
672
+ for (const id of plan.selection.unknown) console.log(` ${id}`);
673
+ }
674
+
675
+ for (const note of plan.notes) console.log(`\nNote: ${note.detail}`);
676
+
677
+ // Only the interesting half. A hundred `keep` lines buries the four that matter.
678
+ const shown = plan.actions.filter((a) => a.kind !== "keep");
679
+ if (shown.length > 0) {
680
+ printSection("Planned actions");
681
+ const width = Math.max(...shown.map((a) => a.kind.length));
682
+ for (const a of shown) {
683
+ console.log(` ${a.kind.padEnd(width)} ${a.id}${a.reason ? ` — ${a.reason}` : ""}`);
684
+ for (const f of a.files ?? []) console.log(` ${" ".repeat(width)} ${f.state}: ${f.path}`);
685
+ }
686
+ }
687
+
688
+ printOperatorSteps(plan.actions);
689
+
690
+ printSection("Summary");
691
+ console.log(
692
+ ` ${s.changes} change(s): ${s.create} create · ${s.refresh} refresh · ` +
693
+ `${s.repair} repair · ${s.remove} remove`,
694
+ );
695
+ console.log(
696
+ ` ${s.keep} kept${s.preserved ? ` (${s.preserved} local edit(s) preserved)` : ""}` +
697
+ `${s.overwrites ? ` · ${s.overwrites} overwrite local edits` : ""}`,
698
+ );
699
+ if (s.skip || s.exec || s.external || s.operator) {
700
+ console.log(
701
+ ` not applied: ${s.skip} skipped · ${s.exec} exec · ` +
702
+ `${s.external} external · ${s.operator} operator`,
703
+ );
704
+ }
705
+ if (s.newAvailable > 0 && plan.verb !== "uninstall") {
706
+ console.log(` ${s.newAvailable} catalogued item(s) not selected — widen with --profile full`);
707
+ }
708
+
709
+ console.log();
710
+ if (hasConflicts(plan)) {
711
+ console.log(
712
+ `✗ ${plan.conflicts.length} conflict(s): changed both locally and upstream.\n` +
713
+ " Resolve with --accept-theirs (take the new version) or --accept-ours (keep yours).",
714
+ );
715
+ return;
716
+ }
275
717
  console.log(
276
- "Re-run Agent Fleet's setup command inside your coding agent if you also want to add or remove artifacts.",
718
+ isNoop(plan)
719
+ ? "✓ Nothing to do — the workspace already matches this plan."
720
+ : `✓ Plan is clean: ${s.changes} change(s), no conflicts.`,
277
721
  );
278
722
  }
279
723
 
724
+ /**
725
+ * The half of a plan the engine will not perform: Hermes profiles, user systemd
726
+ * units, packages that must be installed by hand. These items exist precisely
727
+ * because their targets sit outside the workspace the engine is allowed to
728
+ * write to, so the only useful thing to emit is the exact command list — which
729
+ * the manifest declares, so it cannot rot away from the artifact it describes.
730
+ */
731
+ function printOperatorSteps(actions) {
732
+ const external = actions.filter((a) => a.kind === "external");
733
+ const operator = actions.filter((a) => a.kind === "operator");
734
+ if (external.length === 0 && operator.length === 0) return;
735
+
736
+ printSection("Do these yourself — the engine performs none of them");
737
+ for (const a of external) {
738
+ console.log(` ${a.id}`);
739
+ console.log(` install the package: ${a.packageSpec ?? "(unspecified)"}`);
740
+ }
741
+ for (const a of operator) {
742
+ console.log(` ${a.id}`);
743
+ for (const step of a.operatorSteps ?? []) console.log(` - ${step}`);
744
+ if ((a.operatorSteps ?? []).length === 0) console.log(" - (no steps declared)");
745
+ }
746
+ }
747
+
748
+ /**
749
+ * Validate `--method`, and refuse `symlink` outside an agent-fleet checkout.
750
+ *
751
+ * Symlinks are only sound where the source is meant to be edited in place —
752
+ * that is, in agent-fleet itself. Anywhere else the link target must never move
753
+ * again: an npx cache clean breaks every link at once, and a `git pull` in the
754
+ * source rewrites artifacts the workspace never agreed to change. A copy plus
755
+ * `agent-fleet upgrade` gives the same freshness with none of that.
756
+ *
757
+ * Explicit is refused rather than downgraded — a flag the user typed deserves
758
+ * an answer, not a silent substitution. Workspaces that merely *recorded*
759
+ * symlink from before are migrated to copies by the planner instead.
760
+ *
761
+ * @returns {"copy"|"symlink"} the method to use
762
+ */
763
+ function resolveMethod(supplied, fallback = "copy") {
764
+ const method = supplied ?? fallback;
765
+ if (!["copy", "symlink"].includes(method)) {
766
+ fail(`--method must be "copy" or "symlink" (got "${method}")`);
767
+ }
768
+ if (method === "symlink" && !isAgentFleetCheckout(workspace)) {
769
+ if (supplied === "symlink") {
770
+ fail(
771
+ "--method symlink is supported only inside an agent-fleet checkout.\n" +
772
+ " Everywhere else it breaks as soon as the source moves or an npx cache is cleaned.\n" +
773
+ " Install with --method copy and keep it current with `agent-fleet upgrade`.",
774
+ );
775
+ }
776
+ return "copy"; // recorded from before the restriction — migrate quietly
777
+ }
778
+ return method;
779
+ }
780
+
781
+ function splitList(value) {
782
+ return (value ?? "").split(",").map((s) => s.trim()).filter(Boolean);
783
+ }
784
+
785
+ // A numbered list, not a TUI: this runs inside `npx` on machines whose terminal
786
+ // capabilities are unknown, and the flags remain the primary interface.
787
+ async function askProfile(manifest) {
788
+ const names = Object.keys(manifest.profiles ?? {});
789
+ if (names.length === 0) fail("the manifest declares no profiles");
790
+
791
+ printSection("Which set of artifacts?");
792
+ names.forEach((name, i) => {
793
+ console.log(` ${i + 1}) ${name.padEnd(16)} ${manifest.profiles[name].title ?? ""}`);
794
+ });
795
+
796
+ const answer = (await prompt(`\nProfile [1-${names.length}, or a name]: `)).trim();
797
+ const byIndex = names[Number(answer) - 1];
798
+ const chosen = byIndex ?? names.find((n) => n === answer);
799
+ if (!chosen) fail(`not a profile: "${answer}"`);
800
+ return chosen;
801
+ }
802
+
280
803
  async function cmdUpdate() {
281
804
  await mustBeDirectory(workspace, "workspace");
282
805
 
@@ -315,10 +838,7 @@ async function cmdUpdate() {
315
838
  if (agent && !AGENTS.includes(agent)) agent = null;
316
839
  if (!agent) agent = await chooseAgent(opts.agent);
317
840
 
318
- const method = opts.method ?? marker?.method ?? "copy";
319
- if (!["copy", "symlink"].includes(method)) {
320
- fail(`--method must be "copy" or "symlink" (got "${method}")`);
321
- }
841
+ const method = resolveMethod(opts.method, marker?.method ?? "copy");
322
842
 
323
843
  printSection("Refresh installer command");
324
844
  const { written, skipped, removed, warnings } = bootstrap({
@@ -604,7 +1124,6 @@ function printHelp(sub) {
604
1124
 
605
1125
  Options:
606
1126
  --agent <claude-code|opencode|pi> Skip the agent auto-detection
607
- --method <copy|symlink> Default install method (default: copy)
608
1127
  --workspace <path> Target workspace (default: cwd)
609
1128
  --launch Attempt to launch the coding agent after init
610
1129
  -h, --help Show this help
@@ -614,13 +1133,116 @@ Options:
614
1133
  if (sub === "doctor") {
615
1134
  console.log(`agent-fleet doctor [options]
616
1135
 
617
- Scan the workspace for broken symlinks and stale persona references.
1136
+ Find and repair breakage. Two sources, one report:
1137
+
1138
+ • recorded items that are missing, dangling, or linked outside the source
1139
+ root — repaired through the same apply() path \`install\` writes with, so
1140
+ a repaired file is byte-identical to a freshly installed one;
1141
+ • broken symlinks and stale persona names the install record cannot own
1142
+ (pre-engine workspaces, hand-edited .pi/agents/*.yaml).
1143
+
1144
+ Overrides problems and malformed peers.yaml entries are advisory: reported,
1145
+ never auto-fixed, because the fix is always a hand edit.
1146
+
1147
+ Options:
1148
+ --workspace <path> Target workspace (default: cwd)
1149
+ --agent <claude-code|opencode|pi> Override the recorded/detected agent
1150
+ --fix Apply the repairs without prompting
1151
+ --dry-run Report only; never write, never prompt
1152
+ --json Emit the machine report on stdout
1153
+ -y, --yes Alias for --fix
1154
+ -h, --help Show this help
1155
+
1156
+ Exit codes:
1157
+ 0 nothing to repair
1158
+ 1 could not run
1159
+ 2 repairable issues found (or advisory findings), or a repair failed
1160
+ `);
1161
+ return;
1162
+ }
1163
+ if (sub === "uninstall") {
1164
+ console.log(`agent-fleet uninstall [options]
1165
+
1166
+ Remove artifacts agent-fleet installed. Bound by the ownership rule: only
1167
+ paths recorded in .ai/agent-fleet-state.json are eligible, and a recorded
1168
+ file whose bytes no longer match what we wrote is kept and listed as skipped.
1169
+ Nothing else in the workspace is ever touched.
1170
+
1171
+ Removing an item takes its companions with it, unless another installed item
1172
+ still needs them; an item another installed item pins is refused by name.
618
1173
 
619
1174
  Options:
620
- --workspace <path> Target workspace (default: cwd)
621
- --dry-run Show findings, do not apply fixes
622
- -y, --yes Apply all suggested fixes without prompting
623
- -h, --help Show this help
1175
+ --workspace <path> Target workspace (default: cwd)
1176
+ --items <id[,id]> Item ids to remove
1177
+ --all Remove everything the state file records
1178
+ --agent <claude-code|opencode|pi> Override the recorded agent
1179
+ --dry-run Print the plan, write nothing
1180
+ --json Emit the machine plan/result on stdout
1181
+ -y, --yes Skip the confirmation
1182
+ -h, --help Show this help
1183
+
1184
+ Exit codes:
1185
+ 0 removed (or nothing to remove)
1186
+ 1 could not plan (no install record, no selection, unknown agent)
1187
+ `);
1188
+ return;
1189
+ }
1190
+ if (sub === "verify") {
1191
+ console.log(`agent-fleet verify [options]
1192
+
1193
+ Read-only inspection of a workspace against the install manifest: what is
1194
+ recorded, what is on disk, what differs, and what is broken. Writes nothing.
1195
+
1196
+ Options:
1197
+ --workspace <path> Target workspace (default: cwd)
1198
+ --agent <claude-code|opencode|pi> Override the recorded/detected agent
1199
+ --json Emit the machine report on stdout
1200
+ --no-doctor Skip the symlink/persona/overrides scan
1201
+ -h, --help Show this help
1202
+
1203
+ Exit codes:
1204
+ 0 no broken items and no findings
1205
+ 1 could not run (bad flags, missing manifest, unreadable workspace)
1206
+ 2 findings, or items in a broken state
1207
+
1208
+ An available upgrade (state "outdated") and a deliberate local edit (state
1209
+ "modified") are reported but do not fail the run.
1210
+ `);
1211
+ return;
1212
+ }
1213
+ if (sub === "install" || sub === "upgrade") {
1214
+ console.log(`agent-fleet ${sub} [options]
1215
+
1216
+ ${sub === "install"
1217
+ ? "Install the selected artifacts into a workspace."
1218
+ : "Upgrade what this workspace already has to the current package, with a\n three-way merge against the snapshot of the version it recorded."}
1219
+
1220
+ Options:
1221
+ --workspace <path> Target workspace (default: cwd)
1222
+ --agent <claude-code|opencode|pi> Override the recorded/detected agent${sub === "install" ? `
1223
+ --profile <name[,name]> Named selections, unioned
1224
+ --items <id[,id]> Explicit item ids, added to the profiles` : ""}
1225
+ --allow-exec Include items that run a command
1226
+ --accept-theirs Resolve conflicts by taking the new version
1227
+ --accept-ours Resolve conflicts by keeping the local copy
1228
+ --dry-run Print the plan, write nothing
1229
+ --json Emit the machine plan/result on stdout
1230
+ -y, --yes Skip the confirmation (required with --json)
1231
+ -h, --help Show this help
1232
+
1233
+ Exit codes:
1234
+ 0 applied, or nothing to do
1235
+ 1 could not plan, or a write failed partway
1236
+ 3 conflicts — changed both locally and upstream, needs a decision
1237
+
1238
+ ${sub === "install"
1239
+ ? "A selection never removes anything: installing a narrower profile keeps what\nis already there. Local edits to a selected item ARE overwritten — selecting\nan item is the consent — and every such item is listed as `overwrites`."
1240
+ : "Upgrade never widens the install. Locally modified files are preserved, not\noverwritten; artifacts retired upstream are proposed for removal by name."}
1241
+
1242
+ Artifacts are installed as copies. --method symlink exists only inside an
1243
+ agent-fleet checkout, where editing an artifact is meant to edit the source; a
1244
+ workspace that recorded symlinks before that restriction is migrated to copies
1245
+ on the next install or upgrade.
624
1246
  `);
625
1247
  return;
626
1248
  }
@@ -704,7 +1326,6 @@ Examples:
704
1326
 
705
1327
  Options:
706
1328
  --agent <claude-code|opencode|pi> Override the agent (default: marker → auto-detect)
707
- --method <copy|symlink> Install method for the command (default: copy)
708
1329
  --workspace <path> Target workspace (default: cwd)
709
1330
  --dry-run Show what would be written; touch nothing
710
1331
  -h, --help Show this help
@@ -722,7 +1343,11 @@ Usage:
722
1343
 
723
1344
  Commands:
724
1345
  init Bootstrap installer files + hand off to the setup workflow
725
- doctor Scan for broken symlinks and stale persona references
1346
+ doctor Find and repair breakage (--fix); advisory findings listed
1347
+ verify Read-only report: manifest × install state × disk (--json)
1348
+ install Install from a profile or explicit item ids
1349
+ upgrade Upgrade what is installed, with a three-way merge
1350
+ uninstall Remove recorded artifacts (--items / --all)
726
1351
  update Surface the version delta + hand off to the setup workflow
727
1352
  check-update One-line registry check (used by session hooks; safe to script)
728
1353
  cleanup-installer Remove the installer slash commands from a workspace (used
@@ -739,7 +1364,12 @@ Options:
739
1364
  Examples:
740
1365
  npx agent-fleet init
741
1366
  npx agent-fleet init --agent claude-code --method copy
742
- npx agent-fleet doctor --workspace ~/projects/foo
1367
+ npx agent-fleet doctor --workspace ~/projects/foo --fix
1368
+ npx agent-fleet verify --agent pi --json
1369
+ npx agent-fleet install --agent pi --profile recommended --yes
1370
+ npx agent-fleet install --agent pi --profile hermes-plugins --dry-run
1371
+ npx agent-fleet upgrade --accept-ours --yes
1372
+ npx agent-fleet uninstall --items skill:peer-coms --yes
743
1373
  npx agent-fleet update
744
1374
  npx agent-fleet set-hermes-telegram on 7883056502:1735
745
1375
  npx agent-fleet set-hermes-watchdog status --profile default