@chankov/agent-fleet 2.0.13 → 2.0.14

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 (530) hide show
  1. package/.pi/harnesses/agent-hub/README.md +9 -0
  2. package/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  3. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +75 -0
  4. package/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  5. package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +53 -0
  6. package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +15 -0
  7. package/.pi/harnesses/agent-hub/index.ts +40 -6
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  10. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +8 -1
  11. package/.pi/harnesses/agent-hub/system1-communication-store.ts +95 -0
  12. package/.pi/harnesses/agent-hub/system1-runtime.ts +5 -2
  13. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  14. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +9 -3
  15. package/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  16. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +29 -1
  17. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  18. package/.pi/harnesses/agent-hub/work-mode.ts +2 -1
  19. package/.pi/harnesses/coms/package.json +1 -1
  20. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  21. package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
  22. package/.pi/harnesses/lib/fleet-strip-controller.ts +2 -1
  23. package/.pi/harnesses/lib/fleet-strip-view.ts +1 -1
  24. package/.versions/2.0.14/.pi/agent-fleet/hermes/README.md +347 -0
  25. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  26. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  27. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  28. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  29. package/.versions/2.0.14/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  30. package/.versions/2.0.14/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  31. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  32. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  33. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  34. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  35. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  36. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  37. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  38. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  39. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  40. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  41. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  42. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  43. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  44. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  45. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  46. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  47. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  48. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  49. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  50. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  51. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  52. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  53. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  54. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  55. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  56. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  57. package/.versions/2.0.14/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  58. package/.versions/2.0.14/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  59. package/.versions/2.0.14/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  60. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  61. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  62. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  63. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  64. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  65. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet.ts +216 -0
  66. package/.versions/2.0.14/.pi/agent-fleet/scripts/flow.ts +157 -0
  67. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  68. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  69. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  70. package/.versions/2.0.14/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  71. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  72. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  73. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  74. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  75. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  76. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  77. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  78. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  79. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  80. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  81. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  82. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  83. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  84. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  85. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  86. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  87. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  88. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  89. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  90. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  91. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  92. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  93. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  94. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  95. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  96. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  97. package/.versions/2.0.14/.pi/agent-fleet/scripts/package-lock.json +35 -0
  98. package/.versions/2.0.14/.pi/agent-fleet/scripts/package.json +9 -0
  99. package/.versions/2.0.14/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  100. package/.versions/2.0.14/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  101. package/.versions/2.0.14/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  102. package/.versions/2.0.14/.pi/agent-fleet/scripts/team-up.ts +378 -0
  103. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  104. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  105. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  106. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  107. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  108. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  109. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  110. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  111. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  112. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  113. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  114. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  115. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  116. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  117. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  118. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  119. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  120. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  121. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  122. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  123. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  124. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  125. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  126. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  127. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  128. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  129. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  130. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  131. package/.versions/2.0.14/.pi/agents/dispatch-policy.yaml +32 -0
  132. package/.versions/2.0.14/.pi/agents/model-profiles.yaml +134 -0
  133. package/.versions/2.0.14/.pi/agents/peers.yaml +147 -0
  134. package/.versions/2.0.14/.pi/agents/teams.yaml +41 -0
  135. package/.versions/2.0.14/.pi/agents/voices.yaml +13 -0
  136. package/.versions/2.0.14/.pi/damage-control-rules.yaml +297 -0
  137. package/.versions/2.0.14/.pi/extensions/btw/README.md +120 -0
  138. package/.versions/2.0.14/.pi/extensions/btw/index.ts +914 -0
  139. package/.versions/2.0.14/.pi/extensions/btw/package.json +6 -0
  140. package/.versions/2.0.14/.pi/extensions/btw/state.js +179 -0
  141. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  142. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  143. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  144. package/.versions/2.0.14/.pi/extensions/compact-and-continue/README.md +42 -0
  145. package/.versions/2.0.14/.pi/extensions/compact-and-continue/index.ts +120 -0
  146. package/.versions/2.0.14/.pi/extensions/compact-and-continue/package.json +6 -0
  147. package/.versions/2.0.14/.pi/extensions/mcp-bridge/README.md +46 -0
  148. package/.versions/2.0.14/.pi/extensions/mcp-bridge/index.ts +206 -0
  149. package/.versions/2.0.14/.pi/extensions/mcp-bridge/package.json +6 -0
  150. package/.versions/2.0.14/.pi/extensions/package-lock.json +1175 -0
  151. package/.versions/2.0.14/.pi/extensions/package.json +9 -0
  152. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/README.md +224 -0
  153. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/config.ts +198 -0
  154. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  155. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/index.ts +248 -0
  156. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/package.json +6 -0
  157. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  158. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  159. package/.versions/2.0.14/.pi/harnesses/agent-hub/README.md +1369 -0
  160. package/.versions/2.0.14/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  161. package/.versions/2.0.14/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  162. package/.versions/2.0.14/.pi/harnesses/agent-hub/artifacts.js +146 -0
  163. package/.versions/2.0.14/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  164. package/.versions/2.0.14/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  165. package/.versions/2.0.14/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  166. package/.versions/2.0.14/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  167. package/.versions/2.0.14/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  168. package/.versions/2.0.14/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  169. package/.versions/2.0.14/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  170. package/.versions/2.0.14/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  171. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  172. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  173. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  174. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  175. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  176. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  177. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  178. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  179. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  180. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  181. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  182. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  183. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  184. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  185. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  186. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  187. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  188. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  189. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  190. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  191. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  192. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  193. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  194. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  195. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  196. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  197. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  198. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  199. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  200. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  201. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  202. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  203. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  204. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  205. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  206. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  207. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  208. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-window.js +108 -0
  209. package/.versions/2.0.14/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  210. package/.versions/2.0.14/.pi/harnesses/agent-hub/delegate.ts +467 -0
  211. package/.versions/2.0.14/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  212. package/.versions/2.0.14/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  213. package/.versions/2.0.14/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  214. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  215. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  216. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  217. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  218. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  219. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  220. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  221. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  222. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  223. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +75 -0
  224. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  225. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +53 -0
  226. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-state.ts +15 -0
  227. package/.versions/2.0.14/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  228. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  229. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  230. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  231. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  232. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  233. package/.versions/2.0.14/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  234. package/.versions/2.0.14/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  235. package/.versions/2.0.14/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  236. package/.versions/2.0.14/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  237. package/.versions/2.0.14/.pi/harnesses/agent-hub/fixtures/registration-surface.json +62 -0
  238. package/.versions/2.0.14/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  239. package/.versions/2.0.14/.pi/harnesses/agent-hub/footer.ts +30 -0
  240. package/.versions/2.0.14/.pi/harnesses/agent-hub/helpers.ts +270 -0
  241. package/.versions/2.0.14/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  242. package/.versions/2.0.14/.pi/harnesses/agent-hub/index.ts +2370 -0
  243. package/.versions/2.0.14/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  244. package/.versions/2.0.14/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  245. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  246. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  247. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  248. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  249. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  250. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  251. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  252. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  253. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  254. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  255. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  256. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  257. package/.versions/2.0.14/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  258. package/.versions/2.0.14/.pi/harnesses/agent-hub/package.json +7 -0
  259. package/.versions/2.0.14/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  260. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  261. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  262. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  263. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  264. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  265. package/.versions/2.0.14/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  266. package/.versions/2.0.14/.pi/harnesses/agent-hub/presentation.ts +48 -0
  267. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  268. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  269. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  270. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  271. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  272. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  273. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  274. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  275. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  276. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  277. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  278. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  279. package/.versions/2.0.14/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  280. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  281. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  282. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  283. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  284. package/.versions/2.0.14/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  285. package/.versions/2.0.14/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  286. package/.versions/2.0.14/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  287. package/.versions/2.0.14/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  288. package/.versions/2.0.14/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  289. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  290. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  291. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  292. package/.versions/2.0.14/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  293. package/.versions/2.0.14/.pi/harnesses/agent-hub/return-contract.js +327 -0
  294. package/.versions/2.0.14/.pi/harnesses/agent-hub/return-extract.js +77 -0
  295. package/.versions/2.0.14/.pi/harnesses/agent-hub/review-findings.js +104 -0
  296. package/.versions/2.0.14/.pi/harnesses/agent-hub/run-budget.js +542 -0
  297. package/.versions/2.0.14/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  298. package/.versions/2.0.14/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  299. package/.versions/2.0.14/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  300. package/.versions/2.0.14/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  301. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  302. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-health.js +110 -0
  303. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-start.ts +42 -0
  304. package/.versions/2.0.14/.pi/harnesses/agent-hub/spawn.ts +526 -0
  305. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  306. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-communication-store.ts +95 -0
  307. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  308. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-runtime.ts +279 -0
  309. package/.versions/2.0.14/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  310. package/.versions/2.0.14/.pi/harnesses/agent-hub/timeline.ts +72 -0
  311. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  312. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  313. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  314. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  315. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  316. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  317. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  318. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  319. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  320. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  321. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  322. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  323. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  324. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  325. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  326. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  327. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  328. package/.versions/2.0.14/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  329. package/.versions/2.0.14/.pi/harnesses/agent-hub/types.ts +66 -0
  330. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  331. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  332. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  333. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  334. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +152 -0
  335. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  336. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  337. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  338. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  339. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  340. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  341. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  342. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  343. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  344. package/.versions/2.0.14/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  345. package/.versions/2.0.14/.pi/harnesses/agent-hub/version.ts +42 -0
  346. package/.versions/2.0.14/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  347. package/.versions/2.0.14/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  348. package/.versions/2.0.14/.pi/harnesses/agent-hub/work-mode.ts +174 -0
  349. package/.versions/2.0.14/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  350. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/README.md +59 -0
  351. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/index.ts +558 -0
  352. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  353. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  354. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  355. package/.versions/2.0.14/.pi/harnesses/coms/README.md +100 -0
  356. package/.versions/2.0.14/.pi/harnesses/coms/index.ts +282 -0
  357. package/.versions/2.0.14/.pi/harnesses/coms/package.json +7 -0
  358. package/.versions/2.0.14/.pi/harnesses/coms/version.ts +42 -0
  359. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/README.md +135 -0
  360. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/index.ts +550 -0
  361. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/package.json +7 -0
  362. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/version.ts +42 -0
  363. package/.versions/2.0.14/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  364. package/.versions/2.0.14/.pi/harnesses/lib/coms-core-io.ts +385 -0
  365. package/.versions/2.0.14/.pi/harnesses/lib/coms-core.ts +577 -0
  366. package/.versions/2.0.14/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  367. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  368. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  369. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-view.ts +107 -0
  370. package/.versions/2.0.14/.pi/harnesses/lib/context-budget.ts +114 -0
  371. package/.versions/2.0.14/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  372. package/.versions/2.0.14/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  373. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  374. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  375. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  376. package/.versions/2.0.14/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  377. package/.versions/2.0.14/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  378. package/.versions/2.0.14/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  379. package/.versions/2.0.14/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  380. package/.versions/2.0.14/.pi/harnesses/lib/fleet-panel.ts +34 -0
  381. package/.versions/2.0.14/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  382. package/.versions/2.0.14/.pi/harnesses/lib/fleet-selection.ts +24 -0
  383. package/.versions/2.0.14/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  384. package/.versions/2.0.14/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  385. package/.versions/2.0.14/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  386. package/.versions/2.0.14/.pi/harnesses/lib/herdr-client.ts +472 -0
  387. package/.versions/2.0.14/.pi/harnesses/lib/herdr-presence.ts +399 -0
  388. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  389. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  390. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  391. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  392. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  393. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  394. package/.versions/2.0.14/.pi/harnesses/lib/spawned-peers.js +191 -0
  395. package/.versions/2.0.14/.pi/harnesses/lib/system1/config.js +61 -0
  396. package/.versions/2.0.14/.pi/harnesses/lib/system1/contracts.ts +152 -0
  397. package/.versions/2.0.14/.pi/harnesses/lib/system1/demo.ts +106 -0
  398. package/.versions/2.0.14/.pi/harnesses/lib/system1/jev.ts +503 -0
  399. package/.versions/2.0.14/.pi/harnesses/lib/system1/service.ts +245 -0
  400. package/.versions/2.0.14/.pi/harnesses/lib/update-check.ts +222 -0
  401. package/.versions/2.0.14/.pi/harnesses/package-lock.json +2039 -0
  402. package/.versions/2.0.14/.pi/harnesses/package.json +10 -0
  403. package/.versions/2.0.14/.pi/prompts/af-build.md +24 -0
  404. package/.versions/2.0.14/.pi/prompts/af-code-simplify.md +22 -0
  405. package/.versions/2.0.14/.pi/prompts/af-constraints.md +31 -0
  406. package/.versions/2.0.14/.pi/prompts/af-plan.md +17 -0
  407. package/.versions/2.0.14/.pi/prompts/af-review.md +16 -0
  408. package/.versions/2.0.14/.pi/prompts/af-set-hermes-telegram.md +15 -0
  409. package/.versions/2.0.14/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  410. package/.versions/2.0.14/.pi/prompts/af-setup-rules.md +20 -0
  411. package/.versions/2.0.14/.pi/prompts/af-ship.md +17 -0
  412. package/.versions/2.0.14/.pi/prompts/af-spec.md +15 -0
  413. package/.versions/2.0.14/.pi/prompts/af-test.md +19 -0
  414. package/.versions/2.0.14/.pi/skills/bowser/SKILL.md +145 -0
  415. package/.versions/2.0.14/.version +1 -0
  416. package/.versions/2.0.14/agents/architect.md +24 -0
  417. package/.versions/2.0.14/agents/bowser.md +28 -0
  418. package/.versions/2.0.14/agents/builder.md +55 -0
  419. package/.versions/2.0.14/agents/code-reviewer.md +209 -0
  420. package/.versions/2.0.14/agents/deep-researcher.md +32 -0
  421. package/.versions/2.0.14/agents/documenter.md +22 -0
  422. package/.versions/2.0.14/agents/orchestrator.md +22 -0
  423. package/.versions/2.0.14/agents/plan-reviewer.md +83 -0
  424. package/.versions/2.0.14/agents/planner.md +105 -0
  425. package/.versions/2.0.14/agents/releaser.md +24 -0
  426. package/.versions/2.0.14/agents/researcher.md +30 -0
  427. package/.versions/2.0.14/agents/security-auditor.md +167 -0
  428. package/.versions/2.0.14/agents/test-engineer.md +153 -0
  429. package/.versions/2.0.14/agents/web-debugger.md +44 -0
  430. package/.versions/2.0.14/agents/web-performance-auditor.md +194 -0
  431. package/.versions/2.0.14/bin/catalog/harness-runtime-closure.json +73 -0
  432. package/.versions/2.0.14/codex/fleet-session-client/SKILL.md +34 -0
  433. package/.versions/2.0.14/codex/fleet-session-client.zip +0 -0
  434. package/.versions/2.0.14/docs/ARCHITECTURE.md +754 -0
  435. package/.versions/2.0.14/docs/agent-fleet-setup.md +917 -0
  436. package/.versions/2.0.14/docs/claude-code-coms-bridge.md +134 -0
  437. package/.versions/2.0.14/docs/codex-session-bridge.md +219 -0
  438. package/.versions/2.0.14/docs/coms-hermes-bridge.md +188 -0
  439. package/.versions/2.0.14/docs/getting-started.md +126 -0
  440. package/.versions/2.0.14/docs/npm-install.md +476 -0
  441. package/.versions/2.0.14/docs/pi-extensions.md +454 -0
  442. package/.versions/2.0.14/docs/pi-setup.md +92 -0
  443. package/.versions/2.0.14/docs/skill-anatomy.md +150 -0
  444. package/.versions/2.0.14/install-manifest.json +3183 -0
  445. package/.versions/2.0.14/justfile +247 -0
  446. package/.versions/2.0.14/manifest-meta.json +1065 -0
  447. package/.versions/2.0.14/references/accessibility-checklist.md +160 -0
  448. package/.versions/2.0.14/references/communication-contract.md +26 -0
  449. package/.versions/2.0.14/references/definition-of-done.md +67 -0
  450. package/.versions/2.0.14/references/fleet-coordination-patterns.md +171 -0
  451. package/.versions/2.0.14/references/observability-checklist.md +92 -0
  452. package/.versions/2.0.14/references/orchestration-patterns.md +370 -0
  453. package/.versions/2.0.14/references/performance-checklist.md +236 -0
  454. package/.versions/2.0.14/references/prompting-patterns.md +380 -0
  455. package/.versions/2.0.14/references/security-checklist.md +245 -0
  456. package/.versions/2.0.14/references/testing-patterns.md +235 -0
  457. package/.versions/2.0.14/references/workflow-authoring.md +304 -0
  458. package/.versions/2.0.14/skills/_internal/grilling.md +59 -0
  459. package/.versions/2.0.14/skills/browser-testing-with-devtools/SKILL.md +351 -0
  460. package/.versions/2.0.14/skills/code-review-and-quality/SKILL.md +396 -0
  461. package/.versions/2.0.14/skills/compound-learning/SKILL.md +137 -0
  462. package/.versions/2.0.14/skills/constraint-driven-development/SKILL.md +338 -0
  463. package/.versions/2.0.14/skills/constraint-driven-development/references/floor-guard.md +99 -0
  464. package/.versions/2.0.14/skills/context-engineering/SKILL.md +341 -0
  465. package/.versions/2.0.14/skills/deprecation-and-migration/SKILL.md +247 -0
  466. package/.versions/2.0.14/skills/designing-agents/SKILL.md +394 -0
  467. package/.versions/2.0.14/skills/designing-agents/pi-harness-authoring.md +222 -0
  468. package/.versions/2.0.14/skills/drafting-workflows/SKILL.md +143 -0
  469. package/.versions/2.0.14/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  470. package/.versions/2.0.14/skills/frontend-ui-engineering/SKILL.md +328 -0
  471. package/.versions/2.0.14/skills/git-workflow-and-versioning/SKILL.md +316 -0
  472. package/.versions/2.0.14/skills/idea-refine/SKILL.md +182 -0
  473. package/.versions/2.0.14/skills/idea-refine/examples.md +238 -0
  474. package/.versions/2.0.14/skills/idea-refine/frameworks.md +99 -0
  475. package/.versions/2.0.14/skills/idea-refine/refinement-criteria.md +113 -0
  476. package/.versions/2.0.14/skills/idea-refine/scripts/idea-refine.sh +15 -0
  477. package/.versions/2.0.14/skills/incremental-implementation/SKILL.md +302 -0
  478. package/.versions/2.0.14/skills/interview-me/SKILL.md +226 -0
  479. package/.versions/2.0.14/skills/orchestration-verification/SKILL.md +182 -0
  480. package/.versions/2.0.14/skills/peer-coms/SKILL.md +90 -0
  481. package/.versions/2.0.14/skills/performance-optimization/SKILL.md +496 -0
  482. package/.versions/2.0.14/skills/planning-and-task-breakdown/SKILL.md +289 -0
  483. package/.versions/2.0.14/skills/repository-ai-setup/SKILL.md +117 -0
  484. package/.versions/2.0.14/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  485. package/.versions/2.0.14/skills/repository-ai-setup/references/apply-contract.md +74 -0
  486. package/.versions/2.0.14/skills/repository-ai-setup/references/provenance-template.md +16 -0
  487. package/.versions/2.0.14/skills/repository-ai-setup/references/setup-flow.md +108 -0
  488. package/.versions/2.0.14/skills/repository-ai-setup/references/verify-setup.md +20 -0
  489. package/.versions/2.0.14/skills/security-and-hardening/SKILL.md +524 -0
  490. package/.versions/2.0.14/skills/spec-driven-development/SKILL.md +295 -0
  491. package/.versions/2.0.14/skills/using-agent-skills/SKILL.md +198 -0
  492. package/.versions/2.0.14/vendor/agent-skills-upstream/LICENSE +21 -0
  493. package/.versions/2.0.14/vendor/agent-skills-upstream/README.md +430 -0
  494. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  495. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  496. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  497. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  498. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  499. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  500. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  501. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  502. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  503. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  504. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  505. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  506. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  507. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  508. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  509. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  510. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  511. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  512. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  513. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  514. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  515. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  516. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  517. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  518. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  519. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  520. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  521. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  522. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  523. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  524. package/CHANGELOG.md +6 -0
  525. package/docs/ARCHITECTURE.md +1 -0
  526. package/docs/agent-fleet-setup.md +17 -0
  527. package/docs/npm-install.md +8 -0
  528. package/install-manifest.json +9 -1
  529. package/manifest-meta.json +8 -0
  530. package/package.json +3 -2
@@ -0,0 +1,126 @@
1
+ # Getting started
2
+
3
+ <img src="https://raw.githubusercontent.com/chankov/agent-fleet/main/docs/assets/branding/agent-fleet-logo-white-v1.png" alt="Agent Fleet — Many agents. One direction." width="480">
4
+
5
+ Agent Fleet installs deterministic pi workspace content. The public lifecycle is
6
+ **setup**, **doctor**, and **uninstall**; no coding agent or model is required.
7
+
8
+ ## Install a new repository
9
+
10
+ From the target repository, run the package command. `just fleet` does not exist
11
+ yet — the managed justfile region is one of the things setup writes — so a first
12
+ install always goes through `npx`:
13
+
14
+ ```bash
15
+ cd ~/projects/my-app
16
+ npx @chankov/agent-fleet@latest setup
17
+ ```
18
+
19
+ In a real TTY that opens the installer: choose **Default** or **Full** plus
20
+ optional comma-separated features, read the exact plan, and confirm once. For
21
+ automation, name the selection and consent:
22
+
23
+ ```bash
24
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
25
+ ```
26
+
27
+ Choose **Default** for stable Fleet Core or **Full** for all stable,
28
+ platform-applicable catalogue roots. Default creates neither voice configuration
29
+ nor `.claude/`; Full may install the recorded Claude Code coms bridge. Features
30
+ are named additions after preset selection. In an Agent Fleet source checkout,
31
+ use `node bin/cli.js setup` instead.
32
+
33
+ Setup writes files but runs no commands, so finish the install with the npm
34
+ steps it deliberately skipped — the workspace is not launchable until they run:
35
+
36
+ ```bash
37
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
38
+ just fleet doctor # exit 0 = nothing to repair
39
+ ```
40
+
41
+ (Or pass `--allow-exec` to setup and let it run them in the same pass.)
42
+
43
+ `doctor` validates all three roots with `npm ls`. The launcher repeats that
44
+ read-only preflight before Pi starts and points back to `just fleet deps` or
45
+ `setup --allow-exec` instead of allowing a missing import to surface later as a
46
+ misleading unknown command-line option.
47
+
48
+ ## First session
49
+
50
+ ```bash
51
+ just fleet # Hub/operator; empty native roster
52
+ just fleet --agents default --project af # Hub/orchestrator + native roster
53
+ just fleet --agents default --peers docs --project af
54
+ # Hub + standing Herdr peers
55
+ ```
56
+
57
+ ## Run and maintain deterministic flows
58
+
59
+ When the workflow runtime is selected, `just flow` runs code-owned workflows outside the interactive hub:
60
+
61
+ ```bash
62
+ just flow scout "where is authentication configured?"
63
+ just flow quality
64
+ just flow build-test "add the validated endpoint"
65
+ ```
66
+
67
+ Each run creates a `flow/<name>-<runId>` branch. Use the numbered maintenance selector to remove an empty/integrated branch or squash-merge an accepted result back to the branch from which it started:
68
+
69
+ ```bash
70
+ just flow cleanup # list flow branches and prompt for a number
71
+ just flow cleanup 1 # safely remove selection 1 through Worktrunk
72
+ just flow merge # list flow branches and prompt for a number
73
+ just flow merge 2 # squash-merge selection 2 through Worktrunk
74
+ ```
75
+
76
+ Maintenance requires [Worktrunk](https://worktrunk.dev). It refuses dirty worktrees, rejected runs, and unknown merge targets. See [workflows.md](workflows.md#clean-up-and-merge-flow-branches) for `--discard`, `--target`, full branch selectors, non-interactive `--yes`, and safety details.
77
+
78
+ ## Update an existing install
79
+
80
+ A pi session tells you when a newer version is published. To act on it:
81
+
82
+ ```bash
83
+ just fleet setup --dry-run # preview: what changes, what gets overwritten
84
+ just fleet setup # apply; shows the plan and asks once
85
+ just fleet deps # if the plan skipped the npm steps
86
+ just fleet doctor
87
+ ```
88
+
89
+ Your preset and features are remembered in `.ai/agent-fleet.json`, so a plain
90
+ `setup` reconciles to the selection you already chose.
91
+
92
+ Two things to know before your first update:
93
+
94
+ - **`setup` reconciles toward the package.** A file you edited in place is
95
+ refreshed and your edit is overwritten — no prompt, no conflict. Customize
96
+ through `.ai/agent-fleet-overrides.md` instead, which the lifecycle never
97
+ touches.
98
+ - **A conflict stops the run.** If you *and* the new version changed the same
99
+ file, setup exits `3` having written nothing; re-run with `--on-conflict
100
+ theirs` or `--on-conflict ours`.
101
+
102
+ `pi update --extensions` updates pi's own extensions only — never this installer
103
+ or what it wrote. Full update reference, including what happens to every file
104
+ state: [npm-install.md](npm-install.md#updating-an-existing-install).
105
+
106
+ ## Uninstall
107
+
108
+ `just fleet uninstall --yes` is for the self-hosted workspace lifecycle; it
109
+ removes the launcher last. Reinstall after that with the package CLI, not `just`:
110
+
111
+ ```bash
112
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
113
+ ```
114
+
115
+ ## Pi package-native skills and prompts
116
+
117
+ For pi package-native skills/prompts instead of copied ones:
118
+
119
+ ```bash
120
+ pi install -l npm:@chankov/agent-fleet
121
+ ```
122
+
123
+ Do not mix copied and package-native skills/prompts. `doctor` identifies that
124
+ ownership overlap. Read [pi-setup.md](pi-setup.md) for runtime composition,
125
+ [agent-fleet-setup.md](agent-fleet-setup.md) for project configuration, and
126
+ [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md) for the major-release matrix.
@@ -0,0 +1,476 @@
1
+ # Install and lifecycle
2
+
3
+ <img src="https://raw.githubusercontent.com/chankov/agent-fleet/main/docs/assets/branding/agent-fleet-logo-white-v1.png" alt="Agent Fleet — Many agents. One direction." width="480">
4
+
5
+ `@chankov/agent-fleet` is a deterministic pi workspace installer. It needs no
6
+ coding agent or model: `setup`, `doctor`, and `uninstall` are the public
7
+ lifecycle commands.
8
+
9
+ - [First install](#first-install) — a repository that has never had Agent Fleet
10
+ - [Updating an existing install](#updating-an-existing-install) — a new version shipped
11
+ - [What reconcile does to each file](#what-reconcile-does-to-each-file) — **read this before your first update**
12
+ - [Doctor and uninstall](#doctor-and-uninstall)
13
+
14
+ ## First install
15
+
16
+ Run the package command from the target repository. There is no `just fleet`
17
+ recipe yet — the managed justfile region is one of the things setup *writes* —
18
+ so the first install always goes through `npx`:
19
+
20
+ ```bash
21
+ cd ~/projects/my-app
22
+ npx @chankov/agent-fleet@latest setup
23
+ ```
24
+
25
+ In a real TTY this opens the installer: pick **Default**, **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:
26
+
27
+ ```bash
28
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
29
+ ```
30
+
31
+ Pin the exact version when the run has to be reproducible:
32
+
33
+ ```bash
34
+ npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
35
+ ```
36
+
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`,
38
+ `claude-bridge`, and the experimental `chatgpt-client` and `system1`), not an
39
+ arbitrary package-entry mode — `setup --help` lists them. Experimental features
40
+ are selected only when named explicitly; automatic **Full** does not include
41
+ `system1`.
42
+
43
+ ### Experimental System 1 foundation
44
+
45
+ System 1 is an optional foundation for fast, structured judgments. Select it
46
+ explicitly; a credential in the environment does not enable it:
47
+
48
+ ```bash
49
+ npx @chankov/agent-fleet@latest setup \
50
+ --preset default --features system1 --yes
51
+ ```
52
+
53
+ Setup installs the shared runtime and prints configuration instructions. It does
54
+ not create the human-owned `.ai/system1.json`, acquire a credential, contact the
55
+ provider, or install a local model. Create this exact version-1 configuration:
56
+
57
+ ```json
58
+ {
59
+ "version": 1,
60
+ "mode": "auto",
61
+ "provider": "typesafe",
62
+ "model": "jev-1.13.0",
63
+ "apiKeyEnv": "TYPESAFE_API_KEY"
64
+ }
65
+ ```
66
+
67
+ Keep the key out of JSON and version control. The managed `just` launcher loads
68
+ the workspace root `.env`, so a gitignored file may declare it for commands run
69
+ through `just`:
70
+
71
+ ```sh
72
+ TYPESAFE_API_KEY=<your-key>
73
+ ```
74
+
75
+ A direct Node launch does **not** load `.env`; export or inject the variable into
76
+ that process yourself. Neither setup nor System 1 imports execute `.env` or
77
+ mutate the caller's environment.
78
+
79
+ Doctor is advisory and offline for this feature:
80
+
81
+ ```bash
82
+ just fleet doctor
83
+ # or directly:
84
+ npx @chankov/agent-fleet@latest doctor
85
+ ```
86
+
87
+ It distinguishes a name declared in `.env` from a nonempty value in its current
88
+ process environment, but never prints the value, contacts TypeSafe, or claims
89
+ the credential is valid. System 1 findings do not make an otherwise healthy
90
+ Fleet installation unlaunchable, and `doctor --fix` does not modify System 1
91
+ configuration.
92
+
93
+ The copied demo is TypeScript and needs a Node runtime that supports type
94
+ stripping (the managed `just` runtime supplies the required flags). Run it from
95
+ the workspace root. The default command is offline and only reports readiness:
96
+
97
+ ```bash
98
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
99
+ .pi/harnesses/lib/system1/demo.ts
100
+ ```
101
+
102
+ Only an explicit `--live` sends the demo's embedded synthetic Bulgarian/English
103
+ examples to the fixed TypeSafe endpoint:
104
+
105
+ ```bash
106
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
107
+ .pi/harnesses/lib/system1/demo.ts --live
108
+ ```
109
+
110
+ Live evaluation still requires explicit feature selection, the exact valid
111
+ configuration above, and a nonempty caller-environment key. The provider/model
112
+ are pinned to TypeSafe `jev-1.13.0`; arbitrary endpoints and automatic model
113
+ fallback are unsupported. Results are judgments, not permission to act.
114
+ Distributions, probabilities, and provider confidence are retained when the
115
+ provider supplies them, but are not invented or universally calibrated.
116
+
117
+ Current verification is deliberately split: offline contract and installed
118
+ package checks passed on Node 25.2.1; the real provider smoke was not run because
119
+ `TYPESAFE_API_KEY` was absent, and packaged doctor execution on Node 18 remains
120
+ unverified because that runtime was unavailable. This foundation has no
121
+ Watchdog consumer, local-model installation, or guarantee that existing child
122
+ processes cannot inherit the caller environment. A later integration must own
123
+ credential filtering, consumer policy, and calibration for its domain and
124
+ language.
125
+
126
+ ### Then install the runtime dependencies
127
+
128
+ 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
129
+ `.pi/extensions`, `.pi/harnesses`, and `scripts` are planned as `skip` with the
130
+ reason *"runs a command — re-run with `--allow-exec` to include it"*. **A
131
+ workspace is not launchable until they run.** Either let setup run them:
132
+
133
+ ```bash
134
+ npx @chankov/agent-fleet@latest setup --preset default --features none --allow-exec --yes
135
+ ```
136
+
137
+ …or run them afterwards through the recipe setup just installed:
138
+
139
+ ```bash
140
+ just fleet deps # npm install in .pi/extensions, .pi/harnesses, and scripts
141
+ just fleet doctor # confirm the workspace is whole
142
+ ```
143
+
144
+ `doctor` runs `npm ls --depth=0` against each installed root. Missing or invalid
145
+ runtime trees are launch-blocking findings (exit `2`) with the same two
146
+ remediation paths above; `doctor --fix` deliberately does not infer consent to
147
+ run a new npm install. The `just fleet` launcher performs the same check before
148
+ starting Pi, so an extension import failure cannot be misreported as an unknown
149
+ flag such as `--project`.
150
+
151
+ ### Verify the result
152
+
153
+ ```bash
154
+ just fleet doctor # exit 0 = nothing to repair, 2 = repairable findings
155
+ just fleet # Hub in operator work mode, empty native roster
156
+ ```
157
+
158
+ From here on `just fleet setup`, `just fleet doctor`, and `just fleet uninstall`
159
+ are available as thin wrappers over `npx @chankov/agent-fleet@latest`. They are
160
+ a convenience for a workspace that already has the justfile — never the
161
+ first-install path.
162
+
163
+ ### Source checkout
164
+
165
+ Inside an Agent Fleet checkout, use the local CLI instead of the published
166
+ package:
167
+
168
+ ```bash
169
+ node bin/cli.js setup --workspace ~/projects/my-app --preset default --features none --yes
170
+ ```
171
+
172
+ ### Voice STT configuration
173
+
174
+ Voice setup uses a nested `.ai/stt.json` provider object. Runtime types are `openai`,
175
+ `openai-compatible`, `azure` (Azure Speech), and `azure-openai` (Azure OpenAI Whisper).
176
+ The CLI aliases are `openai`, `groq`, `azure`, and `azure-openai`; `groq` is an installer
177
+ alias, not a runtime type, and the two Azure aliases select different services.
178
+
179
+ First-time OpenAI setup can use runtime defaults. For Groq, prepare complete nested JSON
180
+ with runtime type `openai-compatible` and the actual Groq endpoint/model, then run setup
181
+ without `--stt-provider groq`; that flag selects an installer alias, not the prepared runtime
182
+ type. Other OpenAI-compatible services use their own endpoint/model and are not Groq. For
183
+ Azure Speech or Azure OpenAI, prepare the complete nested JSON before setup. The installer
184
+ does not invent an endpoint, model, deployment, or API version. Existing canonical files
185
+ remain unchanged. Supported legacy flat files are preserved with a runtime-compatibility
186
+ warning and are not migrated automatically.
187
+
188
+ Keep credential values in the gitignored root `.env`, not in `.ai/stt.json`. The JSON names
189
+ the variables through fields such as `provider.apiKeyEnv` and `provider.endpointEnv`. Setup
190
+ preserves existing assignments (including `export NAME=...`) and adds only missing empty
191
+ placeholders. It checks structure and variable names, not whether credentials are present or
192
+ valid. See [the STT configuration guide](../.pi/extensions/pi-voice-stt/README.md).
193
+
194
+ A local checkout contains unreleased fixes only for commands run through `node bin/cli.js`.
195
+ Users invoking `npx @chankov/agent-fleet@latest` receive this behavior only after a corrected
196
+ package has been published; editing this repository does not change the already published
197
+ `2.0.9` package.
198
+
199
+ ## Updating an existing install
200
+
201
+ ### 1. Notice there is one
202
+
203
+ A `just fleet` session started from a workspace with an install record prints a
204
+ banner at session start when a newer package is published (the shared helper in
205
+ `damage-control-continue`, not a standalone pi extension):
206
+
207
+ ```
208
+ agent-fleet update available: 0.1.0 → 0.2.0
209
+
210
+ In the workspace root:
211
+ npx @chankov/agent-fleet@latest setup
212
+
213
+ Preview without writing:
214
+ npx @chankov/agent-fleet@latest setup --dry-run
215
+
216
+ Releases:
217
+ https://github.com/chankov/agent-fleet/releases
218
+ ```
219
+
220
+ To ask directly, without a session — it prints one line when an update exists
221
+ and stays silent when you are current:
222
+
223
+ ```bash
224
+ npx @chankov/agent-fleet check-update
225
+ ```
226
+
227
+ `pi update --extensions` updates pi's own extensions. It does **not** update
228
+ this installer or anything it wrote.
229
+
230
+ ### 2. Preview the reconcile
231
+
232
+ 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):
233
+
234
+ ```bash
235
+ just fleet setup --dry-run
236
+ # or, without the justfile recipe:
237
+ npx @chankov/agent-fleet@latest setup --dry-run
238
+ ```
239
+
240
+ The plan names every action and its reason. What you are reading for:
241
+
242
+ | Line in the plan | Means |
243
+ |---|---|
244
+ | `create` | New in this version, or a feature you added |
245
+ | `refresh … source is newer; the local copy is unmodified` | Clean update. Safe. |
246
+ | `refresh … locally modified — selecting it overwrites your edits` | **Your edit is about to be lost.** See below. |
247
+ | `conflict … changed both locally and upstream` | The run will exit `3` and write nothing until you choose a policy |
248
+ | `keep` | Unchanged, or installed but outside this selection |
249
+ | `remove` | Retired upstream and recorded as ours |
250
+ | `skip … runs a command` | The `npm` steps — follow with `just fleet deps` |
251
+
252
+ ### 3. Apply it
253
+
254
+ ```bash
255
+ just fleet setup # interactive: shows the plan, asks once
256
+ just fleet setup --yes # non-interactive
257
+ just fleet deps # if the plan skipped the exec steps
258
+ just fleet doctor # verify
259
+ ```
260
+
261
+ Your `--preset` / `--features` selection is **remembered**. `.ai/agent-fleet.json`
262
+ is the desired state, so a plain `setup` reconciles to whatever that file says —
263
+ you do not restate the preset on every update. Flags passed on an update are
264
+ ephemeral for that run only unless you add `--save-desired`:
265
+
266
+ ```bash
267
+ just fleet setup --features voice,browser --yes # this run only
268
+ just fleet setup --features voice,browser --save-desired --yes # persisted
269
+ ```
270
+
271
+ ### 4. Handle a conflict
272
+
273
+ A conflict is *both* sides changing: you edited an installed file **and** the new
274
+ version changed the same file. Setup refuses to guess — it exits `3` before
275
+ writing anything:
276
+
277
+ ```
278
+ conflict skill:code-review-and-quality changed both locally and upstream
279
+ exit 3
280
+ ```
281
+
282
+ Resolve by naming a policy for the run:
283
+
284
+ ```bash
285
+ just fleet setup --on-conflict theirs --yes # take the package version
286
+ just fleet setup --on-conflict ours --yes # keep your copy
287
+ ```
288
+
289
+ `theirs` writes the incoming file and your version is gone; `ours` keeps your
290
+ file and this item stays behind the package until you reconcile it by hand. To
291
+ keep a local edit *and* pick up the new upstream content, copy your edit out
292
+ first, take `theirs`, then re-apply it.
293
+
294
+ ### Keeping local edits across updates
295
+
296
+ If you have customized an installed artifact — a skill under `.pi/skills/`, a
297
+ persona under `.pi/agents/personas/` — understand that `setup` is a **reconcile to the
298
+ package**, not a merge in your favour. A file you edited where upstream did not
299
+ change is refreshed and your edit is overwritten, without a conflict and without
300
+ a prompt. `--dry-run` is what makes this visible before it happens.
301
+
302
+ The durable ways to customize:
303
+
304
+ - **`.ai/agent-fleet-overrides.md`** — human-owned, never overwritten. Spec/plan
305
+ paths, dev server, branch policy, per-persona models, dispatcher language.
306
+ See [agent-fleet-setup.md](agent-fleet-setup.md). This is the intended door.
307
+ - **Your own artifacts** — a skill under a name Agent Fleet does not ship is not
308
+ in the catalogue, so no lifecycle command touches it.
309
+ - **Deselect the item** — `setup` never removes what falls outside the current
310
+ selection, so a narrower preset leaves an item installed and frozen (`keep …
311
+ installed but not in this selection`).
312
+
313
+ Editing a shipped artifact in place is the one approach the lifecycle actively
314
+ works against.
315
+
316
+ ## What reconcile does to each file
317
+
318
+ The engine classifies every recorded file by comparing three things: the copy on
319
+ disk, the current package source, and the *baseline* — the same file as it
320
+ shipped in the version recorded in `.ai/agent-fleet-state.json`, read from the
321
+ package's `.versions/<x.y.z>/` snapshot tree.
322
+
323
+ | Disk vs source vs baseline | State | `setup` does |
324
+ |---|---|---|
325
+ | Disk matches source | `up-to-date` | `keep` |
326
+ | Disk matches baseline, source moved | `outdated` | `refresh` — clean update |
327
+ | Source matches baseline, disk moved | `modified` | **`refresh` — overwrites your edit** |
328
+ | Disk and source both moved, differently | `conflict` | exits `3` unless `--on-conflict` |
329
+ | Recorded, but no source in this version | `gone` | `keep` (the deprecated `upgrade` proposes removal) |
330
+ | Recorded, missing or mis-linked on disk | breakage | `repair`, regardless of selection |
331
+
332
+ Two things narrow this. If the `.versions/` snapshot for the recorded version is
333
+ missing (an unpublished local build, or a version older than retention), there is
334
+ no baseline: the comparison degrades to two-way, an edited file reads as
335
+ `modified`, and no `conflict` can be detected. And `keep`-on-local-edit is the
336
+ behaviour of the **deprecated `upgrade` verb**, not of `setup` — if you have
337
+ relied on `upgrade` preserving your edits, that is the difference to plan for.
338
+
339
+ ## Upgrading across the `.pi/agent-fleet` move
340
+
341
+ Before 2.1 an install wrote `scripts/`, `hermes/`, `agents/` and
342
+ `.claude/hooks/` at the root of your project. They are now `.pi/agent-fleet/`
343
+ (`scripts/`, `hermes/`, `hooks/`, `docs/`) and `.pi/agents/personas/`, and the
344
+ only thing an existing workspace has to do is run `setup` once.
345
+
346
+ There is no migration script, because none is needed. Changing where an item
347
+ installs changes its binding, and reconcile already retires recorded files that
348
+ have left one — under the same ownership rule as everything else, so a file you
349
+ edited is kept, becomes yours, and is reported by name. Directories the move
350
+ empties are pruned; a directory that still holds a file of yours is not.
351
+
352
+ Two details worth reading before you run it:
353
+
354
+ - `verify` reports the whole move as one advisory finding
355
+ (`19 item(s) moved: 111 old file(s) to remove, 2 kept`) rather than one per
356
+ path. `verify --json` still lists every path under `items[].obsoleteFiles`,
357
+ each flagged `retained` when it will be kept.
358
+ - The state file's `schemaVersion` goes `1` → `2`. A workspace still reading `1`
359
+ is one that has not been reconciled yet; `setup` re-stamps it on the way out.
360
+ The file's shape did not change — only the paths recorded in it.
361
+
362
+ The Claude Code bridge Stop hook is the one thing reconcile cannot finish for
363
+ you: it moves to `.pi/agent-fleet/hooks/coms-stop-hook.mjs`, and Claude Code
364
+ only runs it once `.claude/settings.json` names it. `setup` prints the snippet
365
+ with the current path when it installs the hook. Nothing else installs under
366
+ `.claude/` any more.
367
+
368
+ ## Desired state and migration
369
+
370
+ The desired selection lives in `.ai/agent-fleet.json` — human-owned, meant to be
371
+ committed. Command-line preset and feature flags are ephemeral over an existing
372
+ file unless `--save-desired` is passed. When the file is missing, setup writes
373
+ the selected desired state in the same transaction as its artifacts.
374
+
375
+ The first major-release migration, from a workspace that predates the state
376
+ file, is deliberately strict:
377
+
378
+ ```bash
379
+ # Preview is safe and does not require consent.
380
+ npx @chankov/agent-fleet@latest setup --migrate --dry-run
381
+
382
+ # Automation must name the desired state and explicitly consent to migration.
383
+ npx @chankov/agent-fleet@latest setup --migrate --preset default --features none --yes
384
+ ```
385
+
386
+ Migration lists each exact removal before consent and removes only unchanged,
387
+ state-owned legacy artifacts. Foreign or locally modified files survive.
388
+
389
+ `init`, `install`, `upgrade`, and `update` are deprecated. `init` and `update`
390
+ dispatch to `setup`; `install` and `upgrade` keep their historical selection and
391
+ three-way-merge semantics and warn. New scripts should use `setup`.
392
+
393
+ ## Transaction and recovery contract
394
+
395
+ 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.
396
+
397
+ 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.
398
+
399
+ 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.
400
+
401
+ ## Doctor and uninstall
402
+
403
+ ```bash
404
+ npx @chankov/agent-fleet doctor # read-only; never prompts
405
+ npx @chankov/agent-fleet doctor --fix
406
+ npx @chankov/agent-fleet uninstall --all --yes
407
+ npx @chankov/agent-fleet uninstall --all --purge-config --yes
408
+ ```
409
+
410
+ Uninstall removes only paths recorded in `.ai/agent-fleet-state.json`, and
411
+ preserves any recorded path whose bytes no longer match what we wrote. It also
412
+ preserves human configuration by default: `.ai/agent-fleet.json`,
413
+ `.ai/agent-fleet-overrides.md`, `.ai/stt.json`, and environment files.
414
+ `--purge-config` is the separate destructive gate for the three human config
415
+ files; environment files are never removed.
416
+
417
+ A self-hosted workspace may use `just fleet uninstall --yes`. It removes ordinary
418
+ owned artifacts first, then the managed justfile region and launcher scripts,
419
+ and finally lifecycle state/journal data; the already-running command prints its
420
+ final report from memory. Because that removes `just fleet`, reinstall with the
421
+ package CLI, then use `just fleet` again:
422
+
423
+ ```bash
424
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
425
+ just fleet doctor
426
+ ```
427
+
428
+ ## Package-native pi install
429
+
430
+ ```bash
431
+ pi install -l npm:@chankov/agent-fleet
432
+ ```
433
+
434
+ This exposes package-native skills and prompts. Do not also copy the same skills
435
+ and prompts into `.pi/`; `doctor` reports that ownership overlap as a read-only
436
+ `pi-package-ownership` advisory. Harness-only composition is supported:
437
+ package-native skills/prompts with copied Fleet Core harnesses.
438
+
439
+ ## Safety contract
440
+
441
+ All lifecycle commands support `--dry-run`; JSON output requires either
442
+ `--dry-run` or `--yes`. Files outside state ownership are never adopted for
443
+ removal. A failed file transaction rolls back rather than reporting success, and
444
+ `.ai/agent-fleet-transaction.json` is the crash-recovery journal `doctor --fix`
445
+ reads.
446
+
447
+ | Exit | Meaning |
448
+ |---|---|
449
+ | `0` | Success, or nothing to do |
450
+ | `1` | Could not run |
451
+ | `2` | `doctor` found repairable or launch-blocking manual-action issues |
452
+ | `3` | `setup` hit unresolved conflicts and wrote nothing |
453
+
454
+ See [Migration](MIGRATION-agent-fleet.md) for the full major-release matrix.
455
+
456
+ ## Release operator verification
457
+
458
+ 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:
459
+
460
+ ```bash
461
+ version=2.0.7 # released version, never `latest` for the first probe
462
+ repo="$(mktemp -d)"
463
+ (cd "$repo" && npx "@chankov/agent-fleet@$version" setup --preset default --features none --dry-run --json)
464
+ npm view "@chankov/agent-fleet@$version" version
465
+ npm view @chankov/agent-fleet@latest version # must equal $version only after the exact-version smoke passes
466
+ ```
467
+
468
+ No release verification should target a real application workspace.
469
+
470
+ ## System 1 dispatch advice and communication
471
+
472
+ Fleet `1` opens the session-only System 1 communication viewer; capture requires
473
+ explicit opt-in. The orchestrator may call `dispatch_triage` when its separate
474
+ human-owned configuration permits it. Both remain off by default; installation
475
+ does not authorize live requests or calibrate the policy. See the
476
+ [configuration, keys, privacy and evaluation guide](system1-dispatch-triage.md).