@chankov/agent-fleet 2.0.3 → 2.0.4

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 (452) hide show
  1. package/.pi/agents/model-profiles.yaml +64 -13
  2. package/.pi/agents/peers.yaml +11 -8
  3. package/.pi/harnesses/agent-hub/README.md +4 -2
  4. package/.pi/harnesses/agent-hub/config/agents.ts +13 -14
  5. package/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  6. package/.pi/harnesses/agent-hub/dispatch-coms.ts +6 -4
  7. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +6 -3
  8. package/.pi/harnesses/agent-hub/dispatch-native.ts +4 -1
  9. package/.pi/harnesses/agent-hub/index.ts +61 -9
  10. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +7 -7
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/policy/models.ts +35 -8
  13. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  14. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  15. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  16. package/.pi/harnesses/agent-hub/research/spawn-run.ts +2 -1
  17. package/.pi/harnesses/agent-hub/spawn.ts +17 -1
  18. package/.pi/harnesses/agent-hub/tools/action-executors.ts +2 -0
  19. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -0
  20. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +4 -1
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  23. package/.versions/2.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/2.0.4/.pi/agents/model-profiles.yaml +78 -0
  25. package/.versions/2.0.4/.pi/agents/peers.yaml +145 -0
  26. package/.versions/2.0.4/.pi/agents/teams.yaml +41 -0
  27. package/.versions/2.0.4/.pi/agents/voices.yaml +13 -0
  28. package/.versions/2.0.4/.pi/damage-control-rules.yaml +297 -0
  29. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  30. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  31. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  32. package/.versions/2.0.4/.pi/extensions/btw/README.md +120 -0
  33. package/.versions/2.0.4/.pi/extensions/btw/index.ts +914 -0
  34. package/.versions/2.0.4/.pi/extensions/btw/package.json +6 -0
  35. package/.versions/2.0.4/.pi/extensions/btw/state.js +179 -0
  36. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  37. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  38. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  39. package/.versions/2.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  40. package/.versions/2.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  41. package/.versions/2.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  42. package/.versions/2.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  43. package/.versions/2.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  44. package/.versions/2.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  45. package/.versions/2.0.4/.pi/extensions/package-lock.json +1175 -0
  46. package/.versions/2.0.4/.pi/extensions/package.json +9 -0
  47. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  48. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  49. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  50. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  51. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  52. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  53. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  54. package/.versions/2.0.4/.pi/harnesses/agent-hub/README.md +1160 -0
  55. package/.versions/2.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  56. package/.versions/2.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  57. package/.versions/2.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  58. package/.versions/2.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  59. package/.versions/2.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  60. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  61. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  62. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  63. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  64. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  65. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  66. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  67. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  68. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  69. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  70. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  71. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  72. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  73. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  74. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  75. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  76. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  77. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  78. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  79. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  80. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  81. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  82. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  83. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  84. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  85. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  86. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  87. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  88. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  89. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  90. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  91. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  92. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  93. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  94. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  95. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  96. package/.versions/2.0.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  97. package/.versions/2.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  98. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  99. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  100. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  101. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  102. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  103. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  104. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native.ts +187 -0
  105. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  106. package/.versions/2.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  107. package/.versions/2.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  108. package/.versions/2.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  109. package/.versions/2.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  110. package/.versions/2.0.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  111. package/.versions/2.0.4/.pi/harnesses/agent-hub/footer.ts +30 -0
  112. package/.versions/2.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  113. package/.versions/2.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  114. package/.versions/2.0.4/.pi/harnesses/agent-hub/index.ts +2088 -0
  115. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  116. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  117. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  118. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  119. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  120. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  121. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  122. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  123. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  124. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  125. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  126. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  127. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  128. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  129. package/.versions/2.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  130. package/.versions/2.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  131. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  132. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  133. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  134. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  135. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  136. package/.versions/2.0.4/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  137. package/.versions/2.0.4/.pi/harnesses/agent-hub/presentation.ts +48 -0
  138. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  139. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  140. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  141. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  142. package/.versions/2.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  143. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  144. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  145. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/spawn-run.ts +144 -0
  146. package/.versions/2.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  147. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  148. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  149. package/.versions/2.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  150. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  151. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  152. package/.versions/2.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  153. package/.versions/2.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  154. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  155. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  156. package/.versions/2.0.4/.pi/harnesses/agent-hub/spawn.ts +404 -0
  157. package/.versions/2.0.4/.pi/harnesses/agent-hub/timeline.ts +54 -0
  158. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/action-executors.ts +148 -0
  159. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  160. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  161. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  162. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  163. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  164. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  165. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +84 -0
  166. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  167. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  168. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  169. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  170. package/.versions/2.0.4/.pi/harnesses/agent-hub/types.ts +61 -0
  171. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  172. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  173. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  174. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  175. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  176. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  177. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  178. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  179. package/.versions/2.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  180. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  181. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  182. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  183. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  184. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  185. package/.versions/2.0.4/.pi/harnesses/coms/README.md +100 -0
  186. package/.versions/2.0.4/.pi/harnesses/coms/index.ts +276 -0
  187. package/.versions/2.0.4/.pi/harnesses/coms/package.json +7 -0
  188. package/.versions/2.0.4/.pi/harnesses/coms/version.ts +42 -0
  189. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  190. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  191. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  192. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  193. package/.versions/2.0.4/.pi/harnesses/lib/coms-core-io.ts +385 -0
  194. package/.versions/2.0.4/.pi/harnesses/lib/coms-core.ts +577 -0
  195. package/.versions/2.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  196. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  197. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  198. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  199. package/.versions/2.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  200. package/.versions/2.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  201. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  202. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  203. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  204. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  205. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  206. package/.versions/2.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  207. package/.versions/2.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  208. package/.versions/2.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  209. package/.versions/2.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  210. package/.versions/2.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  211. package/.versions/2.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  212. package/.versions/2.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  213. package/.versions/2.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  214. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  215. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  216. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  217. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  218. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  219. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  220. package/.versions/2.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  221. package/.versions/2.0.4/.pi/harnesses/package-lock.json +2039 -0
  222. package/.versions/2.0.4/.pi/harnesses/package.json +10 -0
  223. package/.versions/2.0.4/.pi/prompts/af-build.md +24 -0
  224. package/.versions/2.0.4/.pi/prompts/af-code-simplify.md +22 -0
  225. package/.versions/2.0.4/.pi/prompts/af-plan.md +17 -0
  226. package/.versions/2.0.4/.pi/prompts/af-review.md +16 -0
  227. package/.versions/2.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  228. package/.versions/2.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  229. package/.versions/2.0.4/.pi/prompts/af-ship.md +17 -0
  230. package/.versions/2.0.4/.pi/prompts/af-spec.md +15 -0
  231. package/.versions/2.0.4/.pi/prompts/af-test.md +19 -0
  232. package/.versions/2.0.4/.pi/skills/bowser/SKILL.md +145 -0
  233. package/.versions/2.0.4/.version +1 -0
  234. package/.versions/2.0.4/agents/architect.md +25 -0
  235. package/.versions/2.0.4/agents/bowser.md +28 -0
  236. package/.versions/2.0.4/agents/builder.md +56 -0
  237. package/.versions/2.0.4/agents/code-reviewer.md +210 -0
  238. package/.versions/2.0.4/agents/deep-researcher.md +33 -0
  239. package/.versions/2.0.4/agents/documenter.md +22 -0
  240. package/.versions/2.0.4/agents/orchestrator.md +23 -0
  241. package/.versions/2.0.4/agents/plan-reviewer.md +84 -0
  242. package/.versions/2.0.4/agents/planner.md +105 -0
  243. package/.versions/2.0.4/agents/releaser.md +25 -0
  244. package/.versions/2.0.4/agents/researcher.md +31 -0
  245. package/.versions/2.0.4/agents/security-auditor.md +168 -0
  246. package/.versions/2.0.4/agents/test-engineer.md +154 -0
  247. package/.versions/2.0.4/agents/web-debugger.md +44 -0
  248. package/.versions/2.0.4/agents/web-performance-auditor.md +194 -0
  249. package/.versions/2.0.4/bin/catalog/harness-runtime-closure.json +36 -0
  250. package/.versions/2.0.4/codex/CONDUCTOR.md +148 -0
  251. package/.versions/2.0.4/docs/ARCHITECTURE.md +407 -0
  252. package/.versions/2.0.4/docs/agent-fleet-setup.md +547 -0
  253. package/.versions/2.0.4/docs/claude-code-coms-bridge.md +133 -0
  254. package/.versions/2.0.4/docs/codex-remote-conductor.md +170 -0
  255. package/.versions/2.0.4/docs/coms-hermes-bridge.md +189 -0
  256. package/.versions/2.0.4/docs/getting-started.md +124 -0
  257. package/.versions/2.0.4/docs/npm-install.md +299 -0
  258. package/.versions/2.0.4/docs/pi-extensions.md +447 -0
  259. package/.versions/2.0.4/docs/pi-setup.md +74 -0
  260. package/.versions/2.0.4/docs/skill-anatomy.md +150 -0
  261. package/.versions/2.0.4/hermes/README.md +347 -0
  262. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  263. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  264. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  265. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  266. package/.versions/2.0.4/hermes/gates/gate-o-capability.md +8 -0
  267. package/.versions/2.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  268. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  269. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  270. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  271. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  272. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  273. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  274. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  275. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  276. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  277. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  278. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  279. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  280. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  281. package/.versions/2.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  282. package/.versions/2.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  283. package/.versions/2.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  284. package/.versions/2.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  285. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  286. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  287. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  288. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  289. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  290. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  291. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  292. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  293. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  294. package/.versions/2.0.4/hermes/watchdog-tests/__init__.py +0 -0
  295. package/.versions/2.0.4/hooks/coms-stop-hook.mjs +84 -0
  296. package/.versions/2.0.4/install-manifest.json +2942 -0
  297. package/.versions/2.0.4/justfile +289 -0
  298. package/.versions/2.0.4/manifest-meta.json +969 -0
  299. package/.versions/2.0.4/references/accessibility-checklist.md +160 -0
  300. package/.versions/2.0.4/references/communication-contract.md +26 -0
  301. package/.versions/2.0.4/references/definition-of-done.md +67 -0
  302. package/.versions/2.0.4/references/fleet-coordination-patterns.md +171 -0
  303. package/.versions/2.0.4/references/observability-checklist.md +91 -0
  304. package/.versions/2.0.4/references/orchestration-patterns.md +370 -0
  305. package/.versions/2.0.4/references/performance-checklist.md +153 -0
  306. package/.versions/2.0.4/references/prompting-patterns.md +380 -0
  307. package/.versions/2.0.4/references/security-checklist.md +179 -0
  308. package/.versions/2.0.4/references/testing-patterns.md +236 -0
  309. package/.versions/2.0.4/references/workflow-authoring.md +304 -0
  310. package/.versions/2.0.4/scripts/claude-code-preflight.ts +70 -0
  311. package/.versions/2.0.4/scripts/codex-conductor.ts +41 -0
  312. package/.versions/2.0.4/scripts/codex-remote-control.ts +167 -0
  313. package/.versions/2.0.4/scripts/coms-claude-bridge.ts +411 -0
  314. package/.versions/2.0.4/scripts/coms-cli.ts +484 -0
  315. package/.versions/2.0.4/scripts/coms-hermes-bridge.ts +413 -0
  316. package/.versions/2.0.4/scripts/fleet.ts +222 -0
  317. package/.versions/2.0.4/scripts/flow.ts +137 -0
  318. package/.versions/2.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  319. package/.versions/2.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  320. package/.versions/2.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  321. package/.versions/2.0.4/scripts/install-hermes-plugin.sh +180 -0
  322. package/.versions/2.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  323. package/.versions/2.0.4/scripts/lib/codex-conductor.ts +88 -0
  324. package/.versions/2.0.4/scripts/lib/codex-remote-control.ts +482 -0
  325. package/.versions/2.0.4/scripts/lib/coms-envelope.ts +582 -0
  326. package/.versions/2.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  327. package/.versions/2.0.4/scripts/lib/fleet-command.ts +270 -0
  328. package/.versions/2.0.4/scripts/lib/flow-command.ts +93 -0
  329. package/.versions/2.0.4/scripts/lib/flow-maintenance.ts +230 -0
  330. package/.versions/2.0.4/scripts/lib/herdr-layout.ts +281 -0
  331. package/.versions/2.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  332. package/.versions/2.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  333. package/.versions/2.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  334. package/.versions/2.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  335. package/.versions/2.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  336. package/.versions/2.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  337. package/.versions/2.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  338. package/.versions/2.0.4/scripts/lib/monitor-env.ts +146 -0
  339. package/.versions/2.0.4/scripts/lib/peer-launch.ts +318 -0
  340. package/.versions/2.0.4/scripts/lib/persona-banner.ts +62 -0
  341. package/.versions/2.0.4/scripts/lib/runtime-dependencies.js +124 -0
  342. package/.versions/2.0.4/scripts/lib/spawn-stagger.ts +101 -0
  343. package/.versions/2.0.4/scripts/lib/team-project.ts +213 -0
  344. package/.versions/2.0.4/scripts/lib/team-snapshot.ts +147 -0
  345. package/.versions/2.0.4/scripts/package-lock.json +35 -0
  346. package/.versions/2.0.4/scripts/package.json +9 -0
  347. package/.versions/2.0.4/scripts/peer-banner.ts +40 -0
  348. package/.versions/2.0.4/scripts/peer-launch.ts +285 -0
  349. package/.versions/2.0.4/scripts/team-snapshot.ts +237 -0
  350. package/.versions/2.0.4/scripts/team-up.ts +406 -0
  351. package/.versions/2.0.4/scripts/workflows/lib/agent-phase.ts +133 -0
  352. package/.versions/2.0.4/scripts/workflows/lib/changes.ts +61 -0
  353. package/.versions/2.0.4/scripts/workflows/lib/debate.ts +149 -0
  354. package/.versions/2.0.4/scripts/workflows/lib/env.ts +34 -0
  355. package/.versions/2.0.4/scripts/workflows/lib/envelopes.ts +169 -0
  356. package/.versions/2.0.4/scripts/workflows/lib/gates.ts +81 -0
  357. package/.versions/2.0.4/scripts/workflows/lib/git.ts +96 -0
  358. package/.versions/2.0.4/scripts/workflows/lib/merge.ts +95 -0
  359. package/.versions/2.0.4/scripts/workflows/lib/model-profile.ts +22 -0
  360. package/.versions/2.0.4/scripts/workflows/lib/model-visibility.ts +92 -0
  361. package/.versions/2.0.4/scripts/workflows/lib/permissions.ts +130 -0
  362. package/.versions/2.0.4/scripts/workflows/lib/personas.ts +57 -0
  363. package/.versions/2.0.4/scripts/workflows/lib/poll.ts +86 -0
  364. package/.versions/2.0.4/scripts/workflows/lib/quality.ts +64 -0
  365. package/.versions/2.0.4/scripts/workflows/lib/run.ts +108 -0
  366. package/.versions/2.0.4/scripts/workflows/lib/trace.ts +34 -0
  367. package/.versions/2.0.4/scripts/workflows/lib/voices.ts +128 -0
  368. package/.versions/2.0.4/scripts/workflows/lib/writer-lease.ts +112 -0
  369. package/.versions/2.0.4/scripts/workflows/tsconfig.json +22 -0
  370. package/.versions/2.0.4/scripts/workflows/wf-build-test.ts +61 -0
  371. package/.versions/2.0.4/scripts/workflows/wf-debate.ts +87 -0
  372. package/.versions/2.0.4/scripts/workflows/wf-document.ts +50 -0
  373. package/.versions/2.0.4/scripts/workflows/wf-poll.ts +95 -0
  374. package/.versions/2.0.4/scripts/workflows/wf-quality.ts +20 -0
  375. package/.versions/2.0.4/scripts/workflows/wf-scout.ts +38 -0
  376. package/.versions/2.0.4/skills/_internal/grilling.md +59 -0
  377. package/.versions/2.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  378. package/.versions/2.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  379. package/.versions/2.0.4/skills/compound-learning/SKILL.md +137 -0
  380. package/.versions/2.0.4/skills/context-engineering/SKILL.md +291 -0
  381. package/.versions/2.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  382. package/.versions/2.0.4/skills/designing-agents/SKILL.md +394 -0
  383. package/.versions/2.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  384. package/.versions/2.0.4/skills/drafting-workflows/SKILL.md +143 -0
  385. package/.versions/2.0.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  386. package/.versions/2.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  387. package/.versions/2.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  388. package/.versions/2.0.4/skills/idea-refine/SKILL.md +182 -0
  389. package/.versions/2.0.4/skills/idea-refine/examples.md +238 -0
  390. package/.versions/2.0.4/skills/idea-refine/frameworks.md +99 -0
  391. package/.versions/2.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  392. package/.versions/2.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  393. package/.versions/2.0.4/skills/incremental-implementation/SKILL.md +298 -0
  394. package/.versions/2.0.4/skills/interview-me/SKILL.md +226 -0
  395. package/.versions/2.0.4/skills/orchestration-verification/SKILL.md +181 -0
  396. package/.versions/2.0.4/skills/peer-coms/SKILL.md +90 -0
  397. package/.versions/2.0.4/skills/performance-optimization/SKILL.md +350 -0
  398. package/.versions/2.0.4/skills/planning-and-task-breakdown/SKILL.md +265 -0
  399. package/.versions/2.0.4/skills/security-and-hardening/SKILL.md +461 -0
  400. package/.versions/2.0.4/skills/spec-driven-development/SKILL.md +256 -0
  401. package/.versions/2.0.4/skills/using-agent-skills/SKILL.md +197 -0
  402. package/.versions/2.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  403. package/.versions/2.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  404. package/.versions/2.0.4/vendor/agent-skills-upstream/README.md +11 -0
  405. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  406. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  407. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  408. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  409. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  410. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  411. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  412. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  413. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  414. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  415. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  416. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  417. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  418. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  419. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  420. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  421. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  422. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  423. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  424. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  425. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  426. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  427. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  428. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  429. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  430. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  431. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  432. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  433. package/CHANGELOG.md +7 -0
  434. package/bin/catalog/harness-runtime-closure.json +2 -0
  435. package/bin/cli.js +47 -9
  436. package/bin/lib/doctor.js +35 -2
  437. package/bin/lib/reconcile.js +3 -2
  438. package/docs/agent-fleet-setup.md +74 -0
  439. package/docs/claude-code-coms-bridge.md +5 -0
  440. package/docs/getting-started.md +5 -0
  441. package/docs/npm-install.md +12 -5
  442. package/install-manifest.json +3 -1
  443. package/justfile +1 -1
  444. package/package.json +5 -3
  445. package/scripts/claude-code-preflight.ts +70 -0
  446. package/scripts/fleet.ts +23 -0
  447. package/scripts/lib/runtime-dependencies.js +124 -0
  448. package/scripts/peer-launch.ts +27 -1
  449. package/scripts/workflows/lib/agent-phase.ts +2 -1
  450. package/scripts/workflows/lib/model-profile.ts +22 -0
  451. package/scripts/workflows/lib/personas.ts +6 -3
  452. package/scripts/workflows/lib/voices.ts +3 -0
@@ -0,0 +1,191 @@
1
+ ---
2
+ name: using-agent-skills
3
+ description: Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
4
+ ---
5
+
6
+ # Using Agent Skills
7
+
8
+ ## Overview
9
+
10
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
11
+
12
+ ## Skill Discovery
13
+
14
+ When a task arrives, identify the development phase and apply the corresponding skill:
15
+
16
+ ```
17
+ Task arrives
18
+ │
19
+ ├── Don't know what you want yet? ──────→ interview-me
20
+ ├── Have a rough concept, need variants? → idea-refine
21
+ ├── New project/feature/change? ──→ spec-driven-development
22
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
23
+ ├── Implementing code? ────────────→ incremental-implementation
24
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
25
+ │ ├── API work? ────────────────→ api-and-interface-design
26
+ │ ├── Need better context? ─────→ context-engineering
27
+ │ ├── Need doc-verified code? ───→ source-driven-development
28
+ │ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
29
+ ├── Writing/running tests? ────────→ test-driven-development
30
+ │ └── Browser-based? ───────────→ browser-testing-with-devtools
31
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
32
+ ├── Reviewing code? ───────────────→ code-review-and-quality
33
+ │ ├── Too complex? ─────────────→ code-simplification
34
+ │ ├── Security concerns? ───────→ security-and-hardening
35
+ │ └── Performance concerns? ────→ performance-optimization
36
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
37
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
38
+ ├── Deprecating/migrating? ────────→ deprecation-and-migration
39
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
40
+ ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
41
+ └── Deploying/launching? ─────────→ shipping-and-launch
42
+ ```
43
+
44
+ ## Core Operating Behaviors
45
+
46
+ These behaviors apply at all times, across all skills. They are non-negotiable.
47
+
48
+ ### 1. Surface Assumptions
49
+
50
+ Before implementing anything non-trivial, explicitly state your assumptions:
51
+
52
+ ```
53
+ ASSUMPTIONS I'M MAKING:
54
+ 1. [assumption about requirements]
55
+ 2. [assumption about architecture]
56
+ 3. [assumption about scope]
57
+ → Correct me now or I'll proceed with these.
58
+ ```
59
+
60
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
61
+
62
+ ### 2. Manage Confusion Actively
63
+
64
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
65
+
66
+ 1. **STOP.** Do not proceed with a guess.
67
+ 2. Name the specific confusion.
68
+ 3. Present the tradeoff or ask the clarifying question.
69
+ 4. Wait for resolution before continuing.
70
+
71
+ **Bad:** Silently picking one interpretation and hoping it's right.
72
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
73
+
74
+ ### 3. Push Back When Warranted
75
+
76
+ You are not a yes-machine. When an approach has clear problems:
77
+
78
+ - Point out the issue directly
79
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
80
+ - Propose an alternative
81
+ - Accept the human's decision if they override with full information
82
+
83
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
84
+
85
+ ### 4. Enforce Simplicity
86
+
87
+ Your natural tendency is to overcomplicate. Actively resist it.
88
+
89
+ Before finishing any implementation, ask:
90
+ - Can this be done in fewer lines?
91
+ - Are these abstractions earning their complexity?
92
+ - Would a staff engineer look at this and say "why didn't you just..."?
93
+
94
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
95
+
96
+ ### 5. Maintain Scope Discipline
97
+
98
+ Touch only what you're asked to touch.
99
+
100
+ Do NOT:
101
+ - Remove comments you don't understand
102
+ - "Clean up" code orthogonal to the task
103
+ - Refactor adjacent systems as a side effect
104
+ - Delete code that seems unused without explicit approval
105
+ - Add features not in the spec because they "seem useful"
106
+
107
+ Your job is surgical precision, not unsolicited renovation.
108
+
109
+ ### 6. Verify, Don't Assume
110
+
111
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
112
+
113
+ Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
114
+
115
+ ## Failure Modes to Avoid
116
+
117
+ These are the subtle errors that look like productivity but create problems:
118
+
119
+ 1. Making wrong assumptions without checking
120
+ 2. Not managing your own confusion — plowing ahead when lost
121
+ 3. Not surfacing inconsistencies you notice
122
+ 4. Not presenting tradeoffs on non-obvious decisions
123
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
124
+ 6. Overcomplicating code and APIs
125
+ 7. Modifying code or comments orthogonal to the task
126
+ 8. Removing things you don't fully understand
127
+ 9. Building without a spec because "it's obvious"
128
+ 10. Skipping verification because "it looks right"
129
+
130
+ ## Skill Rules
131
+
132
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
133
+
134
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
135
+
136
+ 3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
137
+
138
+ 4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
139
+
140
+ ## Lifecycle Sequence
141
+
142
+ For a complete feature, the typical skill sequence is:
143
+
144
+ ```
145
+ 1. interview-me → Extract what the user actually wants
146
+ 2. idea-refine → Refine vague ideas
147
+ 3. spec-driven-development → Define what we're building
148
+ 4. planning-and-task-breakdown → Break into verifiable chunks
149
+ 5. context-engineering → Load the right context
150
+ 6. source-driven-development → Verify against official docs
151
+ 7. incremental-implementation → Build slice by slice
152
+ 8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
153
+ 9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
154
+ 10. test-driven-development → Prove each slice works
155
+ 11. code-review-and-quality → Review before merge
156
+ 12. code-simplification → Reduce unnecessary complexity while preserving behavior
157
+ 13. git-workflow-and-versioning → Clean commit history
158
+ 14. documentation-and-adrs → Document decisions
159
+ 15. deprecation-and-migration → Retire old systems and move users safely when needed
160
+ 16. shipping-and-launch → Deploy safely
161
+ ```
162
+
163
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
164
+
165
+ ## Quick Reference
166
+
167
+ | Phase | Skill | One-Line Summary |
168
+ |-------|-------|-----------------|
169
+ | Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
170
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
171
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
172
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
173
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
174
+ | Build | source-driven-development | Verify against official docs before implementing |
175
+ | Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
176
+ | Build | context-engineering | Right context at the right time |
177
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
178
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
179
+ | Verify | test-driven-development | Failing test first, then make it pass |
180
+ | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
181
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
182
+ | Review | code-review-and-quality | Five-axis review with quality gates |
183
+ | Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
184
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
185
+ | Review | performance-optimization | Measure first, optimize only what matters |
186
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
187
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
188
+ | Ship | deprecation-and-migration | Remove old systems and migrate users safely |
189
+ | Ship | documentation-and-adrs | Document the why, not just the what |
190
+ | Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
191
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Agent Fleet changelog
2
2
 
3
+ ## 2.0.4
4
+
5
+ ### Patch Changes
6
+
7
+ - fc8be3e: Check the `.pi/extensions`, `.pi/harnesses`, and `scripts` npm roots in `doctor`, and stop Fleet Pi launchers with actionable dependency remediation before extension import failures can surface as misleading unknown flags.
8
+ - e4f1957: Make `agent-fleet setup --allow-exec` include and run the consented runtime dependency steps instead of leaving them as skipped plan actions.
9
+
3
10
  ## 2.0.3
4
11
 
5
12
  ### Patch Changes
@@ -7,6 +7,7 @@
7
7
  ],
8
8
  "files": [
9
9
  "justfile",
10
+ "scripts/claude-code-preflight.ts",
10
11
  "scripts/codex-conductor.ts",
11
12
  "scripts/codex-remote-control.ts",
12
13
  "scripts/coms-claude-bridge.ts",
@@ -27,6 +28,7 @@
27
28
  "scripts/lib/monitor-env.ts",
28
29
  "scripts/lib/peer-launch.ts",
29
30
  "scripts/lib/persona-banner.ts",
31
+ "scripts/lib/runtime-dependencies.js",
30
32
  "scripts/lib/spawn-stagger.ts",
31
33
  "scripts/lib/team-project.ts",
32
34
  "scripts/lib/team-snapshot.ts"
package/bin/cli.js CHANGED
@@ -27,6 +27,7 @@ import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
27
27
  import { checkAndNotify } from "./lib/update-notifier.js";
28
28
  import { setHermesTelegram, runHermesCommand } from "./lib/set-hermes-telegram.js";
29
29
  import { setHermesWatchdog } from "./lib/set-hermes-watchdog.js";
30
+ import { runtimeDependencyFindings } from "../scripts/lib/runtime-dependencies.js";
30
31
 
31
32
  const __dirname = dirname(fileURLToPath(import.meta.url));
32
33
  const pkgRoot = resolve(__dirname, "..");
@@ -260,6 +261,7 @@ async function cmdSetup() {
260
261
  plan = buildReconcilePlan({ workspace, sourceRoot: pkgRoot, packageVersion: pkg.version, manifest,
261
262
  agent: opts.agent ?? "pi", method: opts.method, preset, features,
262
263
  saveDesired: opts["save-desired"], tuiDesired, dryRun,
264
+ allowExec: Boolean(opts["allow-exec"]),
263
265
  // The interactive selector and final exact-plan confirmation are the
264
266
  // migration consent. Automation retains every explicit gate.
265
267
  migrate: opts.migrate || interactiveMigration, yes: opts.yes || interactive,
@@ -316,6 +318,9 @@ async function cmdDoctor() {
316
318
  }
317
319
 
318
320
  const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape"]);
321
+ // These findings affect launch readiness and the doctor exit code, but npm
322
+ // execution remains behind its dedicated explicit-consent commands.
323
+ const MANUAL_FINDING_TYPES = new Set(["runtime-dependencies"]);
319
324
  const pendingTransaction = existsSync(journalPath(workspace));
320
325
  const unrecoverableJournal = recovery.pending && !recovery.recoverable;
321
326
  const plan = buildRepairPlan();
@@ -335,10 +340,24 @@ async function cmdDoctor() {
335
340
  issue: "transaction backup is missing or unreadable", fix: "discard installer-owned journal with doctor --fix",
336
341
  });
337
342
 
338
- const fixable = findings.filter((f) => !ADVISORY_FINDING_TYPES.has(f.type) && f.type !== "unrecoverable-transaction");
339
- const advisory = findings.length - fixable.length;
343
+ const manual = findings.filter((f) => MANUAL_FINDING_TYPES.has(f.type));
344
+ const fixable = findings.filter((f) =>
345
+ !ADVISORY_FINDING_TYPES.has(f.type) &&
346
+ !MANUAL_FINDING_TYPES.has(f.type) &&
347
+ f.type !== "unrecoverable-transaction"
348
+ );
349
+ const advisory = findings.length - fixable.length - manual.length;
340
350
  const pendingRuntime = readState(workspace)?.runtimeRepairs ?? [];
341
- const outstanding = repairs.length + fixable.length + (pendingTransaction ? 1 : 0) + pendingRuntime.length;
351
+ const repairRoot = (repair) => {
352
+ const index = repair?.args?.indexOf("--prefix") ?? -1;
353
+ const value = index >= 0 ? repair.args[index + 1] : null;
354
+ return typeof value === "string" ? value.replaceAll("\\", "/").replace(/^\.\//, "") : null;
355
+ };
356
+ // A failed setup exec already records one retryable repair. The matching npm
357
+ // finding describes the same broken root and must not double the exit count.
358
+ const pendingDependencyRoots = new Set(pendingRuntime.map(repairRoot).filter(Boolean));
359
+ const manualOutstanding = manual.filter((finding) => !pendingDependencyRoots.has(finding.root));
360
+ const outstanding = repairs.length + fixable.length + manualOutstanding.length + (pendingTransaction ? 1 : 0) + pendingRuntime.length;
342
361
 
343
362
  // The report comes first, then the question. Asking "apply 7 fixes?" before
344
363
  // naming them is asking for a blind yes.
@@ -355,6 +374,9 @@ async function cmdDoctor() {
355
374
  if (findings.length > 0) {
356
375
  printSection(`Scan findings (${findings.length})`);
357
376
  console.log(formatFindingsTable(findings));
377
+ if (manual.length > 0) {
378
+ console.log(`\n(${manual.length} launch-blocking dependency finding(s) — use the explicit remediation above; doctor --fix never runs an unplanned npm install)`);
379
+ }
358
380
  if (advisory > 0) {
359
381
  console.log(`\n(${advisory} advisory — fix by hand per the suggestions above; never auto-applied)`);
360
382
  }
@@ -374,10 +396,23 @@ async function cmdDoctor() {
374
396
  if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true });
375
397
  }
376
398
 
399
+ const runtimeRepairOutput = (line) => (opts.json ? console.error : console.log)(`exec: ${line}`);
377
400
  const runtimeRepair = willFix
378
- ? retryRuntimeRepairs({ workspace, output: (line) => console.log(`exec: ${line}`) })
401
+ ? retryRuntimeRepairs({ workspace, output: runtimeRepairOutput })
379
402
  : { attempted: 0, remaining: pendingRuntime };
380
403
 
404
+ let remainingManual = manualOutstanding;
405
+ if (willFix && manual.length > 0) {
406
+ // A recorded npm repair may exit zero without actually producing a healthy
407
+ // tree. Re-run the shared probe and keep any such root outstanding.
408
+ const remainingRepairRoots = new Set(runtimeRepair.remaining.map(repairRoot).filter(Boolean));
409
+ remainingManual = runtimeDependencyFindings({ workspace })
410
+ .filter((finding) => !remainingRepairRoots.has(finding.root));
411
+ }
412
+ const remainingAfterFix = willFix
413
+ ? remainingManual.length + (scanRepair?.skipped ?? 0) + (applied?.summary.failed ?? 0) + runtimeRepair.remaining.length
414
+ : outstanding;
415
+
381
416
  const report = {
382
417
  schemaVersion: 1,
383
418
  verb: "doctor",
@@ -398,9 +433,10 @@ async function cmdDoctor() {
398
433
  summary: {
399
434
  repairs: repairs.length,
400
435
  fixable: fixable.length,
436
+ manual: manual.length,
401
437
  advisories: advisory,
402
- fixed: willFix ? outstanding - (scanRepair?.skipped ?? 0) - (applied?.summary.failed ?? 0) : 0,
403
- outstanding: willFix ? (scanRepair?.skipped ?? 0) + (applied?.summary.failed ?? 0) + runtimeRepair.remaining.length : outstanding,
438
+ fixed: willFix ? Math.max(0, outstanding - remainingAfterFix) : 0,
439
+ outstanding: remainingAfterFix,
404
440
  },
405
441
  };
406
442
 
@@ -410,7 +446,7 @@ async function cmdDoctor() {
410
446
  }
411
447
 
412
448
  if (outstanding === 0) {
413
- console.log("\n✓ Nothing to repair: no broken recorded items, no broken symlinks, no stale persona references.");
449
+ console.log("\n✓ Nothing to repair: recorded items and runtime dependency roots are healthy.");
414
450
  exit(0);
415
451
  }
416
452
 
@@ -418,8 +454,10 @@ async function cmdDoctor() {
418
454
  if (!willFix) {
419
455
  console.log(
420
456
  opts["dry-run"]
421
- ? `${outstanding} repairable issue(s) found (--dry-run: nothing was written).`
422
- : `${outstanding} repairable issue(s) found. Re-run with --fix to apply them.`,
457
+ ? `${outstanding} actionable issue(s) found (--dry-run: nothing was written).`
458
+ : manual.length > 0
459
+ ? `${outstanding} actionable issue(s) found. Follow the dependency remediation above; re-run with --fix for auto-fixable items.`
460
+ : `${outstanding} repairable issue(s) found. Re-run with --fix to apply them.`,
423
461
  );
424
462
  exit(2);
425
463
  }
package/bin/lib/doctor.js CHANGED
@@ -20,6 +20,9 @@
20
20
  // 6. Model visibility — persona, delegate sub-role, and voices.yaml models
21
21
  // that a clean-room `pi --no-extensions` child cannot see. Read-only:
22
22
  // never auto-fixed. A missing voices.yaml is not a finding.
23
+ // 7. Runtime dependencies — each installed npm root is checked with `npm ls`.
24
+ // Missing/broken dependencies are actionable but never auto-installed by
25
+ // doctor; use the explicit dependency or setup execution consent path.
23
26
  //
24
27
  // For each broken link we look up a canonical replacement in the source
25
28
  // `agents/` or `skills/` tree (many breakages are stale names from the
@@ -31,6 +34,7 @@ import { homedir } from "node:os";
31
34
  import { parse as parseYaml } from "yaml";
32
35
  import { validateOverrides } from "./validate-overrides.js";
33
36
  import { readState, STATE_REL_PATH } from "./state.js";
37
+ import { runtimeDependencyFindings } from "../../scripts/lib/runtime-dependencies.js";
34
38
 
35
39
  export const AGENT_FLEET_PACKAGE_NAME = "@chankov/agent-fleet";
36
40
  const AGENT_FLEET_PACKAGE_PATTERN = /(^|[/:])@chankov\/agent-fleet(@[^/]*)?$/;
@@ -78,7 +82,7 @@ const YAML_REFS = [
78
82
  * @param {boolean} [opts.apply] If true, apply suggested fixes; otherwise just report
79
83
  * @returns {Array|object} Findings array (apply=false) or {repaired,deleted,skipped} (apply=true)
80
84
  */
81
- export async function runDoctor({ workspace, sourceRoot, apply = false, checkVisibility } = {}) {
85
+ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVisibility, checkDependencies } = {}) {
82
86
  const findings = [];
83
87
 
84
88
  // 1. Broken symlinks in install-target directories.
@@ -162,6 +166,10 @@ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVis
162
166
  // 6. Model visibility for roster personas, delegate sub-roles, and voices.yaml.
163
167
  findings.push(...await scanModelVisibility({ workspace, checkVisibility }));
164
168
 
169
+ // 7. Every installed npm root must have its own complete dependency tree.
170
+ // Node module resolution cannot borrow a sibling root's node_modules.
171
+ findings.push(...runtimeDependencyFindings({ workspace, run: checkDependencies }));
172
+
165
173
  if (!apply) return findings;
166
174
 
167
175
  // ── Apply ──────────────────────────────────────────────────────────────
@@ -579,7 +587,31 @@ export function collectModelTargets(workspace) {
579
587
  catch { /* unreadable persona is not a visibility finding */ }
580
588
  }
581
589
  }
582
- targets.push(...collectVoiceTargets(workspace));
590
+ targets.push(...collectVoiceTargets(workspace), ...collectProfileTargets(workspace));
591
+ return targets;
592
+ }
593
+
594
+ function collectProfileTargets(workspace) {
595
+ const path = ".pi/agents/model-profiles.yaml", file = join(workspace, path);
596
+ if (!existsSync(file)) return [];
597
+ let profiles;
598
+ try { profiles = parseYaml(readFileSync(file, "utf8")); } catch { return []; }
599
+ if (!profiles || typeof profiles !== "object" || Array.isArray(profiles)) return [];
600
+ const targets = [];
601
+ const add = (subject, selection) => {
602
+ const model = typeof selection === "string" ? selection : selection?.model;
603
+ if (typeof model === "string") targets.push({ kind: "profile", subject, model, path });
604
+ };
605
+ for (const [name, profile] of Object.entries(profiles)) {
606
+ if (!profile || typeof profile !== "object" || Array.isArray(profile)) continue;
607
+ if (profile.version !== 2) { for (const [persona, model] of Object.entries(profile)) add(`${name}/${persona}`, model); continue; }
608
+ add(`${name}/defaults`, profile.defaults);
609
+ add(`${name}/dispatcher`, profile.dispatcher);
610
+ for (const [persona, value] of Object.entries(profile.agents ?? {})) add(`${name}/${persona}`, value);
611
+ for (const [persona, roles] of Object.entries(profile.subagents ?? {})) for (const [role, value] of Object.entries(roles ?? {})) add(`${name}/${persona}/${role}`, value);
612
+ for (const [service, value] of Object.entries(profile.services ?? {})) add(`${name}/${service}`, value);
613
+ if (Array.isArray(profile.panel)) for (const voice of profile.panel) add(`${name}/panel/${voice?.name}`, voice);
614
+ }
583
615
  return targets;
584
616
  }
585
617
 
@@ -650,6 +682,7 @@ function parsePersonaModelTargets(absPath, relPath) {
650
682
  }
651
683
 
652
684
  function subjectLabel(target) {
685
+ if (target.kind === "profile") return `profile "${target.subject}"`;
653
686
  if (target.kind === "voice") return `voice "${target.subject}"`;
654
687
  if (target.kind === "subagent") return `subagent "${target.subject}"`;
655
688
  return `persona "${target.subject}"`;
@@ -14,7 +14,8 @@ import { appendEnvPlaceholders, renderSttConfig } from "./stt-wizard.js";
14
14
  export function buildReconcilePlan(opts) {
15
15
  const { workspace, manifest, sourceRoot, packageVersion, agent = "pi", method,
16
16
  preset, features, saveDesired = false, tuiDesired = null, dryRun = false,
17
- migrate = false, yes = false, accept = null, platform = process.platform } = opts;
17
+ migrate = false, yes = false, accept = null, allowExec = false,
18
+ platform = process.platform } = opts;
18
19
  const state = readState(workspace);
19
20
  const desiredPath = join(workspace, DESIRED_FILE);
20
21
  const firstMigration = Boolean(state && !existsSync(desiredPath));
@@ -33,7 +34,7 @@ export function buildReconcilePlan(opts) {
33
34
  agent, platform,
34
35
  });
35
36
  const base = buildPlan({ workspace, sourceRoot, packageVersion, manifest, verb: "install", agent,
36
- method, items: featureResult.roots, accept, platform });
37
+ method, items: featureResult.roots, accept, allowExec, platform });
37
38
  const wanted = new Set(featureResult.selected);
38
39
  const overrides = planOverrides(workspace, scanProject(workspace));
39
40
  const sttConfig = featureResult.features.includes("voice")
@@ -471,3 +471,77 @@ AZURE_SPEECH_KEY=<your-resource-key>
471
471
 
472
472
  For the OpenAI-compatible backend, `provider.type` is `openai` with `baseUrl` / `model` and an
473
473
  `OPENAI_API_KEY` env var instead. Full schema: [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
474
+
475
+ ### Complete model profiles
476
+
477
+ `/af-models <name>` reads `.pi/agents/model-profiles.yaml`. Flat persona-to-model
478
+ maps remain supported and keep their declared-candidate validation. A `version: 2`
479
+ profile declares the whole execution model set independently of
480
+ `.ai/agent-fleet-overrides.md`:
481
+
482
+ ```yaml
483
+ local-duo:
484
+ version: 2
485
+ defaults:
486
+ model: &laguna omlx/Laguna-XS-2.1-4bit
487
+ thinking: off
488
+ allowed-models:
489
+ - *laguna
490
+ - &qwen omlx/Qwen3.8-9B-heretic-uncensored-5bit-MLX
491
+ fallback: none
492
+ routing: native
493
+ dispatcher: *laguna
494
+ agents:
495
+ documenter: *qwen
496
+ subagents:
497
+ code-reviewer:
498
+ docs: *qwen
499
+ test-engineer:
500
+ conventions: *qwen
501
+ services:
502
+ watchdog: *laguna
503
+ return-extractor: *qwen
504
+ panel:
505
+ - { name: laguna, model: *laguna, integrator: true }
506
+ - { name: qwen, model: *qwen }
507
+ ```
508
+
509
+ - `defaults` supplies **every persona and every declared child**, including future
510
+ personas, research helpers and team changes. `agents` and `subagents` contain
511
+ exceptions. Each selection accepts a model string or `{model, thinking}`.
512
+ Unspecified thinking inherits defaults, then `off`. Tool caps and delegation
513
+ depth remain unchanged. Unknown persona/child names are rejected.
514
+ - `dispatcher` changes the current Pi session's model and thinking. It defaults
515
+ to `defaults`; an `orchestrator` persona entry alone is not the live dispatcher.
516
+ - `services` sets the watchdog and structured-return extractor independently;
517
+ unspecified services use defaults. `panel` supplies 2–5 poll/debate voices and
518
+ an optional single integrator. `/af-poll` and `/af-debate` select the active
519
+ profile's panel automatically. Explicit other panel names are refused while
520
+ the complete profile is active. Without `panel`, two default-model voices are used.
521
+ - `routing: native` (default) bypasses configured standing peers and refuses explicit
522
+ coms dispatch, handoff, coms_send and peer spawning. Existing peer processes are
523
+ not reconfigured or stopped. `routing: configured` opts into the existing dispatch
524
+ policy and cannot be combined with `allowed-models`, since a peer's children
525
+ cannot be verified by this hub.
526
+ - `fallback: none` (default) disables automatic original-model fallback, including
527
+ nested children and workflows. `declared` retains it. Optional `allowed-models`
528
+ is an exact provider/model allowlist checked before actual child spawns and
529
+ fallback attempts. Manual model pickers and session substitutions respect it.
530
+ This governs Fleet model execution; it is not an OS/network sandbox for arbitrary
531
+ shell commands or unrelated applications.
532
+
533
+ Activation validates the complete profile and Pi availability of its referenced
534
+ models before changing settings. Missing models leave the previous configuration
535
+ in place. Busy dispatchers, agents and poll/debate runs refuse switching: wait for
536
+ completion first. On leaving a complete profile, the previous dispatcher, thinking
537
+ and manual model/sub-role/substitution settings are restored before applying the
538
+ next profile. A fresh Pi session clears the active profile; select it again there.
539
+
540
+ The profile is passed through the owned process tree. Workflow commands started
541
+ from that session inherit its persona models, thinking, panel and fallback policy.
542
+ Separately started fleet sessions/standing peers retain their own configuration.
543
+ The bundled `local-duo` profile explicitly covers all shipped child roles and needs
544
+ no project model overrides. Both exact model IDs must be registered in Pi and
545
+ served locally by oMLX. Selecting a profile does not download or register models.
546
+ The `omlx` provider has a default concurrency limit of two per Pi process;
547
+ `AGENT_HUB_PROVIDER_LIMITS` can override it.
@@ -109,6 +109,11 @@ Older releases used the ambiguous name-only path `~/.pi/coms/cli/<name>/`. If th
109
109
 
110
110
  ## Behavior notes
111
111
 
112
+ - **Executable preflight:** a standalone `fleet peer` requires `claude --version`
113
+ to succeed before it creates a pane, so a missing CLI or partial npm install
114
+ fails directly instead of surfacing as a 45-second registration timeout. Team
115
+ layouts and direct `_claude-peer` calls repeat the check inside each created
116
+ pane before starting its bridge; their failure remains visible in that pane.
112
117
  - **Serialization:** one prompt at a time per pane; queue depth shows in the peer's
113
118
  agent card and the herdr sidebar (`q<depth>`).
114
119
  - **Presence:** the bridge annotates its pane through the shared `HerdrPresence`
@@ -38,6 +38,11 @@ just fleet doctor # exit 0 = nothing to repair
38
38
 
39
39
  (Or pass `--allow-exec` to setup and let it run them in the same pass.)
40
40
 
41
+ `doctor` validates all three roots with `npm ls`. The launcher repeats that
42
+ read-only preflight before Pi starts and points back to `just fleet deps` or
43
+ `setup --allow-exec` instead of allowing a missing import to surface later as a
44
+ misleading unknown command-line option.
45
+
41
46
  ## First session
42
47
 
43
48
  ```bash
@@ -43,10 +43,10 @@ package-entry mode — `setup --help` lists them.
43
43
 
44
44
  ### Then install the runtime dependencies
45
45
 
46
- Setup writes files; it does not run commands for you. The two `npm` steps that
47
- the harnesses and extensions need are planned as `skip` with the reason *"runs a
48
- command — re-run with `--allow-exec` to include it"*. **A workspace is not
49
- launchable until they run.** Either let setup run them:
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
50
 
51
51
  ```bash
52
52
  npx @chankov/agent-fleet@latest setup --preset default --features none --allow-exec --yes
@@ -59,6 +59,13 @@ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
59
59
  just fleet doctor # confirm the workspace is whole
60
60
  ```
61
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
+
62
69
  ### Verify the result
63
70
 
64
71
  ```bash
@@ -286,7 +293,7 @@ reads.
286
293
  |---|---|
287
294
  | `0` | Success, or nothing to do |
288
295
  | `1` | Could not run |
289
- | `2` | `doctor` found repairable issues |
296
+ | `2` | `doctor` found repairable or launch-blocking manual-action issues |
290
297
  | `3` | `setup` hit unresolved conflicts and wrote nothing |
291
298
 
292
299
  See [Migration](MIGRATION-agent-fleet.md) for the full major-release matrix.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "packageVersion": "2.0.3",
3
+ "packageVersion": "2.0.4",
4
4
  "groups": [
5
5
  {
6
6
  "id": "skills",
@@ -613,6 +613,7 @@
613
613
  "source": [
614
614
  "hermes/skills",
615
615
  "systemd",
616
+ "scripts/claude-code-preflight.ts",
616
617
  "scripts/codex-conductor.ts",
617
618
  "scripts/codex-remote-control.ts",
618
619
  "scripts/coms-claude-bridge.ts",
@@ -629,6 +630,7 @@
629
630
  "scripts/lib/monitor-env.ts",
630
631
  "scripts/lib/peer-launch.ts",
631
632
  "scripts/lib/persona-banner.ts",
633
+ "scripts/lib/runtime-dependencies.js",
632
634
  "scripts/lib/spawn-stagger.ts",
633
635
  "scripts/lib/team-project.ts",
634
636
  "scripts/lib/team-snapshot.ts",
package/justfile CHANGED
@@ -183,7 +183,7 @@ _peer-plus extensions persona name="" model="" session="" project="default":
183
183
  # The bridge registers the pane as coms peer <name>; the trailing session
184
184
  # positional maps to `claude --resume <id>` for `just fleet resume`.
185
185
  _claude-peer name model="" session="" project="default":
186
- {{node_ts}} scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
186
+ {{node_ts}} scripts/claude-code-preflight.ts || exit $?; {{node_ts}} scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
187
187
 
188
188
  # The hidden team implementations take the team as a positional arg (default "full")
189
189
  # and pass everything after it straight to the script.