@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
@@ -1,42 +1,26 @@
1
- // transaction.js — crash-recoverable managed workspace commits.
2
-
3
- import { closeSync, cpSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
4
- import { tmpdir } from "node:os";
5
- import { dirname, join, resolve, relative, sep } from "node:path";
1
+ // transaction.js — durable, crash-recoverable managed workspace commits.
2
+ import { closeSync, cpSync, existsSync, fsyncSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, writeSync } from "node:fs";
3
+ import { createHash, randomUUID } from "node:crypto";
4
+ import { dirname, join } from "node:path";
6
5
  import { STATE_REL_PATH, LEGACY_RECORD_REL_PATH } from "./state.js";
6
+ import { acquireWorkspaceLock, assertSafeWorkspaceTarget, ownedRelativePath } from "./workspace-safety.js";
7
7
 
8
8
  export const JOURNAL_REL_PATH = ".ai/agent-fleet-transaction.json";
9
+ export const RECOVERY_REL_PATH = ".ai/.agent-fleet-recovery";
9
10
  const DESIRED_REL_PATH = ".ai/agent-fleet.json";
10
11
  const OVERRIDES_REL_PATH = ".ai/agent-fleet-overrides.md";
11
12
  const STT_REL_PATH = ".ai/stt.json";
12
-
13
13
  export function journalPath(workspace) { return join(workspace, JOURNAL_REL_PATH); }
14
14
 
15
- function relativeOwnedPath(workspace, path) {
16
- const rel = relative(workspace, resolve(workspace, path));
17
- if (!rel || rel === ".." || rel.startsWith(`..${sep}`) || rel.split(sep).includes("..")) {
18
- throw new Error(`transaction path is outside the workspace: ${path}`);
19
- }
20
- return rel;
21
- }
22
-
23
- // Never snapshot the workspace root or a broad target directory: a transaction
24
- // owns only the exact files its plan can alter. This deliberately leaves .git,
25
- // foreign files, and concurrently-created siblings untouched.
26
15
  function sourceLeaves(path) {
27
16
  if (!statSync(path).isDirectory()) return [""];
28
- const leaves = [];
29
- for (const entry of readdirSync(path, { withFileTypes: true })) {
30
- const child = join(path, entry.name);
31
- for (const leaf of sourceLeaves(child)) leaves.push(join(entry.name, leaf));
32
- }
33
- return leaves;
17
+ return readdirSync(path, { withFileTypes: true }).flatMap((entry) => sourceLeaves(join(path, entry.name)).map((leaf) => join(entry.name, leaf)));
34
18
  }
35
19
 
36
- function touchedPaths(plan, manifest) {
20
+ export function touchedPaths(plan, manifest) {
37
21
  const paths = new Set([STATE_REL_PATH, LEGACY_RECORD_REL_PATH]);
38
22
  const catalogue = new Map((manifest?.items ?? []).map((item) => [item.id, item]));
39
- for (const action of plan.actions ?? []) {
23
+ for (const action of plan?.actions ?? []) {
40
24
  for (const file of action.files ?? []) if (file.path) paths.add(file.path);
41
25
  for (const path of action.paths ?? []) if (path) paths.add(path);
42
26
  const binding = catalogue.get(action.id)?.agents?.[plan.agent];
@@ -45,118 +29,144 @@ function touchedPaths(plan, manifest) {
45
29
  for (const rel of binding.source ?? []) {
46
30
  const source = join(plan.sourceRoot, rel);
47
31
  if (!existsSync(source)) continue;
48
- if (binding.strategy === "copy-tree" && statSync(source).isDirectory()) {
49
- for (const leaf of sourceLeaves(source)) paths.add(join(rel, leaf));
50
- } else {
51
- paths.add(rel);
52
- }
32
+ if (binding.strategy === "copy-tree" && statSync(source).isDirectory()) for (const leaf of sourceLeaves(source)) paths.add(join(rel, leaf));
33
+ else paths.add(rel);
53
34
  }
54
- continue;
55
- }
56
- if (!binding.target) continue;
57
- const source = (binding.source ?? []).map((path) => join(plan.sourceRoot, path)).find(existsSync);
58
- if (binding.strategy === "copy-tree" && source) {
59
- for (const leaf of sourceLeaves(source)) paths.add(join(binding.target, leaf));
60
- } else {
61
- paths.add(binding.target);
35
+ } else if (binding.target) {
36
+ const source = (binding.source ?? []).map((path) => join(plan.sourceRoot, path)).find(existsSync);
37
+ if (binding.strategy === "copy-tree" && source) for (const leaf of sourceLeaves(source)) paths.add(join(binding.target, leaf));
38
+ else paths.add(binding.target);
62
39
  }
63
40
  }
64
- if (plan.writeDesired) paths.add(relativeOwnedPath(plan.workspace, plan.desiredPath ?? DESIRED_REL_PATH));
65
- if (plan.overrides?.write) paths.add(relativeOwnedPath(plan.workspace, plan.overrides.path ?? OVERRIDES_REL_PATH));
66
- if (plan.stt?.path) paths.add(relativeOwnedPath(plan.workspace, plan.stt.path ?? STT_REL_PATH));
67
- if (plan.stt?.env?.missing?.length) paths.add(relativeOwnedPath(plan.workspace, plan.stt.env.path));
68
- return [...paths].map((path) => relativeOwnedPath(plan.workspace, path)).sort();
41
+ if (plan?.writeDesired) paths.add(ownedRelativePath(plan.workspace, plan.desiredPath ?? DESIRED_REL_PATH));
42
+ if (plan?.overrides?.write) paths.add(ownedRelativePath(plan.workspace, plan.overrides.path ?? OVERRIDES_REL_PATH));
43
+ if (plan?.stt?.write) paths.add(ownedRelativePath(plan.workspace, plan.stt.path ?? STT_REL_PATH));
44
+ if (plan?.stt?.env?.missing?.length) paths.add(ownedRelativePath(plan.workspace, plan.stt.env.path));
45
+ const collapseManagedLink = (value) => {
46
+ const rel = ownedRelativePath(plan.workspace, value); const parts = rel.split(/[/\\]/); let cursor = plan.workspace;
47
+ for (let i = 0; i < parts.length - 1; i++) { cursor = join(cursor, parts[i]); if (existsSync(cursor) && lstatSync(cursor).isSymbolicLink()) return parts.slice(0, i + 1).join("/"); }
48
+ return rel;
49
+ };
50
+ return [...new Set([...paths].map(collapseManagedLink))].sort();
51
+ }
52
+
53
+ function fingerprint(path) {
54
+ if (!existsSync(path)) return "absent";
55
+ const stat = lstatSync(path);
56
+ if (stat.isSymbolicLink()) return `link:${readlinkSync(path)}`;
57
+ if (stat.isDirectory()) return `dir:${readdirSync(path).sort().join("\0")}`;
58
+ return `file:${createHash("sha256").update(readFileSync(path)).digest("hex")}:${stat.mode & 0o777}`;
59
+ }
60
+
61
+ export function capturePlanFingerprints(plan, manifest) {
62
+ return Object.fromEntries(touchedPaths(plan, manifest).map((rel) => [rel, fingerprint(join(plan.workspace, rel))]));
63
+ }
64
+
65
+ export function assertPlanFingerprints(plan, manifest) {
66
+ if (!plan.fingerprints) return;
67
+ for (const [rel, expected] of Object.entries(plan.fingerprints)) {
68
+ assertSafeWorkspaceTarget(plan.workspace, rel);
69
+ if (fingerprint(join(plan.workspace, rel)) !== expected) throw new Error(`workspace changed since preview: ${rel}; re-run setup`);
70
+ }
69
71
  }
70
72
 
73
+ function fsyncPath(path) {
74
+ const fd = openSync(path, "r");
75
+ try { fsyncSync(fd); } finally { closeSync(fd); }
76
+ }
77
+ function durableJson(path, value) {
78
+ const temp = `${path}.tmp-${process.pid}`;
79
+ const fd = openSync(temp, "wx", 0o600);
80
+ try { writeSync(fd, JSON.stringify(value, null, 2) + "\n"); fsyncSync(fd); } finally { closeSync(fd); }
81
+ renameSync(temp, path);
82
+ // Persist the directory entry after the atomic replacement.
83
+ fsyncPath(dirname(path));
84
+ }
85
+ function validateJournal(workspace, value) {
86
+ if (!value || value.schemaVersion !== 3 || !["prepared", "applying", "committed"].includes(value.phase)) throw new Error("transaction journal schema or phase is invalid");
87
+ if (!Array.isArray(value.paths) || !Array.isArray(value.present) || !value.paths.every((x) => typeof x === "string") || !value.present.every((x) => value.paths.includes(x))) throw new Error("transaction journal paths are invalid");
88
+ value.paths = value.paths.map((rel) => ownedRelativePath(workspace, rel, "journal path"));
89
+ value.present = value.present.map((rel) => ownedRelativePath(workspace, rel, "journal present path"));
90
+ value.backup = ownedRelativePath(workspace, value.backup, "journal backup");
91
+ if (!value.backup.startsWith(`${RECOVERY_REL_PATH}/`) && value.backup !== RECOVERY_REL_PATH) throw new Error("transaction backup is not installer-owned");
92
+ for (const rel of value.paths) assertSafeWorkspaceTarget(workspace, rel);
93
+ assertSafeWorkspaceTarget(workspace, value.backup, { allowLeafSymlink: false });
94
+ return value;
95
+ }
71
96
  function backupTouchedPaths(workspace, paths) {
72
- const backup = join(tmpdir(), `agent-fleet-tx-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);
97
+ const rootRel = join(RECOVERY_REL_PATH, randomUUID());
98
+ const backupRel = join(rootRel, "backup");
99
+ const backup = assertSafeWorkspaceTarget(workspace, backupRel, { allowLeafSymlink: false });
73
100
  mkdirSync(backup, { recursive: true });
74
101
  const present = [];
75
102
  for (const rel of paths) {
103
+ assertSafeWorkspaceTarget(workspace, rel);
76
104
  const source = join(workspace, rel);
77
105
  if (!existsSync(source)) continue;
78
- const destination = join(backup, rel);
79
- mkdirSync(dirname(destination), { recursive: true });
80
- cpSync(source, destination, { recursive: true, dereference: false });
81
- present.push(rel);
106
+ const destination = join(backup, rel); mkdirSync(dirname(destination), { recursive: true });
107
+ cpSync(source, destination, { recursive: true, dereference: false }); present.push(rel);
82
108
  }
83
- return { backup, present };
109
+ // Durably materialize every regular backup leaf and the recovery directory metadata.
110
+ const syncTree = (path) => { for (const entry of readdirSync(path, { withFileTypes: true })) { const child = join(path, entry.name); if (entry.isDirectory()) syncTree(child); else if (!entry.isSymbolicLink()) fsyncPath(child); } fsyncPath(path); };
111
+ syncTree(join(workspace, rootRel));
112
+ return { backup: backupRel, present, rootRel };
84
113
  }
85
-
86
114
  function restoreTouchedPaths(workspace, journal) {
87
- for (const rel of journal.paths ?? []) rmSync(join(workspace, rel), { recursive: true, force: true });
88
- for (const rel of journal.present ?? []) {
89
- const source = join(journal.backup, rel);
90
- if (!existsSync(source)) continue;
91
- const destination = join(workspace, rel);
92
- mkdirSync(dirname(destination), { recursive: true });
93
- cpSync(source, destination, { recursive: true, dereference: false });
115
+ for (const rel of journal.paths) { assertSafeWorkspaceTarget(workspace, rel); rmSync(join(workspace, rel), { recursive: true, force: true }); }
116
+ for (const rel of journal.present) {
117
+ const source = assertSafeWorkspaceTarget(workspace, join(journal.backup, rel));
118
+ if (!existsSync(source)) throw Object.assign(new Error(`transaction backup is missing ${rel}; journal preserved for diagnosis`), { unrecoverable: true });
119
+ // The prior target was removed above. Reject any newly introduced leaf or
120
+ // parent link before copying; a backed-up leaf symlink itself remains a
121
+ // legitimate object because cpSync does not dereference it.
122
+ const destination = assertSafeWorkspaceTarget(workspace, rel, { allowLeafSymlink: false });
123
+ mkdirSync(dirname(destination), { recursive: true }); cpSync(source, destination, { recursive: true, dereference: false });
94
124
  }
95
125
  }
96
-
126
+ function readJournal(workspace) { return validateJournal(workspace, JSON.parse(readFileSync(journalPath(workspace), "utf8"))); }
97
127
  export function transactionRecovery(workspace) {
98
- const path = journalPath(workspace);
99
- if (!existsSync(path)) return { pending: false, recoverable: false };
100
- try {
101
- const journal = JSON.parse(readFileSync(path, "utf8"));
102
- return { pending: true, recoverable: Boolean(journal.backup && existsSync(journal.backup)) };
103
- } catch {
104
- return { pending: true, recoverable: false };
105
- }
128
+ if (!existsSync(journalPath(workspace))) return { pending: false, recoverable: false };
129
+ try { const journal = readJournal(workspace); return { pending: true, recoverable: journal.phase === "committed" || existsSync(join(workspace, journal.backup)), phase: journal.phase }; }
130
+ catch (error) { return { pending: true, recoverable: false, error: error.message }; }
106
131
  }
107
-
108
- /** Restore an interrupted transaction, returning false when none exists. */
109
132
  export function recoverTransaction(workspace) {
110
- const path = journalPath(workspace);
111
- if (!existsSync(path)) return false;
133
+ const path = journalPath(workspace); if (!existsSync(path)) return false;
112
134
  let journal;
113
- try { journal = JSON.parse(readFileSync(path, "utf8")); }
114
- catch { throw Object.assign(new Error("transaction journal is unreadable or has no recoverable backup"), { unrecoverable: true }); }
115
- if (!journal.backup || !existsSync(journal.backup)) {
116
- throw Object.assign(new Error("transaction journal has no recoverable backup"), { unrecoverable: true });
135
+ try { journal = readJournal(workspace); } catch (error) { throw Object.assign(new Error(`transaction journal is unreadable: ${error.message}; preserved for diagnosis`), { unrecoverable: true }); }
136
+ if (journal.phase !== "committed") {
137
+ if (!existsSync(join(workspace, journal.backup))) throw Object.assign(new Error("transaction backup is missing; journal preserved for diagnosis"), { unrecoverable: true });
138
+ restoreTouchedPaths(workspace, journal);
117
139
  }
118
- restoreTouchedPaths(workspace, journal);
119
- rmSync(journal.backup, { recursive: true, force: true });
120
- rmSync(path, { force: true });
121
- return true;
140
+ rmSync(join(workspace, dirname(journal.backup)), { recursive: true, force: true }); rmSync(path, { force: true });
141
+ return { recovered: journal.phase !== "committed", finalized: journal.phase === "committed", phase: journal.phase };
122
142
  }
143
+ /** Explicit diagnostic discard; never called automatically. */
144
+ export function discardUnrecoverableTransaction(workspace) { rmSync(journalPath(workspace), { force: true }); }
123
145
 
124
- /** The backup was reaped, so only the installer-owned journal can be discarded. */
125
- export function discardUnrecoverableTransaction(workspace) {
126
- rmSync(journalPath(workspace), { force: true });
127
- }
128
-
129
- /**
130
- * Journal before mutation; restore only managed paths if commit throws.
131
- * `validate` runs before journal creation, which is critical for conflicts,
132
- * unsupported snapshot metadata, and rejected migrations.
133
- */
134
- export function runTransaction({ workspace, plan, manifest, validate = () => {}, commit, failAt = null }) {
146
+ export function runTransaction({ workspace, plan, manifest, validate = () => {}, commit, failAt = null, lockHeld = false }) {
135
147
  validate();
136
- const paths = plan ? touchedPaths(plan, manifest) : [];
137
- const { backup, present } = backupTouchedPaths(workspace, paths);
138
- const path = journalPath(workspace);
139
- mkdirSync(dirname(path), { recursive: true });
140
- const journal = { schemaVersion: 2, backup, paths, present };
141
- // Durable pre-image: fsync the journal before any managed workspace write.
142
- const fd = openSync(path, "w");
143
- try {
144
- writeSync(fd, JSON.stringify(journal, null, 2) + "\n");
145
- fsyncSync(fd);
146
- } finally {
147
- closeSync(fd);
148
- }
148
+ if (existsSync(journalPath(workspace))) throw new Error("pending transaction journal exists; run doctor --fix before replanning");
149
+ const lock = lockHeld ? null : acquireWorkspaceLock(workspace, plan?.verb ?? "transaction");
150
+ let journal;
149
151
  try {
152
+ assertPlanFingerprints(plan ?? { workspace }, manifest);
153
+ const paths = plan ? touchedPaths(plan, manifest) : [];
154
+ const saved = backupTouchedPaths(workspace, paths);
155
+ journal = { schemaVersion: 3, phase: "prepared", backup: saved.backup, paths, present: saved.present };
156
+ mkdirSync(dirname(journalPath(workspace)), { recursive: true }); durableJson(journalPath(workspace), journal);
150
157
  if (failAt === "after-journal") throw new Error("injected transaction interruption");
158
+ journal.phase = "applying"; durableJson(journalPath(workspace), journal);
151
159
  const result = commit();
152
160
  if (failAt === "after-commit") throw new Error("injected transaction interruption");
153
- rmSync(path, { force: true });
154
- rmSync(backup, { recursive: true, force: true });
161
+ journal.phase = "committed"; durableJson(journalPath(workspace), journal);
162
+ if (failAt === "after-durable-commit") throw Object.assign(new Error("files committed; cleanup incomplete"), { postCommit: true });
163
+ rmSync(join(workspace, dirname(journal.backup)), { recursive: true, force: true }); rmSync(journalPath(workspace), { force: true });
155
164
  return result;
156
165
  } catch (error) {
157
- restoreTouchedPaths(workspace, journal);
158
- rmSync(path, { force: true });
159
- rmSync(backup, { recursive: true, force: true });
166
+ if (journal && journal.phase !== "committed") {
167
+ try { restoreTouchedPaths(workspace, journal); rmSync(join(workspace, dirname(journal.backup)), { recursive: true, force: true }); rmSync(journalPath(workspace), { force: true }); }
168
+ catch (rollback) { throw Object.assign(new Error(`apply failed: ${error.message}; rollback failed: ${rollback.message}; recovery diagnostics preserved`), { rollbackFailed: true }); }
169
+ }
160
170
  throw error;
161
- }
171
+ } finally { lock?.release(); }
162
172
  }
package/bin/lib/tui.js CHANGED
@@ -1,71 +1,76 @@
1
- // tui.js — dependency-free, readline-driven setup selection.
2
-
1
+ // tui.js — dependency-free prompt ownership and setup selection.
2
+ import { resolveDesiredFeatures, resolveFeatures } from "./features.js";
3
3
  const CANCEL = /^(c|cancel|q|quit)$/i;
4
-
5
- function enabledFeatures(desired) {
6
- return Object.entries(desired?.features ?? {})
7
- .filter(([, enabled]) => enabled)
8
- .map(([name]) => name)
9
- .sort();
4
+ function enabledFeatures(desired) { return Object.entries(desired?.features ?? {}).filter(([, on]) => on).map(([name]) => name).sort(); }
5
+ function availability(manifest, platform) {
6
+ return Object.keys(manifest.features ?? {}).sort().map((name) => {
7
+ try { resolveDesiredFeatures(manifest, { preset: "default", features: [name], platform }); return { name, available: true, stability: manifest.features[name].stability ?? "stable" }; }
8
+ catch (error) { return { name, available: false, stability: manifest.features[name].stability ?? "stable", reason: error.message }; }
9
+ });
10
10
  }
11
-
12
- function featureList(manifest) {
13
- return Object.keys(manifest.features ?? {}).sort()
14
- .map((name) => ` - ${name} (${manifest.features[name].stability ?? "stable"})`)
15
- .join("\n");
11
+ export function selectionSummary(manifest, preset, selected, platform = process.platform) {
12
+ const effective = resolveFeatures(manifest, selected, { platform });
13
+ const direct = [...selected].sort(); const deps = effective.filter((name) => !direct.includes(name));
14
+ const label = preset === "full" ? "Full" : "Default";
15
+ const describe = (values) => values.length ? values.map((name) => `${name} (${manifest.features[name].stability ?? "stable"})`).join(", ") : "none";
16
+ return `Preset: ${label}\nSelected features: ${describe(direct)}\nDependency features: ${describe(deps)}\n`;
16
17
  }
17
-
18
- /**
19
- * Collect an editable desired-state selection. Application confirmation belongs
20
- * to the caller after it has rendered the complete reconciliation plan.
21
- */
22
- export async function chooseSetup({ output, readLine, manifest, currentDesired = null }) {
23
- const currentPreset = currentDesired?.preset ?? "default";
24
- const currentFeatures = enabledFeatures(currentDesired);
25
- const ask = async (question) => {
26
- output.write(question);
27
- return readLine();
28
- };
29
-
30
- let preset;
31
- while (!preset) {
32
- const answer = await ask(
33
- "Choose a preset:\n" +
34
- " [1] Default — recommended stable Fleet basics\n" +
35
- " [2] Full — every stable integration (experimental features excluded)\n" +
36
- `Preset [${currentPreset}]: `,
37
- );
38
- if (answer === null || CANCEL.test(answer.trim())) return { cancelled: true };
39
- const value = answer.trim().toLowerCase();
40
- preset = value === "" ? currentPreset : value === "1" || value === "default" ? "default" : value === "2" || value === "full" ? "full" : null;
41
- if (!preset) output.write('Invalid preset. Enter 1 (Default), 2 (Full), or cancel.\n');
42
- }
43
-
44
- const known = new Set(Object.keys(manifest.features ?? {}));
45
- let features;
46
- while (!features) {
47
- const current = currentFeatures.length ? currentFeatures.join(",") : "none";
48
- const answer = await ask(
49
- `Optional features (comma-separated; blank keeps ${current}; "none" disables all):\n` +
50
- `${featureList(manifest)}\n` +
51
- "Experimental features are opt-in only and are never included by Full.\n" +
52
- "Features: ",
53
- );
54
- if (answer === null || CANCEL.test(answer.trim())) return { cancelled: true };
18
+ export async function askChoice({ output, readLine, prompt, validate }) {
19
+ while (true) {
20
+ // A real readline interface must own the prompt so its redraw/erase cycle
21
+ // cannot clear text printed separately just before question(""). Test and
22
+ // non-readline adapters retain the explicit output path.
23
+ if (!readLine.ownsPrompt) output.write(prompt);
24
+ const answer = await readLine(prompt);
25
+ if (answer === null) return { cancelled: true, reason: "EOF" };
26
+ if (answer === "__AGENT_FLEET_INTERRUPT__") return { cancelled: true, reason: "Ctrl+C" };
55
27
  const value = answer.trim();
56
- const selected = value === "" ? currentFeatures : value === "none" ? [] : [...new Set(value.split(",").map((name) => name.trim()).filter(Boolean))].sort();
57
- const unknown = selected.find((name) => !known.has(name));
58
- if (unknown) {
59
- output.write(`Unknown feature "${unknown}". Try again using one of the listed feature IDs.\n`);
60
- continue;
61
- }
62
- features = selected;
28
+ if (CANCEL.test(value)) return { cancelled: true, reason: "cancel" };
29
+ const result = validate(value);
30
+ if (result.ok) return { cancelled: false, value: result.value };
31
+ output.write(`${result.error}\n`);
63
32
  }
64
-
65
- return {
66
- cancelled: false,
67
- preset,
68
- features,
69
- changed: preset !== currentPreset || features.join(",") !== currentFeatures.join(","),
70
- };
33
+ }
34
+ export async function askFinalApproval({ output, readLine }) {
35
+ return askChoice({ output, readLine, prompt: "Apply this setup plan? yes/y | no/n; Enter = no (cancel without applying) > ", validate: (value) => {
36
+ if (/^y(?:es)?$/i.test(value)) return { ok: true, value: true };
37
+ if (value === "" || /^n(?:o)?$/i.test(value)) return { ok: true, value: false };
38
+ return { ok: false, error: "Invalid answer. Enter yes/y to apply or no/n to cancel." };
39
+ } });
40
+ }
41
+ /** Collect editable desired state; the caller owns final exact-plan approval. */
42
+ export async function chooseSetup({ output, readLine, manifest, currentDesired = null, platform = process.platform }) {
43
+ const currentPreset = currentDesired?.preset ?? "default";
44
+ const currentFeatures = enabledFeatures(currentDesired);
45
+ const available = availability(manifest, platform); const all = available.filter((x) => x.available).map((x) => x.name);
46
+ const presetResult = await askChoice({ output, readLine,
47
+ prompt: "Choose a preset:\n [1] Default — recommended stable Fleet basics\n [2] Full — every stable integration\n [3] Full + all features — includes platform-compatible experimental features\n" +
48
+ `Choose: 1 | 2 | 3 | cancel; Enter = ${currentPreset === "full" ? "Full" : "Default"} > `,
49
+ validate(value) {
50
+ if (value === "") return { ok: true, value: { preset: currentPreset, allFeatures: false } };
51
+ if (value === "1" || value.toLowerCase() === "default") return { ok: true, value: { preset: "default", allFeatures: false } };
52
+ if (value === "2" || value.toLowerCase() === "full") return { ok: true, value: { preset: "full", allFeatures: false } };
53
+ if (value === "3" || /^full\s*\+\s*all/i.test(value)) return { ok: true, value: { preset: "full", allFeatures: true } };
54
+ return { ok: false, error: "Invalid preset. Enter 1 (Default), 2 (Full), 3 (Full + all features), or cancel." };
55
+ },
56
+ });
57
+ if (presetResult.cancelled) return presetResult;
58
+ const preset = presetResult.value.preset;
59
+ const featureDefault = presetResult.value.allFeatures ? all : currentFeatures;
60
+ const listed = available.map((x) => ` - ${x.name} (${x.stability})${x.available ? "" : ` — unavailable: ${x.reason}`}`).join("\n");
61
+ const featureResult = await askChoice({ output, readLine,
62
+ prompt: `Available features:\n${listed}\nFeatures: <name>[,<name>...] | none | cancel; Enter = keep [${featureDefault.length ? featureDefault.join(",") : "none"}] > `,
63
+ validate(value) {
64
+ const selected = value === "" ? featureDefault : value.toLowerCase() === "none" ? [] : [...new Set(value.split(",").map((x) => x.trim()).filter(Boolean))].sort();
65
+ const found = selected.find((name) => !available.some((entry) => entry.name === name));
66
+ if (found) return { ok: false, error: `Unknown feature "${found}". Try again using a listed feature ID.` };
67
+ const blocked = selected.find((name) => !available.find((entry) => entry.name === name)?.available);
68
+ if (blocked) return { ok: false, error: `Feature "${blocked}" is unavailable on ${platform}.` };
69
+ return { ok: true, value: selected };
70
+ },
71
+ });
72
+ if (featureResult.cancelled) return featureResult;
73
+ const features = featureResult.value;
74
+ output.write(selectionSummary(manifest, preset, features, platform));
75
+ return { cancelled: false, preset, features, allFeaturesSnapshot: presetResult.value.allFeatures, changed: preset !== currentPreset || features.join(",") !== currentFeatures.join(",") };
71
76
  }
@@ -1,6 +1,6 @@
1
1
  // update-notifier — zero-dependency check for newer versions on the npm
2
- // registry, shared by the CLI, the Claude Code session hook, and the pi
3
- // extension.
2
+ // registry, shared by the CLI, the Claude Code session hook, and the Fleet
3
+ // Core helper (`.pi/harnesses/lib/update-check.ts`).
4
4
  //
5
5
  // Behaviour:
6
6
  // - Cache lives at $XDG_CACHE_HOME/agent-fleet/latest-version.json
@@ -0,0 +1,72 @@
1
+ // Shared workspace path and single-writer safety.
2
+ import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, rmdirSync, rmSync, writeFileSync } from "node:fs";
3
+ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
4
+
5
+ export const LOCK_REL_PATH = ".ai/agent-fleet.lock";
6
+
7
+ export function ownedRelativePath(workspace, value, label = "path") {
8
+ if (typeof value !== "string" || !value) throw new Error(`${label} must be a non-empty workspace path`);
9
+ const rel = relative(resolve(workspace), isAbsolute(value) ? resolve(value) : resolve(workspace, value));
10
+ if (rel === "") return ".";
11
+ if (rel === ".." || rel.startsWith(`..${sep}`) || rel.split(sep).includes("..")) throw new Error(`${label} is outside the workspace: ${value}`);
12
+ return rel;
13
+ }
14
+
15
+ /** Refuse writes through any existing parent symlink. Leaf symlinks remain valid managed targets. */
16
+ export function assertSafeWorkspaceTarget(workspace, value, { allowLeafSymlink = true } = {}) {
17
+ const rel = ownedRelativePath(workspace, value, "target path");
18
+ let cursor = resolve(workspace);
19
+ for (const [index, part] of rel.split(sep).entries()) {
20
+ cursor = join(cursor, part);
21
+ if (!existsSync(cursor)) continue;
22
+ const leaf = index === rel.split(sep).length - 1;
23
+ if (lstatSync(cursor).isSymbolicLink() && !(leaf && allowLeafSymlink)) {
24
+ throw new Error(`refusing target through symlink: ${rel}`);
25
+ }
26
+ }
27
+ return join(resolve(workspace), rel);
28
+ }
29
+
30
+ export function lockPath(workspace) { return join(workspace, LOCK_REL_PATH); }
31
+ export function breakWorkspaceLock(workspace) {
32
+ const path = assertSafeWorkspaceTarget(workspace, LOCK_REL_PATH, { allowLeafSymlink: false });
33
+ if (!existsSync(path)) return false;
34
+ rmSync(path, { force: true });
35
+ return true;
36
+ }
37
+
38
+ /** No stale-lock stealing: recovery is an explicit operator decision. */
39
+ export function acquireWorkspaceLock(workspace, operation) {
40
+ const path = lockPath(workspace);
41
+ assertSafeWorkspaceTarget(workspace, LOCK_REL_PATH, { allowLeafSymlink: false });
42
+ const parentExisted = existsSync(dirname(path));
43
+ mkdirSync(dirname(path), { recursive: true });
44
+ let fd;
45
+ try { fd = openSync(path, "wx", 0o600); }
46
+ catch (error) {
47
+ if (error.code !== "EEXIST") throw error;
48
+ let owner = "unknown owner";
49
+ try { owner = readFileSync(path, "utf8").trim() || owner; } catch {}
50
+ throw Object.assign(new Error(`workspace is locked (${owner}); locks are never stolen automatically`), { exitCode: 4 });
51
+ }
52
+ const body = JSON.stringify({ schemaVersion: 1, pid: process.pid, operation, createdAt: new Date().toISOString() }) + "\n";
53
+ writeFileSync(fd, body); closeSync(fd);
54
+ let released = false;
55
+ return {
56
+ path,
57
+ release() {
58
+ if (released) return;
59
+ released = true;
60
+ try {
61
+ const current = JSON.parse(readFileSync(path, "utf8"));
62
+ if (current.pid === process.pid) rmSync(path, { force: true });
63
+ if (!parentExisted) try { rmdirSync(dirname(path)); } catch {}
64
+ } catch {}
65
+ },
66
+ };
67
+ }
68
+
69
+ export function assertWorkspaceRootSafe(workspace) {
70
+ const root = realpathSync(workspace);
71
+ if (root !== resolve(workspace)) throw new Error("workspace root must not be a symlink");
72
+ }
@@ -22,9 +22,7 @@ cd ~/projects/my-app
22
22
  npx @chankov/agent-fleet@latest setup
23
23
  ```
24
24
 
25
- In a real TTY this opens the installer: pick **Default** or **Full**, add
26
- optional comma-separated features, read the exact reconciliation plan, and
27
- confirm once to apply. For automation, name the selection and consent up front:
25
+ In a real TTY this opens the installer: pick **Default**, **Full**, or **Full + all features**, edit the exact feature list, read the complete reconciliation plan, and answer `yes` to apply. Enter never approves mutation. For automation, name the selection and consent up front:
28
26
 
29
27
  ```bash
30
28
  npx @chankov/agent-fleet@latest setup --preset default --features none --yes
@@ -36,16 +34,13 @@ Pin the exact version when the run has to be reproducible:
36
34
  npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
37
35
  ```
38
36
 
39
- **Default** is the launchable, stable Fleet Core and creates neither `.claude/`
40
- nor voice configuration. **Full** selects every stable, platform-applicable
41
- catalogue root; it may install the recorded Claude Code coms bridge. Features
42
- are additive named capabilities (`browser`, `voice`, `hermes`, `telegram`,
37
+ **Default** is the stable Fleet Core selection and creates neither `.claude/` nor voice configuration. **Full** selects every stable, platform-applicable catalogue root; it may install the recorded Claude Code coms bridge. **Full + all features** is not a permanent preset: it stores `preset: "full"` and an explicit snapshot of every currently platform-compatible feature, including experimental ones, so future features are not silently enabled. Features are named capabilities (`browser`, `voice`, `hermes`, `telegram`,
43
38
  `claude-bridge`, and the experimental `chatgpt-client`), not an arbitrary
44
39
  package-entry mode — `setup --help` lists them.
45
40
 
46
41
  ### Then install the runtime dependencies
47
42
 
48
- Setup writes files; it does not run commands for you. The three `npm` steps for
43
+ Setup writes files; it does not run commands for you, and a successful file commit is not reported as runtime readiness unless the existing dependency checks pass. The three `npm` steps for
49
44
  `.pi/extensions`, `.pi/harnesses`, and `scripts` are planned as `skip` with the
50
45
  reason *"runs a command — re-run with `--allow-exec` to include it"*. **A
51
46
  workspace is not launchable until they run.** Either let setup run them:
@@ -93,12 +88,21 @@ node bin/cli.js setup --workspace ~/projects/my-app --preset default --features
93
88
 
94
89
  ### 1. Notice there is one
95
90
 
96
- A pi session started from a workspace with an install record prints a one-line
97
- banner on its first turn (`pi-extension:agent-fleet-update-check`, installed by
98
- Default):
91
+ A `just fleet` session started from a workspace with an install record prints a
92
+ banner at session start when a newer package is published (the shared helper in
93
+ `damage-control-continue`, not a standalone pi extension):
99
94
 
100
95
  ```
101
- agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest setup" to reconcile the workspace.
96
+ agent-fleet update available: 0.1.0 → 0.2.0
97
+
98
+ In the workspace root:
99
+ npx @chankov/agent-fleet@latest setup
100
+
101
+ Preview without writing:
102
+ npx @chankov/agent-fleet@latest setup --dry-run
103
+
104
+ Releases:
105
+ https://github.com/chankov/agent-fleet/releases
102
106
  ```
103
107
 
104
108
  To ask directly, without a session — it prints one line when an update exists
@@ -113,7 +117,7 @@ this installer or anything it wrote.
113
117
 
114
118
  ### 2. Preview the reconcile
115
119
 
116
- Always worth it, always free — `--dry-run` writes nothing and needs no consent:
120
+ Always worth it, always free — `--dry-run` creates no lock, backup, journal, or target write and needs no consent. JSON preview uses a versioned public model that deliberately omits internal write buffers (including complete `.env` and config before/after text):
117
121
 
118
122
  ```bash
119
123
  just fleet setup --dry-run
@@ -148,8 +152,8 @@ you do not restate the preset on every update. Flags passed on an update are
148
152
  ephemeral for that run only unless you add `--save-desired`:
149
153
 
150
154
  ```bash
151
- just fleet setup --features voice,browser --yes # this run only
152
- just fleet setup --features voice,browser --save-desired --yes # persisted
155
+ just fleet setup --features voice,browser --stt-provider groq --yes # this run only
156
+ just fleet setup --features voice,browser --stt-provider groq --save-desired --yes # persisted
153
157
  ```
154
158
 
155
159
  ### 4. Handle a conflict
@@ -245,6 +249,14 @@ state-owned legacy artifacts. Foreign or locally modified files survive.
245
249
  dispatch to `setup`; `install` and `upgrade` keep their historical selection and
246
250
  three-way-merge semantics and warn. New scripts should use `setup`.
247
251
 
252
+ ## Transaction and recovery contract
253
+
254
+ Mutating lifecycle commands hold `.ai/agent-fleet.lock`; locks are never stolen automatically. Planning refuses an existing `.ai/agent-fleet-transaction.json`. Recovery pre-images live durably under `.ai/.agent-fleet-recovery/`, and journal phases are `prepared`, `applying`, and `committed`. `doctor --fix` restores pre-commit phases or only finalizes cleanup for a durable committed phase. A missing/corrupt backup leaves diagnostics in place and fails honestly. After an operator has verified that the recorded process is gone, `doctor --fix --force` is the explicit stale-lock recovery path.
255
+
256
+ Plans fingerprint every touched target before approval and re-check immediately before writing. Absolute/`..` journal paths, non-installer backup roots, and target paths crossing parent symlinks are refused. Runtime subprocesses have a 120-second bound and visible start/completion output. Retry state stores an action ID, but the command is always reloaded from the trusted current manifest; saved argv never grants execution authority.
257
+
258
+ JSON stdout is one clean document. Public plan schema `1` adds a `stage` (`preview`, `config-repair-preview`, or `apply`) while retaining safe plan fields for consumers. Secret-bearing buffers (`text`, complete before/after/original/replacement bodies, and recovery locations) are never serialized.
259
+
248
260
  ## Doctor and uninstall
249
261
 
250
262
  ```bash
@@ -299,3 +311,17 @@ reads.
299
311
  | `3` | `setup` hit unresolved conflicts and wrote nothing |
300
312
 
301
313
  See [Migration](MIGRATION-agent-fleet.md) for the full major-release matrix.
314
+
315
+ ## Release operator verification
316
+
317
+ CI runs the installer and packed-artifact regression suite on Linux and macOS, including the narrow PTY path, then checks `npm pack --dry-run`. Publishing remains a separate protected step. After publishing, the operator must smoke the exact immutable version in a disposable repository before checking the tag:
318
+
319
+ ```bash
320
+ version=2.0.7 # released version, never `latest` for the first probe
321
+ repo="$(mktemp -d)"
322
+ (cd "$repo" && npx "@chankov/agent-fleet@$version" setup --preset default --features none --dry-run --json)
323
+ npm view "@chankov/agent-fleet@$version" version
324
+ npm view @chankov/agent-fleet@latest version # must equal $version only after the exact-version smoke passes
325
+ ```
326
+
327
+ No release verification should target a real application workspace.
@@ -28,7 +28,7 @@ not vendor that code; the mechanisms are rebuilt on Agent Fleet seams.
28
28
  ## What these extensions are
29
29
 
30
30
  `.pi/extensions/` contains utility extensions. Fleet Core explicitly loads
31
- `compact-and-continue`, `agent-fleet-update-check`, and `btw`; browser and voice are
31
+ `compact-and-continue` and `btw`; browser and voice are
32
32
  feature-gated: after setup installs them, launch with `just fleet --browser` or
33
33
  `just fleet --voice`. This keeps Default deterministic even though pi can auto-discover
34
34
  extensions outside Fleet Core. `btw` adds a
@@ -56,8 +56,8 @@ see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/READM
56
56
  The documented harnesses below are different: each is a **session harness**. They
57
57
  reshape the whole pi session — some set orchestration/UI surfaces and some gate every
58
58
  tool call. The unified `just fleet` entry point composes them with a deterministic
59
- Fleet Core: `damage-control-continue`, `ask-user-remote`, Compact & Continue,
60
- BTW, and the update checker. Voice is an optional feature, not Default Fleet Core.
59
+ Fleet Core: `damage-control-continue` (which also runs the shared package update
60
+ check once per session), `ask-user-remote`, Compact & Continue, and BTW. Voice is an optional feature, not Default Fleet Core.
61
61
  Every public Pi launch through bare `just fleet` also loads
62
62
  `agent-hub`; operator/orchestrator work mode changes its direct tool surface without changing
63
63
  process or session. `just fleet peer` starts a standalone coms peer. Harnesses live in