@chankov/agent-fleet 2.0.4 → 2.0.6

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 (939) hide show
  1. package/.pi/agents/model-profiles.yaml +39 -34
  2. package/.pi/harnesses/agent-hub/README.md +85 -42
  3. package/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  4. package/.pi/harnesses/agent-hub/artifacts.js +1 -1
  5. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -60
  6. package/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  7. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  8. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  9. package/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  10. package/.pi/harnesses/agent-hub/config/agents.ts +3 -9
  11. package/.pi/harnesses/agent-hub/context/agent-state.ts +1 -1
  12. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +7 -5
  13. package/.pi/harnesses/agent-hub/context/budgets.ts +8 -14
  14. package/.pi/harnesses/agent-hub/debate-command.ts +2 -2
  15. package/.pi/harnesses/agent-hub/dispatch-coms.ts +4 -1
  16. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +37 -18
  17. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +5 -5
  18. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  19. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +23 -0
  20. package/.pi/harnesses/agent-hub/dispatch-native.ts +56 -30
  21. package/.pi/harnesses/agent-hub/dispatch-observability.ts +6 -1
  22. package/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  23. package/.pi/harnesses/agent-hub/footer.ts +2 -2
  24. package/.pi/harnesses/agent-hub/hub-state-audit.js +5 -0
  25. package/.pi/harnesses/agent-hub/index.ts +148 -85
  26. package/.pi/harnesses/agent-hub/input/shortcuts.ts +0 -29
  27. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +2 -0
  28. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +9 -30
  29. package/.pi/harnesses/agent-hub/monitor-control.ts +1 -1
  30. package/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  31. package/.pi/harnesses/agent-hub/package.json +1 -1
  32. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +59 -3
  33. package/.pi/harnesses/agent-hub/policy/roster.ts +16 -1
  34. package/.pi/harnesses/agent-hub/policy/work-mode.ts +3 -2
  35. package/.pi/harnesses/agent-hub/poll-command.ts +2 -2
  36. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  37. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
  38. package/.pi/harnesses/agent-hub/research/runtime.ts +19 -2
  39. package/.pi/harnesses/agent-hub/research/spawn-run.ts +18 -6
  40. package/.pi/harnesses/agent-hub/scope-gate.js +50 -30
  41. package/.pi/harnesses/agent-hub/tools/action-executors.ts +5 -4
  42. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  43. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +6 -3
  44. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +99 -25
  45. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +4 -2
  46. package/.pi/harnesses/agent-hub/types.ts +2 -0
  47. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  48. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +4 -2
  49. package/.pi/harnesses/agent-hub/ui/grid.ts +16 -118
  50. package/.pi/harnesses/agent-hub/ui/pool.ts +7 -7
  51. package/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  52. package/.pi/harnesses/agent-hub/work-mode-controls.ts +1 -1
  53. package/.pi/harnesses/ask-user-remote/README.md +8 -2
  54. package/.pi/harnesses/ask-user-remote/index.ts +40 -14
  55. package/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  56. package/.pi/harnesses/ask-user-remote/race-core.js +23 -5
  57. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  58. package/.pi/harnesses/coms/README.md +1 -1
  59. package/.pi/harnesses/coms/index.ts +7 -1
  60. package/.pi/harnesses/coms/package.json +1 -1
  61. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  62. package/.pi/harnesses/lib/context-budget-child-prompt.ts +5 -4
  63. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +0 -5
  64. package/.pi/harnesses/lib/fleet-dashboard-view.ts +8 -2
  65. package/.versions/2.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  66. package/.versions/2.0.5/.pi/agents/model-profiles.yaml +83 -0
  67. package/.versions/2.0.5/.pi/agents/peers.yaml +145 -0
  68. package/.versions/2.0.5/.pi/agents/teams.yaml +41 -0
  69. package/.versions/2.0.5/.pi/agents/voices.yaml +13 -0
  70. package/.versions/2.0.5/.pi/damage-control-rules.yaml +297 -0
  71. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  72. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  73. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  74. package/.versions/2.0.5/.pi/extensions/btw/README.md +120 -0
  75. package/.versions/2.0.5/.pi/extensions/btw/index.ts +914 -0
  76. package/.versions/2.0.5/.pi/extensions/btw/package.json +6 -0
  77. package/.versions/2.0.5/.pi/extensions/btw/state.js +179 -0
  78. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  79. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  80. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  81. package/.versions/2.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  82. package/.versions/2.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  83. package/.versions/2.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  84. package/.versions/2.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  85. package/.versions/2.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  86. package/.versions/2.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  87. package/.versions/2.0.5/.pi/extensions/package-lock.json +1175 -0
  88. package/.versions/2.0.5/.pi/extensions/package.json +9 -0
  89. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/README.md +205 -0
  90. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  91. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  92. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  93. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  94. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  95. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  96. package/.versions/2.0.5/.pi/harnesses/agent-hub/README.md +1139 -0
  97. package/.versions/2.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  98. package/.versions/2.0.5/.pi/harnesses/agent-hub/artifacts.js +146 -0
  99. package/.versions/2.0.5/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  100. package/.versions/2.0.5/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  101. package/.versions/2.0.5/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  102. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  103. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  104. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  105. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  106. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  107. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  108. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  109. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  110. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  111. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  112. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  113. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  114. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  115. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  116. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  117. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  118. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  119. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  120. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  121. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  122. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  123. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  124. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  125. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  126. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  127. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  128. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  129. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  130. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  131. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  132. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  133. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  134. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  135. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  136. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  137. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-window.js +106 -0
  138. package/.versions/2.0.5/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  139. package/.versions/2.0.5/.pi/harnesses/agent-hub/delegate.ts +446 -0
  140. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  141. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  142. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  143. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  144. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  145. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-types.ts +208 -0
  146. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native.ts +199 -0
  147. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  148. package/.versions/2.0.5/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  149. package/.versions/2.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  150. package/.versions/2.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  151. package/.versions/2.0.5/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  152. package/.versions/2.0.5/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  153. package/.versions/2.0.5/.pi/harnesses/agent-hub/footer.ts +30 -0
  154. package/.versions/2.0.5/.pi/harnesses/agent-hub/helpers.ts +266 -0
  155. package/.versions/2.0.5/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  156. package/.versions/2.0.5/.pi/harnesses/agent-hub/index.ts +2115 -0
  157. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  158. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  159. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  160. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  161. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  162. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  163. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  164. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  165. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  166. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  167. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  168. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  169. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  170. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  171. package/.versions/2.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  172. package/.versions/2.0.5/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  173. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  174. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  175. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  176. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  177. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  178. package/.versions/2.0.5/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  179. package/.versions/2.0.5/.pi/harnesses/agent-hub/presentation.ts +48 -0
  180. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  181. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  182. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  183. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  184. package/.versions/2.0.5/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  185. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  186. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/runtime.ts +177 -0
  187. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/spawn-run.ts +148 -0
  188. package/.versions/2.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  189. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-contract.js +293 -0
  190. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-extract.js +75 -0
  191. package/.versions/2.0.5/.pi/harnesses/agent-hub/review-findings.js +102 -0
  192. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-budget.js +537 -0
  193. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  194. package/.versions/2.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  195. package/.versions/2.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  196. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-health.js +110 -0
  197. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-start.ts +42 -0
  198. package/.versions/2.0.5/.pi/harnesses/agent-hub/spawn.ts +404 -0
  199. package/.versions/2.0.5/.pi/harnesses/agent-hub/timeline.ts +54 -0
  200. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  201. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  202. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  203. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  204. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +232 -0
  205. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  206. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  207. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  208. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  209. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  210. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  211. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  212. package/.versions/2.0.5/.pi/harnesses/agent-hub/types.ts +62 -0
  213. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  214. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  215. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  216. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  217. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  218. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  219. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  220. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/pool.ts +98 -0
  221. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  222. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  223. package/.versions/2.0.5/.pi/harnesses/agent-hub/version.ts +42 -0
  224. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  225. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  226. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/README.md +53 -0
  227. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/index.ts +532 -0
  228. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  229. package/.versions/2.0.5/.pi/harnesses/coms/README.md +100 -0
  230. package/.versions/2.0.5/.pi/harnesses/coms/index.ts +276 -0
  231. package/.versions/2.0.5/.pi/harnesses/coms/package.json +7 -0
  232. package/.versions/2.0.5/.pi/harnesses/coms/version.ts +42 -0
  233. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/README.md +124 -0
  234. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  235. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  236. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/version.ts +42 -0
  237. package/.versions/2.0.5/.pi/harnesses/lib/coms-core-io.ts +385 -0
  238. package/.versions/2.0.5/.pi/harnesses/lib/coms-core.ts +577 -0
  239. package/.versions/2.0.5/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  240. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  241. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  242. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-view.ts +107 -0
  243. package/.versions/2.0.5/.pi/harnesses/lib/context-budget.ts +114 -0
  244. package/.versions/2.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  245. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  246. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  247. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  248. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  249. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  250. package/.versions/2.0.5/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  251. package/.versions/2.0.5/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  252. package/.versions/2.0.5/.pi/harnesses/lib/fleet-panel.ts +34 -0
  253. package/.versions/2.0.5/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  254. package/.versions/2.0.5/.pi/harnesses/lib/fleet-selection.ts +24 -0
  255. package/.versions/2.0.5/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  256. package/.versions/2.0.5/.pi/harnesses/lib/herdr-client.ts +472 -0
  257. package/.versions/2.0.5/.pi/harnesses/lib/herdr-presence.ts +399 -0
  258. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  259. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  260. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  261. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  262. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  263. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  264. package/.versions/2.0.5/.pi/harnesses/lib/spawned-peers.js +190 -0
  265. package/.versions/2.0.5/.pi/harnesses/package-lock.json +2039 -0
  266. package/.versions/2.0.5/.pi/harnesses/package.json +10 -0
  267. package/.versions/2.0.5/.pi/prompts/af-build.md +24 -0
  268. package/.versions/2.0.5/.pi/prompts/af-code-simplify.md +22 -0
  269. package/.versions/2.0.5/.pi/prompts/af-plan.md +17 -0
  270. package/.versions/2.0.5/.pi/prompts/af-review.md +16 -0
  271. package/.versions/2.0.5/.pi/prompts/af-set-hermes-telegram.md +15 -0
  272. package/.versions/2.0.5/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  273. package/.versions/2.0.5/.pi/prompts/af-ship.md +17 -0
  274. package/.versions/2.0.5/.pi/prompts/af-spec.md +15 -0
  275. package/.versions/2.0.5/.pi/prompts/af-test.md +19 -0
  276. package/.versions/2.0.5/.pi/skills/bowser/SKILL.md +145 -0
  277. package/.versions/2.0.5/.version +1 -0
  278. package/.versions/2.0.5/agents/architect.md +25 -0
  279. package/.versions/2.0.5/agents/bowser.md +28 -0
  280. package/.versions/2.0.5/agents/builder.md +56 -0
  281. package/.versions/2.0.5/agents/code-reviewer.md +210 -0
  282. package/.versions/2.0.5/agents/deep-researcher.md +33 -0
  283. package/.versions/2.0.5/agents/documenter.md +23 -0
  284. package/.versions/2.0.5/agents/orchestrator.md +23 -0
  285. package/.versions/2.0.5/agents/plan-reviewer.md +84 -0
  286. package/.versions/2.0.5/agents/planner.md +106 -0
  287. package/.versions/2.0.5/agents/releaser.md +25 -0
  288. package/.versions/2.0.5/agents/researcher.md +31 -0
  289. package/.versions/2.0.5/agents/security-auditor.md +168 -0
  290. package/.versions/2.0.5/agents/test-engineer.md +154 -0
  291. package/.versions/2.0.5/agents/web-debugger.md +44 -0
  292. package/.versions/2.0.5/agents/web-performance-auditor.md +194 -0
  293. package/.versions/2.0.5/bin/catalog/harness-runtime-closure.json +36 -0
  294. package/.versions/2.0.5/docs/ARCHITECTURE.md +407 -0
  295. package/.versions/2.0.5/docs/agent-fleet-setup.md +561 -0
  296. package/.versions/2.0.5/docs/claude-code-coms-bridge.md +133 -0
  297. package/.versions/2.0.5/docs/coms-hermes-bridge.md +189 -0
  298. package/.versions/2.0.5/docs/getting-started.md +124 -0
  299. package/.versions/2.0.5/docs/npm-install.md +299 -0
  300. package/.versions/2.0.5/docs/pi-extensions.md +446 -0
  301. package/.versions/2.0.5/docs/pi-setup.md +74 -0
  302. package/.versions/2.0.5/docs/skill-anatomy.md +150 -0
  303. package/.versions/2.0.5/hermes/README.md +347 -0
  304. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  305. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  306. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  307. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  308. package/.versions/2.0.5/hermes/gates/gate-o-capability.md +8 -0
  309. package/.versions/2.0.5/hermes/gates/gate-o-validator-fixtures.json +1 -0
  310. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  311. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  312. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  313. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  314. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  315. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  316. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  317. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  318. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  319. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  320. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  321. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  322. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  323. package/.versions/2.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  324. package/.versions/2.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  325. package/.versions/2.0.5/hermes/skills/hub-watchdog/SKILL.md +76 -0
  326. package/.versions/2.0.5/hermes/skills/hub-watchdog/manifest.json +1 -0
  327. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  328. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  329. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  330. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  331. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  332. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  333. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  334. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  335. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  336. package/.versions/2.0.5/hermes/watchdog-tests/__init__.py +0 -0
  337. package/.versions/2.0.5/hooks/coms-stop-hook.mjs +84 -0
  338. package/.versions/2.0.5/install-manifest.json +2942 -0
  339. package/.versions/2.0.5/justfile +289 -0
  340. package/.versions/2.0.5/manifest-meta.json +969 -0
  341. package/.versions/2.0.5/references/accessibility-checklist.md +160 -0
  342. package/.versions/2.0.5/references/communication-contract.md +26 -0
  343. package/.versions/2.0.5/references/definition-of-done.md +67 -0
  344. package/.versions/2.0.5/references/fleet-coordination-patterns.md +171 -0
  345. package/.versions/2.0.5/references/observability-checklist.md +91 -0
  346. package/.versions/2.0.5/references/orchestration-patterns.md +370 -0
  347. package/.versions/2.0.5/references/performance-checklist.md +153 -0
  348. package/.versions/2.0.5/references/prompting-patterns.md +380 -0
  349. package/.versions/2.0.5/references/security-checklist.md +179 -0
  350. package/.versions/2.0.5/references/testing-patterns.md +236 -0
  351. package/.versions/2.0.5/references/workflow-authoring.md +304 -0
  352. package/.versions/2.0.5/scripts/claude-code-preflight.ts +70 -0
  353. package/.versions/2.0.5/scripts/coms-claude-bridge.ts +411 -0
  354. package/.versions/2.0.5/scripts/coms-cli.ts +484 -0
  355. package/.versions/2.0.5/scripts/coms-hermes-bridge.ts +413 -0
  356. package/.versions/2.0.5/scripts/fleet.ts +222 -0
  357. package/.versions/2.0.5/scripts/flow.ts +137 -0
  358. package/.versions/2.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  359. package/.versions/2.0.5/scripts/hermes-monitor-scenario.ts +474 -0
  360. package/.versions/2.0.5/scripts/hermes-watchdog-capability-probe.ts +45 -0
  361. package/.versions/2.0.5/scripts/install-hermes-plugin.sh +180 -0
  362. package/.versions/2.0.5/scripts/lib/claude-bridge-core.ts +210 -0
  363. package/.versions/2.0.5/scripts/lib/coms-envelope.ts +582 -0
  364. package/.versions/2.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  365. package/.versions/2.0.5/scripts/lib/fleet-command.ts +270 -0
  366. package/.versions/2.0.5/scripts/lib/flow-command.ts +93 -0
  367. package/.versions/2.0.5/scripts/lib/flow-maintenance.ts +230 -0
  368. package/.versions/2.0.5/scripts/lib/herdr-layout.ts +281 -0
  369. package/.versions/2.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  370. package/.versions/2.0.5/scripts/lib/hermes-monitor-events.ts +1 -0
  371. package/.versions/2.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  372. package/.versions/2.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  373. package/.versions/2.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  374. package/.versions/2.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  375. package/.versions/2.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  376. package/.versions/2.0.5/scripts/lib/monitor-env.ts +146 -0
  377. package/.versions/2.0.5/scripts/lib/peer-launch.ts +318 -0
  378. package/.versions/2.0.5/scripts/lib/persona-banner.ts +62 -0
  379. package/.versions/2.0.5/scripts/lib/runtime-dependencies.js +124 -0
  380. package/.versions/2.0.5/scripts/lib/spawn-stagger.ts +101 -0
  381. package/.versions/2.0.5/scripts/lib/team-project.ts +213 -0
  382. package/.versions/2.0.5/scripts/lib/team-snapshot.ts +147 -0
  383. package/.versions/2.0.5/scripts/package-lock.json +35 -0
  384. package/.versions/2.0.5/scripts/package.json +9 -0
  385. package/.versions/2.0.5/scripts/peer-banner.ts +40 -0
  386. package/.versions/2.0.5/scripts/peer-launch.ts +285 -0
  387. package/.versions/2.0.5/scripts/team-snapshot.ts +237 -0
  388. package/.versions/2.0.5/scripts/team-up.ts +406 -0
  389. package/.versions/2.0.5/scripts/workflows/lib/agent-phase.ts +133 -0
  390. package/.versions/2.0.5/scripts/workflows/lib/changes.ts +61 -0
  391. package/.versions/2.0.5/scripts/workflows/lib/debate.ts +149 -0
  392. package/.versions/2.0.5/scripts/workflows/lib/env.ts +34 -0
  393. package/.versions/2.0.5/scripts/workflows/lib/envelopes.ts +169 -0
  394. package/.versions/2.0.5/scripts/workflows/lib/gates.ts +81 -0
  395. package/.versions/2.0.5/scripts/workflows/lib/git.ts +96 -0
  396. package/.versions/2.0.5/scripts/workflows/lib/merge.ts +95 -0
  397. package/.versions/2.0.5/scripts/workflows/lib/model-profile.ts +22 -0
  398. package/.versions/2.0.5/scripts/workflows/lib/model-visibility.ts +92 -0
  399. package/.versions/2.0.5/scripts/workflows/lib/permissions.ts +130 -0
  400. package/.versions/2.0.5/scripts/workflows/lib/personas.ts +57 -0
  401. package/.versions/2.0.5/scripts/workflows/lib/poll.ts +86 -0
  402. package/.versions/2.0.5/scripts/workflows/lib/quality.ts +64 -0
  403. package/.versions/2.0.5/scripts/workflows/lib/run.ts +108 -0
  404. package/.versions/2.0.5/scripts/workflows/lib/trace.ts +34 -0
  405. package/.versions/2.0.5/scripts/workflows/lib/voices.ts +128 -0
  406. package/.versions/2.0.5/scripts/workflows/lib/writer-lease.ts +112 -0
  407. package/.versions/2.0.5/scripts/workflows/tsconfig.json +22 -0
  408. package/.versions/2.0.5/scripts/workflows/wf-build-test.ts +61 -0
  409. package/.versions/2.0.5/scripts/workflows/wf-debate.ts +87 -0
  410. package/.versions/2.0.5/scripts/workflows/wf-document.ts +50 -0
  411. package/.versions/2.0.5/scripts/workflows/wf-poll.ts +95 -0
  412. package/.versions/2.0.5/scripts/workflows/wf-quality.ts +20 -0
  413. package/.versions/2.0.5/scripts/workflows/wf-scout.ts +38 -0
  414. package/.versions/2.0.5/skills/_internal/grilling.md +59 -0
  415. package/.versions/2.0.5/skills/browser-testing-with-devtools/SKILL.md +351 -0
  416. package/.versions/2.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  417. package/.versions/2.0.5/skills/compound-learning/SKILL.md +137 -0
  418. package/.versions/2.0.5/skills/context-engineering/SKILL.md +291 -0
  419. package/.versions/2.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  420. package/.versions/2.0.5/skills/designing-agents/SKILL.md +394 -0
  421. package/.versions/2.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  422. package/.versions/2.0.5/skills/drafting-workflows/SKILL.md +143 -0
  423. package/.versions/2.0.5/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  424. package/.versions/2.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  425. package/.versions/2.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  426. package/.versions/2.0.5/skills/idea-refine/SKILL.md +182 -0
  427. package/.versions/2.0.5/skills/idea-refine/examples.md +238 -0
  428. package/.versions/2.0.5/skills/idea-refine/frameworks.md +99 -0
  429. package/.versions/2.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  430. package/.versions/2.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  431. package/.versions/2.0.5/skills/incremental-implementation/SKILL.md +298 -0
  432. package/.versions/2.0.5/skills/interview-me/SKILL.md +226 -0
  433. package/.versions/2.0.5/skills/orchestration-verification/SKILL.md +181 -0
  434. package/.versions/2.0.5/skills/peer-coms/SKILL.md +90 -0
  435. package/.versions/2.0.5/skills/performance-optimization/SKILL.md +350 -0
  436. package/.versions/2.0.5/skills/planning-and-task-breakdown/SKILL.md +265 -0
  437. package/.versions/2.0.5/skills/security-and-hardening/SKILL.md +461 -0
  438. package/.versions/2.0.5/skills/spec-driven-development/SKILL.md +256 -0
  439. package/.versions/2.0.5/skills/using-agent-skills/SKILL.md +197 -0
  440. package/.versions/2.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  441. package/.versions/2.0.5/vendor/agent-skills-upstream/README.md +11 -0
  442. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  443. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  444. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  445. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  446. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  447. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  448. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  449. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  450. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  451. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  452. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  453. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  454. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  455. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  456. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  457. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  458. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  459. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  460. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  461. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  462. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  463. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  464. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  465. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  466. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  467. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  468. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  469. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  470. package/.versions/2.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  471. package/.versions/2.0.6/.pi/agents/model-profiles.yaml +83 -0
  472. package/.versions/2.0.6/.pi/agents/peers.yaml +145 -0
  473. package/.versions/2.0.6/.pi/agents/teams.yaml +41 -0
  474. package/.versions/2.0.6/.pi/agents/voices.yaml +13 -0
  475. package/.versions/2.0.6/.pi/damage-control-rules.yaml +297 -0
  476. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  477. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  478. package/.versions/2.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  479. package/.versions/2.0.6/.pi/extensions/btw/README.md +120 -0
  480. package/.versions/2.0.6/.pi/extensions/btw/index.ts +914 -0
  481. package/.versions/2.0.6/.pi/extensions/btw/package.json +6 -0
  482. package/.versions/2.0.6/.pi/extensions/btw/state.js +179 -0
  483. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  484. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  485. package/.versions/2.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  486. package/.versions/2.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  487. package/.versions/2.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  488. package/.versions/2.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  489. package/.versions/2.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  490. package/.versions/2.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  491. package/.versions/2.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  492. package/.versions/2.0.6/.pi/extensions/package-lock.json +1175 -0
  493. package/.versions/2.0.6/.pi/extensions/package.json +9 -0
  494. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/README.md +205 -0
  495. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  496. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  497. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  498. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  499. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  500. package/.versions/2.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  501. package/.versions/2.0.6/.pi/harnesses/agent-hub/README.md +1203 -0
  502. package/.versions/2.0.6/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  503. package/.versions/2.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  504. package/.versions/2.0.6/.pi/harnesses/agent-hub/artifacts.js +146 -0
  505. package/.versions/2.0.6/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  506. package/.versions/2.0.6/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  507. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  508. package/.versions/2.0.6/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  509. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  510. package/.versions/2.0.6/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  511. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  512. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  513. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  514. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  515. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  516. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  517. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  518. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  519. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  520. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  521. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  522. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  523. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  524. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  525. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  526. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  527. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  528. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  529. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  530. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  531. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  532. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  533. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  534. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  535. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  536. package/.versions/2.0.6/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  537. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  538. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  539. package/.versions/2.0.6/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  540. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  541. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  542. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  543. package/.versions/2.0.6/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  544. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  545. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  546. package/.versions/2.0.6/.pi/harnesses/agent-hub/context-window.js +106 -0
  547. package/.versions/2.0.6/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  548. package/.versions/2.0.6/.pi/harnesses/agent-hub/delegate.ts +446 -0
  549. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  550. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  551. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  552. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  553. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  554. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  555. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  556. package/.versions/2.0.6/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  557. package/.versions/2.0.6/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  558. package/.versions/2.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  559. package/.versions/2.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  560. package/.versions/2.0.6/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  561. package/.versions/2.0.6/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  562. package/.versions/2.0.6/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  563. package/.versions/2.0.6/.pi/harnesses/agent-hub/footer.ts +30 -0
  564. package/.versions/2.0.6/.pi/harnesses/agent-hub/helpers.ts +266 -0
  565. package/.versions/2.0.6/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  566. package/.versions/2.0.6/.pi/harnesses/agent-hub/index.ts +2151 -0
  567. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  568. package/.versions/2.0.6/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  569. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  570. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  571. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  572. package/.versions/2.0.6/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  573. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  574. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  575. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  576. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  577. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  578. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  579. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  580. package/.versions/2.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  581. package/.versions/2.0.6/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  582. package/.versions/2.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  583. package/.versions/2.0.6/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  584. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  585. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  586. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  587. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  588. package/.versions/2.0.6/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  589. package/.versions/2.0.6/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  590. package/.versions/2.0.6/.pi/harnesses/agent-hub/presentation.ts +48 -0
  591. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  592. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  593. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  594. package/.versions/2.0.6/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  595. package/.versions/2.0.6/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  596. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  597. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  598. package/.versions/2.0.6/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  599. package/.versions/2.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  600. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-contract.js +293 -0
  601. package/.versions/2.0.6/.pi/harnesses/agent-hub/return-extract.js +75 -0
  602. package/.versions/2.0.6/.pi/harnesses/agent-hub/review-findings.js +102 -0
  603. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-budget.js +537 -0
  604. package/.versions/2.0.6/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  605. package/.versions/2.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  606. package/.versions/2.0.6/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  607. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-health.js +110 -0
  608. package/.versions/2.0.6/.pi/harnesses/agent-hub/session-start.ts +42 -0
  609. package/.versions/2.0.6/.pi/harnesses/agent-hub/spawn.ts +404 -0
  610. package/.versions/2.0.6/.pi/harnesses/agent-hub/timeline.ts +54 -0
  611. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  612. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  613. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  614. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  615. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  616. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  617. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  618. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  619. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  620. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  621. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  622. package/.versions/2.0.6/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  623. package/.versions/2.0.6/.pi/harnesses/agent-hub/types.ts +63 -0
  624. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  625. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  626. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  627. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  628. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  629. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  630. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  631. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  632. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  633. package/.versions/2.0.6/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  634. package/.versions/2.0.6/.pi/harnesses/agent-hub/version.ts +42 -0
  635. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  636. package/.versions/2.0.6/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  637. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/README.md +59 -0
  638. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/index.ts +558 -0
  639. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  640. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  641. package/.versions/2.0.6/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  642. package/.versions/2.0.6/.pi/harnesses/coms/README.md +100 -0
  643. package/.versions/2.0.6/.pi/harnesses/coms/index.ts +282 -0
  644. package/.versions/2.0.6/.pi/harnesses/coms/package.json +7 -0
  645. package/.versions/2.0.6/.pi/harnesses/coms/version.ts +42 -0
  646. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/README.md +124 -0
  647. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  648. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  649. package/.versions/2.0.6/.pi/harnesses/damage-control-continue/version.ts +42 -0
  650. package/.versions/2.0.6/.pi/harnesses/lib/coms-core-io.ts +385 -0
  651. package/.versions/2.0.6/.pi/harnesses/lib/coms-core.ts +577 -0
  652. package/.versions/2.0.6/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  653. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  654. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  655. package/.versions/2.0.6/.pi/harnesses/lib/context-budget-view.ts +107 -0
  656. package/.versions/2.0.6/.pi/harnesses/lib/context-budget.ts +114 -0
  657. package/.versions/2.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  658. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  659. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  660. package/.versions/2.0.6/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  661. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  662. package/.versions/2.0.6/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  663. package/.versions/2.0.6/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  664. package/.versions/2.0.6/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  665. package/.versions/2.0.6/.pi/harnesses/lib/fleet-panel.ts +34 -0
  666. package/.versions/2.0.6/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  667. package/.versions/2.0.6/.pi/harnesses/lib/fleet-selection.ts +24 -0
  668. package/.versions/2.0.6/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  669. package/.versions/2.0.6/.pi/harnesses/lib/herdr-client.ts +472 -0
  670. package/.versions/2.0.6/.pi/harnesses/lib/herdr-presence.ts +399 -0
  671. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  672. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  673. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  674. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  675. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  676. package/.versions/2.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  677. package/.versions/2.0.6/.pi/harnesses/lib/spawned-peers.js +190 -0
  678. package/.versions/2.0.6/.pi/harnesses/package-lock.json +2039 -0
  679. package/.versions/2.0.6/.pi/harnesses/package.json +10 -0
  680. package/.versions/2.0.6/.pi/prompts/af-build.md +24 -0
  681. package/.versions/2.0.6/.pi/prompts/af-code-simplify.md +22 -0
  682. package/.versions/2.0.6/.pi/prompts/af-plan.md +17 -0
  683. package/.versions/2.0.6/.pi/prompts/af-review.md +16 -0
  684. package/.versions/2.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  685. package/.versions/2.0.6/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  686. package/.versions/2.0.6/.pi/prompts/af-ship.md +17 -0
  687. package/.versions/2.0.6/.pi/prompts/af-spec.md +15 -0
  688. package/.versions/2.0.6/.pi/prompts/af-test.md +19 -0
  689. package/.versions/2.0.6/.pi/skills/bowser/SKILL.md +145 -0
  690. package/.versions/2.0.6/.version +1 -0
  691. package/.versions/2.0.6/agents/architect.md +25 -0
  692. package/.versions/2.0.6/agents/bowser.md +28 -0
  693. package/.versions/2.0.6/agents/builder.md +56 -0
  694. package/.versions/2.0.6/agents/code-reviewer.md +210 -0
  695. package/.versions/2.0.6/agents/deep-researcher.md +33 -0
  696. package/.versions/2.0.6/agents/documenter.md +23 -0
  697. package/.versions/2.0.6/agents/orchestrator.md +23 -0
  698. package/.versions/2.0.6/agents/plan-reviewer.md +84 -0
  699. package/.versions/2.0.6/agents/planner.md +106 -0
  700. package/.versions/2.0.6/agents/releaser.md +25 -0
  701. package/.versions/2.0.6/agents/researcher.md +31 -0
  702. package/.versions/2.0.6/agents/security-auditor.md +168 -0
  703. package/.versions/2.0.6/agents/test-engineer.md +154 -0
  704. package/.versions/2.0.6/agents/web-debugger.md +44 -0
  705. package/.versions/2.0.6/agents/web-performance-auditor.md +194 -0
  706. package/.versions/2.0.6/bin/catalog/harness-runtime-closure.json +31 -0
  707. package/.versions/2.0.6/codex/fleet-session-client/SKILL.md +34 -0
  708. package/.versions/2.0.6/codex/fleet-session-client.zip +0 -0
  709. package/.versions/2.0.6/docs/ARCHITECTURE.md +407 -0
  710. package/.versions/2.0.6/docs/agent-fleet-setup.md +561 -0
  711. package/.versions/2.0.6/docs/claude-code-coms-bridge.md +133 -0
  712. package/.versions/2.0.6/docs/codex-session-bridge.md +219 -0
  713. package/.versions/2.0.6/docs/coms-hermes-bridge.md +188 -0
  714. package/.versions/2.0.6/docs/getting-started.md +126 -0
  715. package/.versions/2.0.6/docs/npm-install.md +301 -0
  716. package/.versions/2.0.6/docs/pi-extensions.md +446 -0
  717. package/.versions/2.0.6/docs/pi-setup.md +76 -0
  718. package/.versions/2.0.6/docs/skill-anatomy.md +150 -0
  719. package/.versions/2.0.6/hermes/README.md +347 -0
  720. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  721. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  722. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  723. package/.versions/2.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  724. package/.versions/2.0.6/hermes/gates/gate-o-capability.md +8 -0
  725. package/.versions/2.0.6/hermes/gates/gate-o-validator-fixtures.json +1 -0
  726. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  727. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  728. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  729. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  730. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  731. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  732. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  733. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  734. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  735. package/.versions/2.0.6/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  736. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  737. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  738. package/.versions/2.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  739. package/.versions/2.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  740. package/.versions/2.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  741. package/.versions/2.0.6/hermes/skills/hub-watchdog/SKILL.md +76 -0
  742. package/.versions/2.0.6/hermes/skills/hub-watchdog/manifest.json +1 -0
  743. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  744. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  745. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  746. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  747. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  748. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  749. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  750. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  751. package/.versions/2.0.6/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  752. package/.versions/2.0.6/hermes/watchdog-tests/__init__.py +0 -0
  753. package/.versions/2.0.6/hooks/coms-stop-hook.mjs +84 -0
  754. package/.versions/2.0.6/install-manifest.json +2924 -0
  755. package/.versions/2.0.6/justfile +247 -0
  756. package/.versions/2.0.6/manifest-meta.json +976 -0
  757. package/.versions/2.0.6/references/accessibility-checklist.md +160 -0
  758. package/.versions/2.0.6/references/communication-contract.md +26 -0
  759. package/.versions/2.0.6/references/definition-of-done.md +67 -0
  760. package/.versions/2.0.6/references/fleet-coordination-patterns.md +171 -0
  761. package/.versions/2.0.6/references/observability-checklist.md +91 -0
  762. package/.versions/2.0.6/references/orchestration-patterns.md +370 -0
  763. package/.versions/2.0.6/references/performance-checklist.md +153 -0
  764. package/.versions/2.0.6/references/prompting-patterns.md +380 -0
  765. package/.versions/2.0.6/references/security-checklist.md +179 -0
  766. package/.versions/2.0.6/references/testing-patterns.md +236 -0
  767. package/.versions/2.0.6/references/workflow-authoring.md +304 -0
  768. package/.versions/2.0.6/scripts/claude-code-preflight.ts +70 -0
  769. package/.versions/2.0.6/scripts/coms-claude-bridge.ts +411 -0
  770. package/.versions/2.0.6/scripts/coms-cli.ts +425 -0
  771. package/.versions/2.0.6/scripts/coms-hermes-bridge.ts +413 -0
  772. package/.versions/2.0.6/scripts/fleet-codex-client.ts +69 -0
  773. package/.versions/2.0.6/scripts/fleet-codex-read.py +146 -0
  774. package/.versions/2.0.6/scripts/fleet.ts +216 -0
  775. package/.versions/2.0.6/scripts/flow.ts +137 -0
  776. package/.versions/2.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  777. package/.versions/2.0.6/scripts/hermes-monitor-scenario.ts +474 -0
  778. package/.versions/2.0.6/scripts/hermes-watchdog-capability-probe.ts +45 -0
  779. package/.versions/2.0.6/scripts/install-hermes-plugin.sh +180 -0
  780. package/.versions/2.0.6/scripts/lib/claude-bridge-core.ts +210 -0
  781. package/.versions/2.0.6/scripts/lib/coms-envelope.ts +582 -0
  782. package/.versions/2.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  783. package/.versions/2.0.6/scripts/lib/fleet-codex-catalog.ts +63 -0
  784. package/.versions/2.0.6/scripts/lib/fleet-codex-operations.ts +190 -0
  785. package/.versions/2.0.6/scripts/lib/fleet-codex-session.ts +166 -0
  786. package/.versions/2.0.6/scripts/lib/fleet-codex-transport.ts +124 -0
  787. package/.versions/2.0.6/scripts/lib/fleet-command.ts +252 -0
  788. package/.versions/2.0.6/scripts/lib/flow-command.ts +93 -0
  789. package/.versions/2.0.6/scripts/lib/flow-maintenance.ts +230 -0
  790. package/.versions/2.0.6/scripts/lib/herdr-layout.ts +281 -0
  791. package/.versions/2.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  792. package/.versions/2.0.6/scripts/lib/hermes-monitor-events.ts +1 -0
  793. package/.versions/2.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  794. package/.versions/2.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  795. package/.versions/2.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  796. package/.versions/2.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  797. package/.versions/2.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  798. package/.versions/2.0.6/scripts/lib/monitor-env.ts +146 -0
  799. package/.versions/2.0.6/scripts/lib/peer-launch.ts +318 -0
  800. package/.versions/2.0.6/scripts/lib/persona-banner.ts +62 -0
  801. package/.versions/2.0.6/scripts/lib/runtime-dependencies.js +124 -0
  802. package/.versions/2.0.6/scripts/lib/spawn-stagger.ts +101 -0
  803. package/.versions/2.0.6/scripts/lib/team-project.ts +178 -0
  804. package/.versions/2.0.6/scripts/lib/team-snapshot.ts +147 -0
  805. package/.versions/2.0.6/scripts/package-lock.json +35 -0
  806. package/.versions/2.0.6/scripts/package.json +9 -0
  807. package/.versions/2.0.6/scripts/peer-banner.ts +40 -0
  808. package/.versions/2.0.6/scripts/peer-launch.ts +285 -0
  809. package/.versions/2.0.6/scripts/team-snapshot.ts +237 -0
  810. package/.versions/2.0.6/scripts/team-up.ts +378 -0
  811. package/.versions/2.0.6/scripts/workflows/lib/agent-phase.ts +133 -0
  812. package/.versions/2.0.6/scripts/workflows/lib/changes.ts +61 -0
  813. package/.versions/2.0.6/scripts/workflows/lib/debate.ts +149 -0
  814. package/.versions/2.0.6/scripts/workflows/lib/env.ts +34 -0
  815. package/.versions/2.0.6/scripts/workflows/lib/envelopes.ts +169 -0
  816. package/.versions/2.0.6/scripts/workflows/lib/gates.ts +81 -0
  817. package/.versions/2.0.6/scripts/workflows/lib/git.ts +96 -0
  818. package/.versions/2.0.6/scripts/workflows/lib/merge.ts +95 -0
  819. package/.versions/2.0.6/scripts/workflows/lib/model-profile.ts +22 -0
  820. package/.versions/2.0.6/scripts/workflows/lib/model-visibility.ts +92 -0
  821. package/.versions/2.0.6/scripts/workflows/lib/permissions.ts +130 -0
  822. package/.versions/2.0.6/scripts/workflows/lib/personas.ts +57 -0
  823. package/.versions/2.0.6/scripts/workflows/lib/poll.ts +86 -0
  824. package/.versions/2.0.6/scripts/workflows/lib/quality.ts +64 -0
  825. package/.versions/2.0.6/scripts/workflows/lib/run.ts +108 -0
  826. package/.versions/2.0.6/scripts/workflows/lib/trace.ts +34 -0
  827. package/.versions/2.0.6/scripts/workflows/lib/voices.ts +128 -0
  828. package/.versions/2.0.6/scripts/workflows/lib/writer-lease.ts +112 -0
  829. package/.versions/2.0.6/scripts/workflows/tsconfig.json +22 -0
  830. package/.versions/2.0.6/scripts/workflows/wf-build-test.ts +61 -0
  831. package/.versions/2.0.6/scripts/workflows/wf-debate.ts +87 -0
  832. package/.versions/2.0.6/scripts/workflows/wf-document.ts +50 -0
  833. package/.versions/2.0.6/scripts/workflows/wf-poll.ts +95 -0
  834. package/.versions/2.0.6/scripts/workflows/wf-quality.ts +20 -0
  835. package/.versions/2.0.6/scripts/workflows/wf-scout.ts +38 -0
  836. package/.versions/2.0.6/skills/_internal/grilling.md +59 -0
  837. package/.versions/2.0.6/skills/browser-testing-with-devtools/SKILL.md +351 -0
  838. package/.versions/2.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  839. package/.versions/2.0.6/skills/compound-learning/SKILL.md +137 -0
  840. package/.versions/2.0.6/skills/context-engineering/SKILL.md +291 -0
  841. package/.versions/2.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  842. package/.versions/2.0.6/skills/designing-agents/SKILL.md +394 -0
  843. package/.versions/2.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  844. package/.versions/2.0.6/skills/drafting-workflows/SKILL.md +143 -0
  845. package/.versions/2.0.6/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  846. package/.versions/2.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  847. package/.versions/2.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  848. package/.versions/2.0.6/skills/idea-refine/SKILL.md +182 -0
  849. package/.versions/2.0.6/skills/idea-refine/examples.md +238 -0
  850. package/.versions/2.0.6/skills/idea-refine/frameworks.md +99 -0
  851. package/.versions/2.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  852. package/.versions/2.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  853. package/.versions/2.0.6/skills/incremental-implementation/SKILL.md +298 -0
  854. package/.versions/2.0.6/skills/interview-me/SKILL.md +226 -0
  855. package/.versions/2.0.6/skills/orchestration-verification/SKILL.md +181 -0
  856. package/.versions/2.0.6/skills/peer-coms/SKILL.md +90 -0
  857. package/.versions/2.0.6/skills/performance-optimization/SKILL.md +350 -0
  858. package/.versions/2.0.6/skills/planning-and-task-breakdown/SKILL.md +265 -0
  859. package/.versions/2.0.6/skills/security-and-hardening/SKILL.md +461 -0
  860. package/.versions/2.0.6/skills/spec-driven-development/SKILL.md +256 -0
  861. package/.versions/2.0.6/skills/using-agent-skills/SKILL.md +197 -0
  862. package/.versions/2.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  863. package/.versions/2.0.6/vendor/agent-skills-upstream/README.md +11 -0
  864. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  865. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  866. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  867. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  868. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  869. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  870. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  871. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  872. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  873. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  874. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  875. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  876. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  877. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  878. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  879. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  880. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  881. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  882. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  883. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  884. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  885. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  886. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  887. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  888. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  889. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  890. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  891. package/.versions/2.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  892. package/CHANGELOG.md +29 -0
  893. package/README.md +13 -15
  894. package/agents/builder.md +2 -2
  895. package/agents/documenter.md +2 -1
  896. package/agents/planner.md +2 -1
  897. package/agents/releaser.md +2 -2
  898. package/bin/catalog/harness-runtime-closure.json +1 -6
  899. package/bin/lib/desired.js +2 -2
  900. package/bin/lib/features.js +8 -1
  901. package/bin/snapshot-version.js +1 -2
  902. package/codex/fleet-session-client/SKILL.md +34 -0
  903. package/codex/fleet-session-client.zip +0 -0
  904. package/docs/ARCHITECTURE.md +4 -4
  905. package/docs/MIGRATION-agent-fleet.md +2 -2
  906. package/docs/agent-fleet-setup.md +28 -14
  907. package/docs/assets/branding/README.md +33 -0
  908. package/docs/assets/branding/agent-fleet-logo-v1.png +0 -0
  909. package/docs/assets/branding/agent-fleet-logo-white-v1.png +0 -0
  910. package/docs/codex-session-bridge.md +219 -0
  911. package/docs/coms-hermes-bridge.md +4 -5
  912. package/docs/getting-started.md +2 -0
  913. package/docs/npm-install.md +3 -1
  914. package/docs/pi-extensions.md +3 -4
  915. package/docs/pi-setup.md +2 -0
  916. package/hermes/README.md +1 -1
  917. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +19 -16
  918. package/install-manifest.json +54 -72
  919. package/justfile +0 -42
  920. package/manifest-meta.json +50 -43
  921. package/package.json +10 -7
  922. package/scripts/coms-cli.ts +2 -61
  923. package/scripts/fleet-codex-client.ts +69 -0
  924. package/scripts/fleet-codex-read.py +146 -0
  925. package/scripts/fleet.ts +0 -6
  926. package/scripts/lib/fleet-codex-catalog.ts +63 -0
  927. package/scripts/lib/fleet-codex-operations.ts +190 -0
  928. package/scripts/lib/fleet-codex-session.ts +166 -0
  929. package/scripts/lib/fleet-codex-transport.ts +124 -0
  930. package/scripts/lib/fleet-command.ts +5 -23
  931. package/scripts/lib/team-project.ts +15 -50
  932. package/scripts/team-up.ts +6 -34
  933. /package/{codex → .versions/2.0.5/codex}/CONDUCTOR.md +0 -0
  934. /package/{docs → .versions/2.0.5/docs}/codex-remote-conductor.md +0 -0
  935. /package/{scripts → .versions/2.0.5/scripts}/codex-conductor.ts +0 -0
  936. /package/{scripts → .versions/2.0.5/scripts}/codex-remote-control.ts +0 -0
  937. /package/{scripts → .versions/2.0.5/scripts}/lib/codex-conductor.ts +0 -0
  938. /package/{scripts → .versions/2.0.5/scripts}/lib/codex-remote-control.ts +0 -0
  939. /package/{systemd → .versions/2.0.5/systemd}/user/agent-fleet-codex-remote-control.service.in +0 -0
@@ -0,0 +1,126 @@
1
+ # Getting started
2
+
3
+ <img src="https://raw.githubusercontent.com/chankov/agent-fleet/main/docs/assets/branding/agent-fleet-logo-white-v1.png" alt="Agent Fleet — Many agents. One direction." width="480">
4
+
5
+ Agent Fleet installs deterministic pi workspace content. The public lifecycle is
6
+ **setup**, **doctor**, and **uninstall**; no coding agent or model is required.
7
+
8
+ ## Install a new repository
9
+
10
+ From the target repository, run the package command. `just fleet` does not exist
11
+ yet — the managed justfile region is one of the things setup writes — so a first
12
+ install always goes through `npx`:
13
+
14
+ ```bash
15
+ cd ~/projects/my-app
16
+ npx @chankov/agent-fleet@latest setup
17
+ ```
18
+
19
+ In a real TTY that opens the installer: choose **Default** or **Full** plus
20
+ optional comma-separated features, read the exact plan, and confirm once. For
21
+ automation, name the selection and consent:
22
+
23
+ ```bash
24
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
25
+ ```
26
+
27
+ Choose **Default** for stable Fleet Core or **Full** for all stable,
28
+ platform-applicable catalogue roots. Default creates neither voice configuration
29
+ nor `.claude/`; Full may install the recorded Claude Code coms bridge. Features
30
+ are named additions after preset selection. In an Agent Fleet source checkout,
31
+ use `node bin/cli.js setup` instead.
32
+
33
+ Setup writes files but runs no commands, so finish the install with the npm
34
+ steps it deliberately skipped — the workspace is not launchable until they run:
35
+
36
+ ```bash
37
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
38
+ just fleet doctor # exit 0 = nothing to repair
39
+ ```
40
+
41
+ (Or pass `--allow-exec` to setup and let it run them in the same pass.)
42
+
43
+ `doctor` validates all three roots with `npm ls`. The launcher repeats that
44
+ read-only preflight before Pi starts and points back to `just fleet deps` or
45
+ `setup --allow-exec` instead of allowing a missing import to surface later as a
46
+ misleading unknown command-line option.
47
+
48
+ ## First session
49
+
50
+ ```bash
51
+ just fleet # Hub/operator; empty native roster
52
+ just fleet --agents default --project af # Hub/orchestrator + native roster
53
+ just fleet --agents default --peers docs --project af
54
+ # Hub + standing Herdr peers
55
+ ```
56
+
57
+ ## Run and maintain deterministic flows
58
+
59
+ When the workflow runtime is selected, `just flow` runs code-owned workflows outside the interactive hub:
60
+
61
+ ```bash
62
+ just flow scout "where is authentication configured?"
63
+ just flow quality
64
+ just flow build-test "add the validated endpoint"
65
+ ```
66
+
67
+ Each run creates a `flow/<name>-<runId>` branch. Use the numbered maintenance selector to remove an empty/integrated branch or squash-merge an accepted result back to the branch from which it started:
68
+
69
+ ```bash
70
+ just flow cleanup # list flow branches and prompt for a number
71
+ just flow cleanup 1 # safely remove selection 1 through Worktrunk
72
+ just flow merge # list flow branches and prompt for a number
73
+ just flow merge 2 # squash-merge selection 2 through Worktrunk
74
+ ```
75
+
76
+ Maintenance requires [Worktrunk](https://worktrunk.dev). It refuses dirty worktrees, rejected runs, and unknown merge targets. See [workflows.md](workflows.md#clean-up-and-merge-flow-branches) for `--discard`, `--target`, full branch selectors, non-interactive `--yes`, and safety details.
77
+
78
+ ## Update an existing install
79
+
80
+ A pi session tells you when a newer version is published. To act on it:
81
+
82
+ ```bash
83
+ just fleet setup --dry-run # preview: what changes, what gets overwritten
84
+ just fleet setup # apply; shows the plan and asks once
85
+ just fleet deps # if the plan skipped the npm steps
86
+ just fleet doctor
87
+ ```
88
+
89
+ Your preset and features are remembered in `.ai/agent-fleet.json`, so a plain
90
+ `setup` reconciles to the selection you already chose.
91
+
92
+ Two things to know before your first update:
93
+
94
+ - **`setup` reconciles toward the package.** A file you edited in place is
95
+ refreshed and your edit is overwritten — no prompt, no conflict. Customize
96
+ through `.ai/agent-fleet-overrides.md` instead, which the lifecycle never
97
+ touches.
98
+ - **A conflict stops the run.** If you *and* the new version changed the same
99
+ file, setup exits `3` having written nothing; re-run with `--on-conflict
100
+ theirs` or `--on-conflict ours`.
101
+
102
+ `pi update --extensions` updates pi's own extensions only — never this installer
103
+ or what it wrote. Full update reference, including what happens to every file
104
+ state: [npm-install.md](npm-install.md#updating-an-existing-install).
105
+
106
+ ## Uninstall
107
+
108
+ `just fleet uninstall --yes` is for the self-hosted workspace lifecycle; it
109
+ removes the launcher last. Reinstall after that with the package CLI, not `just`:
110
+
111
+ ```bash
112
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
113
+ ```
114
+
115
+ ## Pi package-native skills and prompts
116
+
117
+ For pi package-native skills/prompts instead of copied ones:
118
+
119
+ ```bash
120
+ pi install -l npm:@chankov/agent-fleet
121
+ ```
122
+
123
+ Do not mix copied and package-native skills/prompts. `doctor` identifies that
124
+ ownership overlap. Read [pi-setup.md](pi-setup.md) for runtime composition,
125
+ [agent-fleet-setup.md](agent-fleet-setup.md) for project configuration, and
126
+ [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md) for the major-release matrix.
@@ -0,0 +1,301 @@
1
+ # Install and lifecycle
2
+
3
+ <img src="https://raw.githubusercontent.com/chankov/agent-fleet/main/docs/assets/branding/agent-fleet-logo-white-v1.png" alt="Agent Fleet — Many agents. One direction." width="480">
4
+
5
+ `@chankov/agent-fleet` is a deterministic pi workspace installer. It needs no
6
+ coding agent or model: `setup`, `doctor`, and `uninstall` are the public
7
+ lifecycle commands.
8
+
9
+ - [First install](#first-install) — a repository that has never had Agent Fleet
10
+ - [Updating an existing install](#updating-an-existing-install) — a new version shipped
11
+ - [What reconcile does to each file](#what-reconcile-does-to-each-file) — **read this before your first update**
12
+ - [Doctor and uninstall](#doctor-and-uninstall)
13
+
14
+ ## First install
15
+
16
+ Run the package command from the target repository. There is no `just fleet`
17
+ recipe yet — the managed justfile region is one of the things setup *writes* —
18
+ so the first install always goes through `npx`:
19
+
20
+ ```bash
21
+ cd ~/projects/my-app
22
+ npx @chankov/agent-fleet@latest setup
23
+ ```
24
+
25
+ In a real TTY this opens the installer: pick **Default** or **Full**, add
26
+ optional comma-separated features, read the exact reconciliation plan, and
27
+ confirm once to apply. For automation, name the selection and consent up front:
28
+
29
+ ```bash
30
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
31
+ ```
32
+
33
+ Pin the exact version when the run has to be reproducible:
34
+
35
+ ```bash
36
+ npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
37
+ ```
38
+
39
+ **Default** is the launchable, stable Fleet Core and creates neither `.claude/`
40
+ nor voice configuration. **Full** selects every stable, platform-applicable
41
+ catalogue root; it may install the recorded Claude Code coms bridge. Features
42
+ are additive named capabilities (`browser`, `voice`, `hermes`, `telegram`,
43
+ `claude-bridge`, and the experimental `chatgpt-client`), not an arbitrary
44
+ package-entry mode — `setup --help` lists them.
45
+
46
+ ### Then install the runtime dependencies
47
+
48
+ Setup writes files; it does not run commands for you. The three `npm` steps for
49
+ `.pi/extensions`, `.pi/harnesses`, and `scripts` are planned as `skip` with the
50
+ reason *"runs a command — re-run with `--allow-exec` to include it"*. **A
51
+ workspace is not launchable until they run.** Either let setup run them:
52
+
53
+ ```bash
54
+ npx @chankov/agent-fleet@latest setup --preset default --features none --allow-exec --yes
55
+ ```
56
+
57
+ …or run them afterwards through the recipe setup just installed:
58
+
59
+ ```bash
60
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
61
+ just fleet doctor # confirm the workspace is whole
62
+ ```
63
+
64
+ `doctor` runs `npm ls --depth=0` against each installed root. Missing or invalid
65
+ runtime trees are launch-blocking findings (exit `2`) with the same two
66
+ remediation paths above; `doctor --fix` deliberately does not infer consent to
67
+ run a new npm install. The `just fleet` launcher performs the same check before
68
+ starting Pi, so an extension import failure cannot be misreported as an unknown
69
+ flag such as `--project`.
70
+
71
+ ### Verify the result
72
+
73
+ ```bash
74
+ just fleet doctor # exit 0 = nothing to repair, 2 = repairable findings
75
+ just fleet # Hub in operator work mode, empty native roster
76
+ ```
77
+
78
+ From here on `just fleet setup`, `just fleet doctor`, and `just fleet uninstall`
79
+ are available as thin wrappers over `npx @chankov/agent-fleet@latest`. They are
80
+ a convenience for a workspace that already has the justfile — never the
81
+ first-install path.
82
+
83
+ ### Source checkout
84
+
85
+ Inside an Agent Fleet checkout, use the local CLI instead of the published
86
+ package:
87
+
88
+ ```bash
89
+ node bin/cli.js setup --workspace ~/projects/my-app --preset default --features none --yes
90
+ ```
91
+
92
+ ## Updating an existing install
93
+
94
+ ### 1. Notice there is one
95
+
96
+ A pi session started from a workspace with an install record prints a one-line
97
+ banner on its first turn (`pi-extension:agent-fleet-update-check`, installed by
98
+ Default):
99
+
100
+ ```
101
+ agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest setup" to reconcile the workspace.
102
+ ```
103
+
104
+ To ask directly, without a session — it prints one line when an update exists
105
+ and stays silent when you are current:
106
+
107
+ ```bash
108
+ npx @chankov/agent-fleet check-update
109
+ ```
110
+
111
+ `pi update --extensions` updates pi's own extensions. It does **not** update
112
+ this installer or anything it wrote.
113
+
114
+ ### 2. Preview the reconcile
115
+
116
+ Always worth it, always free — `--dry-run` writes nothing and needs no consent:
117
+
118
+ ```bash
119
+ just fleet setup --dry-run
120
+ # or, without the justfile recipe:
121
+ npx @chankov/agent-fleet@latest setup --dry-run
122
+ ```
123
+
124
+ The plan names every action and its reason. What you are reading for:
125
+
126
+ | Line in the plan | Means |
127
+ |---|---|
128
+ | `create` | New in this version, or a feature you added |
129
+ | `refresh … source is newer; the local copy is unmodified` | Clean update. Safe. |
130
+ | `refresh … locally modified — selecting it overwrites your edits` | **Your edit is about to be lost.** See below. |
131
+ | `conflict … changed both locally and upstream` | The run will exit `3` and write nothing until you choose a policy |
132
+ | `keep` | Unchanged, or installed but outside this selection |
133
+ | `remove` | Retired upstream and recorded as ours |
134
+ | `skip … runs a command` | The `npm` steps — follow with `just fleet deps` |
135
+
136
+ ### 3. Apply it
137
+
138
+ ```bash
139
+ just fleet setup # interactive: shows the plan, asks once
140
+ just fleet setup --yes # non-interactive
141
+ just fleet deps # if the plan skipped the exec steps
142
+ just fleet doctor # verify
143
+ ```
144
+
145
+ Your `--preset` / `--features` selection is **remembered**. `.ai/agent-fleet.json`
146
+ is the desired state, so a plain `setup` reconciles to whatever that file says —
147
+ you do not restate the preset on every update. Flags passed on an update are
148
+ ephemeral for that run only unless you add `--save-desired`:
149
+
150
+ ```bash
151
+ just fleet setup --features voice,browser --yes # this run only
152
+ just fleet setup --features voice,browser --save-desired --yes # persisted
153
+ ```
154
+
155
+ ### 4. Handle a conflict
156
+
157
+ A conflict is *both* sides changing: you edited an installed file **and** the new
158
+ version changed the same file. Setup refuses to guess — it exits `3` before
159
+ writing anything:
160
+
161
+ ```
162
+ conflict skill:code-review-and-quality changed both locally and upstream
163
+ exit 3
164
+ ```
165
+
166
+ Resolve by naming a policy for the run:
167
+
168
+ ```bash
169
+ just fleet setup --on-conflict theirs --yes # take the package version
170
+ just fleet setup --on-conflict ours --yes # keep your copy
171
+ ```
172
+
173
+ `theirs` writes the incoming file and your version is gone; `ours` keeps your
174
+ file and this item stays behind the package until you reconcile it by hand. To
175
+ keep a local edit *and* pick up the new upstream content, copy your edit out
176
+ first, take `theirs`, then re-apply it.
177
+
178
+ ### Keeping local edits across updates
179
+
180
+ If you have customized an installed artifact — a skill under `.pi/skills/`, a
181
+ persona under `agents/` — understand that `setup` is a **reconcile to the
182
+ package**, not a merge in your favour. A file you edited where upstream did not
183
+ change is refreshed and your edit is overwritten, without a conflict and without
184
+ a prompt. `--dry-run` is what makes this visible before it happens.
185
+
186
+ The durable ways to customize:
187
+
188
+ - **`.ai/agent-fleet-overrides.md`** — human-owned, never overwritten. Spec/plan
189
+ paths, dev server, branch policy, per-persona models, dispatcher language.
190
+ See [agent-fleet-setup.md](agent-fleet-setup.md). This is the intended door.
191
+ - **Your own artifacts** — a skill under a name Agent Fleet does not ship is not
192
+ in the catalogue, so no lifecycle command touches it.
193
+ - **Deselect the item** — `setup` never removes what falls outside the current
194
+ selection, so a narrower preset leaves an item installed and frozen (`keep …
195
+ installed but not in this selection`).
196
+
197
+ Editing a shipped artifact in place is the one approach the lifecycle actively
198
+ works against.
199
+
200
+ ## What reconcile does to each file
201
+
202
+ The engine classifies every recorded file by comparing three things: the copy on
203
+ disk, the current package source, and the *baseline* — the same file as it
204
+ shipped in the version recorded in `.ai/agent-fleet-state.json`, read from the
205
+ package's `.versions/<x.y.z>/` snapshot tree.
206
+
207
+ | Disk vs source vs baseline | State | `setup` does |
208
+ |---|---|---|
209
+ | Disk matches source | `up-to-date` | `keep` |
210
+ | Disk matches baseline, source moved | `outdated` | `refresh` — clean update |
211
+ | Source matches baseline, disk moved | `modified` | **`refresh` — overwrites your edit** |
212
+ | Disk and source both moved, differently | `conflict` | exits `3` unless `--on-conflict` |
213
+ | Recorded, but no source in this version | `gone` | `keep` (the deprecated `upgrade` proposes removal) |
214
+ | Recorded, missing or mis-linked on disk | breakage | `repair`, regardless of selection |
215
+
216
+ Two things narrow this. If the `.versions/` snapshot for the recorded version is
217
+ missing (an unpublished local build, or a version older than retention), there is
218
+ no baseline: the comparison degrades to two-way, an edited file reads as
219
+ `modified`, and no `conflict` can be detected. And `keep`-on-local-edit is the
220
+ behaviour of the **deprecated `upgrade` verb**, not of `setup` — if you have
221
+ relied on `upgrade` preserving your edits, that is the difference to plan for.
222
+
223
+ ## Desired state and migration
224
+
225
+ The desired selection lives in `.ai/agent-fleet.json` — human-owned, meant to be
226
+ committed. Command-line preset and feature flags are ephemeral over an existing
227
+ file unless `--save-desired` is passed. When the file is missing, setup writes
228
+ the selected desired state in the same transaction as its artifacts.
229
+
230
+ The first major-release migration, from a workspace that predates the state
231
+ file, is deliberately strict:
232
+
233
+ ```bash
234
+ # Preview is safe and does not require consent.
235
+ npx @chankov/agent-fleet@latest setup --migrate --dry-run
236
+
237
+ # Automation must name the desired state and explicitly consent to migration.
238
+ npx @chankov/agent-fleet@latest setup --migrate --preset default --features none --yes
239
+ ```
240
+
241
+ Migration lists each exact removal before consent and removes only unchanged,
242
+ state-owned legacy artifacts. Foreign or locally modified files survive.
243
+
244
+ `init`, `install`, `upgrade`, and `update` are deprecated. `init` and `update`
245
+ dispatch to `setup`; `install` and `upgrade` keep their historical selection and
246
+ three-way-merge semantics and warn. New scripts should use `setup`.
247
+
248
+ ## Doctor and uninstall
249
+
250
+ ```bash
251
+ npx @chankov/agent-fleet doctor # read-only; never prompts
252
+ npx @chankov/agent-fleet doctor --fix
253
+ npx @chankov/agent-fleet uninstall --all --yes
254
+ npx @chankov/agent-fleet uninstall --all --purge-config --yes
255
+ ```
256
+
257
+ Uninstall removes only paths recorded in `.ai/agent-fleet-state.json`, and
258
+ preserves any recorded path whose bytes no longer match what we wrote. It also
259
+ preserves human configuration by default: `.ai/agent-fleet.json`,
260
+ `.ai/agent-fleet-overrides.md`, `.ai/stt.json`, and environment files.
261
+ `--purge-config` is the separate destructive gate for the three human config
262
+ files; environment files are never removed.
263
+
264
+ A self-hosted workspace may use `just fleet uninstall --yes`. It removes ordinary
265
+ owned artifacts first, then the managed justfile region and launcher scripts,
266
+ and finally lifecycle state/journal data; the already-running command prints its
267
+ final report from memory. Because that removes `just fleet`, reinstall with the
268
+ package CLI, then use `just fleet` again:
269
+
270
+ ```bash
271
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
272
+ just fleet doctor
273
+ ```
274
+
275
+ ## Package-native pi install
276
+
277
+ ```bash
278
+ pi install -l npm:@chankov/agent-fleet
279
+ ```
280
+
281
+ This exposes package-native skills and prompts. Do not also copy the same skills
282
+ and prompts into `.pi/`; `doctor` reports that ownership overlap as a read-only
283
+ `pi-package-ownership` advisory. Harness-only composition is supported:
284
+ package-native skills/prompts with copied Fleet Core harnesses.
285
+
286
+ ## Safety contract
287
+
288
+ All lifecycle commands support `--dry-run`; JSON output requires either
289
+ `--dry-run` or `--yes`. Files outside state ownership are never adopted for
290
+ removal. A failed file transaction rolls back rather than reporting success, and
291
+ `.ai/agent-fleet-transaction.json` is the crash-recovery journal `doctor --fix`
292
+ reads.
293
+
294
+ | Exit | Meaning |
295
+ |---|---|
296
+ | `0` | Success, or nothing to do |
297
+ | `1` | Could not run |
298
+ | `2` | `doctor` found repairable or launch-blocking manual-action issues |
299
+ | `3` | `setup` hit unresolved conflicts and wrote nothing |
300
+
301
+ See [Migration](MIGRATION-agent-fleet.md) for the full major-release matrix.