@chankov/agent-fleet 2.0.6 → 2.0.7

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 (450) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/README.md +11 -0
  4. package/.pi/harnesses/damage-control-continue/index.ts +5 -0
  5. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  6. package/.pi/harnesses/lib/update-check.ts +222 -0
  7. package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  8. package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
  9. package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
  10. package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
  11. package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
  12. package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
  13. package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
  14. package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
  15. package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
  16. package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
  17. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  18. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  19. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  20. package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  21. package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  22. package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  23. package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  24. package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  25. package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  26. package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
  27. package/.versions/2.0.7/.pi/extensions/package.json +9 -0
  28. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
  29. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  30. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  31. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  32. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  33. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  34. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  35. package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
  36. package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  37. package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  38. package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  39. package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  40. package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  41. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  42. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  43. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  44. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  45. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  46. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  47. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  48. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  49. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  50. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  51. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  52. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  53. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  54. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  55. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  56. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  57. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  58. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  59. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  60. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  61. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  62. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  63. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  64. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  65. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  66. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  67. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  68. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  69. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  70. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  71. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  72. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  73. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  74. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  75. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  76. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  77. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  78. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  79. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  80. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  81. package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  82. package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
  83. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  84. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  85. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  86. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  87. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  88. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  89. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  90. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  91. package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  92. package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  93. package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  94. package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  95. package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  96. package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  97. package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
  98. package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
  99. package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  100. package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
  101. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  102. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  103. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  104. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  105. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  106. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  107. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  108. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  109. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  110. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  111. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  112. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  113. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  114. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  115. package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  116. package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  117. package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  118. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  119. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  120. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  121. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  122. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  123. package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  124. package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
  125. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  126. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  127. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  128. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  129. package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  130. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  131. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  132. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  133. package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  134. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  135. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  136. package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
  137. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
  138. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  139. package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  140. package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  141. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  142. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
  143. package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
  144. package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
  145. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  146. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  147. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  148. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  149. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  150. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  151. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  152. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  153. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  154. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  155. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  156. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  157. package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
  158. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  159. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  160. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  161. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  162. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  163. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  164. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  165. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  166. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  167. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  168. package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
  169. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  170. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  171. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
  172. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
  173. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  174. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  175. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  176. package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
  177. package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
  178. package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
  179. package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
  180. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
  181. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
  182. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  183. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
  184. package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
  185. package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
  186. package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  187. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  188. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  189. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
  190. package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
  191. package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  192. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  193. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  194. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  195. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  196. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  197. package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  198. package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  199. package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
  200. package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  201. package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
  202. package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  203. package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
  204. package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  205. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  206. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  207. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  208. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  209. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  210. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  211. package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
  212. package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
  213. package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
  214. package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
  215. package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
  216. package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
  217. package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
  218. package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
  219. package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  220. package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  221. package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
  222. package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
  223. package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
  224. package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
  225. package/.versions/2.0.7/.version +1 -0
  226. package/.versions/2.0.7/agents/architect.md +25 -0
  227. package/.versions/2.0.7/agents/bowser.md +28 -0
  228. package/.versions/2.0.7/agents/builder.md +56 -0
  229. package/.versions/2.0.7/agents/code-reviewer.md +210 -0
  230. package/.versions/2.0.7/agents/deep-researcher.md +33 -0
  231. package/.versions/2.0.7/agents/documenter.md +23 -0
  232. package/.versions/2.0.7/agents/orchestrator.md +23 -0
  233. package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
  234. package/.versions/2.0.7/agents/planner.md +106 -0
  235. package/.versions/2.0.7/agents/releaser.md +25 -0
  236. package/.versions/2.0.7/agents/researcher.md +31 -0
  237. package/.versions/2.0.7/agents/security-auditor.md +168 -0
  238. package/.versions/2.0.7/agents/test-engineer.md +154 -0
  239. package/.versions/2.0.7/agents/web-debugger.md +44 -0
  240. package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
  241. package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
  242. package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
  243. package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
  244. package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
  245. package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
  246. package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
  247. package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
  248. package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
  249. package/.versions/2.0.7/docs/getting-started.md +126 -0
  250. package/.versions/2.0.7/docs/npm-install.md +327 -0
  251. package/.versions/2.0.7/docs/pi-extensions.md +446 -0
  252. package/.versions/2.0.7/docs/pi-setup.md +76 -0
  253. package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
  254. package/.versions/2.0.7/hermes/README.md +347 -0
  255. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  256. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  257. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  258. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  259. package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
  260. package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  261. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  262. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  263. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  264. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  265. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  266. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  267. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  268. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  269. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  270. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  271. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  272. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  273. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  274. package/.versions/2.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  275. package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  276. package/.versions/2.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  277. package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  278. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  279. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  280. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  281. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  282. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  283. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  284. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  285. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  286. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  287. package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
  288. package/.versions/2.0.7/hooks/coms-stop-hook.mjs +84 -0
  289. package/.versions/2.0.7/install-manifest.json +2886 -0
  290. package/.versions/2.0.7/justfile +247 -0
  291. package/.versions/2.0.7/manifest-meta.json +958 -0
  292. package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
  293. package/.versions/2.0.7/references/communication-contract.md +26 -0
  294. package/.versions/2.0.7/references/definition-of-done.md +67 -0
  295. package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
  296. package/.versions/2.0.7/references/observability-checklist.md +91 -0
  297. package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
  298. package/.versions/2.0.7/references/performance-checklist.md +153 -0
  299. package/.versions/2.0.7/references/prompting-patterns.md +380 -0
  300. package/.versions/2.0.7/references/security-checklist.md +179 -0
  301. package/.versions/2.0.7/references/testing-patterns.md +236 -0
  302. package/.versions/2.0.7/references/workflow-authoring.md +304 -0
  303. package/.versions/2.0.7/scripts/claude-code-preflight.ts +70 -0
  304. package/.versions/2.0.7/scripts/coms-claude-bridge.ts +411 -0
  305. package/.versions/2.0.7/scripts/coms-cli.ts +425 -0
  306. package/.versions/2.0.7/scripts/coms-hermes-bridge.ts +413 -0
  307. package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
  308. package/.versions/2.0.7/scripts/fleet-codex-read.py +146 -0
  309. package/.versions/2.0.7/scripts/fleet.ts +216 -0
  310. package/.versions/2.0.7/scripts/flow.ts +137 -0
  311. package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  312. package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  313. package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  314. package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
  315. package/.versions/2.0.7/scripts/lib/claude-bridge-core.ts +210 -0
  316. package/.versions/2.0.7/scripts/lib/coms-envelope.ts +582 -0
  317. package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  318. package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
  319. package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
  320. package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
  321. package/.versions/2.0.7/scripts/lib/fleet-codex-transport.ts +124 -0
  322. package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
  323. package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
  324. package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
  325. package/.versions/2.0.7/scripts/lib/herdr-layout.ts +281 -0
  326. package/.versions/2.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  327. package/.versions/2.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  328. package/.versions/2.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  329. package/.versions/2.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  330. package/.versions/2.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  331. package/.versions/2.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  332. package/.versions/2.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  333. package/.versions/2.0.7/scripts/lib/monitor-env.ts +146 -0
  334. package/.versions/2.0.7/scripts/lib/peer-launch.ts +318 -0
  335. package/.versions/2.0.7/scripts/lib/persona-banner.ts +62 -0
  336. package/.versions/2.0.7/scripts/lib/runtime-dependencies.js +124 -0
  337. package/.versions/2.0.7/scripts/lib/spawn-stagger.ts +101 -0
  338. package/.versions/2.0.7/scripts/lib/team-project.ts +178 -0
  339. package/.versions/2.0.7/scripts/lib/team-snapshot.ts +147 -0
  340. package/.versions/2.0.7/scripts/package-lock.json +35 -0
  341. package/.versions/2.0.7/scripts/package.json +9 -0
  342. package/.versions/2.0.7/scripts/peer-banner.ts +40 -0
  343. package/.versions/2.0.7/scripts/peer-launch.ts +285 -0
  344. package/.versions/2.0.7/scripts/team-snapshot.ts +237 -0
  345. package/.versions/2.0.7/scripts/team-up.ts +378 -0
  346. package/.versions/2.0.7/scripts/workflows/lib/agent-phase.ts +133 -0
  347. package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
  348. package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
  349. package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
  350. package/.versions/2.0.7/scripts/workflows/lib/envelopes.ts +169 -0
  351. package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
  352. package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
  353. package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
  354. package/.versions/2.0.7/scripts/workflows/lib/model-profile.ts +22 -0
  355. package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
  356. package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
  357. package/.versions/2.0.7/scripts/workflows/lib/personas.ts +57 -0
  358. package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
  359. package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
  360. package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
  361. package/.versions/2.0.7/scripts/workflows/lib/trace.ts +34 -0
  362. package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
  363. package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
  364. package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
  365. package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
  366. package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
  367. package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
  368. package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
  369. package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
  370. package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
  371. package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
  372. package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
  373. package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  374. package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
  375. package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
  376. package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  377. package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
  378. package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  379. package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
  380. package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  381. package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  382. package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  383. package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
  384. package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
  385. package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
  386. package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  387. package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  388. package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
  389. package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
  390. package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
  391. package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
  392. package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
  393. package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
  394. package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
  395. package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
  396. package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
  397. package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  398. package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
  399. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  400. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  401. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  402. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  403. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  404. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  405. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  406. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  407. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  408. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  409. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  410. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  411. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  412. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  413. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  414. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  415. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  416. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  417. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  418. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  419. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  420. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  421. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  422. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  423. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  424. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  425. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  426. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  427. package/CHANGELOG.md +8 -0
  428. package/README.md +14 -7
  429. package/bin/cli.js +149 -78
  430. package/bin/lib/apply.js +53 -62
  431. package/bin/lib/features.js +2 -2
  432. package/bin/lib/public-plan.js +17 -0
  433. package/bin/lib/purge.js +9 -3
  434. package/bin/lib/reconcile.js +4 -10
  435. package/bin/lib/repair-desired.js +73 -0
  436. package/bin/lib/stt-wizard.js +25 -11
  437. package/bin/lib/transaction.js +118 -108
  438. package/bin/lib/tui.js +70 -65
  439. package/bin/lib/update-notifier.js +2 -2
  440. package/bin/lib/workspace-safety.js +72 -0
  441. package/docs/npm-install.md +41 -15
  442. package/docs/pi-extensions.md +3 -3
  443. package/docs/pi-setup.md +2 -2
  444. package/install-manifest.json +1 -39
  445. package/justfile +3 -3
  446. package/manifest-meta.json +2 -20
  447. package/package.json +2 -2
  448. package/scripts/fleet.ts +1 -1
  449. package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
  450. package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
package/bin/cli.js CHANGED
@@ -4,7 +4,7 @@
4
4
  // setup, doctor, and uninstall are complete without a coding agent or model.
5
5
  // Legacy command names remain compatibility aliases and route to setup.
6
6
 
7
- import { readFileSync, existsSync, statSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
7
+ import { readFileSync, existsSync, statSync, mkdirSync, writeFileSync, writeSync, rmSync } from "node:fs";
8
8
  import { fileURLToPath } from "node:url";
9
9
  import { dirname, join, resolve, relative } from "node:path";
10
10
  import { spawnSync } from "node:child_process";
@@ -18,10 +18,15 @@ import { runVerify, hasDrift } from "./lib/verify.js";
18
18
  import { buildPlan, hasConflicts, isNoop } from "./lib/plan.js";
19
19
  import { buildReconcilePlan } from "./lib/reconcile.js";
20
20
  import { applyPlan, retryRuntimeRepairs } from "./lib/apply.js";
21
- import { chooseSetup } from "./lib/tui.js";
21
+ import { askChoice, askFinalApproval, chooseSetup, selectionSummary } from "./lib/tui.js";
22
22
  import { defaultDesired, readDesired } from "./lib/desired.js";
23
+ import { normalizeFeatureSet } from "./lib/features.js";
24
+ import { readSttConfig, STT_PROVIDERS } from "./lib/stt-wizard.js";
25
+ import { prepareDesiredRepair } from "./lib/repair-desired.js";
23
26
  import { purgeHumanConfig } from "./lib/purge.js";
24
- import { recoverTransaction, discardUnrecoverableTransaction, journalPath, transactionRecovery } from "./lib/transaction.js";
27
+ import { capturePlanFingerprints, recoverTransaction, journalPath, transactionRecovery } from "./lib/transaction.js";
28
+ import { acquireWorkspaceLock, breakWorkspaceLock } from "./lib/workspace-safety.js";
29
+ import { publicPlan, publicResult } from "./lib/public-plan.js";
25
30
  import { readState, readLegacyRecord, isAgentFleetCheckout, STATE_REL_PATH } from "./lib/state.js";
26
31
  import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
27
32
  import { checkAndNotify } from "./lib/update-notifier.js";
@@ -32,6 +37,17 @@ import { runtimeDependencyFindings } from "../scripts/lib/runtime-dependencies.j
32
37
  const __dirname = dirname(fileURLToPath(import.meta.url));
33
38
  const pkgRoot = resolve(__dirname, "..");
34
39
  const pkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
40
+ function writeJson(value) {
41
+ const bytes = Buffer.from(JSON.stringify(value, null, 2) + "\n");
42
+ let offset = 0;
43
+ while (offset < bytes.length) {
44
+ try { offset += writeSync(stdout.fd, bytes, offset, bytes.length - offset); }
45
+ catch (error) {
46
+ if (error.code !== "EAGAIN") throw error;
47
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 1);
48
+ }
49
+ }
50
+ }
35
51
 
36
52
  // ── argv parsing ──────────────────────────────────────────────────────────
37
53
 
@@ -60,7 +76,9 @@ const parsed = (() => {
60
76
  profile: { type: "string" },
61
77
  preset: { type: "string" },
62
78
  features: { type: "string" },
79
+ "stt-provider": { type: "string" },
63
80
  "save-desired": { type: "boolean" },
81
+ "repair-config": { type: "boolean" },
64
82
  migrate: { type: "boolean" },
65
83
  "on-conflict": { type: "string" },
66
84
  "purge-config": { type: "boolean" },
@@ -88,6 +106,15 @@ const parsed = (() => {
88
106
  const opts = parsed.values;
89
107
  const workspace = resolve(opts.workspace ?? process.cwd());
90
108
  let repairPlanNote = null;
109
+ let activeLock = null;
110
+ process.once("exit", () => activeLock?.release());
111
+ function lockMutation(operation, { allowPending = false } = {}) {
112
+ // Acquire first so a live transaction is reported as a lock conflict rather
113
+ // than being mistaken for abandoned recovery state.
114
+ try { activeLock = acquireWorkspaceLock(workspace, operation); } catch (error) { fail(error.message, error.exitCode ?? 4); }
115
+ const recovery = transactionRecovery(workspace);
116
+ if (recovery.pending && !allowPending) fail(`pending transaction journal exists${recovery.error ? ` (${recovery.error})` : ""}; run agent-fleet doctor --fix before replanning`);
117
+ }
91
118
 
92
119
  if (opts.help) {
93
120
  printHelp(sub);
@@ -211,45 +238,84 @@ async function cmdSetup() {
211
238
  }
212
239
  const manifest = loadManifest(pkgRoot);
213
240
  const dryRun = Boolean(opts["dry-run"]);
241
+ if (opts.json && !opts.yes && !dryRun) fail("--json requires --yes (or --dry-run); JSON mode never prompts");
214
242
  const interactive = !opts.yes && !dryRun;
243
+ if (!dryRun) lockMutation("setup");
244
+ else if (transactionRecovery(workspace).pending) fail("pending transaction journal exists; run agent-fleet doctor --fix before replanning");
245
+ let configRepair;
246
+ try {
247
+ configRepair = await prepareDesiredRepair({
248
+ workspace, manifest, dryRun, approved: Boolean(opts["repair-config"] && opts.yes),
249
+ interactive: interactive && Boolean(stdin.isTTY), output: process.stderr,
250
+ confirm: async (prompt) => {
251
+ const rl = createInterface({ input: stdin, output: process.stderr }); let interrupted = false;
252
+ rl.on("SIGINT", () => { interrupted = true; rl.close(); });
253
+ try { return await rl.question(prompt); } catch { return interrupted ? null : null; } finally { rl.close(); }
254
+ },
255
+ });
256
+ } catch (err) { fail(err.message); }
257
+ if (configRepair.preview) {
258
+ console.log(JSON.stringify(configRepair.preview, null, 2));
259
+ return;
260
+ }
261
+ if (configRepair.cancelled) {
262
+ console.log("Aborted — nothing was written.");
263
+ return;
264
+ }
215
265
  if (interactive && !stdin.isTTY) {
216
266
  fail("setup mutation requires --yes in non-TTY mode (or use --dry-run to preview)");
217
267
  }
268
+ const setupAborted = configRepair.repaired
269
+ ? "Setup aborted. The approved config repair and its backup remain; no setup plan was applied."
270
+ : "Aborted — nothing was written.";
218
271
 
219
272
  let preset = opts.preset;
220
273
  let features = opts.features;
274
+ let sttProvider = opts["stt-provider"] ?? null;
275
+ let sttReplacementApproved = Boolean(opts.yes || dryRun);
221
276
  let tuiDesired = null;
222
277
  let setupReadLine = null;
223
278
  let setupRl = null;
224
279
  if (interactive) {
225
280
  setupRl = createInterface({ input: stdin, output: stdout });
226
- setupReadLine = async () => {
227
- try { return await setupRl.question(""); } catch { return null; }
228
- };
281
+ setupReadLine = (prompt = "") => new Promise((resolveAnswer) => {
282
+ const interrupted = () => { setupRl.removeListener("SIGINT", interrupted); resolveAnswer("__AGENT_FLEET_INTERRUPT__"); };
283
+ setupRl.once("SIGINT", interrupted);
284
+ setupRl.question(prompt).then((answer) => { setupRl.removeListener("SIGINT", interrupted); resolveAnswer(answer); }, () => { setupRl.removeListener("SIGINT", interrupted); resolveAnswer(null); });
285
+ });
286
+ setupReadLine.ownsPrompt = true;
229
287
  let selection;
230
288
  try {
231
- selection = await chooseSetup({
232
- output: stdout,
233
- readLine: setupReadLine,
234
- manifest,
235
- currentDesired: readDesired(workspace, manifest),
236
- });
237
- } catch (err) {
238
- setupRl.close();
239
- fail(err.message);
240
- }
241
- if (selection.cancelled) {
242
- setupRl.close();
243
- console.log("Aborted — nothing was written.");
244
- exit(0);
245
- }
246
- preset = selection.preset;
247
- features = selection.features.join(",");
289
+ const initial = readDesired(workspace, manifest) ?? defaultDesired(manifest);
290
+ if (preset !== undefined) initial.preset = preset;
291
+ if (features !== undefined) {
292
+ const selected = new Set(normalizeFeatureSet(manifest, features));
293
+ initial.features = Object.fromEntries(Object.keys(initial.features).map((name) => [name, selected.has(name)]));
294
+ }
295
+ selection = await chooseSetup({ output: stdout, readLine: setupReadLine, manifest, currentDesired: initial });
296
+ const existingStt = !selection.cancelled && selection.features.includes("voice") ? readSttConfig(workspace) : null;
297
+ if (!selection.cancelled && selection.features.includes("voice") && !existingStt && !sttProvider) {
298
+ const provider = await askChoice({ output: stdout, readLine: setupReadLine,
299
+ prompt: `STT provider: ${Object.keys(STT_PROVIDERS).join(" | ")} | cancel; Enter = cancel (no secret values requested) > `,
300
+ validate: (value) => STT_PROVIDERS[value.toLowerCase()] ? { ok: true, value: value.toLowerCase() } : value === "" ? { ok: true, value: null } : { ok: false, error: "Invalid STT provider. Choose a listed provider or cancel." },
301
+ });
302
+ if (provider.cancelled || !provider.value) selection = { cancelled: true, reason: provider.reason ?? "no provider" };
303
+ else sttProvider = provider.value;
304
+ } else if (!selection.cancelled && existingStt && sttProvider && sttProvider !== existingStt.config.provider) {
305
+ const replacement = await askChoice({ output: stdout, readLine: setupReadLine,
306
+ prompt: `Replace STT provider ${existingStt.config.provider} with ${sttProvider}? yes/y | no/n | cancel; Enter = no (keep existing provider) > `,
307
+ validate: (value) => /^y(?:es)?$/i.test(value) ? { ok: true, value: true } : value === "" || /^n(?:o)?$/i.test(value) ? { ok: true, value: false } : { ok: false, error: "Invalid answer. Enter yes/y to replace or no/n to keep the existing provider." },
308
+ });
309
+ if (replacement.cancelled) selection = { cancelled: true, reason: replacement.reason };
310
+ else if (!replacement.value) sttProvider = existingStt.config.provider;
311
+ else sttReplacementApproved = true;
312
+ }
313
+ } catch (err) { setupRl.close(); fail(err.message); }
314
+ if (selection.cancelled) { setupRl.close(); console.log(`${setupAborted} (${selection.reason ?? "cancelled"})`); exit(0); }
315
+ preset = selection.preset; features = selection.features.join(",");
248
316
  if (selection.changed) {
249
- const desired = defaultDesired(manifest);
250
- desired.preset = preset;
251
- desired.features = Object.fromEntries(Object.keys(desired.features).map((name) => [name, selection.features.includes(name)]));
252
- tuiDesired = desired;
317
+ const desired = defaultDesired(manifest); desired.preset = preset;
318
+ desired.features = Object.fromEntries(Object.keys(desired.features).map((name) => [name, selection.features.includes(name)])); tuiDesired = desired;
253
319
  }
254
320
  }
255
321
 
@@ -265,7 +331,7 @@ async function cmdSetup() {
265
331
  // The interactive selector and final exact-plan confirmation are the
266
332
  // migration consent. Automation retains every explicit gate.
267
333
  migrate: opts.migrate || interactiveMigration, yes: opts.yes || interactive,
268
- accept: opts["on-conflict"] ?? null });
334
+ accept: opts["on-conflict"] ?? null, sttProvider, sttReplacementApproved });
269
335
  } catch (err) {
270
336
  setupRl?.close();
271
337
  fail(err.message);
@@ -274,33 +340,33 @@ async function cmdSetup() {
274
340
  setupRl?.close();
275
341
  fail(plan.migrationError);
276
342
  }
343
+ plan.fingerprints = capturePlanFingerprints(plan, manifest);
277
344
  if (dryRun) {
278
- setupRl?.close();
279
- process.stdout.write(JSON.stringify(plan, null, 2) + "\n");
280
- exit(plan.conflicts.length ? 3 : 0);
345
+ setupRl?.close(); writeJson(publicPlan(plan)); exit(plan.conflicts.length ? 3 : 0);
281
346
  }
282
347
  if ((interactive || opts.yes) && !opts.json) printPlan(plan);
283
348
  if (interactive) {
284
- stdout.write(`\nApply this exact ${plan.firstMigration ? "first-migration " : ""}setup plan? [y/N] `);
285
- const answer = await setupReadLine();
286
- setupRl.close();
287
- if (answer === null || !/^y(es)?$/i.test(answer.trim())) {
288
- console.log("Aborted — nothing was written.");
289
- exit(0);
290
- }
349
+ stdout.write("\n" + selectionSummary(manifest, plan.desired.preset, plan.selection.desired.requestedFeatures));
350
+ const approval = await askFinalApproval({ output: stdout, readLine: setupReadLine }); setupRl.close();
351
+ if (approval.cancelled || !approval.value) { console.log(`${setupAborted}${approval.reason ? ` (${approval.reason})` : ""}`); exit(0); }
291
352
  }
292
353
  const execOutput = (line) => (opts.json ? console.error : console.log)(`exec: ${line}`);
293
- let result = applyPlan({ plan, manifest, allowExec: Boolean(opts["allow-exec"]), output: execOutput });
294
- if (opts["allow-exec"] && result.exitCode === 0) {
295
- result = { ...result, retryRuntimeRepair: retryRuntimeRepairs({ workspace, output: execOutput }) };
296
- }
297
- if (opts.json) process.stdout.write(JSON.stringify(result, null, 2) + "\n");
298
- else console.log(result.exitCode === 0 ? "Setup complete." : result.failure?.detail ?? "Setup incomplete.");
354
+ let result = applyPlan({ plan, manifest, allowExec: Boolean(opts["allow-exec"]), output: execOutput, lockHeld: true });
355
+ if (opts["allow-exec"] && result.exitCode === 0) result = { ...result, retryRuntimeRepair: retryRuntimeRepairs({ workspace, manifest, output: execOutput }) };
356
+ if (opts.json) writeJson(publicResult(result));
357
+ else if (result.exitCode === 0) {
358
+ const missing = runtimeDependencyFindings({ workspace });
359
+ console.log(missing.length ? "Files installed; runtime dependencies are missing or unverified. Next: just fleet deps, then just fleet doctor." : "Files installed; existing readiness checks passed.");
360
+ } else console.log(result.failure?.detail ?? "Setup incomplete.");
299
361
  exit(result.exitCode);
300
362
  }
301
363
 
302
364
  async function cmdDoctor() {
303
365
  await mustBeDirectory(workspace, "workspace");
366
+ if (opts.fix && !opts["dry-run"]) {
367
+ if (opts.force) breakWorkspaceLock(workspace); // explicit recovery only; normal commands never steal locks.
368
+ lockMutation("doctor --fix", { allowPending: true });
369
+ }
304
370
 
305
371
  // Recovery is itself a write, so bare doctor must not even inspect a journal
306
372
  // beyond reporting the resulting repairable state. `--fix` recovers first,
@@ -310,11 +376,7 @@ async function cmdDoctor() {
310
376
  let discardedUnrecoverableJournal = false;
311
377
  if (opts.fix && !opts["dry-run"] && recovery.pending) {
312
378
  try { recoveredTransaction = recoverTransaction(workspace); }
313
- catch (err) {
314
- if (!err.unrecoverable) fail(`cannot recover pending transaction: ${err.message}`);
315
- discardUnrecoverableTransaction(workspace);
316
- discardedUnrecoverableJournal = true;
317
- }
379
+ catch (err) { fail(`cannot recover pending transaction: ${err.message}`); }
318
380
  }
319
381
 
320
382
  const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape"]);
@@ -398,7 +460,7 @@ async function cmdDoctor() {
398
460
 
399
461
  const runtimeRepairOutput = (line) => (opts.json ? console.error : console.log)(`exec: ${line}`);
400
462
  const runtimeRepair = willFix
401
- ? retryRuntimeRepairs({ workspace, output: runtimeRepairOutput })
463
+ ? retryRuntimeRepairs({ workspace, manifest: loadManifest(pkgRoot), output: runtimeRepairOutput })
402
464
  : { attempted: 0, remaining: pendingRuntime };
403
465
 
404
466
  let remainingManual = manualOutstanding;
@@ -441,7 +503,7 @@ async function cmdDoctor() {
441
503
  };
442
504
 
443
505
  if (opts.json) {
444
- process.stdout.write(JSON.stringify(report, null, 2) + "\n");
506
+ writeJson(report);
445
507
  exit(report.summary.outstanding > 0 ? 2 : 0);
446
508
  }
447
509
 
@@ -532,7 +594,7 @@ async function cmdVerify() {
532
594
  });
533
595
 
534
596
  if (opts.json) {
535
- process.stdout.write(JSON.stringify(report, null, 2) + "\n");
597
+ writeJson(report);
536
598
  exit(hasDrift(report) ? 2 : 0);
537
599
  }
538
600
 
@@ -601,15 +663,19 @@ async function cmdVerify() {
601
663
  // decision table, not here.
602
664
  async function cmdPlanVerb(verb) {
603
665
  await mustBeDirectory(workspace, "workspace");
666
+ if (transactionRecovery(workspace).pending) fail("pending transaction journal exists; run agent-fleet doctor --fix before replanning");
667
+ if (!opts["dry-run"]) lockMutation(verb);
604
668
 
605
669
  // State may already be gone after a self-uninstall. The separate explicit
606
670
  // config-purge gate remains usable in that final state without inventing a
607
671
  // new ownership record.
608
672
  if (verb === "uninstall" && opts.all && opts["purge-config"] && !readState(workspace)) {
609
- if (!opts.yes && (!stdin.isTTY || opts.json)) fail("--purge-config requires --yes in non-TTY/JSON mode");
610
- if (!opts.yes && !await confirm("\nPurge human configuration? [y/N] ")) { console.log("Aborted — nothing was written."); exit(0); }
611
- const purge = purgeHumanConfig(workspace, { purgeConfig: true });
612
- if (opts.json) process.stdout.write(JSON.stringify({ plan: null, applied: null, purge }, null, 2) + "\n");
673
+ if (!opts["dry-run"] && !opts.yes && (!stdin.isTTY || opts.json)) fail("--purge-config requires --yes in non-TTY/JSON mode");
674
+ if (!opts["dry-run"] && !opts.yes && !await confirm("\nPurge human configuration? yes/y | no/n; Enter = no (cancel) > ")) { console.log("Aborted — nothing was written."); exit(0); }
675
+ const purge = purgeHumanConfig(workspace, { purgeConfig: true, dryRun: Boolean(opts["dry-run"]) });
676
+ const report = { publicSchemaVersion: 1, stage: opts["dry-run"] ? "preview" : "apply", plan: null, applied: null, purge };
677
+ if (opts.json) writeJson(report);
678
+ else if (opts["dry-run"]) console.log(`Would purge human configuration: ${purge.wouldRemove.join(", ") || "nothing"}`);
613
679
  else if (purge.removed.length) console.log(`Purged human configuration: ${purge.removed.join(", ")}`);
614
680
  else console.log("Nothing to purge.");
615
681
  exit(0);
@@ -676,13 +742,10 @@ async function cmdPlanVerb(verb) {
676
742
  });
677
743
  } catch (err) { fail(err.message); }
678
744
 
745
+ plan.fingerprints = capturePlanFingerprints(plan, manifest);
679
746
  if (opts["dry-run"]) {
680
- if (opts.json) {
681
- process.stdout.write(JSON.stringify(plan, null, 2) + "\n");
682
- exit(hasConflicts(plan) ? 3 : 0);
683
- }
684
- printPlan(plan);
685
- exit(hasConflicts(plan) ? 3 : 0);
747
+ if (opts.json) { writeJson(publicPlan(plan)); exit(hasConflicts(plan) ? 3 : 0); }
748
+ printPlan(plan); exit(hasConflicts(plan) ? 3 : 0);
686
749
  }
687
750
 
688
751
  // A config purge is independent of state-owned actions, so it must still
@@ -691,13 +754,13 @@ async function cmdPlanVerb(verb) {
691
754
  if (verb === "uninstall" && opts["purge-config"] && !opts.yes) {
692
755
  if (!stdin.isTTY || opts.json) fail("--purge-config requires --yes in non-TTY/JSON mode");
693
756
  printPlan(plan);
694
- if (!await confirm("\nPurge human configuration? [y/N] ")) { console.log("Aborted — nothing was written."); exit(0); }
757
+ if (!await confirm("\nPurge human configuration? yes/y | no/n; Enter = no (cancel) > ")) { console.log("Aborted — nothing was written."); exit(0); }
695
758
  }
696
759
  const purge = verb === "uninstall" && opts["purge-config"]
697
760
  ? purgeHumanConfig(workspace, { purgeConfig: true })
698
761
  : null;
699
762
  if (opts.json) {
700
- process.stdout.write(JSON.stringify({ plan, applied: null, purge }, null, 2) + "\n");
763
+ writeJson({ publicSchemaVersion: 1, stage: "apply", plan: publicPlan(plan, "apply"), applied: null, purge });
701
764
  exit(0);
702
765
  }
703
766
  printPlan(plan);
@@ -713,14 +776,14 @@ async function cmdPlanVerb(verb) {
713
776
  const overwrites = plan.summary.overwrites;
714
777
  const ok = await confirm(
715
778
  verb === "uninstall"
716
- ? `\nRemove ${plan.summary.remove} item(s)? Files you have edited are kept. [y/N] `
779
+ ? `\nRemove ${plan.summary.remove} item(s)? Files you have edited are kept. yes/y | no/n; Enter = no (cancel) > `
717
780
  : `\nApply ${plan.summary.changes} change(s)` +
718
- `${overwrites ? `, overwriting local edits in ${overwrites} item(s)` : ""}? [y/N] `,
781
+ `${overwrites ? `, overwriting local edits in ${overwrites} item(s)` : ""}? yes/y | no/n; Enter = no (cancel) > `,
719
782
  );
720
783
  if (!ok) { console.log("Aborted — nothing was written."); exit(0); }
721
784
  }
722
785
 
723
- const applied = applyPlan({ plan, manifest, allowExec: Boolean(opts["allow-exec"]) });
786
+ const applied = applyPlan({ plan, manifest, allowExec: Boolean(opts["allow-exec"]), lockHeld: true });
724
787
  const purge = verb === "uninstall" && !applied.summary.failed
725
788
  ? purgeHumanConfig(workspace, { purgeConfig: Boolean(opts["purge-config"]) })
726
789
  : null;
@@ -738,7 +801,7 @@ async function cmdPlanVerb(verb) {
738
801
  };
739
802
 
740
803
  if (opts.json) {
741
- process.stdout.write(JSON.stringify({ plan, applied, purge }, null, 2) + "\n");
804
+ writeJson({ publicSchemaVersion: 1, stage: "apply", plan: publicPlan(plan, "apply"), applied: publicResult(applied), purge });
742
805
  finishLifecycleCleanup();
743
806
  exit(applied.summary.failed ? 1 : hasConflicts(plan) ? 3 : 0);
744
807
  }
@@ -790,10 +853,9 @@ function printApplied(plan, applied) {
790
853
 
791
854
  console.log();
792
855
  if (applied.failure) {
793
- console.log(
794
- `✗ Stopped at ${applied.failure.id}: ${applied.failure.detail}\n` +
795
- ` ${s.notReached} action(s) not reached. What was applied is recorded — fix the cause and re-run.`,
796
- );
856
+ if (applied.failure.status === "runtime-incomplete") console.log(`✗ ${applied.failure.detail}. Files are committed; retry with doctor --fix after correcting the cause.`);
857
+ else if (applied.failure.status === "committed-cleanup-incomplete") console.log(`✗ ${applied.failure.detail}. Files are durably committed; run doctor --fix to finalize recovery metadata.`);
858
+ else console.log(`✗ Apply failed; managed changes were rolled back: ${applied.failure.detail}`);
797
859
  return;
798
860
  }
799
861
  if (applied.conflictFiles.length > 0) {
@@ -805,10 +867,17 @@ function printApplied(plan, applied) {
805
867
 
806
868
  function printPlan(plan) {
807
869
  const s = plan.summary;
808
- printBanner(`agent-fleet v${pkg.version} — ${plan.verb} plan`);
870
+ printBanner(`agent-fleet v${pkg.version} — ${plan.firstMigration ? "first-migration " : ""}${plan.verb} plan`);
809
871
  console.log(`Workspace: ${plan.workspace}`);
810
872
  console.log(`Agent: ${agentLabel(plan.agent)} Method: ${plan.method}`);
811
- if (plan.verb === "install") {
873
+ if (plan.verb === "setup") {
874
+ const requested = plan.selection.desired?.requestedFeatures ?? [];
875
+ const effective = plan.selection.desired?.features ?? [];
876
+ console.log(`Preset: ${plan.desired.preset === "full" ? "Full" : "Default"}`);
877
+ console.log(`Selected features: ${requested.length ? requested.join(", ") : "none"}`);
878
+ console.log(`Dependency features: ${effective.filter((name) => !requested.includes(name)).join(", ") || "none"}`);
879
+ console.log(`Artifacts after dependency closure: ${plan.selection.resolved.length}`);
880
+ } else if (plan.verb === "install") {
812
881
  const picked = [
813
882
  plan.selection.profiles.length ? `profiles: ${plan.selection.profiles.join(", ")}` : null,
814
883
  plan.selection.requested.length ? `items: ${plan.selection.requested.length}` : null,
@@ -864,7 +933,7 @@ function printPlan(plan) {
864
933
  );
865
934
  }
866
935
  if (s.newAvailable > 0 && plan.verb !== "uninstall") {
867
- console.log(` ${s.newAvailable} catalogued item(s) not selected — widen with --profile full`);
936
+ console.log(` ${s.newAvailable} catalogued item(s) not selected — widen setup with --preset full`);
868
937
  }
869
938
 
870
939
  console.log();
@@ -1075,9 +1144,9 @@ function printSection(text) {
1075
1144
  console.log(`\n── ${text} ${"─".repeat(Math.max(0, 60 - text.length))}`);
1076
1145
  }
1077
1146
 
1078
- function fail(msg) {
1147
+ function fail(msg, code = 1) {
1079
1148
  console.error(`agent-fleet: ${msg}`);
1080
- exit(1);
1149
+ exit(code);
1081
1150
  }
1082
1151
 
1083
1152
  function printHelp(sub) {
@@ -1092,7 +1161,9 @@ function printHelp(sub) {
1092
1161
  Options:
1093
1162
  --workspace <path> Target workspace (default: cwd)
1094
1163
  --preset <default|full> Desired preset
1095
- --features <name[,name]|none> Exact feature opt-ins
1164
+ --repair-config With --yes, approve known retired config removal (backup saved)
1165
+ --features <name[,name]|none> Exact feature snapshot (replaces, never adds)
1166
+ --stt-provider <openai|groq|azure> First-time voice provider; no secret is prompted
1096
1167
  --save-desired Persist CLI overrides to .ai/agent-fleet.json
1097
1168
  --migrate Permit non-interactive first migration (with explicit preset/features and --yes)
1098
1169
  --allow-exec Run consented runtime commands after the file transaction