@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
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.6"
6
+ "version": "2.0.7"
7
7
  }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.6"
6
+ "version": "2.0.7"
7
7
  }
@@ -89,6 +89,17 @@ refuses guarded child dispatch rather than launching an unprotected process.
89
89
 
90
90
  Blocking itself runs passively on the `tool_call` event.
91
91
 
92
+ ## Package update check
93
+
94
+ On `session_start` this harness also schedules the shared Fleet Core helper
95
+ [`.pi/harnesses/lib/update-check.ts`](../lib/update-check.ts). In an interactive
96
+ session with a `version:` line in `.ai/agent-fleet-setup.md`, it compares that
97
+ record to the npm registry (24h shared cache with the CLI) and, when a newer
98
+ version exists, notifies with the exact `npx @chankov/agent-fleet@latest setup`
99
+ command — plus `--dry-run` and the releases URL. Headless hub children, CI, and
100
+ `AGENT_SKILLS_NO_UPDATE_CHECK` / `NO_UPDATE_NOTIFIER` skip the check. It never
101
+ blocks session start and never writes the install record.
102
+
92
103
  ## Requires
93
104
 
94
105
  - `.pi/damage-control-rules.yaml` — the rule set (shipped in this repo)
@@ -26,6 +26,8 @@
26
26
  * In this repo it is the only supported safety harness: the agent-hub main
27
27
  * session and every native specialist, research helper, and nested delegate
28
28
  * use it. Missing safety plumbing makes Agent Hub refuse child dispatch.
29
+ * Interactive sessions also schedule the shared Fleet Core update check
30
+ * (../lib/update-check.ts) on session_start — never blocking, never in children.
29
31
  *
30
32
  * Usage: pi -e .pi/harnesses/damage-control-continue/index.ts
31
33
  */
@@ -52,6 +54,7 @@ import {
52
54
  type PathRuleCategory,
53
55
  } from "../lib/damage-control-shared.ts";
54
56
  import { registerVersionStatus } from "./version.ts";
57
+ import { scheduleFleetUpdateCheck } from "../lib/update-check.ts";
55
58
 
56
59
  interface Rule {
57
60
  pattern: string;
@@ -266,6 +269,8 @@ export default function (pi: ExtensionAPI) {
266
269
 
267
270
  pi.on("session_start", async (_event, ctx) => {
268
271
  registerVersionStatus(ctx);
272
+ // Non-blocking: never delay rule loading or session start for a registry fetch.
273
+ scheduleFleetUpdateCheck(ctx);
269
274
  const projectRulesPath = path.join(ctx.cwd, ".pi", "damage-control-rules.yaml");
270
275
  const globalRulesPath = path.join(os.homedir(), ".pi", "damage-control-rules.yaml");
271
276
  const rulesPath = fs.existsSync(projectRulesPath) ? projectRulesPath : fs.existsSync(globalRulesPath) ? globalRulesPath : null;
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.6"
6
+ "version": "2.0.7"
7
7
  }
@@ -0,0 +1,222 @@
1
+ /**
2
+ * Fleet Core update check — surfaces an "update available" banner once per
3
+ * interactive session when @chankov/agent-fleet has a newer published version
4
+ * than the one recorded in `.ai/agent-fleet-setup.md`.
5
+ *
6
+ * damage-control-continue imports this helper so every `just fleet` launch
7
+ * (Hub, peer, coms) gets the check without a standalone pi extension.
8
+ *
9
+ * Design constraints:
10
+ * - Never blocks session start. Callers schedule it; network I/O is bounded
11
+ * to a single 3s fetch and every error path is swallowed.
12
+ * - Shares the same XDG cache file as the CLI (`~/.cache/agent-fleet/
13
+ * latest-version.json`) so the CLI and Fleet Core do not double-fetch.
14
+ * - Honors AGENT_SKILLS_NO_UPDATE_CHECK / NO_UPDATE_NOTIFIER / CI opt-outs.
15
+ * - Skips headless hub children (no UI, or AGENT_HUB_AGENT_ID set).
16
+ */
17
+
18
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
19
+ import { homedir } from "node:os";
20
+ import { dirname, join } from "node:path";
21
+ import { request } from "node:https";
22
+
23
+ import { AGENT_ID_ENV } from "./damage-control-shared.ts";
24
+
25
+ export const PACKAGE_NAME = "@chankov/agent-fleet";
26
+ export const RELEASES_URL = "https://github.com/chankov/agent-fleet/releases";
27
+ const REGISTRY = "https://registry.npmjs.org";
28
+ const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
29
+ const FETCH_TIMEOUT_MS = 3000;
30
+
31
+ const CACHE_DIR = join(
32
+ process.env.XDG_CACHE_HOME || join(homedir(), ".cache"),
33
+ "agent-fleet",
34
+ );
35
+ const DEFAULT_CACHE_FILE = join(CACHE_DIR, "latest-version.json");
36
+
37
+ export interface CachePayload {
38
+ latest: string;
39
+ checkedAt: number;
40
+ }
41
+
42
+ export type FleetUpdateCheckContext = {
43
+ cwd?: string;
44
+ hasUI?: boolean;
45
+ ui?: {
46
+ notify?: (message: string, level?: string) => void;
47
+ };
48
+ };
49
+
50
+ export type FleetUpdateCheckDeps = {
51
+ env?: NodeJS.Dict<string>;
52
+ now?: () => number;
53
+ cwd?: string;
54
+ cacheFile?: string;
55
+ exists?: (path: string) => boolean;
56
+ readFile?: (path: string, encoding: "utf8") => string;
57
+ writeFile?: (path: string, data: string, encoding: "utf8") => void;
58
+ mkdir?: (path: string, opts: { recursive: boolean }) => void;
59
+ fetchLatest?: (timeoutMs: number) => Promise<string | null>;
60
+ };
61
+
62
+ /**
63
+ * Fire-and-forget entry used by damage-control-continue on session_start.
64
+ * Must never reject into the harness.
65
+ */
66
+ export function scheduleFleetUpdateCheck(ctx: FleetUpdateCheckContext, deps: FleetUpdateCheckDeps = {}): void {
67
+ void runFleetUpdateCheck(ctx, deps).catch(() => {});
68
+ }
69
+
70
+ /**
71
+ * Run the check and notify when an upgrade exists.
72
+ * Returns the banner that was shown, or null when the check is skipped/silent.
73
+ */
74
+ export async function runFleetUpdateCheck(
75
+ ctx: FleetUpdateCheckContext,
76
+ deps: FleetUpdateCheckDeps = {},
77
+ ): Promise<string | null> {
78
+ try {
79
+ if (!shouldRun(ctx, deps)) return null;
80
+
81
+ const recorded = readRecordedVersion(deps.cwd ?? ctx.cwd ?? process.cwd(), deps);
82
+ if (!recorded) return null;
83
+
84
+ let latest = readCacheFresh(deps);
85
+ if (!latest) {
86
+ const fetchLatest = deps.fetchLatest ?? fetchLatestFromRegistry;
87
+ latest = await fetchLatest(FETCH_TIMEOUT_MS);
88
+ if (latest) writeCache({ latest, checkedAt: (deps.now ?? Date.now)() }, deps);
89
+ }
90
+ if (!latest) return null;
91
+ if (!isNewerVersion(latest, recorded)) return null;
92
+
93
+ const banner = formatUpdateBanner(recorded, latest);
94
+ ctx.ui?.notify?.(banner, "info");
95
+ return banner;
96
+ } catch {
97
+ return null;
98
+ }
99
+ }
100
+
101
+ export function formatUpdateBanner(recorded: string, latest: string): string {
102
+ return [
103
+ `agent-fleet update available: ${recorded} → ${latest}`,
104
+ ``,
105
+ `In the workspace root:`,
106
+ ` npx ${PACKAGE_NAME}@latest setup`,
107
+ ``,
108
+ `Preview without writing:`,
109
+ ` npx ${PACKAGE_NAME}@latest setup --dry-run`,
110
+ ``,
111
+ `Releases:`,
112
+ ` ${RELEASES_URL}`,
113
+ ].join("\n");
114
+ }
115
+
116
+ export function isNewerVersion(a: string, b: string): boolean {
117
+ const [aMain, aPre = ""] = a.split("-", 2);
118
+ const [bMain, bPre = ""] = b.split("-", 2);
119
+ const aParts = aMain.split(".").map(Number);
120
+ const bParts = bMain.split(".").map(Number);
121
+ for (let i = 0; i < 3; i++) {
122
+ const ai = aParts[i] ?? 0;
123
+ const bi = bParts[i] ?? 0;
124
+ if (ai !== bi) return ai > bi;
125
+ }
126
+ if (!aPre && bPre) return true;
127
+ if (aPre && !bPre) return false;
128
+ return aPre > bPre;
129
+ }
130
+
131
+ export function isUpdateCheckDisabled(env: NodeJS.Dict<string> = process.env): boolean {
132
+ return env.AGENT_SKILLS_NO_UPDATE_CHECK === "1"
133
+ || env.NO_UPDATE_NOTIFIER === "1"
134
+ || env.CI === "true";
135
+ }
136
+
137
+ function shouldRun(ctx: FleetUpdateCheckContext, deps: FleetUpdateCheckDeps): boolean {
138
+ const env = deps.env ?? process.env;
139
+ if (isUpdateCheckDisabled(env)) return false;
140
+ if (env[AGENT_ID_ENV]) return false;
141
+ if (ctx.hasUI !== true) return false;
142
+ if (typeof ctx.ui?.notify !== "function") return false;
143
+ return true;
144
+ }
145
+
146
+ function readRecordedVersion(cwd: string, deps: FleetUpdateCheckDeps): string | null {
147
+ const exists = deps.exists ?? existsSync;
148
+ const readFile = deps.readFile ?? readFileSync;
149
+ const recordPath = join(cwd, ".ai", "agent-fleet-setup.md");
150
+ if (!exists(recordPath)) return null;
151
+ try {
152
+ const text = readFile(recordPath, "utf8");
153
+ const m = text.match(/^version:\s*([^\s#]+)/m);
154
+ return m ? m[1].trim() : null;
155
+ } catch {
156
+ return null;
157
+ }
158
+ }
159
+
160
+ function cacheFilePath(deps: FleetUpdateCheckDeps): string {
161
+ return deps.cacheFile ?? DEFAULT_CACHE_FILE;
162
+ }
163
+
164
+ function readCacheFresh(deps: FleetUpdateCheckDeps): string | null {
165
+ try {
166
+ const exists = deps.exists ?? existsSync;
167
+ const readFile = deps.readFile ?? readFileSync;
168
+ const file = cacheFilePath(deps);
169
+ if (!exists(file)) return null;
170
+ const payload = JSON.parse(readFile(file, "utf8")) as CachePayload;
171
+ if ((deps.now ?? Date.now)() - payload.checkedAt >= CACHE_TTL_MS) return null;
172
+ return payload.latest;
173
+ } catch {
174
+ return null;
175
+ }
176
+ }
177
+
178
+ function writeCache(payload: CachePayload, deps: FleetUpdateCheckDeps): void {
179
+ try {
180
+ const mkdir = deps.mkdir ?? mkdirSync;
181
+ const writeFile = deps.writeFile ?? writeFileSync;
182
+ const file = cacheFilePath(deps);
183
+ mkdir(dirname(file), { recursive: true });
184
+ writeFile(file, JSON.stringify(payload, null, 2), "utf8");
185
+ } catch {
186
+ // Cache write failed — fine, we'll re-fetch next session.
187
+ }
188
+ }
189
+
190
+ function fetchLatestFromRegistry(timeoutMs: number): Promise<string | null> {
191
+ return new Promise((resolve) => {
192
+ const url = `${REGISTRY}/${encodeURIComponent(PACKAGE_NAME).replace("%40", "@")}/latest`;
193
+ const req = request(
194
+ url,
195
+ { method: "GET", headers: { accept: "application/json" } },
196
+ (res) => {
197
+ if (res.statusCode !== 200) {
198
+ res.resume();
199
+ resolve(null);
200
+ return;
201
+ }
202
+ let body = "";
203
+ res.setEncoding("utf8");
204
+ res.on("data", (chunk) => { body += chunk; });
205
+ res.on("end", () => {
206
+ try {
207
+ const parsed = JSON.parse(body);
208
+ resolve(typeof parsed.version === "string" ? parsed.version : null);
209
+ } catch {
210
+ resolve(null);
211
+ }
212
+ });
213
+ },
214
+ );
215
+ req.on("error", () => resolve(null));
216
+ req.setTimeout(timeoutMs, () => {
217
+ req.destroy();
218
+ resolve(null);
219
+ });
220
+ req.end();
221
+ });
222
+ }
@@ -0,0 +1,32 @@
1
+ # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
+ # DISPATCH time, never at team activation — the hub and its peers boot in
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
+ # after the session starts.
5
+ #
6
+ # default: native | coms — coms substitutes ANY active-team member that has
7
+ # a live same-name peer in the coms pool
8
+ # grace_s: <seconds> — how long a `fallback: none` member polls the pool
9
+ # for its peer before the dispatch is refused
10
+ # substitutions:
11
+ # <member>: — team-member/persona name (case-insensitive)
12
+ # prefer: native|coms — bare member block defaults to coms
13
+ # fallback: native|none — none = coms-required (refuse when no live peer)
14
+ # timeout_s: <seconds> — per-member reply timeout (default PI_COMS_TIMEOUT_MS)
15
+ #
16
+ # Missing file = everything native (no behavior change). This file is an
17
+ # orchestration decision; HOW each peer runs (model, runner: claude-code, env)
18
+ # stays in peers.yaml.
19
+
20
+ default: native
21
+ grace_s: 30
22
+
23
+ substitutions:
24
+ plan-reviewer:
25
+ prefer: coms
26
+ fallback: native
27
+ code-reviewer:
28
+ prefer: coms
29
+ fallback: native
30
+ documenter:
31
+ prefer: coms
32
+ fallback: native
@@ -0,0 +1,83 @@
1
+ # Flat profiles switch named personas; version: 2 profiles switch the complete fleet.
2
+ # See docs/agent-fleet-setup.md for defaults, child roles, services and policies.
3
+ mix-max:
4
+ code-reviewer: github-copilot/claude-opus-5
5
+ builder: openai-codex/gpt-5.6-sol
6
+ planner: github-copilot/claude-fable-5
7
+ plan-reviewer: openai-codex/gpt-5.6-sol
8
+ security-auditor: xai/grok-4.6
9
+ test-engineer: xai/grok-4.6
10
+ sol:
11
+ code-reviewer: openai-codex/gpt-5.6-sol
12
+ builder: openai-codex/gpt-5.6-sol
13
+ planner: openai-codex/gpt-5.6-sol
14
+ plan-reviewer: openai-codex/gpt-5.6-sol
15
+ security-auditor: openai-codex/gpt-5.6-sol
16
+ test-engineer: openai-codex/gpt-5.6-sol
17
+
18
+ # Local oMLX pair. 35B (qwen36) is the default brain: dispatcher, specialists,
19
+ # recon/preflight/feasibility/scout/sweeps, watchdog. 9B (qwen) is only the
20
+ # cheap, narrow helpers: documenter, docs, deps, conventions, planner voice-2,
21
+ # return-extractor. thinking stays off. Laguna is retired — do not reintroduce it.
22
+ local-duo:
23
+ version: 2
24
+ defaults:
25
+ model: &qwen36 omlx/Qwen3.6-35B-A3B-4bit
26
+ thinking: off
27
+ allowed-models:
28
+ - *qwen36
29
+ - omlx/Qwen3.6-35B-A3B-UD-MLX-3bit
30
+ - &qwen omlx/Qwen3.8-9B-heretic-uncensored-5bit-MLX
31
+ fallback: none
32
+ routing: native
33
+ dispatcher: *qwen36
34
+ agents:
35
+ architect: *qwen36
36
+ bowser: *qwen36
37
+ builder: *qwen36
38
+ code-reviewer: *qwen36
39
+ deep-researcher: *qwen36
40
+ documenter: *qwen
41
+ orchestrator: *qwen36
42
+ plan-reviewer: *qwen36
43
+ planner: *qwen36
44
+ releaser: *qwen36
45
+ researcher: *qwen36
46
+ security-auditor: *qwen36
47
+ test-engineer: *qwen36
48
+ web-debugger: *qwen36
49
+ web-performance-auditor: *qwen36
50
+ subagents:
51
+ builder:
52
+ recon: *qwen36
53
+ verifier: *qwen36
54
+ code-reviewer:
55
+ preflight: *qwen36
56
+ quality: *qwen36
57
+ perf: *qwen36
58
+ docs: *qwen
59
+ plan-reviewer:
60
+ feasibility: *qwen36
61
+ deps: *qwen
62
+ planner:
63
+ scout: *qwen36
64
+ rules: *qwen36
65
+ voice-1: *qwen36
66
+ voice-2: *qwen
67
+ voice-3: *qwen36
68
+ security-auditor:
69
+ recon: *qwen36
70
+ input-sweep: *qwen36
71
+ secrets-sweep: *qwen36
72
+ test-engineer:
73
+ coverage-scout: *qwen36
74
+ conventions: *qwen
75
+ services:
76
+ watchdog: *qwen36
77
+ return-extractor: *qwen
78
+ panel:
79
+ - name: qwen36
80
+ model: *qwen36
81
+ integrator: true
82
+ - name: qwen
83
+ model: *qwen
@@ -0,0 +1,145 @@
1
+ # Reusable coms peers, grouped into named teams (parallels teams.yaml).
2
+ #
3
+ # `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
4
+ # (requires a running herdr server — https://herdr.dev),
5
+ # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
+ #
7
+ # A team is NOT required to launch a single peer: `just fleet peer <name>` puts
8
+ # one peer (pi or `--runner claude-code`) in its own pane — splitting the current
9
+ # pane inside Herdr, else creating a one-pane workspace, or `--here` for the
10
+ # calling terminal. A name declared below keeps its runner/model/extensions/
11
+ # env_file; an undeclared name works too.
12
+ #
13
+ # Each peer entry:
14
+ # name — coms identity (the addressable peer name); overrides persona frontmatter
15
+ # persona — file under agents/ (without .md); its body is the role, its
16
+ # frontmatter `description`/`color` become the coms purpose/color
17
+ # model — optional pi --model spec (e.g. anthropic/claude-opus-4-7); omit to
18
+ # inherit pi's default model
19
+ # extensions — optional comma-separated extension names under .pi/extensions/ to
20
+ # load into this peer (routes it through `_peer-plus`). Use for a
21
+ # chrome-devtools-mcp browser-debug peer whose `chrome_devtools__*`
22
+ # tools a --no-extensions subagent could not get.
23
+ # env_file — optional repo-relative KEY=VALUE file (no shell evaluation) injected
24
+ # into the peer's pane env by herdr before the command runs. Must exist
25
+ # at spawn or team-up refuses. Values are redacted in --dry-run output.
26
+ # Pair with the gitignored `.env` convention from guided setup
27
+ # (docs/agent-fleet-setup.md).
28
+ # runner — optional; "claude-code" spawns interactive Claude Code + its coms
29
+ # bridge in the pane instead of a pi peer (persona not required;
30
+ # model maps to `claude --model`). Example:
31
+ # - name: claude-main
32
+ # runner: claude-code
33
+ # model: opus
34
+
35
+ # Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
36
+ # workspace containing only the guarded hub, with no reusable coms peer panes.
37
+ base:
38
+
39
+
40
+ # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
41
+ default:
42
+ - name: code-reviewer
43
+ runner: claude-code
44
+ - name: web-debugger
45
+ persona: web-debugger
46
+ model: openai-codex/gpt-5.6-luna
47
+ extensions: chrome-devtools-mcp
48
+
49
+
50
+ full:
51
+ - name: web-debugger
52
+ persona: web-debugger
53
+ model: openai-codex/gpt-5.6-terra
54
+ extensions: chrome-devtools-mcp
55
+ - name: documenter
56
+ persona: documenter
57
+ model: openai-codex/gpt-5.6-terra
58
+ - name: researcher
59
+ persona: researcher
60
+ model: openai-codex/gpt-5.6-luna
61
+
62
+ web:
63
+ - name: web-debugger
64
+ persona: web-debugger
65
+ model: openai-codex/gpt-5.6-terra
66
+ extensions: chrome-devtools-mcp
67
+
68
+ docs:
69
+ - name: documenter
70
+ persona: documenter
71
+ model: openai-codex/gpt-5.6-terra
72
+ - name: researcher
73
+ persona: researcher
74
+ model: openai-codex/gpt-5.6-luna
75
+
76
+
77
+ debug:
78
+ - name: test-engineer
79
+ persona: test-engineer
80
+ model: openai-codex/gpt-5.6-terra
81
+ - name: builder
82
+ persona: builder
83
+ model: openai-codex/gpt-5.6-terra
84
+ - name: code-reviewer
85
+ runner: claude-code
86
+
87
+ frontend:
88
+ - name: planner
89
+ persona: planner
90
+ model: openai-codex/gpt-5.6-sol
91
+ - name: builder
92
+ persona: builder
93
+ model: openai-codex/gpt-5.6-terra
94
+ - name: bowser
95
+ persona: bowser
96
+ model: openai-codex/gpt-5.6-luna
97
+ - name: code-reviewer
98
+ runner: claude-code
99
+
100
+ security:
101
+ - name: security-auditor
102
+ persona: security-auditor
103
+ model: openai-codex/gpt-5.6-sol
104
+ - name: builder
105
+ persona: builder
106
+ model: openai-codex/gpt-5.6-terra
107
+ - name: test-engineer
108
+ persona: test-engineer
109
+ model: openai-codex/gpt-5.6-terra
110
+ - name: code-reviewer
111
+ runner: claude-code
112
+
113
+ hotfix:
114
+ - name: builder
115
+ persona: builder
116
+ model: openai-codex/gpt-5.6-terra
117
+ - name: code-reviewer
118
+ runner: claude-code
119
+
120
+ release:
121
+ - name: releaser
122
+ persona: releaser
123
+ model: openai-codex/gpt-5.6-terra
124
+ - name: documenter
125
+ persona: documenter
126
+ model: openai-codex/gpt-5.6-terra
127
+
128
+ info:
129
+ - name: documenter
130
+ persona: documenter
131
+ model: openai-codex/gpt-5.3-codex-spark
132
+ - name: code-reviewer
133
+ runner: claude-code
134
+
135
+ review:
136
+ - name: plan-reviewer
137
+ runner: claude-code
138
+ - name: code-reviewer
139
+ runner: claude-code
140
+
141
+ plan:
142
+ - name: planner
143
+ runner: claude-code
144
+ - name: code-reviewer
145
+ runner: claude-code
@@ -0,0 +1,41 @@
1
+ # The first team is activated at startup. Switch with: /agents-team
2
+ # researcher / deep-researcher are not listed — they are always available through spawn_research.
3
+
4
+ default:
5
+ - builder
6
+ - test-engineer
7
+ - code-reviewer
8
+ - documenter
9
+
10
+ plan:
11
+ - planner
12
+ - plan-reviewer
13
+
14
+ debug:
15
+ - test-engineer
16
+ - builder
17
+ - code-reviewer
18
+
19
+ frontend:
20
+ - planner
21
+ - builder
22
+ - bowser
23
+ - code-reviewer
24
+
25
+ security:
26
+ - security-auditor
27
+ - builder
28
+ - test-engineer
29
+ - code-reviewer
30
+
31
+ hotfix:
32
+ - builder
33
+ - code-reviewer
34
+
35
+ release:
36
+ - releaser
37
+ - documenter
38
+
39
+ info:
40
+ - documenter
41
+ - code-reviewer
@@ -0,0 +1,13 @@
1
+ # Named model panels for poll/debate. There is no implicit default; pass --panel <name>.
2
+ # One voice = name + fully-qualified provider/id. At most one integrator per panel.
3
+ default:
4
+ - name: sol
5
+ model: openai-codex/gpt-5.6-sol
6
+ thinking: medium
7
+ - name: grok
8
+ model: xai/grok-4.6
9
+ thinking: medium
10
+ - name: opus
11
+ model: github-copilot/claude-opus-5
12
+ thinking: medium
13
+ integrator: true