@chankov/agent-fleet 2.0.2 → 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 (873) 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 +30 -33
  4. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +1 -1
  5. package/.pi/harnesses/agent-hub/config/agents.ts +13 -14
  6. package/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  7. package/.pi/harnesses/agent-hub/config/overrides.ts +2 -7
  8. package/.pi/harnesses/agent-hub/dispatch-coms.ts +6 -4
  9. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +6 -3
  10. package/.pi/harnesses/agent-hub/dispatch-native.ts +4 -1
  11. package/.pi/harnesses/agent-hub/index.ts +75 -34
  12. package/.pi/harnesses/agent-hub/input/completions.ts +2 -2
  13. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +7 -9
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/policy/models.ts +35 -8
  16. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  17. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  18. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  19. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  20. package/.pi/harnesses/agent-hub/research/controls.ts +15 -16
  21. package/.pi/harnesses/agent-hub/research/runtime.ts +30 -39
  22. package/.pi/harnesses/agent-hub/research/spawn-run.ts +109 -111
  23. package/.pi/harnesses/agent-hub/spawn.ts +17 -1
  24. package/.pi/harnesses/agent-hub/tools/action-executors.ts +2 -0
  25. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +2 -3
  26. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -0
  27. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +7 -4
  28. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +0 -7
  29. package/.pi/harnesses/agent-hub/ui/grid.ts +21 -183
  30. package/.pi/harnesses/coms/package.json +1 -1
  31. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  32. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +23 -12
  33. package/.versions/2.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  34. package/.versions/2.0.3/.pi/agents/model-profiles.yaml +27 -0
  35. package/.versions/2.0.3/.pi/agents/peers.yaml +142 -0
  36. package/.versions/2.0.3/.pi/agents/teams.yaml +41 -0
  37. package/.versions/2.0.3/.pi/agents/voices.yaml +13 -0
  38. package/.versions/2.0.3/.pi/damage-control-rules.yaml +297 -0
  39. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  40. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  41. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  42. package/.versions/2.0.3/.pi/extensions/btw/README.md +120 -0
  43. package/.versions/2.0.3/.pi/extensions/btw/index.ts +914 -0
  44. package/.versions/2.0.3/.pi/extensions/btw/package.json +6 -0
  45. package/.versions/2.0.3/.pi/extensions/btw/state.js +179 -0
  46. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  47. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  48. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  49. package/.versions/2.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  50. package/.versions/2.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  51. package/.versions/2.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  52. package/.versions/2.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  53. package/.versions/2.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  54. package/.versions/2.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  55. package/.versions/2.0.3/.pi/extensions/package-lock.json +1175 -0
  56. package/.versions/2.0.3/.pi/extensions/package.json +9 -0
  57. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  58. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  59. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  60. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  61. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  62. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  63. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  64. package/.versions/2.0.3/.pi/harnesses/agent-hub/README.md +1158 -0
  65. package/.versions/2.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  66. package/.versions/2.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  67. package/.versions/2.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  68. package/.versions/2.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  69. package/.versions/2.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  70. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  71. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  72. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  73. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  74. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  75. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  76. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  77. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  78. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  79. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  80. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  81. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  82. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  83. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  84. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  85. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  86. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  87. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  88. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  89. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  90. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  91. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  92. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  93. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  94. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  95. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  96. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/agents.ts +180 -0
  97. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  98. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  99. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  100. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  101. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  102. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  103. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  104. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  105. package/.versions/2.0.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  106. package/.versions/2.0.3/.pi/harnesses/agent-hub/delegate.ts +446 -0
  107. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  108. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  109. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  110. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  111. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  112. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  113. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  114. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  115. package/.versions/2.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  116. package/.versions/2.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  117. package/.versions/2.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  118. package/.versions/2.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  119. package/.versions/2.0.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  120. package/.versions/2.0.3/.pi/harnesses/agent-hub/footer.ts +30 -0
  121. package/.versions/2.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  122. package/.versions/2.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  123. package/.versions/2.0.3/.pi/harnesses/agent-hub/index.ts +2036 -0
  124. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  125. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  126. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  127. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  128. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  129. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  130. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  131. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  132. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  133. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  134. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  135. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  136. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  137. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  138. package/.versions/2.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  139. package/.versions/2.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  140. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  141. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  142. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  143. package/.versions/2.0.3/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  144. package/.versions/2.0.3/.pi/harnesses/agent-hub/presentation.ts +48 -0
  145. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  146. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  147. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  148. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  149. package/.versions/2.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  150. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  151. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  152. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/spawn-run.ts +143 -0
  153. package/.versions/2.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  154. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  155. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  156. package/.versions/2.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  157. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  158. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  159. package/.versions/2.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  160. package/.versions/2.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  161. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  162. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
  163. package/.versions/2.0.3/.pi/harnesses/agent-hub/spawn.ts +388 -0
  164. package/.versions/2.0.3/.pi/harnesses/agent-hub/timeline.ts +54 -0
  165. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  166. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  167. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  168. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  169. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  170. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  171. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  172. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  173. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  174. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  175. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  176. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  177. package/.versions/2.0.3/.pi/harnesses/agent-hub/types.ts +61 -0
  178. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  179. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  180. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  181. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  182. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  183. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  184. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  185. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  186. package/.versions/2.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  187. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  188. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  189. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  190. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  191. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  192. package/.versions/2.0.3/.pi/harnesses/coms/README.md +100 -0
  193. package/.versions/2.0.3/.pi/harnesses/coms/index.ts +276 -0
  194. package/.versions/2.0.3/.pi/harnesses/coms/package.json +7 -0
  195. package/.versions/2.0.3/.pi/harnesses/coms/version.ts +42 -0
  196. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  197. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  198. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  199. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  200. package/.versions/2.0.3/.pi/harnesses/lib/coms-core-io.ts +385 -0
  201. package/.versions/2.0.3/.pi/harnesses/lib/coms-core.ts +577 -0
  202. package/.versions/2.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  203. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  204. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  205. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  206. package/.versions/2.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  207. package/.versions/2.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  208. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  209. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  210. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  211. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  212. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  213. package/.versions/2.0.3/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  214. package/.versions/2.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  215. package/.versions/2.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  216. package/.versions/2.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  217. package/.versions/2.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  218. package/.versions/2.0.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  219. package/.versions/2.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  220. package/.versions/2.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  221. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  222. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  223. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  224. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  225. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  226. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  227. package/.versions/2.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  228. package/.versions/2.0.3/.pi/harnesses/package-lock.json +2039 -0
  229. package/.versions/2.0.3/.pi/harnesses/package.json +10 -0
  230. package/.versions/2.0.3/.pi/prompts/af-build.md +24 -0
  231. package/.versions/2.0.3/.pi/prompts/af-code-simplify.md +22 -0
  232. package/.versions/2.0.3/.pi/prompts/af-plan.md +17 -0
  233. package/.versions/2.0.3/.pi/prompts/af-review.md +16 -0
  234. package/.versions/2.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  235. package/.versions/2.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  236. package/.versions/2.0.3/.pi/prompts/af-ship.md +17 -0
  237. package/.versions/2.0.3/.pi/prompts/af-spec.md +15 -0
  238. package/.versions/2.0.3/.pi/prompts/af-test.md +19 -0
  239. package/.versions/2.0.3/.pi/skills/bowser/SKILL.md +145 -0
  240. package/.versions/2.0.3/.version +1 -0
  241. package/.versions/2.0.3/agents/architect.md +25 -0
  242. package/.versions/2.0.3/agents/bowser.md +28 -0
  243. package/.versions/2.0.3/agents/builder.md +56 -0
  244. package/.versions/2.0.3/agents/code-reviewer.md +210 -0
  245. package/.versions/2.0.3/agents/deep-researcher.md +33 -0
  246. package/.versions/2.0.3/agents/documenter.md +22 -0
  247. package/.versions/2.0.3/agents/orchestrator.md +23 -0
  248. package/.versions/2.0.3/agents/plan-reviewer.md +84 -0
  249. package/.versions/2.0.3/agents/planner.md +105 -0
  250. package/.versions/2.0.3/agents/releaser.md +25 -0
  251. package/.versions/2.0.3/agents/researcher.md +31 -0
  252. package/.versions/2.0.3/agents/security-auditor.md +168 -0
  253. package/.versions/2.0.3/agents/test-engineer.md +154 -0
  254. package/.versions/2.0.3/agents/web-debugger.md +44 -0
  255. package/.versions/2.0.3/agents/web-performance-auditor.md +194 -0
  256. package/.versions/2.0.3/bin/catalog/harness-runtime-closure.json +34 -0
  257. package/.versions/2.0.3/codex/CONDUCTOR.md +148 -0
  258. package/.versions/2.0.3/docs/ARCHITECTURE.md +407 -0
  259. package/.versions/2.0.3/docs/agent-fleet-setup.md +473 -0
  260. package/.versions/2.0.3/docs/claude-code-coms-bridge.md +128 -0
  261. package/.versions/2.0.3/docs/codex-remote-conductor.md +170 -0
  262. package/.versions/2.0.3/docs/coms-hermes-bridge.md +189 -0
  263. package/.versions/2.0.3/docs/getting-started.md +119 -0
  264. package/.versions/2.0.3/docs/npm-install.md +292 -0
  265. package/.versions/2.0.3/docs/pi-extensions.md +447 -0
  266. package/.versions/2.0.3/docs/pi-setup.md +74 -0
  267. package/.versions/2.0.3/docs/skill-anatomy.md +150 -0
  268. package/.versions/2.0.3/hermes/README.md +347 -0
  269. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  270. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  271. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  272. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  273. package/.versions/2.0.3/hermes/gates/gate-o-capability.md +8 -0
  274. package/.versions/2.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  275. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  276. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  277. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  278. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  279. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  280. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  281. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  282. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  283. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  284. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  285. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  286. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  287. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  288. package/.versions/2.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  289. package/.versions/2.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  290. package/.versions/2.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  291. package/.versions/2.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  292. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  293. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  294. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  295. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  296. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  297. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  298. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  299. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  300. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  301. package/.versions/2.0.3/hermes/watchdog-tests/__init__.py +0 -0
  302. package/.versions/2.0.3/hooks/coms-stop-hook.mjs +84 -0
  303. package/.versions/2.0.3/install-manifest.json +2940 -0
  304. package/.versions/2.0.3/justfile +289 -0
  305. package/.versions/2.0.3/manifest-meta.json +969 -0
  306. package/.versions/2.0.3/references/accessibility-checklist.md +160 -0
  307. package/.versions/2.0.3/references/communication-contract.md +26 -0
  308. package/.versions/2.0.3/references/definition-of-done.md +67 -0
  309. package/.versions/2.0.3/references/fleet-coordination-patterns.md +171 -0
  310. package/.versions/2.0.3/references/observability-checklist.md +91 -0
  311. package/.versions/2.0.3/references/orchestration-patterns.md +370 -0
  312. package/.versions/2.0.3/references/performance-checklist.md +153 -0
  313. package/.versions/2.0.3/references/prompting-patterns.md +380 -0
  314. package/.versions/2.0.3/references/security-checklist.md +179 -0
  315. package/.versions/2.0.3/references/testing-patterns.md +236 -0
  316. package/.versions/2.0.3/references/workflow-authoring.md +304 -0
  317. package/.versions/2.0.3/scripts/codex-conductor.ts +41 -0
  318. package/.versions/2.0.3/scripts/codex-remote-control.ts +167 -0
  319. package/.versions/2.0.3/scripts/coms-claude-bridge.ts +411 -0
  320. package/.versions/2.0.3/scripts/coms-cli.ts +484 -0
  321. package/.versions/2.0.3/scripts/coms-hermes-bridge.ts +413 -0
  322. package/.versions/2.0.3/scripts/fleet.ts +199 -0
  323. package/.versions/2.0.3/scripts/flow.ts +137 -0
  324. package/.versions/2.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  325. package/.versions/2.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  326. package/.versions/2.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  327. package/.versions/2.0.3/scripts/install-hermes-plugin.sh +180 -0
  328. package/.versions/2.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  329. package/.versions/2.0.3/scripts/lib/codex-conductor.ts +88 -0
  330. package/.versions/2.0.3/scripts/lib/codex-remote-control.ts +482 -0
  331. package/.versions/2.0.3/scripts/lib/coms-envelope.ts +582 -0
  332. package/.versions/2.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  333. package/.versions/2.0.3/scripts/lib/fleet-command.ts +270 -0
  334. package/.versions/2.0.3/scripts/lib/flow-command.ts +93 -0
  335. package/.versions/2.0.3/scripts/lib/flow-maintenance.ts +230 -0
  336. package/.versions/2.0.3/scripts/lib/herdr-layout.ts +281 -0
  337. package/.versions/2.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  338. package/.versions/2.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  339. package/.versions/2.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  340. package/.versions/2.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  341. package/.versions/2.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  342. package/.versions/2.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  343. package/.versions/2.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  344. package/.versions/2.0.3/scripts/lib/monitor-env.ts +146 -0
  345. package/.versions/2.0.3/scripts/lib/peer-launch.ts +318 -0
  346. package/.versions/2.0.3/scripts/lib/persona-banner.ts +62 -0
  347. package/.versions/2.0.3/scripts/lib/spawn-stagger.ts +101 -0
  348. package/.versions/2.0.3/scripts/lib/team-project.ts +213 -0
  349. package/.versions/2.0.3/scripts/lib/team-snapshot.ts +147 -0
  350. package/.versions/2.0.3/scripts/package-lock.json +35 -0
  351. package/.versions/2.0.3/scripts/package.json +9 -0
  352. package/.versions/2.0.3/scripts/peer-banner.ts +40 -0
  353. package/.versions/2.0.3/scripts/peer-launch.ts +259 -0
  354. package/.versions/2.0.3/scripts/team-snapshot.ts +237 -0
  355. package/.versions/2.0.3/scripts/team-up.ts +406 -0
  356. package/.versions/2.0.3/scripts/workflows/lib/agent-phase.ts +132 -0
  357. package/.versions/2.0.3/scripts/workflows/lib/changes.ts +61 -0
  358. package/.versions/2.0.3/scripts/workflows/lib/debate.ts +149 -0
  359. package/.versions/2.0.3/scripts/workflows/lib/env.ts +34 -0
  360. package/.versions/2.0.3/scripts/workflows/lib/envelopes.ts +169 -0
  361. package/.versions/2.0.3/scripts/workflows/lib/gates.ts +81 -0
  362. package/.versions/2.0.3/scripts/workflows/lib/git.ts +96 -0
  363. package/.versions/2.0.3/scripts/workflows/lib/merge.ts +95 -0
  364. package/.versions/2.0.3/scripts/workflows/lib/model-visibility.ts +92 -0
  365. package/.versions/2.0.3/scripts/workflows/lib/permissions.ts +130 -0
  366. package/.versions/2.0.3/scripts/workflows/lib/personas.ts +54 -0
  367. package/.versions/2.0.3/scripts/workflows/lib/poll.ts +86 -0
  368. package/.versions/2.0.3/scripts/workflows/lib/quality.ts +64 -0
  369. package/.versions/2.0.3/scripts/workflows/lib/run.ts +108 -0
  370. package/.versions/2.0.3/scripts/workflows/lib/trace.ts +34 -0
  371. package/.versions/2.0.3/scripts/workflows/lib/voices.ts +125 -0
  372. package/.versions/2.0.3/scripts/workflows/lib/writer-lease.ts +112 -0
  373. package/.versions/2.0.3/scripts/workflows/tsconfig.json +22 -0
  374. package/.versions/2.0.3/scripts/workflows/wf-build-test.ts +61 -0
  375. package/.versions/2.0.3/scripts/workflows/wf-debate.ts +87 -0
  376. package/.versions/2.0.3/scripts/workflows/wf-document.ts +50 -0
  377. package/.versions/2.0.3/scripts/workflows/wf-poll.ts +95 -0
  378. package/.versions/2.0.3/scripts/workflows/wf-quality.ts +20 -0
  379. package/.versions/2.0.3/scripts/workflows/wf-scout.ts +38 -0
  380. package/.versions/2.0.3/skills/_internal/grilling.md +59 -0
  381. package/.versions/2.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  382. package/.versions/2.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  383. package/.versions/2.0.3/skills/compound-learning/SKILL.md +137 -0
  384. package/.versions/2.0.3/skills/context-engineering/SKILL.md +291 -0
  385. package/.versions/2.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  386. package/.versions/2.0.3/skills/designing-agents/SKILL.md +394 -0
  387. package/.versions/2.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  388. package/.versions/2.0.3/skills/drafting-workflows/SKILL.md +143 -0
  389. package/.versions/2.0.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  390. package/.versions/2.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  391. package/.versions/2.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  392. package/.versions/2.0.3/skills/idea-refine/SKILL.md +182 -0
  393. package/.versions/2.0.3/skills/idea-refine/examples.md +238 -0
  394. package/.versions/2.0.3/skills/idea-refine/frameworks.md +99 -0
  395. package/.versions/2.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  396. package/.versions/2.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  397. package/.versions/2.0.3/skills/incremental-implementation/SKILL.md +298 -0
  398. package/.versions/2.0.3/skills/interview-me/SKILL.md +226 -0
  399. package/.versions/2.0.3/skills/orchestration-verification/SKILL.md +181 -0
  400. package/.versions/2.0.3/skills/peer-coms/SKILL.md +90 -0
  401. package/.versions/2.0.3/skills/performance-optimization/SKILL.md +350 -0
  402. package/.versions/2.0.3/skills/planning-and-task-breakdown/SKILL.md +265 -0
  403. package/.versions/2.0.3/skills/security-and-hardening/SKILL.md +461 -0
  404. package/.versions/2.0.3/skills/spec-driven-development/SKILL.md +256 -0
  405. package/.versions/2.0.3/skills/using-agent-skills/SKILL.md +197 -0
  406. package/.versions/2.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  407. package/.versions/2.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  408. package/.versions/2.0.3/vendor/agent-skills-upstream/README.md +11 -0
  409. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  410. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  411. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  412. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  413. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  414. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  415. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  416. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  417. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  418. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  419. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  420. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  421. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  422. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  423. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  424. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  425. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  426. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  427. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  428. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  429. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  430. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  431. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  432. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  433. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  434. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  435. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  436. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  437. package/.versions/2.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  438. package/.versions/2.0.4/.pi/agents/model-profiles.yaml +78 -0
  439. package/.versions/2.0.4/.pi/agents/peers.yaml +145 -0
  440. package/.versions/2.0.4/.pi/agents/teams.yaml +41 -0
  441. package/.versions/2.0.4/.pi/agents/voices.yaml +13 -0
  442. package/.versions/2.0.4/.pi/damage-control-rules.yaml +297 -0
  443. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  444. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  445. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  446. package/.versions/2.0.4/.pi/extensions/btw/README.md +120 -0
  447. package/.versions/2.0.4/.pi/extensions/btw/index.ts +914 -0
  448. package/.versions/2.0.4/.pi/extensions/btw/package.json +6 -0
  449. package/.versions/2.0.4/.pi/extensions/btw/state.js +179 -0
  450. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  451. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  452. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  453. package/.versions/2.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  454. package/.versions/2.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  455. package/.versions/2.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  456. package/.versions/2.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  457. package/.versions/2.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  458. package/.versions/2.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  459. package/.versions/2.0.4/.pi/extensions/package-lock.json +1175 -0
  460. package/.versions/2.0.4/.pi/extensions/package.json +9 -0
  461. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  462. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  463. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  464. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  465. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  466. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  467. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  468. package/.versions/2.0.4/.pi/harnesses/agent-hub/README.md +1160 -0
  469. package/.versions/2.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  470. package/.versions/2.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  471. package/.versions/2.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  472. package/.versions/2.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  473. package/.versions/2.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  474. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  475. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  476. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  477. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  478. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  479. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  480. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  481. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  482. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  483. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  484. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  485. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  486. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  487. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  488. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  489. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  490. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  491. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  492. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  493. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  494. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  495. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  496. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  497. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  498. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  499. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  500. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  501. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  502. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  503. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  504. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  505. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  506. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  507. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  508. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  509. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  510. package/.versions/2.0.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  511. package/.versions/2.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  512. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  513. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  514. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  515. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  516. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  517. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  518. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native.ts +187 -0
  519. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  520. package/.versions/2.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  521. package/.versions/2.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  522. package/.versions/2.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  523. package/.versions/2.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  524. package/.versions/2.0.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  525. package/.versions/2.0.4/.pi/harnesses/agent-hub/footer.ts +30 -0
  526. package/.versions/2.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  527. package/.versions/2.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  528. package/.versions/2.0.4/.pi/harnesses/agent-hub/index.ts +2088 -0
  529. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  530. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  531. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  532. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  533. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  534. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  535. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  536. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  537. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  538. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  539. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  540. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  541. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  542. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  543. package/.versions/2.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  544. package/.versions/2.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  545. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  546. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  547. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  548. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  549. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  550. package/.versions/2.0.4/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  551. package/.versions/2.0.4/.pi/harnesses/agent-hub/presentation.ts +48 -0
  552. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  553. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  554. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  555. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  556. package/.versions/2.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  557. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  558. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  559. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/spawn-run.ts +144 -0
  560. package/.versions/2.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  561. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  562. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  563. package/.versions/2.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  564. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  565. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  566. package/.versions/2.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  567. package/.versions/2.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  568. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  569. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  570. package/.versions/2.0.4/.pi/harnesses/agent-hub/spawn.ts +404 -0
  571. package/.versions/2.0.4/.pi/harnesses/agent-hub/timeline.ts +54 -0
  572. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/action-executors.ts +148 -0
  573. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  574. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  575. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  576. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  577. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  578. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  579. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +84 -0
  580. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  581. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  582. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  583. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  584. package/.versions/2.0.4/.pi/harnesses/agent-hub/types.ts +61 -0
  585. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  586. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  587. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  588. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  589. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  590. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  591. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  592. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  593. package/.versions/2.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  594. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  595. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  596. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  597. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  598. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  599. package/.versions/2.0.4/.pi/harnesses/coms/README.md +100 -0
  600. package/.versions/2.0.4/.pi/harnesses/coms/index.ts +276 -0
  601. package/.versions/2.0.4/.pi/harnesses/coms/package.json +7 -0
  602. package/.versions/2.0.4/.pi/harnesses/coms/version.ts +42 -0
  603. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  604. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  605. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  606. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  607. package/.versions/2.0.4/.pi/harnesses/lib/coms-core-io.ts +385 -0
  608. package/.versions/2.0.4/.pi/harnesses/lib/coms-core.ts +577 -0
  609. package/.versions/2.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  610. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  611. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  612. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  613. package/.versions/2.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  614. package/.versions/2.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  615. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  616. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  617. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  618. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  619. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  620. package/.versions/2.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  621. package/.versions/2.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  622. package/.versions/2.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  623. package/.versions/2.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  624. package/.versions/2.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  625. package/.versions/2.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  626. package/.versions/2.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  627. package/.versions/2.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  628. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  629. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  630. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  631. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  632. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  633. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  634. package/.versions/2.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  635. package/.versions/2.0.4/.pi/harnesses/package-lock.json +2039 -0
  636. package/.versions/2.0.4/.pi/harnesses/package.json +10 -0
  637. package/.versions/2.0.4/.pi/prompts/af-build.md +24 -0
  638. package/.versions/2.0.4/.pi/prompts/af-code-simplify.md +22 -0
  639. package/.versions/2.0.4/.pi/prompts/af-plan.md +17 -0
  640. package/.versions/2.0.4/.pi/prompts/af-review.md +16 -0
  641. package/.versions/2.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  642. package/.versions/2.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  643. package/.versions/2.0.4/.pi/prompts/af-ship.md +17 -0
  644. package/.versions/2.0.4/.pi/prompts/af-spec.md +15 -0
  645. package/.versions/2.0.4/.pi/prompts/af-test.md +19 -0
  646. package/.versions/2.0.4/.pi/skills/bowser/SKILL.md +145 -0
  647. package/.versions/2.0.4/.version +1 -0
  648. package/.versions/2.0.4/agents/architect.md +25 -0
  649. package/.versions/2.0.4/agents/bowser.md +28 -0
  650. package/.versions/2.0.4/agents/builder.md +56 -0
  651. package/.versions/2.0.4/agents/code-reviewer.md +210 -0
  652. package/.versions/2.0.4/agents/deep-researcher.md +33 -0
  653. package/.versions/2.0.4/agents/documenter.md +22 -0
  654. package/.versions/2.0.4/agents/orchestrator.md +23 -0
  655. package/.versions/2.0.4/agents/plan-reviewer.md +84 -0
  656. package/.versions/2.0.4/agents/planner.md +105 -0
  657. package/.versions/2.0.4/agents/releaser.md +25 -0
  658. package/.versions/2.0.4/agents/researcher.md +31 -0
  659. package/.versions/2.0.4/agents/security-auditor.md +168 -0
  660. package/.versions/2.0.4/agents/test-engineer.md +154 -0
  661. package/.versions/2.0.4/agents/web-debugger.md +44 -0
  662. package/.versions/2.0.4/agents/web-performance-auditor.md +194 -0
  663. package/.versions/2.0.4/bin/catalog/harness-runtime-closure.json +36 -0
  664. package/.versions/2.0.4/codex/CONDUCTOR.md +148 -0
  665. package/.versions/2.0.4/docs/ARCHITECTURE.md +407 -0
  666. package/.versions/2.0.4/docs/agent-fleet-setup.md +547 -0
  667. package/.versions/2.0.4/docs/claude-code-coms-bridge.md +133 -0
  668. package/.versions/2.0.4/docs/codex-remote-conductor.md +170 -0
  669. package/.versions/2.0.4/docs/coms-hermes-bridge.md +189 -0
  670. package/.versions/2.0.4/docs/getting-started.md +124 -0
  671. package/.versions/2.0.4/docs/npm-install.md +299 -0
  672. package/.versions/2.0.4/docs/pi-extensions.md +447 -0
  673. package/.versions/2.0.4/docs/pi-setup.md +74 -0
  674. package/.versions/2.0.4/docs/skill-anatomy.md +150 -0
  675. package/.versions/2.0.4/hermes/README.md +347 -0
  676. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  677. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  678. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  679. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  680. package/.versions/2.0.4/hermes/gates/gate-o-capability.md +8 -0
  681. package/.versions/2.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  682. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  683. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  684. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  685. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  686. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  687. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  688. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  689. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  690. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  691. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  692. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  693. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  694. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  695. package/.versions/2.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  696. package/.versions/2.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  697. package/.versions/2.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  698. package/.versions/2.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  699. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  700. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  701. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  702. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  703. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  704. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  705. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  706. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  707. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  708. package/.versions/2.0.4/hermes/watchdog-tests/__init__.py +0 -0
  709. package/.versions/2.0.4/hooks/coms-stop-hook.mjs +84 -0
  710. package/.versions/2.0.4/install-manifest.json +2942 -0
  711. package/.versions/2.0.4/justfile +289 -0
  712. package/.versions/2.0.4/manifest-meta.json +969 -0
  713. package/.versions/2.0.4/references/accessibility-checklist.md +160 -0
  714. package/.versions/2.0.4/references/communication-contract.md +26 -0
  715. package/.versions/2.0.4/references/definition-of-done.md +67 -0
  716. package/.versions/2.0.4/references/fleet-coordination-patterns.md +171 -0
  717. package/.versions/2.0.4/references/observability-checklist.md +91 -0
  718. package/.versions/2.0.4/references/orchestration-patterns.md +370 -0
  719. package/.versions/2.0.4/references/performance-checklist.md +153 -0
  720. package/.versions/2.0.4/references/prompting-patterns.md +380 -0
  721. package/.versions/2.0.4/references/security-checklist.md +179 -0
  722. package/.versions/2.0.4/references/testing-patterns.md +236 -0
  723. package/.versions/2.0.4/references/workflow-authoring.md +304 -0
  724. package/.versions/2.0.4/scripts/claude-code-preflight.ts +70 -0
  725. package/.versions/2.0.4/scripts/codex-conductor.ts +41 -0
  726. package/.versions/2.0.4/scripts/codex-remote-control.ts +167 -0
  727. package/.versions/2.0.4/scripts/coms-claude-bridge.ts +411 -0
  728. package/.versions/2.0.4/scripts/coms-cli.ts +484 -0
  729. package/.versions/2.0.4/scripts/coms-hermes-bridge.ts +413 -0
  730. package/.versions/2.0.4/scripts/fleet.ts +222 -0
  731. package/.versions/2.0.4/scripts/flow.ts +137 -0
  732. package/.versions/2.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  733. package/.versions/2.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  734. package/.versions/2.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  735. package/.versions/2.0.4/scripts/install-hermes-plugin.sh +180 -0
  736. package/.versions/2.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  737. package/.versions/2.0.4/scripts/lib/codex-conductor.ts +88 -0
  738. package/.versions/2.0.4/scripts/lib/codex-remote-control.ts +482 -0
  739. package/.versions/2.0.4/scripts/lib/coms-envelope.ts +582 -0
  740. package/.versions/2.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  741. package/.versions/2.0.4/scripts/lib/fleet-command.ts +270 -0
  742. package/.versions/2.0.4/scripts/lib/flow-command.ts +93 -0
  743. package/.versions/2.0.4/scripts/lib/flow-maintenance.ts +230 -0
  744. package/.versions/2.0.4/scripts/lib/herdr-layout.ts +281 -0
  745. package/.versions/2.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  746. package/.versions/2.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  747. package/.versions/2.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  748. package/.versions/2.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  749. package/.versions/2.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  750. package/.versions/2.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  751. package/.versions/2.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  752. package/.versions/2.0.4/scripts/lib/monitor-env.ts +146 -0
  753. package/.versions/2.0.4/scripts/lib/peer-launch.ts +318 -0
  754. package/.versions/2.0.4/scripts/lib/persona-banner.ts +62 -0
  755. package/.versions/2.0.4/scripts/lib/runtime-dependencies.js +124 -0
  756. package/.versions/2.0.4/scripts/lib/spawn-stagger.ts +101 -0
  757. package/.versions/2.0.4/scripts/lib/team-project.ts +213 -0
  758. package/.versions/2.0.4/scripts/lib/team-snapshot.ts +147 -0
  759. package/.versions/2.0.4/scripts/package-lock.json +35 -0
  760. package/.versions/2.0.4/scripts/package.json +9 -0
  761. package/.versions/2.0.4/scripts/peer-banner.ts +40 -0
  762. package/.versions/2.0.4/scripts/peer-launch.ts +285 -0
  763. package/.versions/2.0.4/scripts/team-snapshot.ts +237 -0
  764. package/.versions/2.0.4/scripts/team-up.ts +406 -0
  765. package/.versions/2.0.4/scripts/workflows/lib/agent-phase.ts +133 -0
  766. package/.versions/2.0.4/scripts/workflows/lib/changes.ts +61 -0
  767. package/.versions/2.0.4/scripts/workflows/lib/debate.ts +149 -0
  768. package/.versions/2.0.4/scripts/workflows/lib/env.ts +34 -0
  769. package/.versions/2.0.4/scripts/workflows/lib/envelopes.ts +169 -0
  770. package/.versions/2.0.4/scripts/workflows/lib/gates.ts +81 -0
  771. package/.versions/2.0.4/scripts/workflows/lib/git.ts +96 -0
  772. package/.versions/2.0.4/scripts/workflows/lib/merge.ts +95 -0
  773. package/.versions/2.0.4/scripts/workflows/lib/model-profile.ts +22 -0
  774. package/.versions/2.0.4/scripts/workflows/lib/model-visibility.ts +92 -0
  775. package/.versions/2.0.4/scripts/workflows/lib/permissions.ts +130 -0
  776. package/.versions/2.0.4/scripts/workflows/lib/personas.ts +57 -0
  777. package/.versions/2.0.4/scripts/workflows/lib/poll.ts +86 -0
  778. package/.versions/2.0.4/scripts/workflows/lib/quality.ts +64 -0
  779. package/.versions/2.0.4/scripts/workflows/lib/run.ts +108 -0
  780. package/.versions/2.0.4/scripts/workflows/lib/trace.ts +34 -0
  781. package/.versions/2.0.4/scripts/workflows/lib/voices.ts +128 -0
  782. package/.versions/2.0.4/scripts/workflows/lib/writer-lease.ts +112 -0
  783. package/.versions/2.0.4/scripts/workflows/tsconfig.json +22 -0
  784. package/.versions/2.0.4/scripts/workflows/wf-build-test.ts +61 -0
  785. package/.versions/2.0.4/scripts/workflows/wf-debate.ts +87 -0
  786. package/.versions/2.0.4/scripts/workflows/wf-document.ts +50 -0
  787. package/.versions/2.0.4/scripts/workflows/wf-poll.ts +95 -0
  788. package/.versions/2.0.4/scripts/workflows/wf-quality.ts +20 -0
  789. package/.versions/2.0.4/scripts/workflows/wf-scout.ts +38 -0
  790. package/.versions/2.0.4/skills/_internal/grilling.md +59 -0
  791. package/.versions/2.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  792. package/.versions/2.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  793. package/.versions/2.0.4/skills/compound-learning/SKILL.md +137 -0
  794. package/.versions/2.0.4/skills/context-engineering/SKILL.md +291 -0
  795. package/.versions/2.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  796. package/.versions/2.0.4/skills/designing-agents/SKILL.md +394 -0
  797. package/.versions/2.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  798. package/.versions/2.0.4/skills/drafting-workflows/SKILL.md +143 -0
  799. package/.versions/2.0.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  800. package/.versions/2.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  801. package/.versions/2.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  802. package/.versions/2.0.4/skills/idea-refine/SKILL.md +182 -0
  803. package/.versions/2.0.4/skills/idea-refine/examples.md +238 -0
  804. package/.versions/2.0.4/skills/idea-refine/frameworks.md +99 -0
  805. package/.versions/2.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  806. package/.versions/2.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  807. package/.versions/2.0.4/skills/incremental-implementation/SKILL.md +298 -0
  808. package/.versions/2.0.4/skills/interview-me/SKILL.md +226 -0
  809. package/.versions/2.0.4/skills/orchestration-verification/SKILL.md +181 -0
  810. package/.versions/2.0.4/skills/peer-coms/SKILL.md +90 -0
  811. package/.versions/2.0.4/skills/performance-optimization/SKILL.md +350 -0
  812. package/.versions/2.0.4/skills/planning-and-task-breakdown/SKILL.md +265 -0
  813. package/.versions/2.0.4/skills/security-and-hardening/SKILL.md +461 -0
  814. package/.versions/2.0.4/skills/spec-driven-development/SKILL.md +256 -0
  815. package/.versions/2.0.4/skills/using-agent-skills/SKILL.md +197 -0
  816. package/.versions/2.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  817. package/.versions/2.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  818. package/.versions/2.0.4/vendor/agent-skills-upstream/README.md +11 -0
  819. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  820. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  821. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  822. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  823. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  824. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  825. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  826. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  827. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  828. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  829. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  830. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  831. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  832. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  833. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  834. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  835. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  836. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  837. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  838. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  839. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  840. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  841. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  842. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  843. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  844. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  845. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  846. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  847. package/CHANGELOG.md +14 -0
  848. package/README.md +2 -2
  849. package/bin/catalog/harness-runtime-closure.json +2 -0
  850. package/bin/cli.js +47 -9
  851. package/bin/lib/doctor.js +36 -3
  852. package/bin/lib/model-visibility.js +64 -0
  853. package/bin/lib/reconcile.js +3 -2
  854. package/docs/agent-fleet-setup.md +75 -1
  855. package/docs/claude-code-coms-bridge.md +5 -0
  856. package/docs/getting-started.md +7 -2
  857. package/docs/npm-install.md +13 -6
  858. package/docs/pi-extensions.md +13 -10
  859. package/install-manifest.json +38 -1
  860. package/justfile +2 -1
  861. package/manifest-meta.json +25 -1
  862. package/package.json +7 -3
  863. package/scripts/claude-code-preflight.ts +70 -0
  864. package/scripts/fleet.ts +24 -1
  865. package/scripts/lib/runtime-dependencies.js +124 -0
  866. package/scripts/package-lock.json +35 -0
  867. package/scripts/package.json +9 -0
  868. package/scripts/peer-launch.ts +27 -1
  869. package/scripts/workflows/lib/agent-phase.ts +2 -1
  870. package/scripts/workflows/lib/model-profile.ts +22 -0
  871. package/scripts/workflows/lib/personas.ts +6 -3
  872. package/scripts/workflows/lib/voices.ts +3 -0
  873. package/.pi/harnesses/agent-hub/research-retention.js +0 -34
@@ -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,19 @@
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
+
10
+ ## 2.0.3
11
+
12
+ ### Patch Changes
13
+
14
+ - 3cf0e2f: Make native research helpers live-only: they appear in the Fleet Dashboard (`Alt+A`) while running, never as main-dispatcher cards, and are removed immediately on every terminal outcome. Session, transcript, findings, and `/af-agents-history` records remain; finished `rN` restart and `research-keep` are retired.
15
+ - 3cf0e2f: Fix installed workspaces on Node.js 22+ by keeping the doctor model-visibility runtime in plain JavaScript and installing deterministic workflow dependencies under `scripts/node_modules`.
16
+
3
17
  ## 2.0.2
4
18
 
5
19
  ### Patch Changes
package/README.md CHANGED
@@ -90,11 +90,11 @@ voice configuration. **Full** selects all stable platform-applicable catalogue
90
90
  roots and may install the recorded Claude Code coms bridge. The lifecycle
91
91
  requires no coding agent or model.
92
92
 
93
- Setup writes files but never runs commands, so finish with the two npm steps it
93
+ Setup writes files but never runs commands, so finish with the npm steps it
94
94
  deliberately skipped — the workspace is not launchable until they run:
95
95
 
96
96
  ```bash
97
- just fleet deps # npm install in .pi/extensions and .pi/harnesses
97
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
98
98
  just fleet doctor # exit 0 = nothing to repair
99
99
  ```
100
100
 
@@ -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}"`;
@@ -660,7 +693,7 @@ export async function scanModelVisibility({ workspace, checkVisibility } = {}) {
660
693
  if (targets.length === 0) return [];
661
694
  let check = checkVisibility;
662
695
  if (!check) {
663
- const mod = await import("../../scripts/workflows/lib/model-visibility.ts");
696
+ const mod = await import("./model-visibility.js");
664
697
  check = (models) => mod.checkChildVisibility(models);
665
698
  }
666
699
  const unique = [...new Set(targets.map((target) => target.model))];
@@ -0,0 +1,64 @@
1
+ import { spawnSync } from "node:child_process";
2
+
3
+ let listingCache;
4
+
5
+ export function checkChildVisibility(models) {
6
+ const listing = loadListing();
7
+ if (listing.diagnostic) {
8
+ return {
9
+ diagnostic: listing.diagnostic,
10
+ models: models.map((model) => ({
11
+ model,
12
+ ok: false,
13
+ failed: [],
14
+ reasons: [`${model}: child-visible check not performed — ${listing.diagnostic}`],
15
+ })),
16
+ };
17
+ }
18
+ const visible = new Set(listing.models ?? []);
19
+ return {
20
+ models: models.map((model) => visible.has(model)
21
+ ? { model, ok: true, failed: [], reasons: [] }
22
+ : {
23
+ model,
24
+ ok: false,
25
+ failed: ["child-visible"],
26
+ reasons: [`${model}: child-visible check failed — not listed by pi --no-extensions --list-models`],
27
+ }),
28
+ };
29
+ }
30
+
31
+ function loadListing() {
32
+ if (listingCache) return listingCache;
33
+ try { listingCache = listModels(); }
34
+ catch (error) { listingCache = { diagnostic: error instanceof Error ? error.message : String(error) }; }
35
+ return listingCache;
36
+ }
37
+
38
+ function listModels() {
39
+ const result = spawnSync("pi", ["--no-extensions", "--list-models"], {
40
+ encoding: "utf8",
41
+ timeout: 15_000,
42
+ });
43
+ if (result.error) {
44
+ return { diagnostic: `pi --no-extensions --list-models failed: ${result.error.message}` };
45
+ }
46
+ if (result.status !== 0) {
47
+ const detail = (result.stderr || result.stdout || `exit ${result.status}`).trim();
48
+ return { diagnostic: `pi --no-extensions --list-models failed: ${detail}` };
49
+ }
50
+ return { models: parseListModelsOutput(result.stdout) };
51
+ }
52
+
53
+ function parseListModelsOutput(text) {
54
+ const cleaned = text.replace(/\u001B\[[0-9;]*m/g, "");
55
+ const lines = cleaned.split(/\r?\n/).map((line) => line.trimEnd()).filter((line) => line.trim());
56
+ if (lines.length === 0) return [];
57
+ const models = new Set();
58
+ for (const line of lines.slice(1)) {
59
+ const parts = line.trim().split(/\s+/);
60
+ if (parts.length < 2 || (parts[0] === "provider" && parts[1] === "model")) continue;
61
+ models.add(`${parts[0]}/${parts[1]}`);
62
+ }
63
+ return [...models];
64
+ }
@@ -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")
@@ -211,7 +211,7 @@ targets an end-of-session compound pass writes lessons to.
211
211
  | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
212
212
  | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
213
213
  | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
214
- | `research-keep` | `4` | How many **finished** durable/persona research helpers the hub retains (LRU by finish time) for dashboard inspection or a fresh `/af-agents-restart rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
214
+ | `research-keep` | — | **Removed.** Ignored with a session-start warning; live research helpers disappear from the Fleet Dashboard (`Alt+A`) on every terminal outcome. Session, transcript, and findings files plus `/af-agents-history` records remain. Delete the key. |
215
215
  | `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
216
216
  | `mode` | — | **Removed.** Ignored with a warning; budgets follow task tier. Delete the key. |
217
217
  | `max-dispatches-per-turn` | tier default (1/2/8/12) | Ceiling on `dispatch_agent` calls per user turn (`min` with the task-tier envelope). Positive integer or `off` (stays at the tier). |
@@ -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`