@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/lib/apply.js CHANGED
@@ -28,6 +28,7 @@ import { itemsForAgent } from "./manifest.js";
28
28
  import { expandBinding } from "./verify.js";
29
29
  import { extractRegion, replaceRegion, stripRegion, leafPaths, setPath, canonicalJson } from "./merge-forms.js";
30
30
  import { runTransaction } from "./transaction.js";
31
+ import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
31
32
  import { renderDesired } from "./desired.js";
32
33
  import {
33
34
  readState, writeState, emptyState, hashFile, hashText, walkTree,
@@ -35,26 +36,35 @@ import {
35
36
  } from "./state.js";
36
37
 
37
38
  export const APPLY_SCHEMA_VERSION = 1;
39
+ export const EXEC_TIMEOUT_MS = 120_000;
38
40
 
39
- /** Retry only commands recorded after a previous post-commit runtime failure. */
40
- export function retryRuntimeRepairs({ workspace, output = console.log }) {
41
+ function manifestExec(manifest, agent, id) {
42
+ const item = itemsForAgent(manifest, agent).find((entry) => entry.id === id);
43
+ if (!item?.exec) throw new Error(`runtime repair ${id} is not authorized by the current manifest`);
44
+ return item.exec;
45
+ }
46
+ export function runTrustedExec({ workspace, spec, output, timeoutMs = EXEC_TIMEOUT_MS }) {
47
+ const display = `${spec.command} ${(spec.args ?? []).join(" ")}`.trim();
48
+ output(`starting ${display} (timeout ${timeoutMs}ms)`);
49
+ const run = spawnSync(spec.command, spec.args ?? [], { cwd: insideWorkspace(workspace, spec.cwd ?? "."), stdio: "pipe", encoding: "utf8", timeout: timeoutMs });
50
+ output(run.status === 0 ? `completed ${display}` : `failed ${display}`);
51
+ return { run, display };
52
+ }
53
+
54
+ /** Retry only action IDs still authorized by the trusted current manifest. */
55
+ export function retryRuntimeRepairs({ workspace, manifest, output = console.log }) {
41
56
  const state = readState(workspace);
42
57
  const pending = state?.runtimeRepairs ?? [];
43
58
  if (pending.length === 0) return { attempted: 0, remaining: [] };
44
-
45
59
  const remaining = [];
46
60
  for (const repair of pending) {
47
- const command = `${repair.command} ${(repair.args ?? []).join(" ")}`.trim();
48
- output(command);
49
- const run = spawnSync(repair.command, repair.args ?? [], {
50
- cwd: insideWorkspace(workspace, repair.cwd ?? "."), stdio: "pipe", encoding: "utf8",
51
- });
52
- if (run.status !== 0) {
53
- remaining.push({ ...repair, status: run.status ?? "signal", stderr: (run.stderr ?? "").trim() });
54
- }
61
+ let spec;
62
+ try { spec = manifestExec(manifest, state.agent, repair.id); }
63
+ catch (error) { remaining.push({ id: repair.id, status: "unauthorized", detail: error.message }); continue; }
64
+ const { run, display } = runTrustedExec({ workspace, spec, output });
65
+ if (run.status !== 0) remaining.push({ id: repair.id, args: spec.args ?? [], cwd: spec.cwd ?? ".", display, status: run.error?.code === "ETIMEDOUT" ? "timeout" : run.status ?? run.signal ?? "failed", stderr: (run.stderr ?? "").trim() });
55
66
  }
56
- state.runtimeRepairs = remaining;
57
- writeState(workspace, state);
67
+ state.runtimeRepairs = remaining; writeState(workspace, state);
58
68
  return { attempted: pending.length, remaining };
59
69
  }
60
70
 
@@ -68,7 +78,7 @@ export function retryRuntimeRepairs({ workspace, output = console.log }) {
68
78
  * @param {() => string} [opts.now] injectable clock, for deterministic tests
69
79
  * @returns {object} result
70
80
  */
71
- export function applyPlan({ plan, manifest, allowExec = false, now = () => new Date().toISOString(), output = console.log, failAt = null }) {
81
+ export function applyPlan({ plan, manifest, allowExec = false, now = () => new Date().toISOString(), output = console.log, failAt = null, lockHeld = false }) {
72
82
  const validate = () => {
73
83
  if (plan.migrationBlocked) throw Object.assign(new Error(plan.migrationError), { exitCode: 1 });
74
84
  if (plan.snapshotMetadataError) throw Object.assign(new Error(plan.snapshotMetadataError), { exitCode: 1 });
@@ -76,37 +86,34 @@ export function applyPlan({ plan, manifest, allowExec = false, now = () => new D
76
86
  };
77
87
  let result;
78
88
  try {
79
- result = runTransaction({ workspace: plan.workspace, plan, manifest, validate, failAt, commit: () => {
80
- if (plan.writeDesired) writeFileSyncDeep(join(plan.workspace, ".ai", "agent-fleet.json"), renderDesired(plan.desired));
81
- if (plan.overrides?.write) writeFileSyncDeep(plan.overrides.path, plan.overrides.text);
82
- if (plan.stt) {
83
- writeFileSyncDeep(plan.stt.path, plan.stt.text);
84
- if (plan.stt.env.missing.length) writeFileSyncDeep(plan.stt.env.path, plan.stt.env.text);
85
- }
89
+ result = runTransaction({ workspace: plan.workspace, plan, manifest, validate, failAt, lockHeld, commit: () => {
90
+ if (plan.writeDesired) writeFileSyncDeep(join(plan.workspace, ".ai", "agent-fleet.json"), renderDesired(plan.desired), plan.workspace);
91
+ if (plan.overrides?.write) writeFileSyncDeep(plan.overrides.path, plan.overrides.text, plan.workspace);
92
+ if (plan.stt?.write) writeFileSyncDeep(plan.stt.path, plan.stt.text, plan.workspace);
93
+ if (plan.stt?.env?.missing?.length) writeFileSyncDeep(plan.stt.env.path, plan.stt.env.text, plan.workspace);
86
94
  return applyImmediate({ plan, manifest, allowExec: false, now });
87
95
  } });
88
96
  } catch (error) {
97
+ const status = error.postCommit ? "committed-cleanup-incomplete" : error.rollbackFailed ? "rollback-failed" : "rolled-back";
89
98
  return { schemaVersion: APPLY_SCHEMA_VERSION, workspace: plan.workspace, verb: plan.verb,
90
- results: [], conflictFiles: [], failure: { status: "failed", detail: error.message },
91
- exitCode: error.exitCode ?? 1, summary: { applied: 0, failed: 1 } };
99
+ results: [], conflictFiles: [], failure: { status, detail: error.message },
100
+ exitCode: error.exitCode ?? 1, summary: { applied: 0, failed: 1, notReached: 0 } };
92
101
  }
93
102
  if (!allowExec) return { ...result, exitCode: 0 };
94
103
 
95
104
  const repairs = [];
96
105
  for (const action of plan.actions.filter((entry) => entry.kind === "exec")) {
97
- const item = new Map(itemsForAgent(manifest, plan.agent).map((entry) => [entry.id, entry])).get(action.id);
98
- const spec = item?.exec;
99
- if (!spec) continue;
100
- const command = `${spec.command} ${(spec.args ?? []).join(" ")}`.trim();
101
- output(command);
102
- const run = spawnSync(spec.command, spec.args ?? [], { cwd: insideWorkspace(plan.workspace, spec.cwd ?? "."), stdio: "pipe", encoding: "utf8" });
103
- if (run.status !== 0) repairs.push({ id: action.id, command: spec.command, args: spec.args ?? [], cwd: spec.cwd ?? ".", display: command, status: run.status ?? "signal", stderr: (run.stderr ?? "").trim() });
106
+ const spec = manifestExec(manifest, plan.agent, action.id);
107
+ const { run, display } = runTrustedExec({ workspace: plan.workspace, spec, output });
108
+ if (run.status !== 0) repairs.push({ id: action.id, display, status: run.error?.code === "ETIMEDOUT" ? "timeout" : run.status ?? run.signal ?? "failed", stderr: (run.stderr ?? "").trim() });
104
109
  }
105
110
  if (repairs.length) {
106
111
  const state = readState(plan.workspace);
107
112
  state.runtimeRepairs = repairs;
108
113
  writeState(plan.workspace, state);
109
- return { ...result, exitCode: 1, runtimeRepairs: repairs };
114
+ return { ...result, exitCode: 1, runtimeRepairs: repairs,
115
+ failure: { id: repairs[0].id, status: "runtime-incomplete", detail: `files committed; ${repairs.length} runtime command(s) failed or timed out` },
116
+ summary: { ...result.summary, failed: repairs.length } };
110
117
  }
111
118
  const results = result.results.map((entry) => plan.actions.some((action) => action.id === entry.id && action.kind === "exec")
112
119
  ? { ...entry, status: "applied", detail: "command ran after file commit" }
@@ -114,7 +121,7 @@ export function applyPlan({ plan, manifest, allowExec = false, now = () => new D
114
121
  return { ...result, results, exitCode: 0, runtimeRepairs: [] };
115
122
  }
116
123
 
117
- function applyImmediate({ plan, manifest, allowExec = false, now = () => new Date().toISOString() }) {
124
+ function applyImmediate({ plan, manifest, now = () => new Date().toISOString() }) {
118
125
  const { workspace, sourceRoot, agent, method, packageVersion } = plan;
119
126
  const catalogue = new Map(itemsForAgent(manifest, agent).map((i) => [i.id, i]));
120
127
  const previous = readState(workspace);
@@ -142,7 +149,7 @@ function applyImmediate({ plan, manifest, allowExec = false, now = () => new Dat
142
149
  try {
143
150
  const outcome = perform({
144
151
  action, item: catalogue.get(action.id), state, workspace, sourceRoot,
145
- method, agent, allowExec, now,
152
+ method, agent, now,
146
153
  });
147
154
  results.push({ id: action.id, action: action.kind, ...outcome });
148
155
  if (outcome.conflicts) conflictFiles.push(...outcome.conflicts);
@@ -202,7 +209,7 @@ function applyImmediate({ plan, manifest, allowExec = false, now = () => new Dat
202
209
 
203
210
  // ── one action ──────────────────────────────────────────────────────────────
204
211
 
205
- function perform({ action, item, state, workspace, sourceRoot, method, agent, allowExec, now }) {
212
+ function perform({ action, item, state, workspace, sourceRoot, method, agent, now }) {
206
213
  switch (action.kind) {
207
214
  case "create":
208
215
  case "refresh":
@@ -263,25 +270,10 @@ function perform({ action, item, state, workspace, sourceRoot, method, agent, al
263
270
  case "remove":
264
271
  return removeItem({ id: action.id, state, workspace, sourceRoot });
265
272
 
266
- case "exec": {
267
- if (!allowExec) return { status: "skipped", detail: "exec not permitted" };
268
- const spec = item?.exec;
269
- if (!spec) return { status: "skipped", detail: "no exec specification" };
270
- const cwd = insideWorkspace(workspace, spec.cwd ?? ".");
271
- const run = spawnSync(spec.command, spec.args ?? [], { cwd, stdio: "pipe", encoding: "utf8" });
272
- if (run.status !== 0) {
273
- throw new Error(
274
- `${spec.command} ${(spec.args ?? []).join(" ")} exited ${run.status ?? "on signal"}: ` +
275
- `${(run.stderr ?? "").trim().split("\n").slice(-3).join(" ") || "no output"}`,
276
- );
277
- }
278
- state.items[action.id] = {
279
- kind: item.kind, strategy: "exec", method: "exec",
280
- version: state.packageVersion, files: [],
281
- lastRun: { at: now(), command: `${spec.command} ${(spec.args ?? []).join(" ")}`.trim() },
282
- };
283
- return { status: "applied", detail: "command ran" };
284
- }
273
+ case "exec":
274
+ // Runtime execution happens only after the durable file commit through
275
+ // runTrustedExec(), which owns timeout/progress/failure reporting.
276
+ return { status: "skipped", detail: "exec deferred until after file commit" };
285
277
 
286
278
  case "external": {
287
279
  const spec = item?.package;
@@ -501,7 +493,7 @@ function writeManagedRegion({ binding, workspace, sourceRoot }) {
501
493
 
502
494
  const targetAbs = insideWorkspace(workspace, binding.target);
503
495
  const existing = existsSync(targetAbs) ? readFileSync(targetAbs, "utf8") : "";
504
- writeFileSyncDeep(targetAbs, replaceRegion(existing, region.block));
496
+ writeFileSyncDeep(targetAbs, replaceRegion(existing, region.block), workspace);
505
497
 
506
498
  return {
507
499
  files: [{
@@ -537,7 +529,7 @@ function mergeJson({ binding, workspace, sourceRoot }) {
537
529
  sha256: hashText(canonicalJson(value)),
538
530
  });
539
531
  }
540
- writeFileSyncDeep(targetAbs, JSON.stringify(target, null, 2) + "\n");
532
+ writeFileSyncDeep(targetAbs, JSON.stringify(target, null, 2) + "\n", workspace);
541
533
 
542
534
  return { files: [], jsonKeys };
543
535
  }
@@ -555,7 +547,7 @@ function writeConflictCopies({ item, action, workspace, sourceRoot, agent }) {
555
547
  const emit = (targetRel, contents) => {
556
548
  if (!conflicted.has(targetRel)) return;
557
549
  const dest = insideWorkspace(workspace, `${targetRel}.new`);
558
- writeFileSyncDeep(dest, contents);
550
+ writeFileSyncDeep(dest, contents, workspace);
559
551
  written.push(`${targetRel}.new`);
560
552
  };
561
553
 
@@ -673,7 +665,7 @@ updated: ${state.updatedAt.slice(0, 10)}
673
665
  - No secrets are stored in this file or in ${STATE_REL_PATH}.
674
666
  `;
675
667
  const path = join(workspace, LEGACY_RECORD_REL_PATH);
676
- writeFileSyncDeep(path, text);
668
+ writeFileSyncDeep(path, text, workspace);
677
669
  return path;
678
670
  }
679
671
 
@@ -686,13 +678,12 @@ updated: ${state.updatedAt.slice(0, 10)}
686
678
  */
687
679
  function insideWorkspace(workspace, rel) {
688
680
  const abs = resolve(workspace, rel);
689
- if (!isInside(workspace, abs)) {
690
- throw new Error(`refusing to write outside the workspace: ${rel}`);
691
- }
692
- return abs;
681
+ if (!isInside(workspace, abs)) throw new Error(`refusing to write outside the workspace: ${rel}`);
682
+ return assertSafeWorkspaceTarget(workspace, abs);
693
683
  }
694
684
 
695
- function writeFileSyncDeep(abs, contents) {
685
+ function writeFileSyncDeep(abs, contents, workspace = null) {
686
+ if (workspace) assertSafeWorkspaceTarget(workspace, abs, { allowLeafSymlink: false });
696
687
  mkdirSync(dirname(abs), { recursive: true });
697
688
  writeFileSync(abs, contents);
698
689
  }
@@ -16,8 +16,8 @@ export function retiredFeatureError(name) {
16
16
  export function normalizeFeatureSet(manifest, features) {
17
17
  const known = new Set(featureNames(manifest));
18
18
  const values = typeof features === "string"
19
- ? (features === "none" ? [] : features.split(",").filter(Boolean))
20
- : (features ?? []);
19
+ ? (features.trim().toLowerCase() === "none" ? [] : features.split(",").map((name) => name.trim()).filter(Boolean))
20
+ : (features ?? []).map((name) => typeof name === "string" ? name.trim() : name).filter(Boolean);
21
21
  for (const feature of values) {
22
22
  if (!known.has(feature)) throw new Error(retiredFeatureError(feature) ?? `unknown feature "${feature}"`);
23
23
  }
@@ -0,0 +1,17 @@
1
+ // Explicit public serialization boundary: write buffers never cross stdout/stderr.
2
+ const SECRET_BEARING_KEYS = new Set(["text", "original", "replacement", "before", "after", "backup"]);
3
+ export const PUBLIC_PLAN_SCHEMA_VERSION = 1;
4
+ function safe(value, key = "") {
5
+ if (SECRET_BEARING_KEYS.has(key)) return undefined;
6
+ if (Array.isArray(value)) return value.map((item) => safe(item)).filter((item) => item !== undefined);
7
+ if (!value || typeof value !== "object") return value;
8
+ if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) return undefined;
9
+ return Object.fromEntries(Object.entries(value).flatMap(([name, item]) => {
10
+ const cleaned = safe(item, name); return cleaned === undefined ? [] : [[name, cleaned]];
11
+ }));
12
+ }
13
+ export function publicPlan(plan, stage = "preview") { return { ...safe(plan), publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage }; }
14
+ export function publicResult(result, stage = "apply") { return { ...safe(result), publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage }; }
15
+ export function publicRepairPreview(proposal) {
16
+ return { publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage: "config-repair-preview", configRepair: { path: proposal.path, removed: proposal.removed, requiresApproval: true, nextStep: "Run setup interactively, or setup --yes --repair-config. No mutation was applied." } };
17
+ }
package/bin/lib/purge.js CHANGED
@@ -1,11 +1,17 @@
1
1
  // purge.js — explicit human-config boundary for state-owned uninstall.
2
2
  import { existsSync, rmSync } from "node:fs";
3
3
  import { join } from "node:path";
4
+ import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
4
5
 
5
6
  const HUMAN_CONFIG = [".ai/agent-fleet.json", ".ai/agent-fleet-overrides.md", ".ai/stt.json"];
6
- export function purgeHumanConfig(workspace, { purgeConfig = false } = {}) {
7
- if (!purgeConfig) return { removed: [], preserved: HUMAN_CONFIG.filter((path) => existsSync(join(workspace, path))) };
7
+ export function purgeHumanConfig(workspace, { purgeConfig = false, dryRun = false } = {}) {
8
+ const present = HUMAN_CONFIG.filter((path) => {
9
+ const target = assertSafeWorkspaceTarget(workspace, path, { allowLeafSymlink: false });
10
+ return existsSync(target);
11
+ });
12
+ if (!purgeConfig) return { removed: [], preserved: present };
13
+ if (dryRun) return { removed: [], wouldRemove: present, preserved: present };
8
14
  const removed = [];
9
- for (const path of HUMAN_CONFIG) if (existsSync(join(workspace, path))) { rmSync(join(workspace, path), { force: true }); removed.push(path); }
15
+ for (const path of present) { rmSync(join(workspace, path), { force: true }); removed.push(path); }
10
16
  return { removed, preserved: [] };
11
17
  }
@@ -8,14 +8,14 @@ import { buildPlan } from "./plan.js";
8
8
  import { readState } from "./state.js";
9
9
  import { scanProject } from "./scan.js";
10
10
  import { planOverrides } from "./overrides.js";
11
- import { appendEnvPlaceholders, renderSttConfig } from "./stt-wizard.js";
11
+ import { planStt } from "./stt-wizard.js";
12
12
 
13
13
  /** Build one setup plan. This function writes nothing. */
14
14
  export function buildReconcilePlan(opts) {
15
15
  const { workspace, manifest, sourceRoot, packageVersion, agent = "pi", method,
16
16
  preset, features, saveDesired = false, tuiDesired = null, dryRun = false,
17
17
  migrate = false, yes = false, accept = null, allowExec = false,
18
- platform = process.platform } = opts;
18
+ sttProvider = null, sttReplacementApproved = false, platform = process.platform } = opts;
19
19
  const state = readState(workspace);
20
20
  const desiredPath = join(workspace, DESIRED_FILE);
21
21
  const firstMigration = Boolean(state && !existsSync(desiredPath));
@@ -37,13 +37,7 @@ export function buildReconcilePlan(opts) {
37
37
  method, items: featureResult.roots, accept, allowExec, platform });
38
38
  const wanted = new Set(featureResult.selected);
39
39
  const overrides = planOverrides(workspace, scanProject(workspace));
40
- const sttConfig = featureResult.features.includes("voice")
41
- ? { provider: "openai", apiKeyEnv: "OPENAI_API_KEY" }
42
- : null;
43
- const stt = sttConfig ? {
44
- path: join(workspace, ".ai", "stt.json"), text: renderSttConfig(sttConfig),
45
- env: appendEnvPlaceholders(workspace, sttConfig),
46
- } : null;
40
+ const stt = featureResult.features.includes("voice") ? planStt(workspace, sttProvider, { replacementApproved: sttReplacementApproved }) : null;
47
41
  const recorded = Object.keys(state?.items ?? {});
48
42
  const removals = recorded.filter((id) => !wanted.has(id)).sort().map((id) => ({
49
43
  kind: "remove", id, itemKind: state.items[id].kind ?? "unknown", consent: "file", state: "owned",
@@ -60,7 +54,7 @@ export function buildReconcilePlan(opts) {
60
54
  migrationError: migrationBlocked
61
55
  ? "first migration requires --migrate --preset <default|full> --features <exact-set> --yes"
62
56
  : null,
63
- selection: { ...base.selection, desired: featureResult, resolved: featureResult.selected },
57
+ selection: { ...base.selection, desired: { ...featureResult, requestedFeatures: Object.entries(desiredResult.desired.features).filter(([, enabled]) => enabled).map(([name]) => name).sort() }, resolved: featureResult.selected },
64
58
  actions, conflicts,
65
59
  overrides,
66
60
  stt,
@@ -0,0 +1,73 @@
1
+ // Explicit, narrowly scoped repair of known retired desired-state features.
2
+ import { existsSync, readFileSync, lstatSync, writeFileSync, renameSync, unlinkSync } from "node:fs";
3
+ import { randomUUID } from "node:crypto";
4
+ import { join } from "node:path";
5
+ import { DESIRED_FILE, validateDesired } from "./desired.js";
6
+ import { retiredFeatureError } from "./features.js";
7
+ import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
8
+ import { publicRepairPreview } from "./public-plan.js";
9
+
10
+ export function inspectDesiredRepair(workspace, manifest) {
11
+ const path = assertSafeWorkspaceTarget(workspace, DESIRED_FILE, { allowLeafSymlink: false });
12
+ if (!existsSync(path)) return null;
13
+ const original = readFileSync(path, "utf8");
14
+ let value;
15
+ try { value = JSON.parse(original); }
16
+ catch { throw new Error(`invalid desired config ${DESIRED_FILE}: invalid JSON; manual repair required`); }
17
+ const candidate = structuredClone(value);
18
+ const removed = [];
19
+ if (candidate?.features && typeof candidate.features === "object" && !Array.isArray(candidate.features)) {
20
+ for (const [name, enabled] of Object.entries(candidate.features)) {
21
+ if (!manifest.features?.[name] && retiredFeatureError(name) && typeof enabled === "boolean") {
22
+ removed.push({ name, value: enabled });
23
+ delete candidate.features[name];
24
+ }
25
+ }
26
+ }
27
+ // Never offer a partial repair of an otherwise invalid configuration.
28
+ validateDesired(candidate, manifest);
29
+ if (!removed.length) return null;
30
+ if (!lstatSync(path).isFile()) throw new Error(`cannot repair non-regular config ${DESIRED_FILE}`);
31
+ return { path, original, replacement: JSON.stringify(candidate, null, 2) + "\n", removed };
32
+ }
33
+
34
+ export function describeDesiredRepair(proposal) {
35
+ return `Retired settings found in ${DESIRED_FILE}:\n${proposal.removed.map(({ name, value }) => `- ${JSON.stringify(name)}: ${value}`).join("\n")}\nProposed repair: remove only these settings. Other settings are preserved.\nchatgpt-client will NOT be enabled automatically.\nA backup will be saved before the repair. This repair is separate from the subsequent setup plan.`;
36
+ }
37
+
38
+ export function applyDesiredRepair(proposal) {
39
+ const { path, original, replacement } = proposal;
40
+ const unchanged = () => {
41
+ if (!lstatSync(path).isFile() || readFileSync(path, "utf8") !== original) {
42
+ throw new Error("desired config changed since repair was proposed; rerun setup");
43
+ }
44
+ };
45
+ unchanged();
46
+ const id = randomUUID();
47
+ const backup = `${path}.backup-${id}`;
48
+ const temporary = `${path}.repair-${id}`;
49
+ writeFileSync(backup, original, { flag: "wx", mode: 0o600 });
50
+ try {
51
+ writeFileSync(temporary, replacement, { flag: "wx", mode: lstatSync(path).mode & 0o777 });
52
+ unchanged();
53
+ renameSync(temporary, path);
54
+ } finally {
55
+ if (existsSync(temporary)) unlinkSync(temporary);
56
+ }
57
+ return backup;
58
+ }
59
+
60
+ export async function prepareDesiredRepair({ workspace, manifest, dryRun, approved, interactive, output, confirm }) {
61
+ const proposal = inspectDesiredRepair(workspace, manifest);
62
+ if (!proposal) return { repaired: false };
63
+ if (dryRun) return { repaired: false, preview: publicRepairPreview(proposal) };
64
+ output.write(describeDesiredRepair(proposal) + "\n");
65
+ if (!approved) {
66
+ if (!interactive) throw new Error("Config repair requires explicit approval: rerun setup interactively or with --yes --repair-config. No mutation was applied.");
67
+ const answer = await confirm("Apply this config repair now? yes/y | no/n; Enter = no (cancel; backup is created only after yes) > ");
68
+ if (answer === null || !/^y(es)?$/i.test(answer.trim())) return { repaired: false, cancelled: true };
69
+ }
70
+ const backup = applyDesiredRepair(proposal);
71
+ output.write(`Config repaired. Original saved to ${backup}\n`);
72
+ return { repaired: true, backup };
73
+ }
@@ -1,28 +1,32 @@
1
- // Non-secret STT configuration. Values are env-var names only.
1
+ // Human-owned, non-secret STT configuration. Installer prompts for provider/env names, never values.
2
2
  import { existsSync, readFileSync } from "node:fs";
3
3
  import { join } from "node:path";
4
4
 
5
- const PROVIDERS = {
5
+ export const STT_PROVIDERS = {
6
6
  openai: { apiKeyEnv: "OPENAI_API_KEY" },
7
7
  groq: { apiKeyEnv: "GROQ_API_KEY" },
8
8
  azure: { apiKeyEnv: "AZURE_OPENAI_API_KEY", endpointEnv: "AZURE_OPENAI_ENDPOINT" },
9
9
  };
10
-
11
10
  export function validateSttConfig(value) {
12
- const spec = PROVIDERS[value?.provider];
13
- if (!spec) throw new Error(`unsupported STT provider "${value?.provider}"`);
14
- for (const key of ["apiKeyEnv", ...(spec.endpointEnv ? ["endpointEnv"] : [])]) {
15
- if (value[key] !== spec[key]) throw new Error(`${key} must be ${spec[key]} for ${value.provider}`);
11
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("STT config must be an object");
12
+ if (!STT_PROVIDERS[value.provider]) throw new Error(`unsupported STT provider "${value.provider}"`);
13
+ for (const key of ["apiKeyEnv", ...(value.provider === "azure" ? ["endpointEnv"] : [])]) {
14
+ if (typeof value[key] !== "string" || !/^[A-Z_][A-Z0-9_]*$/.test(value[key])) throw new Error(`${key} must name an environment variable`);
16
15
  }
17
16
  for (const [key, item] of Object.entries(value)) {
18
17
  if (/key|token|secret|password/i.test(key) && !/Env$/.test(key)) throw new Error(`STT config must not store ${key}`);
19
- if (typeof item === "string" && /sk-[A-Za-z0-9]|AIza|ghp_/i.test(item)) throw new Error("STT config must not store secret values");
18
+ if (typeof item === "string" && /(?:sk-[A-Za-z0-9]|AIza|ghp_)/i.test(item)) throw new Error("STT config must not store secret values");
20
19
  }
21
- return { provider: value.provider, apiKeyEnv: spec.apiKeyEnv, ...(spec.endpointEnv ? { endpointEnv: spec.endpointEnv } : {}) };
20
+ return structuredClone(value); // unknown human-owned fields are valid and preserved.
22
21
  }
23
-
24
22
  export function renderSttConfig(value) { return JSON.stringify(validateSttConfig(value), null, 2) + "\n"; }
25
-
23
+ export function readSttConfig(workspace) {
24
+ const path = join(workspace, ".ai", "stt.json");
25
+ if (!existsSync(path)) return null;
26
+ const text = readFileSync(path, "utf8");
27
+ try { return { path, text, config: validateSttConfig(JSON.parse(text)) }; }
28
+ catch (error) { throw new Error(`invalid .ai/stt.json: ${error.message}; repair it manually before setup`); }
29
+ }
26
30
  /** Append empty placeholders only for variables not already declared. */
27
31
  export function appendEnvPlaceholders(workspace, config) {
28
32
  const path = join(workspace, ".env");
@@ -31,3 +35,13 @@ export function appendEnvPlaceholders(workspace, config) {
31
35
  const missing = names.filter((name) => !new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=`, "m").test(before));
32
36
  return { path, text: missing.length ? `${before}${before && !before.endsWith("\n") ? "\n" : ""}${missing.map((name) => `${name}=`).join("\n")}\n` : before, missing };
33
37
  }
38
+ export function planStt(workspace, provider, { replacementApproved = false } = {}) {
39
+ const existing = readSttConfig(workspace);
40
+ if (existing && (!provider || provider === existing.config.provider)) {
41
+ return { path: existing.path, write: false, preserved: true, provider: existing.config.provider, env: appendEnvPlaceholders(workspace, existing.config) };
42
+ }
43
+ if (!provider || !STT_PROVIDERS[provider]) throw new Error(`first-time voice setup requires an explicit STT provider: ${Object.keys(STT_PROVIDERS).join(", ")}`);
44
+ if (existing && !replacementApproved) throw new Error(`replacing STT provider ${existing.config.provider} with ${provider} requires explicit approval`);
45
+ const config = validateSttConfig({ ...(existing?.config ?? {}), provider, ...STT_PROVIDERS[provider] });
46
+ return { path: join(workspace, ".ai", "stt.json"), text: renderSttConfig(config), write: true, preserved: false, replacing: existing?.config.provider ?? null, provider, env: appendEnvPlaceholders(workspace, config) };
47
+ }