@chankov/agent-fleet 2.0.3 → 2.0.5

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 (886) hide show
  1. package/.pi/agents/model-profiles.yaml +69 -13
  2. package/.pi/agents/peers.yaml +11 -8
  3. package/.pi/harnesses/agent-hub/README.md +15 -34
  4. package/.pi/harnesses/agent-hub/config/agents.ts +13 -14
  5. package/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  6. package/.pi/harnesses/agent-hub/context/agent-state.ts +1 -1
  7. package/.pi/harnesses/agent-hub/dispatch-coms.ts +6 -4
  8. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +6 -3
  9. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  10. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +1 -0
  11. package/.pi/harnesses/agent-hub/dispatch-native.ts +31 -16
  12. package/.pi/harnesses/agent-hub/dispatch-observability.ts +6 -1
  13. package/.pi/harnesses/agent-hub/footer.ts +2 -2
  14. package/.pi/harnesses/agent-hub/index.ts +128 -49
  15. package/.pi/harnesses/agent-hub/input/shortcuts.ts +0 -29
  16. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +7 -7
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/policy/models.ts +35 -8
  19. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  20. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  21. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  22. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  23. package/.pi/harnesses/agent-hub/research/spawn-run.ts +6 -1
  24. package/.pi/harnesses/agent-hub/spawn.ts +17 -1
  25. package/.pi/harnesses/agent-hub/tools/action-executors.ts +5 -2
  26. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +34 -1
  27. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +4 -0
  28. package/.pi/harnesses/agent-hub/types.ts +1 -0
  29. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  30. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +4 -1
  31. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +4 -2
  32. package/.pi/harnesses/agent-hub/ui/grid.ts +16 -118
  33. package/.pi/harnesses/agent-hub/ui/pool.ts +1 -6
  34. package/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  35. package/.pi/harnesses/coms/package.json +1 -1
  36. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  37. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +0 -5
  38. package/.pi/harnesses/lib/fleet-dashboard-view.ts +8 -2
  39. package/.versions/2.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  40. package/.versions/2.0.4/.pi/agents/model-profiles.yaml +78 -0
  41. package/.versions/2.0.4/.pi/agents/peers.yaml +145 -0
  42. package/.versions/2.0.4/.pi/agents/teams.yaml +41 -0
  43. package/.versions/2.0.4/.pi/agents/voices.yaml +13 -0
  44. package/.versions/2.0.4/.pi/damage-control-rules.yaml +297 -0
  45. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  46. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  47. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  48. package/.versions/2.0.4/.pi/extensions/btw/README.md +120 -0
  49. package/.versions/2.0.4/.pi/extensions/btw/index.ts +914 -0
  50. package/.versions/2.0.4/.pi/extensions/btw/package.json +6 -0
  51. package/.versions/2.0.4/.pi/extensions/btw/state.js +179 -0
  52. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  53. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  54. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  55. package/.versions/2.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  56. package/.versions/2.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  57. package/.versions/2.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  58. package/.versions/2.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  59. package/.versions/2.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  60. package/.versions/2.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  61. package/.versions/2.0.4/.pi/extensions/package-lock.json +1175 -0
  62. package/.versions/2.0.4/.pi/extensions/package.json +9 -0
  63. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  64. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  65. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  66. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  67. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  68. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  69. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  70. package/.versions/2.0.4/.pi/harnesses/agent-hub/README.md +1160 -0
  71. package/.versions/2.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  72. package/.versions/2.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  73. package/.versions/2.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  74. package/.versions/2.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  75. package/.versions/2.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  76. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  77. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  78. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  79. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  80. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  81. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  82. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  83. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  84. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  85. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  86. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  87. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  88. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  89. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  90. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  91. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  92. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  93. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  94. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  95. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  96. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  97. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  98. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  99. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  100. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  101. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  102. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  103. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  104. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  105. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  106. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  107. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  108. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  109. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  110. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  111. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  112. package/.versions/2.0.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  113. package/.versions/2.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  114. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  115. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  116. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  117. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  118. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  119. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  120. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native.ts +187 -0
  121. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  122. package/.versions/2.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  123. package/.versions/2.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  124. package/.versions/2.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  125. package/.versions/2.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  126. package/.versions/2.0.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  127. package/.versions/2.0.4/.pi/harnesses/agent-hub/footer.ts +30 -0
  128. package/.versions/2.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  129. package/.versions/2.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  130. package/.versions/2.0.4/.pi/harnesses/agent-hub/index.ts +2088 -0
  131. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  132. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  133. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  134. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  135. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  136. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  137. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  138. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  139. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  140. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  141. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  142. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  143. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  144. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  145. package/.versions/2.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  146. package/.versions/2.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  147. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  148. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  149. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  150. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  151. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  152. package/.versions/2.0.4/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  153. package/.versions/2.0.4/.pi/harnesses/agent-hub/presentation.ts +48 -0
  154. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  155. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  156. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  157. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  158. package/.versions/2.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  159. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  160. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  161. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/spawn-run.ts +144 -0
  162. package/.versions/2.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  163. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  164. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  165. package/.versions/2.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  166. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  167. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  168. package/.versions/2.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  169. package/.versions/2.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  170. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  171. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  172. package/.versions/2.0.4/.pi/harnesses/agent-hub/spawn.ts +404 -0
  173. package/.versions/2.0.4/.pi/harnesses/agent-hub/timeline.ts +54 -0
  174. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/action-executors.ts +148 -0
  175. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  176. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  177. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  178. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  179. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  180. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  181. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +84 -0
  182. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  183. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  184. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  185. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  186. package/.versions/2.0.4/.pi/harnesses/agent-hub/types.ts +61 -0
  187. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  188. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  189. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  190. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  191. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  192. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  193. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  194. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  195. package/.versions/2.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  196. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  197. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  198. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  199. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  200. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  201. package/.versions/2.0.4/.pi/harnesses/coms/README.md +100 -0
  202. package/.versions/2.0.4/.pi/harnesses/coms/index.ts +276 -0
  203. package/.versions/2.0.4/.pi/harnesses/coms/package.json +7 -0
  204. package/.versions/2.0.4/.pi/harnesses/coms/version.ts +42 -0
  205. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  206. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  207. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  208. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  209. package/.versions/2.0.4/.pi/harnesses/lib/coms-core-io.ts +385 -0
  210. package/.versions/2.0.4/.pi/harnesses/lib/coms-core.ts +577 -0
  211. package/.versions/2.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  212. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  213. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  214. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  215. package/.versions/2.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  216. package/.versions/2.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  217. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  218. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  219. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  220. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  221. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  222. package/.versions/2.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  223. package/.versions/2.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  224. package/.versions/2.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  225. package/.versions/2.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  226. package/.versions/2.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  227. package/.versions/2.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  228. package/.versions/2.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  229. package/.versions/2.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  230. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  231. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  232. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  233. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  234. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  235. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  236. package/.versions/2.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  237. package/.versions/2.0.4/.pi/harnesses/package-lock.json +2039 -0
  238. package/.versions/2.0.4/.pi/harnesses/package.json +10 -0
  239. package/.versions/2.0.4/.pi/prompts/af-build.md +24 -0
  240. package/.versions/2.0.4/.pi/prompts/af-code-simplify.md +22 -0
  241. package/.versions/2.0.4/.pi/prompts/af-plan.md +17 -0
  242. package/.versions/2.0.4/.pi/prompts/af-review.md +16 -0
  243. package/.versions/2.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  244. package/.versions/2.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  245. package/.versions/2.0.4/.pi/prompts/af-ship.md +17 -0
  246. package/.versions/2.0.4/.pi/prompts/af-spec.md +15 -0
  247. package/.versions/2.0.4/.pi/prompts/af-test.md +19 -0
  248. package/.versions/2.0.4/.pi/skills/bowser/SKILL.md +145 -0
  249. package/.versions/2.0.4/.version +1 -0
  250. package/.versions/2.0.4/agents/architect.md +25 -0
  251. package/.versions/2.0.4/agents/bowser.md +28 -0
  252. package/.versions/2.0.4/agents/builder.md +56 -0
  253. package/.versions/2.0.4/agents/code-reviewer.md +210 -0
  254. package/.versions/2.0.4/agents/deep-researcher.md +33 -0
  255. package/.versions/2.0.4/agents/documenter.md +22 -0
  256. package/.versions/2.0.4/agents/orchestrator.md +23 -0
  257. package/.versions/2.0.4/agents/plan-reviewer.md +84 -0
  258. package/.versions/2.0.4/agents/planner.md +105 -0
  259. package/.versions/2.0.4/agents/releaser.md +25 -0
  260. package/.versions/2.0.4/agents/researcher.md +31 -0
  261. package/.versions/2.0.4/agents/security-auditor.md +168 -0
  262. package/.versions/2.0.4/agents/test-engineer.md +154 -0
  263. package/.versions/2.0.4/agents/web-debugger.md +44 -0
  264. package/.versions/2.0.4/agents/web-performance-auditor.md +194 -0
  265. package/.versions/2.0.4/bin/catalog/harness-runtime-closure.json +36 -0
  266. package/.versions/2.0.4/codex/CONDUCTOR.md +148 -0
  267. package/.versions/2.0.4/docs/ARCHITECTURE.md +407 -0
  268. package/.versions/2.0.4/docs/agent-fleet-setup.md +547 -0
  269. package/.versions/2.0.4/docs/claude-code-coms-bridge.md +133 -0
  270. package/.versions/2.0.4/docs/codex-remote-conductor.md +170 -0
  271. package/.versions/2.0.4/docs/coms-hermes-bridge.md +189 -0
  272. package/.versions/2.0.4/docs/getting-started.md +124 -0
  273. package/.versions/2.0.4/docs/npm-install.md +299 -0
  274. package/.versions/2.0.4/docs/pi-extensions.md +447 -0
  275. package/.versions/2.0.4/docs/pi-setup.md +74 -0
  276. package/.versions/2.0.4/docs/skill-anatomy.md +150 -0
  277. package/.versions/2.0.4/hermes/README.md +347 -0
  278. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  279. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  280. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  281. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  282. package/.versions/2.0.4/hermes/gates/gate-o-capability.md +8 -0
  283. package/.versions/2.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  284. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  285. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  286. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  287. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  288. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  289. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  290. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  291. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  292. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  293. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  294. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  295. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  296. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  297. package/.versions/2.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  298. package/.versions/2.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  299. package/.versions/2.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  300. package/.versions/2.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  301. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  302. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  303. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  304. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  305. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  306. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  307. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  308. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  309. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  310. package/.versions/2.0.4/hermes/watchdog-tests/__init__.py +0 -0
  311. package/.versions/2.0.4/hooks/coms-stop-hook.mjs +84 -0
  312. package/.versions/2.0.4/install-manifest.json +2942 -0
  313. package/.versions/2.0.4/justfile +289 -0
  314. package/.versions/2.0.4/manifest-meta.json +969 -0
  315. package/.versions/2.0.4/references/accessibility-checklist.md +160 -0
  316. package/.versions/2.0.4/references/communication-contract.md +26 -0
  317. package/.versions/2.0.4/references/definition-of-done.md +67 -0
  318. package/.versions/2.0.4/references/fleet-coordination-patterns.md +171 -0
  319. package/.versions/2.0.4/references/observability-checklist.md +91 -0
  320. package/.versions/2.0.4/references/orchestration-patterns.md +370 -0
  321. package/.versions/2.0.4/references/performance-checklist.md +153 -0
  322. package/.versions/2.0.4/references/prompting-patterns.md +380 -0
  323. package/.versions/2.0.4/references/security-checklist.md +179 -0
  324. package/.versions/2.0.4/references/testing-patterns.md +236 -0
  325. package/.versions/2.0.4/references/workflow-authoring.md +304 -0
  326. package/.versions/2.0.4/scripts/claude-code-preflight.ts +70 -0
  327. package/.versions/2.0.4/scripts/codex-conductor.ts +41 -0
  328. package/.versions/2.0.4/scripts/codex-remote-control.ts +167 -0
  329. package/.versions/2.0.4/scripts/coms-claude-bridge.ts +411 -0
  330. package/.versions/2.0.4/scripts/coms-cli.ts +484 -0
  331. package/.versions/2.0.4/scripts/coms-hermes-bridge.ts +413 -0
  332. package/.versions/2.0.4/scripts/fleet.ts +222 -0
  333. package/.versions/2.0.4/scripts/flow.ts +137 -0
  334. package/.versions/2.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  335. package/.versions/2.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  336. package/.versions/2.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  337. package/.versions/2.0.4/scripts/install-hermes-plugin.sh +180 -0
  338. package/.versions/2.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  339. package/.versions/2.0.4/scripts/lib/codex-conductor.ts +88 -0
  340. package/.versions/2.0.4/scripts/lib/codex-remote-control.ts +482 -0
  341. package/.versions/2.0.4/scripts/lib/coms-envelope.ts +582 -0
  342. package/.versions/2.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  343. package/.versions/2.0.4/scripts/lib/fleet-command.ts +270 -0
  344. package/.versions/2.0.4/scripts/lib/flow-command.ts +93 -0
  345. package/.versions/2.0.4/scripts/lib/flow-maintenance.ts +230 -0
  346. package/.versions/2.0.4/scripts/lib/herdr-layout.ts +281 -0
  347. package/.versions/2.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  348. package/.versions/2.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  349. package/.versions/2.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  350. package/.versions/2.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  351. package/.versions/2.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  352. package/.versions/2.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  353. package/.versions/2.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  354. package/.versions/2.0.4/scripts/lib/monitor-env.ts +146 -0
  355. package/.versions/2.0.4/scripts/lib/peer-launch.ts +318 -0
  356. package/.versions/2.0.4/scripts/lib/persona-banner.ts +62 -0
  357. package/.versions/2.0.4/scripts/lib/runtime-dependencies.js +124 -0
  358. package/.versions/2.0.4/scripts/lib/spawn-stagger.ts +101 -0
  359. package/.versions/2.0.4/scripts/lib/team-project.ts +213 -0
  360. package/.versions/2.0.4/scripts/lib/team-snapshot.ts +147 -0
  361. package/.versions/2.0.4/scripts/package-lock.json +35 -0
  362. package/.versions/2.0.4/scripts/package.json +9 -0
  363. package/.versions/2.0.4/scripts/peer-banner.ts +40 -0
  364. package/.versions/2.0.4/scripts/peer-launch.ts +285 -0
  365. package/.versions/2.0.4/scripts/team-snapshot.ts +237 -0
  366. package/.versions/2.0.4/scripts/team-up.ts +406 -0
  367. package/.versions/2.0.4/scripts/workflows/lib/agent-phase.ts +133 -0
  368. package/.versions/2.0.4/scripts/workflows/lib/changes.ts +61 -0
  369. package/.versions/2.0.4/scripts/workflows/lib/debate.ts +149 -0
  370. package/.versions/2.0.4/scripts/workflows/lib/env.ts +34 -0
  371. package/.versions/2.0.4/scripts/workflows/lib/envelopes.ts +169 -0
  372. package/.versions/2.0.4/scripts/workflows/lib/gates.ts +81 -0
  373. package/.versions/2.0.4/scripts/workflows/lib/git.ts +96 -0
  374. package/.versions/2.0.4/scripts/workflows/lib/merge.ts +95 -0
  375. package/.versions/2.0.4/scripts/workflows/lib/model-profile.ts +22 -0
  376. package/.versions/2.0.4/scripts/workflows/lib/model-visibility.ts +92 -0
  377. package/.versions/2.0.4/scripts/workflows/lib/permissions.ts +130 -0
  378. package/.versions/2.0.4/scripts/workflows/lib/personas.ts +57 -0
  379. package/.versions/2.0.4/scripts/workflows/lib/poll.ts +86 -0
  380. package/.versions/2.0.4/scripts/workflows/lib/quality.ts +64 -0
  381. package/.versions/2.0.4/scripts/workflows/lib/run.ts +108 -0
  382. package/.versions/2.0.4/scripts/workflows/lib/trace.ts +34 -0
  383. package/.versions/2.0.4/scripts/workflows/lib/voices.ts +128 -0
  384. package/.versions/2.0.4/scripts/workflows/lib/writer-lease.ts +112 -0
  385. package/.versions/2.0.4/scripts/workflows/tsconfig.json +22 -0
  386. package/.versions/2.0.4/scripts/workflows/wf-build-test.ts +61 -0
  387. package/.versions/2.0.4/scripts/workflows/wf-debate.ts +87 -0
  388. package/.versions/2.0.4/scripts/workflows/wf-document.ts +50 -0
  389. package/.versions/2.0.4/scripts/workflows/wf-poll.ts +95 -0
  390. package/.versions/2.0.4/scripts/workflows/wf-quality.ts +20 -0
  391. package/.versions/2.0.4/scripts/workflows/wf-scout.ts +38 -0
  392. package/.versions/2.0.4/skills/_internal/grilling.md +59 -0
  393. package/.versions/2.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  394. package/.versions/2.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  395. package/.versions/2.0.4/skills/compound-learning/SKILL.md +137 -0
  396. package/.versions/2.0.4/skills/context-engineering/SKILL.md +291 -0
  397. package/.versions/2.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  398. package/.versions/2.0.4/skills/designing-agents/SKILL.md +394 -0
  399. package/.versions/2.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  400. package/.versions/2.0.4/skills/drafting-workflows/SKILL.md +143 -0
  401. package/.versions/2.0.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  402. package/.versions/2.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/.versions/2.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  404. package/.versions/2.0.4/skills/idea-refine/SKILL.md +182 -0
  405. package/.versions/2.0.4/skills/idea-refine/examples.md +238 -0
  406. package/.versions/2.0.4/skills/idea-refine/frameworks.md +99 -0
  407. package/.versions/2.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/.versions/2.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/.versions/2.0.4/skills/incremental-implementation/SKILL.md +298 -0
  410. package/.versions/2.0.4/skills/interview-me/SKILL.md +226 -0
  411. package/.versions/2.0.4/skills/orchestration-verification/SKILL.md +181 -0
  412. package/.versions/2.0.4/skills/peer-coms/SKILL.md +90 -0
  413. package/.versions/2.0.4/skills/performance-optimization/SKILL.md +350 -0
  414. package/.versions/2.0.4/skills/planning-and-task-breakdown/SKILL.md +265 -0
  415. package/.versions/2.0.4/skills/security-and-hardening/SKILL.md +461 -0
  416. package/.versions/2.0.4/skills/spec-driven-development/SKILL.md +256 -0
  417. package/.versions/2.0.4/skills/using-agent-skills/SKILL.md +197 -0
  418. package/.versions/2.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  419. package/.versions/2.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  420. package/.versions/2.0.4/vendor/agent-skills-upstream/README.md +11 -0
  421. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  422. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  423. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  424. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  425. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  426. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  427. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  428. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  429. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  430. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  431. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  432. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  433. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  434. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  435. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  436. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  437. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  438. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  439. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  440. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  441. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  442. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  443. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  444. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  445. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  446. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  447. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  448. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  449. package/.versions/2.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  450. package/.versions/2.0.5/.pi/agents/model-profiles.yaml +83 -0
  451. package/.versions/2.0.5/.pi/agents/peers.yaml +145 -0
  452. package/.versions/2.0.5/.pi/agents/teams.yaml +41 -0
  453. package/.versions/2.0.5/.pi/agents/voices.yaml +13 -0
  454. package/.versions/2.0.5/.pi/damage-control-rules.yaml +297 -0
  455. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  456. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  457. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  458. package/.versions/2.0.5/.pi/extensions/btw/README.md +120 -0
  459. package/.versions/2.0.5/.pi/extensions/btw/index.ts +914 -0
  460. package/.versions/2.0.5/.pi/extensions/btw/package.json +6 -0
  461. package/.versions/2.0.5/.pi/extensions/btw/state.js +179 -0
  462. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  463. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  464. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  465. package/.versions/2.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  466. package/.versions/2.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  467. package/.versions/2.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  468. package/.versions/2.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  469. package/.versions/2.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  470. package/.versions/2.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  471. package/.versions/2.0.5/.pi/extensions/package-lock.json +1175 -0
  472. package/.versions/2.0.5/.pi/extensions/package.json +9 -0
  473. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/README.md +205 -0
  474. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  475. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  476. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  477. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  478. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  479. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  480. package/.versions/2.0.5/.pi/harnesses/agent-hub/README.md +1139 -0
  481. package/.versions/2.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  482. package/.versions/2.0.5/.pi/harnesses/agent-hub/artifacts.js +146 -0
  483. package/.versions/2.0.5/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  484. package/.versions/2.0.5/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  485. package/.versions/2.0.5/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  486. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  487. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  488. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  489. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  490. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  491. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  492. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  493. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  494. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  495. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  496. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  497. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  498. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  499. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  500. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  501. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  502. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  503. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  504. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  505. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  506. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  507. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  508. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  509. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  510. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  511. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  512. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  513. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  514. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  515. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  516. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  517. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  518. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  519. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  520. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  521. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-window.js +106 -0
  522. package/.versions/2.0.5/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  523. package/.versions/2.0.5/.pi/harnesses/agent-hub/delegate.ts +446 -0
  524. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  525. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  526. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  527. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  528. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  529. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-types.ts +208 -0
  530. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native.ts +199 -0
  531. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  532. package/.versions/2.0.5/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  533. package/.versions/2.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  534. package/.versions/2.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  535. package/.versions/2.0.5/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  536. package/.versions/2.0.5/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  537. package/.versions/2.0.5/.pi/harnesses/agent-hub/footer.ts +30 -0
  538. package/.versions/2.0.5/.pi/harnesses/agent-hub/helpers.ts +266 -0
  539. package/.versions/2.0.5/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  540. package/.versions/2.0.5/.pi/harnesses/agent-hub/index.ts +2115 -0
  541. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  542. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  543. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  544. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  545. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  546. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  547. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  548. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  549. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  550. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  551. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  552. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  553. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  554. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  555. package/.versions/2.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  556. package/.versions/2.0.5/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  557. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  558. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  559. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  560. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  561. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  562. package/.versions/2.0.5/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  563. package/.versions/2.0.5/.pi/harnesses/agent-hub/presentation.ts +48 -0
  564. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  565. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  566. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  567. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  568. package/.versions/2.0.5/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  569. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  570. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/runtime.ts +177 -0
  571. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/spawn-run.ts +148 -0
  572. package/.versions/2.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  573. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-contract.js +293 -0
  574. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-extract.js +75 -0
  575. package/.versions/2.0.5/.pi/harnesses/agent-hub/review-findings.js +102 -0
  576. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-budget.js +537 -0
  577. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  578. package/.versions/2.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  579. package/.versions/2.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  580. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-health.js +110 -0
  581. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-start.ts +42 -0
  582. package/.versions/2.0.5/.pi/harnesses/agent-hub/spawn.ts +404 -0
  583. package/.versions/2.0.5/.pi/harnesses/agent-hub/timeline.ts +54 -0
  584. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  585. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  586. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  587. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  588. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +232 -0
  589. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  590. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  591. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  592. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  593. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  594. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  595. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  596. package/.versions/2.0.5/.pi/harnesses/agent-hub/types.ts +62 -0
  597. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  598. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  599. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  600. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  601. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  602. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  603. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  604. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/pool.ts +98 -0
  605. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  606. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  607. package/.versions/2.0.5/.pi/harnesses/agent-hub/version.ts +42 -0
  608. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  609. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  610. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/README.md +53 -0
  611. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/index.ts +532 -0
  612. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  613. package/.versions/2.0.5/.pi/harnesses/coms/README.md +100 -0
  614. package/.versions/2.0.5/.pi/harnesses/coms/index.ts +276 -0
  615. package/.versions/2.0.5/.pi/harnesses/coms/package.json +7 -0
  616. package/.versions/2.0.5/.pi/harnesses/coms/version.ts +42 -0
  617. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/README.md +124 -0
  618. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  619. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  620. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/version.ts +42 -0
  621. package/.versions/2.0.5/.pi/harnesses/lib/coms-core-io.ts +385 -0
  622. package/.versions/2.0.5/.pi/harnesses/lib/coms-core.ts +577 -0
  623. package/.versions/2.0.5/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  624. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  625. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  626. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-view.ts +107 -0
  627. package/.versions/2.0.5/.pi/harnesses/lib/context-budget.ts +114 -0
  628. package/.versions/2.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  629. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  630. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  631. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  632. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  633. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  634. package/.versions/2.0.5/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  635. package/.versions/2.0.5/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  636. package/.versions/2.0.5/.pi/harnesses/lib/fleet-panel.ts +34 -0
  637. package/.versions/2.0.5/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  638. package/.versions/2.0.5/.pi/harnesses/lib/fleet-selection.ts +24 -0
  639. package/.versions/2.0.5/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  640. package/.versions/2.0.5/.pi/harnesses/lib/herdr-client.ts +472 -0
  641. package/.versions/2.0.5/.pi/harnesses/lib/herdr-presence.ts +399 -0
  642. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  643. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  644. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  645. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  646. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  647. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  648. package/.versions/2.0.5/.pi/harnesses/lib/spawned-peers.js +190 -0
  649. package/.versions/2.0.5/.pi/harnesses/package-lock.json +2039 -0
  650. package/.versions/2.0.5/.pi/harnesses/package.json +10 -0
  651. package/.versions/2.0.5/.pi/prompts/af-build.md +24 -0
  652. package/.versions/2.0.5/.pi/prompts/af-code-simplify.md +22 -0
  653. package/.versions/2.0.5/.pi/prompts/af-plan.md +17 -0
  654. package/.versions/2.0.5/.pi/prompts/af-review.md +16 -0
  655. package/.versions/2.0.5/.pi/prompts/af-set-hermes-telegram.md +15 -0
  656. package/.versions/2.0.5/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  657. package/.versions/2.0.5/.pi/prompts/af-ship.md +17 -0
  658. package/.versions/2.0.5/.pi/prompts/af-spec.md +15 -0
  659. package/.versions/2.0.5/.pi/prompts/af-test.md +19 -0
  660. package/.versions/2.0.5/.pi/skills/bowser/SKILL.md +145 -0
  661. package/.versions/2.0.5/.version +1 -0
  662. package/.versions/2.0.5/agents/architect.md +25 -0
  663. package/.versions/2.0.5/agents/bowser.md +28 -0
  664. package/.versions/2.0.5/agents/builder.md +56 -0
  665. package/.versions/2.0.5/agents/code-reviewer.md +210 -0
  666. package/.versions/2.0.5/agents/deep-researcher.md +33 -0
  667. package/.versions/2.0.5/agents/documenter.md +23 -0
  668. package/.versions/2.0.5/agents/orchestrator.md +23 -0
  669. package/.versions/2.0.5/agents/plan-reviewer.md +84 -0
  670. package/.versions/2.0.5/agents/planner.md +106 -0
  671. package/.versions/2.0.5/agents/releaser.md +25 -0
  672. package/.versions/2.0.5/agents/researcher.md +31 -0
  673. package/.versions/2.0.5/agents/security-auditor.md +168 -0
  674. package/.versions/2.0.5/agents/test-engineer.md +154 -0
  675. package/.versions/2.0.5/agents/web-debugger.md +44 -0
  676. package/.versions/2.0.5/agents/web-performance-auditor.md +194 -0
  677. package/.versions/2.0.5/bin/catalog/harness-runtime-closure.json +36 -0
  678. package/.versions/2.0.5/codex/CONDUCTOR.md +148 -0
  679. package/.versions/2.0.5/docs/ARCHITECTURE.md +407 -0
  680. package/.versions/2.0.5/docs/agent-fleet-setup.md +561 -0
  681. package/.versions/2.0.5/docs/claude-code-coms-bridge.md +133 -0
  682. package/.versions/2.0.5/docs/codex-remote-conductor.md +170 -0
  683. package/.versions/2.0.5/docs/coms-hermes-bridge.md +189 -0
  684. package/.versions/2.0.5/docs/getting-started.md +124 -0
  685. package/.versions/2.0.5/docs/npm-install.md +299 -0
  686. package/.versions/2.0.5/docs/pi-extensions.md +446 -0
  687. package/.versions/2.0.5/docs/pi-setup.md +74 -0
  688. package/.versions/2.0.5/docs/skill-anatomy.md +150 -0
  689. package/.versions/2.0.5/hermes/README.md +347 -0
  690. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  691. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  692. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  693. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  694. package/.versions/2.0.5/hermes/gates/gate-o-capability.md +8 -0
  695. package/.versions/2.0.5/hermes/gates/gate-o-validator-fixtures.json +1 -0
  696. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  697. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  698. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  699. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  700. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  701. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  702. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  703. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  704. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  705. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  706. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  707. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  708. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  709. package/.versions/2.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  710. package/.versions/2.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  711. package/.versions/2.0.5/hermes/skills/hub-watchdog/SKILL.md +76 -0
  712. package/.versions/2.0.5/hermes/skills/hub-watchdog/manifest.json +1 -0
  713. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  714. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  715. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  716. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  717. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  718. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  719. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  720. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  721. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  722. package/.versions/2.0.5/hermes/watchdog-tests/__init__.py +0 -0
  723. package/.versions/2.0.5/hooks/coms-stop-hook.mjs +84 -0
  724. package/.versions/2.0.5/install-manifest.json +2942 -0
  725. package/.versions/2.0.5/justfile +289 -0
  726. package/.versions/2.0.5/manifest-meta.json +969 -0
  727. package/.versions/2.0.5/references/accessibility-checklist.md +160 -0
  728. package/.versions/2.0.5/references/communication-contract.md +26 -0
  729. package/.versions/2.0.5/references/definition-of-done.md +67 -0
  730. package/.versions/2.0.5/references/fleet-coordination-patterns.md +171 -0
  731. package/.versions/2.0.5/references/observability-checklist.md +91 -0
  732. package/.versions/2.0.5/references/orchestration-patterns.md +370 -0
  733. package/.versions/2.0.5/references/performance-checklist.md +153 -0
  734. package/.versions/2.0.5/references/prompting-patterns.md +380 -0
  735. package/.versions/2.0.5/references/security-checklist.md +179 -0
  736. package/.versions/2.0.5/references/testing-patterns.md +236 -0
  737. package/.versions/2.0.5/references/workflow-authoring.md +304 -0
  738. package/.versions/2.0.5/scripts/claude-code-preflight.ts +70 -0
  739. package/.versions/2.0.5/scripts/codex-conductor.ts +41 -0
  740. package/.versions/2.0.5/scripts/codex-remote-control.ts +167 -0
  741. package/.versions/2.0.5/scripts/coms-claude-bridge.ts +411 -0
  742. package/.versions/2.0.5/scripts/coms-cli.ts +484 -0
  743. package/.versions/2.0.5/scripts/coms-hermes-bridge.ts +413 -0
  744. package/.versions/2.0.5/scripts/fleet.ts +222 -0
  745. package/.versions/2.0.5/scripts/flow.ts +137 -0
  746. package/.versions/2.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  747. package/.versions/2.0.5/scripts/hermes-monitor-scenario.ts +474 -0
  748. package/.versions/2.0.5/scripts/hermes-watchdog-capability-probe.ts +45 -0
  749. package/.versions/2.0.5/scripts/install-hermes-plugin.sh +180 -0
  750. package/.versions/2.0.5/scripts/lib/claude-bridge-core.ts +210 -0
  751. package/.versions/2.0.5/scripts/lib/codex-conductor.ts +88 -0
  752. package/.versions/2.0.5/scripts/lib/codex-remote-control.ts +482 -0
  753. package/.versions/2.0.5/scripts/lib/coms-envelope.ts +582 -0
  754. package/.versions/2.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  755. package/.versions/2.0.5/scripts/lib/fleet-command.ts +270 -0
  756. package/.versions/2.0.5/scripts/lib/flow-command.ts +93 -0
  757. package/.versions/2.0.5/scripts/lib/flow-maintenance.ts +230 -0
  758. package/.versions/2.0.5/scripts/lib/herdr-layout.ts +281 -0
  759. package/.versions/2.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  760. package/.versions/2.0.5/scripts/lib/hermes-monitor-events.ts +1 -0
  761. package/.versions/2.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  762. package/.versions/2.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  763. package/.versions/2.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  764. package/.versions/2.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  765. package/.versions/2.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  766. package/.versions/2.0.5/scripts/lib/monitor-env.ts +146 -0
  767. package/.versions/2.0.5/scripts/lib/peer-launch.ts +318 -0
  768. package/.versions/2.0.5/scripts/lib/persona-banner.ts +62 -0
  769. package/.versions/2.0.5/scripts/lib/runtime-dependencies.js +124 -0
  770. package/.versions/2.0.5/scripts/lib/spawn-stagger.ts +101 -0
  771. package/.versions/2.0.5/scripts/lib/team-project.ts +213 -0
  772. package/.versions/2.0.5/scripts/lib/team-snapshot.ts +147 -0
  773. package/.versions/2.0.5/scripts/package-lock.json +35 -0
  774. package/.versions/2.0.5/scripts/package.json +9 -0
  775. package/.versions/2.0.5/scripts/peer-banner.ts +40 -0
  776. package/.versions/2.0.5/scripts/peer-launch.ts +285 -0
  777. package/.versions/2.0.5/scripts/team-snapshot.ts +237 -0
  778. package/.versions/2.0.5/scripts/team-up.ts +406 -0
  779. package/.versions/2.0.5/scripts/workflows/lib/agent-phase.ts +133 -0
  780. package/.versions/2.0.5/scripts/workflows/lib/changes.ts +61 -0
  781. package/.versions/2.0.5/scripts/workflows/lib/debate.ts +149 -0
  782. package/.versions/2.0.5/scripts/workflows/lib/env.ts +34 -0
  783. package/.versions/2.0.5/scripts/workflows/lib/envelopes.ts +169 -0
  784. package/.versions/2.0.5/scripts/workflows/lib/gates.ts +81 -0
  785. package/.versions/2.0.5/scripts/workflows/lib/git.ts +96 -0
  786. package/.versions/2.0.5/scripts/workflows/lib/merge.ts +95 -0
  787. package/.versions/2.0.5/scripts/workflows/lib/model-profile.ts +22 -0
  788. package/.versions/2.0.5/scripts/workflows/lib/model-visibility.ts +92 -0
  789. package/.versions/2.0.5/scripts/workflows/lib/permissions.ts +130 -0
  790. package/.versions/2.0.5/scripts/workflows/lib/personas.ts +57 -0
  791. package/.versions/2.0.5/scripts/workflows/lib/poll.ts +86 -0
  792. package/.versions/2.0.5/scripts/workflows/lib/quality.ts +64 -0
  793. package/.versions/2.0.5/scripts/workflows/lib/run.ts +108 -0
  794. package/.versions/2.0.5/scripts/workflows/lib/trace.ts +34 -0
  795. package/.versions/2.0.5/scripts/workflows/lib/voices.ts +128 -0
  796. package/.versions/2.0.5/scripts/workflows/lib/writer-lease.ts +112 -0
  797. package/.versions/2.0.5/scripts/workflows/tsconfig.json +22 -0
  798. package/.versions/2.0.5/scripts/workflows/wf-build-test.ts +61 -0
  799. package/.versions/2.0.5/scripts/workflows/wf-debate.ts +87 -0
  800. package/.versions/2.0.5/scripts/workflows/wf-document.ts +50 -0
  801. package/.versions/2.0.5/scripts/workflows/wf-poll.ts +95 -0
  802. package/.versions/2.0.5/scripts/workflows/wf-quality.ts +20 -0
  803. package/.versions/2.0.5/scripts/workflows/wf-scout.ts +38 -0
  804. package/.versions/2.0.5/skills/_internal/grilling.md +59 -0
  805. package/.versions/2.0.5/skills/browser-testing-with-devtools/SKILL.md +351 -0
  806. package/.versions/2.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  807. package/.versions/2.0.5/skills/compound-learning/SKILL.md +137 -0
  808. package/.versions/2.0.5/skills/context-engineering/SKILL.md +291 -0
  809. package/.versions/2.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  810. package/.versions/2.0.5/skills/designing-agents/SKILL.md +394 -0
  811. package/.versions/2.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  812. package/.versions/2.0.5/skills/drafting-workflows/SKILL.md +143 -0
  813. package/.versions/2.0.5/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  814. package/.versions/2.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  815. package/.versions/2.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  816. package/.versions/2.0.5/skills/idea-refine/SKILL.md +182 -0
  817. package/.versions/2.0.5/skills/idea-refine/examples.md +238 -0
  818. package/.versions/2.0.5/skills/idea-refine/frameworks.md +99 -0
  819. package/.versions/2.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  820. package/.versions/2.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  821. package/.versions/2.0.5/skills/incremental-implementation/SKILL.md +298 -0
  822. package/.versions/2.0.5/skills/interview-me/SKILL.md +226 -0
  823. package/.versions/2.0.5/skills/orchestration-verification/SKILL.md +181 -0
  824. package/.versions/2.0.5/skills/peer-coms/SKILL.md +90 -0
  825. package/.versions/2.0.5/skills/performance-optimization/SKILL.md +350 -0
  826. package/.versions/2.0.5/skills/planning-and-task-breakdown/SKILL.md +265 -0
  827. package/.versions/2.0.5/skills/security-and-hardening/SKILL.md +461 -0
  828. package/.versions/2.0.5/skills/spec-driven-development/SKILL.md +256 -0
  829. package/.versions/2.0.5/skills/using-agent-skills/SKILL.md +197 -0
  830. package/.versions/2.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  831. package/.versions/2.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  832. package/.versions/2.0.5/vendor/agent-skills-upstream/README.md +11 -0
  833. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  834. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  835. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  836. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  837. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  838. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  839. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  840. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  841. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  842. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  843. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  844. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  845. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  846. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  847. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  848. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  849. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  850. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  851. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  852. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  853. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  854. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  855. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  856. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  857. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  858. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  859. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  860. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  861. package/CHANGELOG.md +13 -0
  862. package/README.md +1 -1
  863. package/agents/builder.md +2 -2
  864. package/agents/documenter.md +2 -1
  865. package/agents/planner.md +2 -1
  866. package/agents/releaser.md +2 -2
  867. package/bin/catalog/harness-runtime-closure.json +2 -0
  868. package/bin/cli.js +47 -9
  869. package/bin/lib/doctor.js +35 -2
  870. package/bin/lib/reconcile.js +3 -2
  871. package/docs/agent-fleet-setup.md +88 -0
  872. package/docs/claude-code-coms-bridge.md +5 -0
  873. package/docs/getting-started.md +5 -0
  874. package/docs/npm-install.md +12 -5
  875. package/docs/pi-extensions.md +3 -4
  876. package/install-manifest.json +3 -1
  877. package/justfile +1 -1
  878. package/package.json +5 -3
  879. package/scripts/claude-code-preflight.ts +70 -0
  880. package/scripts/fleet.ts +23 -0
  881. package/scripts/lib/runtime-dependencies.js +124 -0
  882. package/scripts/peer-launch.ts +27 -1
  883. package/scripts/workflows/lib/agent-phase.ts +2 -1
  884. package/scripts/workflows/lib/model-profile.ts +22 -0
  885. package/scripts/workflows/lib/personas.ts +6 -3
  886. package/scripts/workflows/lib/voices.ts +3 -0
@@ -0,0 +1,446 @@
1
+ # pi Extensions
2
+
3
+ A catalog of the pi extensions in this repo — what each one does, how to run it, the
4
+ supporting data it needs, and how the ported set differs from upstream.
5
+
6
+ ---
7
+
8
+ ## Attribution
9
+
10
+ The session harnesses documented here — together with their supporting agent
11
+ definitions, design specs, and the `justfile` — are ported
12
+ from the **`pi-vs-claude-code`** project:
13
+
14
+ - **Author:** [disler](https://github.com/disler) (IndyDevDan)
15
+ - **Source:** <https://github.com/disler/pi-vs-claude-code>
16
+ - **License:** MIT — Copyright (c) 2026 IndyDevDan
17
+
18
+ Ported files retain their original authorship; this repo adapts them to its layout and
19
+ conventions. Runtime design specs for the imported harnesses live in `docs/pi-specs/`.
20
+
21
+ The model-poll / debate / merge mechanism (`.pi/agents/voices.yaml`, `/af-poll`,
22
+ `/af-debate`, `just flow poll`, `just flow debate`) follows the *form* of
23
+ [disler/fusion-harness](https://github.com/disler/fusion-harness) (MIT). This repo does
24
+ not vendor that code; the mechanisms are rebuilt on Agent Fleet seams.
25
+
26
+ ---
27
+
28
+ ## What these extensions are
29
+
30
+ `.pi/extensions/` contains utility extensions. Fleet Core explicitly loads
31
+ `compact-and-continue`, `agent-fleet-update-check`, and `btw`; browser and voice are
32
+ feature-gated: after setup installs them, launch with `just fleet --browser` or
33
+ `just fleet --voice`. This keeps Default deterministic even though pi can auto-discover
34
+ extensions outside Fleet Core. `btw` adds a
35
+ `/af-btw <task>` prompt command (plus an `Alt+'` shortcut) that forks the current session
36
+ into an in-process sub-session and opens a focused, capturing full-screen panel — full
37
+ context, same cwd, live transcript, and follow-up composer. `Esc` returns to the main
38
+ session while the side task continues; a compact result card lands in the main transcript
39
+ at idle. See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
40
+
41
+ When loaded with `just fleet --voice`, `pi-voice-stt` adds **Alt+S** push-to-talk dictation: it records the mic to a temp WAV via
42
+ `ffmpeg` and transcribes through one of three backends — a generic OpenAI-compatible endpoint,
43
+ Azure Speech (REST short-audio, with optional per-phrase language identification), or Azure
44
+ OpenAI Whisper (Azure AI Foundry). Alt+S toggles record→insert; Enter-while-recording
45
+ transcribes and sends; Esc cancels. It is **gated**: the hotkey binds only once a provider is
46
+ configured (project-local `.ai/stt.json`, the global `~/.pi/agent/stt.json`, or `PI_STT_CONFIG`),
47
+ so an unconfigured session is a no-op. `/af-stt doctor`
48
+ checks the setup. A simplified port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt);
49
+ see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
50
+
51
+ > **macOS terminal note:** Option-to-Alt behavior belongs to the outer terminal, not macOS or Pi.
52
+ > If an Option shortcut inserts a composed character such as `ß`, configure the terminal to send
53
+ > Option as Meta. In Zed, set `terminal.option_as_meta` to `true`. This enables the existing Alt
54
+ > shortcuts; it is not an OS-wide keybinding change.
55
+
56
+ The documented harnesses below are different: each is a **session harness**. They
57
+ reshape the whole pi session — some set orchestration/UI surfaces and some gate every
58
+ tool call. The unified `just fleet` entry point composes them with a deterministic
59
+ Fleet Core: `damage-control-continue`, `ask-user-remote`, Compact & Continue,
60
+ BTW, and the update checker. Voice is an optional feature, not Default Fleet Core.
61
+ Every public Pi launch through bare `just fleet` also loads
62
+ `agent-hub`; operator/orchestrator work mode changes its direct tool surface without changing
63
+ process or session. `just fleet peer` starts a standalone coms peer. Harnesses live in
64
+ **`.pi/harnesses/`** — a directory pi does
65
+ *not* auto-discover — so a plain `pi` run still loads no safety/orchestration harness.
66
+
67
+ ### Selective loading — read this first
68
+
69
+ pi auto-discovers every extension directory under a project's `.pi/extensions/` and loads
70
+ all of them. If the harnesses lived there, a plain `pi` run would load them all at once
71
+ — UI surfaces would fight, orchestrators would collide, and harnesses that register the
72
+ same CLI flags would abort startup with duplicate registrations. So the harnesses live in
73
+ `.pi/harnesses/` instead, and you load the desired recipe explicitly:
74
+
75
+ - through the unified `justfile` interface — `just fleet`, `just fleet --agents <roster>`, `just fleet --peers <preset>`, `just fleet peer <name>`, …
76
+ - or directly — `pi -e .pi/harnesses/<name>/index.ts` (advanced use; you must compose safety/utilities yourself)
77
+
78
+ When you consume this repo from another project, use deterministic `agent-fleet
79
+ setup` to select Default, Full, and named features; it installs the recorded
80
+ harness closure into *that project's* `.pi/harnesses/`. Then load it via the
81
+ managed `justfile` region, or point `pi -e` at a harness file directly — never
82
+ drop harnesses into `.pi/extensions/`, and never load all of them at once. The supported multi-harness
83
+ exception is loading `damage-control-continue` and `ask-user-remote` before `agent-hub` for a guarded hub session (see
84
+ [pi-setup.md](pi-setup.md#optional-pi-extensions)).
85
+
86
+ ---
87
+
88
+ ## Setup
89
+
90
+ ```bash
91
+ just fleet deps # install nested runtime deps only; starts no Pi/harness
92
+ just fleet # Hub/operator + Fleet Core; empty native roster
93
+ just fleet --agents frontend
94
+ # Hub/orchestrator + native specialist roster
95
+ just fleet --agents default --peers docs --project af
96
+ # Hub + native roster + standing Herdr peers
97
+ just fleet peer code-reviewer --project af # ONE peer in its own Herdr pane, no team
98
+ just fleet help # unified command grammar
99
+ just --list # shows the single public `fleet` entry point
100
+ ```
101
+
102
+ `just fleet deps` installs all three runtime dependency roots:
103
+ `.pi/extensions/` for utilities (`@modelcontextprotocol/sdk`, `typebox`),
104
+ `.pi/harnesses/` for harnesses (`@sinclair/typebox`, `yaml`), and `scripts/` for
105
+ deterministic workflows (`@sinclair/typebox`, `yaml`). That is the **clone** path. In a
106
+ target workspace, deterministic `agent-fleet setup --allow-exec` runs `npm ci`
107
+ for those same three roots after its file transaction. Without `--allow-exec`, the plan lists those runtime steps for the
108
+ operator to run by hand. The extension dependencies are also root production dependencies of
109
+ the published `@chankov/agent-fleet` package, so a pi-package install resolves them from
110
+ the package's real path. The `@mariozechner/pi-*` packages are provided by the pi runtime
111
+ itself.
112
+
113
+ ---
114
+
115
+ ## Catalog
116
+
117
+ | Extension | Category | What it does | Run |
118
+ |-----------|----------|--------------|-----|
119
+ | [agent-hub](../.pi/harnesses/agent-hub/README.md) | Orchestration | Unified operator/orchestrator runtime: Fleet Core guardrails, dynamic native roster, specialist delegation, research helpers, embedded coms, `/af-handoff`, explicit native/coms backend routing, and footer `agent fleet v<version> · <model><thinking> · <team>` — plus, inside [Herdr](https://herdr.dev), constrained peer spawn, raw pane spawn, read, confirmed close, and notify tools | `just fleet` |
120
+ | [ask-user-remote](../.pi/harnesses/ask-user-remote/README.md) | Orchestration | Captures stock `pi-ask-user` and registers the default `ask_user`; with `user-remote` live it races local UI against the Hermes bridge, otherwise it is stock local behavior | Fleet Core (`just fleet`) |
121
+ | [damage-control-continue](../.pi/harnesses/damage-control-continue/README.md) | Safety | Fleet Core safety harness; guards default Pi, Hub, native children, and Herdr Pi peers. Blocks feed back without aborting the turn; protected paths support explicit approval, while dangerous command patterns remain non-exemptible | `just fleet` |
122
+ | [coms](../.pi/harnesses/coms/README.md) | Messaging | Peer-to-peer messaging between agents on one machine, composed with Fleet Core safety and utilities | `just fleet peer <name>` |
123
+ | [Hermes local monitor transport](../hermes/README.md#local-agent-hub-monitor-integration) | Optional local companion | Owner-only discovery + Unix socket for agent-hub snapshots, cursor output, and exact-generation cancellation; consumed by a separate local Hermes client | Set the two monitor environment variables, then run a Herdr topology such as `just fleet --herdr` |
124
+
125
+ Each extension directory has its own `README.md` with the full description, command/tool
126
+ surface, requirements, and per-extension upstream changes.
127
+
128
+ ### Migration: retired hard-stop harness
129
+
130
+ The former `.pi/harnesses/damage-control/` hard-stop harness and its standalone recipe
131
+ are retired. Refresh pi harnesses with `agent-fleet setup`: removal is bound by
132
+ the ownership rule, so only an unchanged, recorded copy
133
+ goes — user-modified and unowned copies are preserved, and the managed `justfile` region
134
+ is refreshed without touching recipes outside the sentinels. Use `damage-control-continue` for standalone and
135
+ Agent Hub safety; missing child safety now fails closed instead of falling back or spawning
136
+ unguarded.
137
+
138
+ ### Harness version footer and provenance
139
+
140
+ The three persistent-UI harnesses — `agent-hub`, `coms`, and
141
+ `damage-control-continue` — each register `agent fleet v<version>` on one shared status key. In pi's
142
+ default status footer, that shared key gives a supported stack exactly one version instead of one
143
+ copy per harness. `agent-hub` replaces the default footer: it does **not** consume that status
144
+ key. Its custom footer reads its own adjacent stamped manifest and renders one local version
145
+ first — `agent fleet v<version> · <model><thinking> · <team>` — so an agent-hub stack also displays the
146
+ version exactly once.
147
+
148
+ The `agent fleet` half of that label is an [OSC 8](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda)
149
+ terminal hyperlink to the project homepage, so a click in a terminal that supports hyperlinks
150
+ (Ghostty, iTerm2, WezTerm, Kitty, VS Code, GNOME Terminal, tmux 3.4+) opens the repository. It is a
151
+ terminal-level link, not a TUI control: pi has no mouse tracking, so a click cannot open an
152
+ in-process overlay — the URL goes to the OS opener. Terminals without OSC 8 support render the
153
+ label unchanged, and pi's `visibleWidth`/`truncateToWidth` strip OSC sequences, so the link costs no
154
+ footer columns. Set `AGENT_FLEET_NO_LINKS=1` to fall back to a plain label on multiplexers that
155
+ mangle unknown OSC sequences (GNU screen, tmux before 3.4).
156
+
157
+ The shared version status is independent of mutable owner status: for example, a
158
+ Damage-Control violation can replace its own safety message without overwriting the version
159
+ entry. The canonical value is the root `package.json` version. During a release,
160
+ `bin/sync-harness-versions.js` stamps that value into each adjacent persistent-harness
161
+ `package.json` after the root bump and before lockfile finalization and snapshotting. Each
162
+ harness keeps a local `version.ts` provenance reader so copied or symlinked harness directories
163
+ resolve their adjacent stamp rather than the launch directory. That local provenance does not
164
+ make a harness self-contained: copied target harnesses still require the existing full
165
+ `.pi/harnesses/` dependency installation described in [Setup](#setup).
166
+
167
+ ### `agent-hub` components
168
+
169
+ `agent-hub` is the consolidated orchestration harness. It replaces the retired standalone
170
+ `agent-team` recipe and absorbs the day-to-day pieces that previously required separate
171
+ harnesses:
172
+
173
+ - **Two live Work Modes** — bare `just fleet` starts as an operator with direct coding tools and an
174
+ empty native roster; `/af-work-mode operator|orchestrator` switches prompt and tool surface without
175
+ restarting or losing session state, while `/af-work-mode` without an argument and **Alt+M** open
176
+ the picker. Orchestrator removes direct coding tools. Budgets and nested delegation follow task tier. All Hub slash commands remain registered in both work modes; capability-off actions
177
+ refuse actionably.
178
+ - **Fleet Dashboard** — **`Alt+A`** or `/af-agents-list` opens a
179
+ full-screen dashboard of the active native roster, delegates, currently running research
180
+ helpers, and coms peers, with the coms pool panel pinned to the bottom. Live research helpers never appear in the
181
+ main dispatcher view; they vanish from the dashboard on every terminal outcome while their
182
+ session/findings files and `/af-agents-history` records remain. The dashboard supports row
183
+ detail, filtering, finished-row visibility, confirmed kills, and a confirmed specialist restart.
184
+ In local row detail, **`m`**
185
+ opens a visible inline full-screen picker over the logs, selects from every model currently
186
+ available in Pi, and applies it to the next specialist, research, or nested-delegate run without
187
+ interrupting current work. See the
188
+ [agent-hub README](../.pi/harnesses/agent-hub/README.md#fleet-dashboard-and-detail) for
189
+ keys and action semantics.
190
+ - **Specialist delegation** — `dispatch_agent` for writable child-agent work. Read-only
191
+ investigation is automated through dispatcher-invoked `spawn_research` and the specialists'
192
+ `NEEDS_RESEARCH:` pipe; dedicated research lifecycle slash commands are not registered.
193
+ - **Verification Contract** — the dispatcher owns a ledger of checkable acceptance assertions
194
+ built before any builder runs, via the `set_assertions` / `update_assertion` tools. Each
195
+ assertion is tagged (`test` | `runtime-ui` | `code-grep` | `manual`) and advanced only on
196
+ *proven with evidence*; the ledger persists to `.pi/agent-sessions/assertions.json` (wiped at
197
+ session start like `findings/`) and shows a one-line status, keeping the contract out of the
198
+ dispatcher LLM context. It kills the parity failure (exemplar shipped, siblings missed) by
199
+ requiring a parity/touchpoint inventory for "behave like" requests and runtime proof for UI
200
+ assertions — see the [`orchestration-verification`](../skills/orchestration-verification/SKILL.md)
201
+ skill, which the `orchestrator` persona drives. Advisory in this phase (surfaced, not a hard
202
+ dispatch refusal).
203
+ - **Operator controls** — `/af-zoom` timeline inspection plus child-agent kill/restart controls. `/af-context` is a separate read-only full-screen context-budget view: provider totals/cache fields are authoritative, component estimates are labelled heuristic or provider-scaled, stable prompt and volatile-state cost are separated, loaded-but-excluded and inactive packs visibly cost zero, and fleet members use separate model-window denominators. It also shows live pressure phase, measured usage, the 80%/90% thresholds, episode, and last recovery outcome. It never reveals or persists raw prompts, schemas, conversation content, error bodies, or compaction summaries.
204
+ - **Automatic capability packs** — no activation command is needed. Intent, work mode, tier, pending work, and runtime state resolve the model-visible tools before the turn; readiness alone does not make coms/Herdr visible. Ambiguous fleet, peer, or workspace use asks once before its first side effect. The compact pack is transient when explicitly requested or pressure is imminent; ordinary task packs persist until `set_task_tier(new_task: true)`. Managed children receive selected replacement prompts/manifests (`--no-skills` and `--no-context-files` where applicable), not inherited global context.
205
+ - **One-click budget continuation** — turn and task refusals ask one localized Yes/No `ask_user` question. Yes renews the budget in the same tool loop, without a typed `continue` or slash command. Task continuation opens an audited tranche while preserving task tier, assertions, capability packs, blockers, label, and progress; genuinely different work uses `set_task_tier(new_task: true)`. Turn and task active-time clocks both exclude human wait time.
206
+ - **Damage-control + ask_user by default** — `just fleet` and `just fleet --no-coms` load the
207
+ `damage-control-continue` safety harness and `ask-user-remote` before `agent-hub`, so the
208
+ dispatcher's tool calls are checked against the rules file and the `askUserAvailable` probe sees
209
+ `ask_user`. A blocked call feeds back and the turn keeps going rather than aborting. `agent-hub` also
210
+ re-loads `damage-control-continue` into every native specialist, research helper, and nested
211
+ delegate (via an explicit `-e` that survives `--no-extensions`). Protected-path access can be
212
+ granted at runtime: `/af-allow <pattern> [turn|session]` in the hub pre-authorizes, a parent-session
213
+ block opens an approval dialog, and a headless child escalates to the hub. Protected deletion
214
+ offers only deny/once; other protected paths may be scoped to an agent or session. Denial and
215
+ timeout fail closed without aborting the child turn. Destructive bash patterns are never exemptible,
216
+ and a missing continue harness refuses child dispatch.
217
+ - **Embedded coms** — peer discovery, `coms_list` / `coms_send` / `coms_get` / `coms_await`,
218
+ `/af-handoff`, and peer-as-subagent flows.
219
+ - **No-coms mode** — `just fleet --no-coms` keeps direct operator work, native delegation,
220
+ research helpers, and controls, but starts without embedded coms. `/af-handoff`
221
+ remains registered and explains why it cannot run. Legacy `--solo` maps to this flag with a warning.
222
+ - **Optional Hermes local monitor transport** — uses `AGENT_FLEET_PROFILE_ID`, the absolute
223
+ `AGENT_FLEET_MONITOR_RUNTIME_DIR`, and the Herdr `HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`
224
+ required to establish its stable hub identity. It is a source-owned, local-only transport—not a
225
+ Hermes SDK task/lifecycle RPC or a bundled plugin—and fails closed without validated owner-only
226
+ discovery, lease, token, and socket state. Follow the
227
+ [Hermes integration guide](../hermes/README.md#local-agent-hub-monitor-integration) for startup,
228
+ wire examples, cancellation semantics, and reconnect behavior.
229
+
230
+ #### Context and roster recovery troubleshooting
231
+
232
+ A green standing-prompt budget does not guarantee that a long tool loop fits: messages and tool
233
+ results continue accumulating inside the current model window. Agent Hub warns at **80%** live
234
+ usage. At **90%** it aborts the next same-turn provider request, waits for persistence/settlement,
235
+ and starts one automatic Pi compaction. Startup or newly submitted input is retained in memory and
236
+ replayed exactly once after recovery. Use `/af-context` to distinguish `warning`, `compacting`,
237
+ `recovered`, and `failed` pressure from stable prompt/schema cost.
238
+
239
+ If automatic compaction fails, retained input is not discarded. Use Pi's built-in `/compact
240
+ [instructions]` command—even in bare Pi without Agent Hub—or switch to a larger-context model. Pi's
241
+ session JSONL under `~/.pi/agent/sessions/` remains the authoritative append-only record. Context
242
+ overflow does not imply corruption: inspect with `/session`, resume with `/resume` or Pi's session
243
+ flags, and **never edit, truncate, reorder, or synthesize JSONL entries to recover**.
244
+
245
+ If resume instead reports that orchestrator work mode has no valid native roster, direct tools and
246
+ model input intentionally remain blocked. Select a current team with `/af-agents-team`; restart via
247
+ `just fleet --agents <name>` (direct Pi: `--agent-team <name>`); or explicitly choose operator with
248
+ `/af-work-mode operator` / `just fleet --work-mode operator`. Repair stale team/persona definitions
249
+ before selecting them. The Hub never invents a roster or silently downgrades persisted work mode, and
250
+ explicit startup flags retain precedence.
251
+
252
+ ### Runtime axes and explicit routing
253
+
254
+ Work mode, native roster, and peer topology are independent:
255
+
256
+ ```bash
257
+ just fleet # operator, empty native roster
258
+ just fleet --agents frontend # orchestrator inferred
259
+ just fleet --work-mode operator --agents frontend # direct tools + native roster
260
+ just fleet --herdr --project af # one Hub pane in Herdr
261
+ just fleet --agents frontend --peers frontend --project af
262
+ ```
263
+
264
+ A **native specialist** is a local headless Pi child selected from `teams.yaml`; a **peer** is a
265
+ separate long-lived Pi or Claude Code process registered over coms, usually in a sibling Herdr
266
+ pane. Add a native reviewer at runtime with `/af-agents-add code-reviewer`. When a same-name
267
+ Claude reviewer is live, `dispatch_agent`'s `backend: "native"` still forces the local Pi child,
268
+ `backend: "coms"` requires that peer with no native fallback, and `backend: "auto"` follows
269
+ `dispatch-policy.yaml`.
270
+
271
+ Inside a Herdr-backed Hub, `herdr_spawn_peer({ name: "code-reviewer" })` uses the declaration in
272
+ `peers.yaml` (including `runner: claude-code`), creates a sibling pane, locks it to the Hub project,
273
+ and waits for coms readiness. Then use `coms_send` + `coms_await`, or `/af-handoff
274
+ code-reviewer`. These actions need a running Herdr server and/or ready coms as appropriate; the
275
+ commands stay registered and explain missing capability. Arbitrary pane commands use the separate
276
+ `herdr_spawn_pane` tool. In orchestrator work mode that tool is limited by policy to auxiliary
277
+ processes such as watchers or servers; it must not be used to bypass delegation for code work.
278
+
279
+ ---
280
+
281
+ ## Two browser stacks — when to use which
282
+
283
+ This repo ships **two** ways to drive a browser from a pi agent. They are complementary, not redundant — the axis that separates them is the **tool model** (and where they can run), not just headless-vs-headful, since both can do either:
284
+
285
+ | | `bowser` / `playwright-cli` | `web-debugger` / `chrome-devtools-mcp` |
286
+ |---|---|---|
287
+ | Tool model | CLI over **Bash** (no tool schemas in context) | live `chrome_devtools__*` MCP tools |
288
+ | Strength | headless, parallel named sessions, background automation, scraping, token-efficient | interactive headful debugging, live DOM/console/network, performance traces |
289
+ | Where it runs | **dispatched subagent** (survives `--no-extensions`), peer, or main session | main session or **coms peer** (the extension must be loaded into the process) |
290
+ | Persona | `bowser` | `web-debugger` |
291
+ | Skill | `.pi/skills/bowser/` | `skills/browser-testing-with-devtools/` |
292
+
293
+ **Policy:**
294
+
295
+ - **Automated / CI / background / parallel runtime-UI evidence** → `bowser` (headless `playwright-cli`). This is what the `orchestrator` delegates as a subagent to close `runtime-ui` acceptance assertions.
296
+ - **Interactive debugging of a running dev app** → `web-debugger` (headful `chrome-devtools-mcp`), reached as a coms peer or run on the main session.
297
+ - **Manual visual inspection / login flows** → `web-debugger` headful, or attach to an existing Chrome.
298
+ - **Always require runtime evidence** — snapshot + console + network before/after a critical interaction; a screenshot only for visual/layout confirmation.
299
+
300
+ Why `web-debugger` is a coms peer and not a dispatchable subagent: its `chrome_devtools__*` tools come from the always-on `chrome-devtools-mcp` extension, and agent-hub spawns subagents with `--no-extensions`, so a dispatched child would not have those tools. A coms peer is its own pi process that loads the extension explicitly (via the `extensions:` field in `.pi/agents/peers.yaml`, routed through the `_peer-plus` recipe), and a long-lived peer maps naturally onto one persistent live browser. `bowser` has no such constraint because it only needs Bash + the `playwright-cli` binary on PATH.
301
+
302
+ ## One peer at a time — `just fleet peer`
303
+
304
+ `just fleet --peers <preset>` is the right topology for a *known* set of collaborators, but it
305
+ requires every peer to be declared in `.pi/agents/peers.yaml` and it builds a whole
306
+ workspace. When you want **one** more agent — often a Claude Code reviewer — next to
307
+ what you already have:
308
+
309
+ ```bash
310
+ just fleet peer code-reviewer --project af # peers.yaml decides the runner
311
+ just fleet peer scratch-reviewer --runner claude-code --model opus --project af
312
+ just fleet peer researcher --model openai-codex/gpt-5.6-luna --project af
313
+ just fleet peer web-debugger --browser --project af # persona peer + devtools MCP
314
+ just fleet peer nick --here --project af # this terminal, not a pane
315
+ just fleet peer anything --runner claude-code --dry-run # print the plan, touch nothing
316
+ ```
317
+
318
+ **The name decides the shape of the peer** — one verb, three launchers:
319
+
320
+ | The name… | Peer | Recipe |
321
+ |---|---|---|
322
+ | is declared in `peers.yaml` | whatever it declares (`runner`, `model`, `extensions`, `env_file`) | per declaration |
323
+ | matches `agents/<name>.md` | that guarded persona peer | `_peer` / `_peer-plus` |
324
+ | matches nothing | Fleet Core + coms under that identity, no persona | `_fleet-peer` |
325
+ | `--runner claude-code` | interactive Claude Code + its coms bridge in one pane | `_claude-peer` |
326
+
327
+ The third row is what this command meant before pane placement existed, and it is the
328
+ only shape that accepts raw pi arguments — everything after `--` goes to pi verbatim
329
+ (`just fleet peer nick --here -- --session /path/to/session.json`). Note that the
330
+ persona-by-name rule can change what an existing invocation means: `agents/architect.md`
331
+ exists, so `just fleet peer architect` is now the architect persona peer. `--no-persona`
332
+ forces the plain Fleet Core shape back.
333
+
334
+ - **Placement** — by default the peer gets its own pane: run inside a herdr pane and it
335
+ splits *that* pane (`--direction right|down`); run outside herdr and it creates a
336
+ single-pane workspace labelled `<worktree-tag>-peer-<name>`, refusing to clobber an
337
+ existing one. `--here` runs it in the calling terminal instead.
338
+ - **Field resolution** — explicit flag → the `peers.yaml` declaration for that *name*
339
+ (searched across every team) → a convention default. A name the fleet already defines
340
+ keeps its declared fields; a name it does not need no manifest entry at all.
341
+ - **Nothing is silently dropped** — a flag that cannot apply to the resolved shape is an
342
+ error, not a no-op: `--all-extensions` on a persona peer, `--persona` on a Claude Code
343
+ peer, a mistyped flag, or a pi flag that forgot its `--` separator.
344
+ - **`--project` matters** — same rule as teams: the flag form is `--project af`;
345
+ `project=af` is a `just` variable override and is silently ignored, leaving the peer
346
+ in the shared `default` pool.
347
+ - **Readiness** — a pane launch waits (bounded) for the peer to register in the coms pool
348
+ and exits non-zero with the pane's last output if it never does. A peer that missed
349
+ the window has failed to start, not started slowly.
350
+
351
+ Pure logic in `scripts/lib/peer-launch.ts` (under `node --test`); the herdr wiring is
352
+ `scripts/peer-launch.ts`. Inside a hub session the equivalent is the `herdr_spawn_peer`
353
+ tool, which shares the same command builder and readiness policy.
354
+
355
+ ## Environment variables
356
+
357
+ The `justfile` sets `dotenv-load`, so a `.env` file at the repo root is auto-loaded
358
+ (`.env` is gitignored). Only a few extensions need keys:
359
+
360
+ | Variable | Needed by | Purpose |
361
+ |----------|-----------|---------|
362
+ | `PI_CHROME_DEVTOOLS_MODE` | `chrome-devtools-mcp` | `headless` runs Chrome with no UI; anything else (default) is headed |
363
+ | `PI_CHROME_DEVTOOLS_BROWSER_URL` | `chrome-devtools-mcp` | Attach to a running Chrome (e.g. `http://127.0.0.1:9222`) instead of launching one |
364
+ | `PI_CHROME_DEVTOOLS_USER_DATA_DIR` | `chrome-devtools-mcp` | Persistent Chrome profile path (else the default ephemeral `--isolated` profile) |
365
+ | `OPENAI_API_KEY` | `pi-voice-stt` (openai backend) | API key for the OpenAI-compatible transcription endpoint (var name overridable via `provider.apiKeyEnv`) |
366
+ | `AZURE_SPEECH_KEY` | `pi-voice-stt` (azure backend) | Azure Speech resource key |
367
+ | `AZURE_SPEECH_ENDPOINT` | `pi-voice-stt` (azure backend) | Azure resource endpoint, used when `provider.endpoint` is unset |
368
+ | `PI_STT_CONFIG` / `PI_STT_KEYBIND` | `pi-voice-stt` | Override config (inline JSON or path) / the record hotkey (default `alt+s`) |
369
+ | `AGENT_FLEET_SPAWN_DELAY` | `_peer` / `_peer-plus` recipes | Seconds to sleep before launching pi in a fleet pane (set per pane by `just fleet --peers`/`just fleet resume`, see below) |
370
+
371
+ The `chrome-devtools-mcp` server starts once at extension load, so changing its vars needs a pi
372
+ restart / `/reload` to take effect.
373
+
374
+ ### Spawn pre-warm/stagger
375
+
376
+ pi loads its credential store (`~/.pi/agent/auth.json`) once at boot under a short-retry
377
+ file lock. When the stored OAuth token is stale, the first pi to boot refreshes it over
378
+ the network *while holding that lock*; sibling panes spawned in the same instant (as
379
+ `just fleet --peers` / `just fleet resume` do) lose the lock race and come up
380
+ with every provider showing **unconfigured**. To dodge this, the team scripts check
381
+ `auth.json` before spawning (only `type`/`expires` are read — values never leave the
382
+ process): if any OAuth credential is expired or about to expire, one pi pane (the hub
383
+ when present, else the first pi peer) starts immediately and refreshes the token, and
384
+ every other pi pane gets `AGENT_FLEET_SPAWN_DELAY` in its pane env — the `_peer` /
385
+ `_peer-plus` recipes sleep that many seconds before launching pi. Fresh tokens mean zero
386
+ delay everywhere; `claude-code` runner panes never wait. Pure logic in
387
+ `scripts/lib/spawn-stagger.ts` (under `node --test`).
388
+
389
+ ---
390
+
391
+ ## Supporting data
392
+
393
+ These ported files are runtime dependencies of the extensions above:
394
+
395
+ - **`agents/`** — canonical persona Markdown files for shared and pi-specific agents.
396
+ Read by `agent-hub`.
397
+ - **`.pi/agents/`** — pi YAML configs only (`teams.yaml`, `peers.yaml`).
398
+ The earlier `reviewer` and `red-team` personas were folded into `code-reviewer` and
399
+ `security-auditor`; the remaining team/peer configs already reference the canonical names.
400
+ A peer entry may carry an optional `extensions:` field (comma-separated names under
401
+ `.pi/extensions/`) — Fleet's team launcher then routes it through the `_peer-plus` recipe so those
402
+ extensions load into the peer process. The `web-debugger` peer uses this to get
403
+ `chrome-devtools-mcp`'s `chrome_devtools__*` tools (see the two-browser-stacks section above).
404
+ - **`.pi/damage-control-rules.yaml`** — the destructive-command / protected-path rule set
405
+ for `damage-control-continue`.
406
+ - **`.pi/skills/bowser/`** — a pi-runtime skill for headless Playwright browser
407
+ automation, used by the `bowser` agent persona. Kept separate from the core
408
+ engineering `skills/`. It drives the external **Playwright Agent CLI**
409
+ (`playwright-cli`), which is **not** bundled — install it once with
410
+ `npm install -g @playwright/cli@latest` (deterministic setup checks for it when
411
+ `bowser` is selected). Docs: <https://playwright.dev/agent-cli/installation>.
412
+ - **`docs/pi-specs/`** — the original design specifications: `agent-forge` (now consolidated
413
+ into `agent-hub`), `agent-workflow` (retired `agent-chain`), and `damage-control`.
414
+
415
+ ---
416
+
417
+ ## Upstream changes
418
+
419
+ What changed relative to `disler/pi-vs-claude-code`:
420
+
421
+ - **Theme code removed.** Every ported harness imported `applyExtensionDefaults` from a
422
+ shared `themeMap.ts`. That import and its `session_start` call site were stripped from
423
+ the ported files; `themeMap.ts` and the 11 `.pi/themes/*.json` palettes are not ported.
424
+ Extensions render against pi's active theme.
425
+ - **Layout converted.** Flat `extensions/<name>.ts` files became
426
+ `.pi/harnesses/<name>/index.ts` directories, each with its own `package.json` and
427
+ `README.md`. They live under `.pi/harnesses/` — *not* `.pi/extensions/` — because pi
428
+ auto-discovers and loads everything in `.pi/extensions/`, while harnesses must be loaded
429
+ explicitly through recipes (with `damage-control-continue` + `ask-user-remote` before
430
+ `agent-hub` as the supported stack).
431
+ - **Tooling switched to npm.** `bun` / `bun.lock` are not used; the `justfile` recipes
432
+ point at the new paths and use npm.
433
+
434
+ ### Not ported
435
+
436
+ - The `pure-focus`, `theme-cycler`, and `cross-agent` extensions.
437
+ - `themeMap.ts` and all 11 `.pi/themes/*.json` theme palettes.
438
+ - The Claude Code `statusLine` config and `status_lines/status_line.py`, and the
439
+ `plan_w_team.md` command (it depended on team-agent files absent from the source).
440
+
441
+ ### A note on `.pi/settings.json`
442
+
443
+ Upstream shipped a `.pi/settings.json` that only set the (now-stripped) theme and
444
+ registered a prompt directory. This repo already keeps pi prompts in the standard
445
+ `.pi/prompts/` location, so no `.pi/settings.json` is shipped — it would carry nothing
446
+ useful.
@@ -0,0 +1,74 @@
1
+ # pi setup
2
+
3
+ Agent Fleet is pi-first. Its deterministic lifecycle writes copied workspace
4
+ artifacts; the package-native path exposes skills/prompts directly.
5
+
6
+ ## Lifecycle install
7
+
8
+ From the target repository in a real TTY, begin with:
9
+
10
+ ```bash
11
+ just fleet setup
12
+ ```
13
+
14
+ This is the easiest installer TUI entry point. It runs `npx
15
+ @chankov/agent-fleet@latest setup`, where you choose Default or Full and optional
16
+ comma-separated features, inspect the exact plan, and confirm once to apply. It needs
17
+ npm registry access unless `@latest` is cached. For automation or without `just`:
18
+
19
+ ```bash
20
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
21
+ ```
22
+
23
+ These are published-package commands; source-checkout development uses
24
+ `node bin/cli.js setup`. `pi update --extensions` does not update the npm installer:
25
+ run `just fleet setup` to resolve `@latest` and reconcile. `just fleet deps` installs
26
+ nested runtime dependencies; `just fleet install` was removed. See
27
+ [npm-install.md](npm-install.md) for the canonical installer guide.
28
+
29
+ Default is launchable Fleet Core and does not create `.claude/` or voice
30
+ configuration. Full selects stable, platform-applicable roots and may add the
31
+ recorded Claude Code coms bridge. Feature flags are named additions over a
32
+ preset; they are not an arbitrary package picker. Flags do not rewrite an
33
+ existing desired file unless `--save-desired` is explicit.
34
+
35
+ The installer owns only paths in `.ai/agent-fleet-state.json`. Normal uninstall
36
+ preserves `.ai/agent-fleet.json`, `.ai/agent-fleet-overrides.md`, `.ai/stt.json`,
37
+ and environment files. See [npm-install.md](npm-install.md) for `--migrate`,
38
+ `--purge-config`, doctor exits, and self-uninstall recovery.
39
+
40
+ ## Runtime closure
41
+
42
+ `just fleet` is the guarded Fleet Core launcher. It explicitly loads
43
+ `damage-control-continue`, `ask-user-remote`, compact-and-continue, BTW, and
44
+ the update checker. Voice is not a Default Core dependency. `just fleet hub`
45
+ adds agent-hub; `just fleet peer` adds coms; `just fleet team` uses Herdr.
46
+
47
+ ```bash
48
+ just fleet help
49
+ just fleet setup
50
+ just fleet deps
51
+ just fleet doctor
52
+ just fleet uninstall --yes
53
+ ```
54
+
55
+ Self-uninstall removes the managed justfile region and dispatcher scripts last,
56
+ so its report completes. Restore it only through `npx @chankov/agent-fleet
57
+ setup ...`; then `just fleet doctor` is available again.
58
+
59
+ ## Package-native skills and prompts
60
+
61
+ ```bash
62
+ pi install -l npm:@chankov/agent-fleet
63
+ ```
64
+
65
+ Do not also copy the same skills/prompts into `.pi/`; that creates collisions.
66
+ Harness-only composition (package-native skills/prompts plus copied harnesses)
67
+ is supported. The package bundles `pi-ask-user`; copied plain-pi installations
68
+ need their own compatible `pi-ask-user` source.
69
+
70
+ ## Project-owned configuration
71
+
72
+ `.ai/agent-fleet-overrides.md` is minimal committed project configuration;
73
+ `.ai/stt.json` contains provider names and environment-variable names, never
74
+ secret values. The root environment file is human-owned and append-only.