@chankov/agent-fleet 2.0.7 → 2.0.8

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 (619) hide show
  1. package/{hermes → .pi/agent-fleet/hermes}/README.md +7 -7
  2. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +2 -2
  3. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +2 -2
  4. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +1 -1
  5. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +2 -2
  6. package/{hermes → .pi/agent-fleet/hermes}/skills/hub-conductor/SKILL.md +1 -1
  7. package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/SKILL.md +3 -3
  8. package/{hooks → .pi/agent-fleet/hooks}/coms-stop-hook.mjs +2 -2
  9. package/{scripts → .pi/agent-fleet/scripts}/claude-code-preflight.ts +1 -1
  10. package/{scripts → .pi/agent-fleet/scripts}/coms-claude-bridge.ts +6 -6
  11. package/{scripts → .pi/agent-fleet/scripts}/coms-cli.ts +1 -1
  12. package/{scripts → .pi/agent-fleet/scripts}/coms-hermes-bridge.ts +1 -1
  13. package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-read.py +5 -3
  14. package/{scripts → .pi/agent-fleet/scripts}/fleet.ts +1 -1
  15. package/{scripts → .pi/agent-fleet/scripts}/flow.ts +1 -1
  16. package/{scripts → .pi/agent-fleet/scripts}/lib/claude-bridge-core.ts +2 -2
  17. package/{scripts → .pi/agent-fleet/scripts}/lib/coms-envelope.ts +1 -1
  18. package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-transport.ts +1 -1
  19. package/{scripts → .pi/agent-fleet/scripts}/lib/herdr-layout.ts +3 -3
  20. package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-bridge-core.ts +1 -1
  21. package/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  22. package/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  23. package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-monitor-model.ts +1 -1
  24. package/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  25. package/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  26. package/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  27. package/{scripts → .pi/agent-fleet/scripts}/lib/monitor-env.ts +1 -1
  28. package/{scripts → .pi/agent-fleet/scripts}/lib/peer-launch.ts +3 -3
  29. package/{scripts → .pi/agent-fleet/scripts}/lib/persona-banner.ts +1 -1
  30. package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  31. package/{scripts → .pi/agent-fleet/scripts}/lib/runtime-dependencies.js +1 -1
  32. package/{scripts → .pi/agent-fleet/scripts}/lib/spawn-stagger.ts +1 -1
  33. package/{scripts → .pi/agent-fleet/scripts}/lib/team-project.ts +1 -1
  34. package/{scripts → .pi/agent-fleet/scripts}/lib/team-snapshot.ts +2 -2
  35. package/{scripts → .pi/agent-fleet/scripts}/peer-banner.ts +5 -4
  36. package/{scripts → .pi/agent-fleet/scripts}/peer-launch.ts +7 -9
  37. package/{scripts → .pi/agent-fleet/scripts}/team-snapshot.ts +5 -5
  38. package/{scripts → .pi/agent-fleet/scripts}/team-up.ts +6 -6
  39. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/agent-phase.ts +3 -3
  40. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/envelopes.ts +1 -1
  41. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-profile.ts +1 -1
  42. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/personas.ts +2 -2
  43. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/trace.ts +1 -1
  44. package/.pi/agents/peers.yaml +3 -1
  45. package/.pi/harnesses/agent-hub/README.md +1 -1
  46. package/.pi/harnesses/agent-hub/config/agents.ts +5 -1
  47. package/.pi/harnesses/agent-hub/debate-command.ts +1 -1
  48. package/.pi/harnesses/agent-hub/index.ts +19 -19
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
  51. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +3 -5
  52. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
  53. package/.pi/harnesses/ask-user-remote/index.ts +2 -2
  54. package/.pi/harnesses/coms/package.json +1 -1
  55. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  56. package/.pi/harnesses/lib/spawned-peers.js +1 -1
  57. package/.pi/prompts/af-constraints.md +31 -0
  58. package/.versions/2.0.8/.pi/agent-fleet/hermes/README.md +347 -0
  59. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  60. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  61. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  62. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  63. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  64. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  65. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  66. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  67. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  68. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  69. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  70. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  71. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  72. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  73. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  74. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  75. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  76. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  77. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  78. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  79. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  80. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  81. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  82. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  83. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  84. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  85. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  86. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  87. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  88. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  89. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  90. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  91. package/.versions/2.0.8/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  92. package/.versions/2.0.8/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  93. package/.versions/2.0.8/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  94. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  95. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  96. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  97. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  98. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  99. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet.ts +216 -0
  100. package/.versions/2.0.8/.pi/agent-fleet/scripts/flow.ts +137 -0
  101. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  102. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  103. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  104. package/.versions/2.0.8/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  105. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  106. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  107. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  108. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  109. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  110. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  111. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  112. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  113. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  114. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  115. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  116. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  117. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  118. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  119. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  120. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  121. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  122. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  123. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  124. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  125. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  126. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  127. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  128. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  129. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  130. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  131. package/.versions/2.0.8/.pi/agent-fleet/scripts/package-lock.json +35 -0
  132. package/.versions/2.0.8/.pi/agent-fleet/scripts/package.json +9 -0
  133. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  134. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  135. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  136. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-up.ts +378 -0
  137. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  138. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  139. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  140. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  141. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  142. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  143. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  144. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  145. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  146. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  147. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  148. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  149. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  150. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  151. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  152. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  153. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  154. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  155. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  156. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  157. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  158. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  159. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  160. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  161. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  162. package/.versions/2.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  163. package/.versions/2.0.8/.pi/agents/model-profiles.yaml +83 -0
  164. package/.versions/2.0.8/.pi/agents/peers.yaml +147 -0
  165. package/.versions/2.0.8/.pi/agents/teams.yaml +41 -0
  166. package/.versions/2.0.8/.pi/agents/voices.yaml +13 -0
  167. package/.versions/2.0.8/.pi/damage-control-rules.yaml +297 -0
  168. package/.versions/2.0.8/.pi/extensions/btw/README.md +120 -0
  169. package/.versions/2.0.8/.pi/extensions/btw/index.ts +914 -0
  170. package/.versions/2.0.8/.pi/extensions/btw/package.json +6 -0
  171. package/.versions/2.0.8/.pi/extensions/btw/state.js +179 -0
  172. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  173. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  174. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  175. package/.versions/2.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  176. package/.versions/2.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  177. package/.versions/2.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  178. package/.versions/2.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  179. package/.versions/2.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  180. package/.versions/2.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  181. package/.versions/2.0.8/.pi/extensions/package-lock.json +1175 -0
  182. package/.versions/2.0.8/.pi/extensions/package.json +9 -0
  183. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/README.md +205 -0
  184. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  185. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  186. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  187. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  188. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  189. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  190. package/.versions/2.0.8/.pi/harnesses/agent-hub/README.md +1203 -0
  191. package/.versions/2.0.8/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  192. package/.versions/2.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  193. package/.versions/2.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  194. package/.versions/2.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  195. package/.versions/2.0.8/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  196. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  197. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  198. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  199. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  200. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  201. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  202. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  203. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  204. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  205. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  206. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  207. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  208. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  209. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  210. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  211. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  212. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  213. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  214. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  215. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  216. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  217. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  218. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  219. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  220. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  221. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  222. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  223. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  224. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  225. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  226. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  227. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  228. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  229. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  230. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  231. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  232. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  233. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  234. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  235. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  236. package/.versions/2.0.8/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  237. package/.versions/2.0.8/.pi/harnesses/agent-hub/delegate.ts +446 -0
  238. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  239. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  240. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  241. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  242. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  243. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  244. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  245. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  246. package/.versions/2.0.8/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  247. package/.versions/2.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  248. package/.versions/2.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  249. package/.versions/2.0.8/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  250. package/.versions/2.0.8/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  251. package/.versions/2.0.8/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  252. package/.versions/2.0.8/.pi/harnesses/agent-hub/footer.ts +30 -0
  253. package/.versions/2.0.8/.pi/harnesses/agent-hub/helpers.ts +266 -0
  254. package/.versions/2.0.8/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  255. package/.versions/2.0.8/.pi/harnesses/agent-hub/index.ts +2151 -0
  256. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  257. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  258. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  259. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  260. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  261. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  262. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  263. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  264. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  265. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  266. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  267. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  268. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  269. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  270. package/.versions/2.0.8/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  271. package/.versions/2.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  272. package/.versions/2.0.8/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  273. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  274. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  275. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  276. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  277. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  278. package/.versions/2.0.8/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  279. package/.versions/2.0.8/.pi/harnesses/agent-hub/presentation.ts +48 -0
  280. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  281. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  282. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  283. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  284. package/.versions/2.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  285. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  286. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  287. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  288. package/.versions/2.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  289. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  290. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  291. package/.versions/2.0.8/.pi/harnesses/agent-hub/review-findings.js +102 -0
  292. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-budget.js +537 -0
  293. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  294. package/.versions/2.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  295. package/.versions/2.0.8/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  296. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  297. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-start.ts +42 -0
  298. package/.versions/2.0.8/.pi/harnesses/agent-hub/spawn.ts +404 -0
  299. package/.versions/2.0.8/.pi/harnesses/agent-hub/timeline.ts +54 -0
  300. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  301. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  302. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  303. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  304. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  305. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  306. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  307. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  308. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  309. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  310. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  311. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  312. package/.versions/2.0.8/.pi/harnesses/agent-hub/types.ts +63 -0
  313. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  314. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  315. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  316. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  317. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  318. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  319. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  320. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  321. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  322. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  323. package/.versions/2.0.8/.pi/harnesses/agent-hub/version.ts +42 -0
  324. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  325. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  326. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/README.md +59 -0
  327. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/index.ts +558 -0
  328. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  329. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  330. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  331. package/.versions/2.0.8/.pi/harnesses/coms/README.md +100 -0
  332. package/.versions/2.0.8/.pi/harnesses/coms/index.ts +282 -0
  333. package/.versions/2.0.8/.pi/harnesses/coms/package.json +7 -0
  334. package/.versions/2.0.8/.pi/harnesses/coms/version.ts +42 -0
  335. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/README.md +135 -0
  336. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/index.ts +541 -0
  337. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  338. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/version.ts +42 -0
  339. package/.versions/2.0.8/.pi/harnesses/lib/coms-core-io.ts +385 -0
  340. package/.versions/2.0.8/.pi/harnesses/lib/coms-core.ts +577 -0
  341. package/.versions/2.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  342. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  343. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  344. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-view.ts +107 -0
  345. package/.versions/2.0.8/.pi/harnesses/lib/context-budget.ts +114 -0
  346. package/.versions/2.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  347. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  348. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  349. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  350. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  351. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  352. package/.versions/2.0.8/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  353. package/.versions/2.0.8/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  354. package/.versions/2.0.8/.pi/harnesses/lib/fleet-panel.ts +34 -0
  355. package/.versions/2.0.8/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  356. package/.versions/2.0.8/.pi/harnesses/lib/fleet-selection.ts +24 -0
  357. package/.versions/2.0.8/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  358. package/.versions/2.0.8/.pi/harnesses/lib/herdr-client.ts +472 -0
  359. package/.versions/2.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  360. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  361. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  362. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  363. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  364. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  365. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  366. package/.versions/2.0.8/.pi/harnesses/lib/spawned-peers.js +190 -0
  367. package/.versions/2.0.8/.pi/harnesses/lib/update-check.ts +222 -0
  368. package/.versions/2.0.8/.pi/harnesses/package-lock.json +2039 -0
  369. package/.versions/2.0.8/.pi/harnesses/package.json +10 -0
  370. package/.versions/2.0.8/.pi/prompts/af-build.md +24 -0
  371. package/.versions/2.0.8/.pi/prompts/af-code-simplify.md +22 -0
  372. package/.versions/2.0.8/.pi/prompts/af-constraints.md +31 -0
  373. package/.versions/2.0.8/.pi/prompts/af-plan.md +17 -0
  374. package/.versions/2.0.8/.pi/prompts/af-review.md +16 -0
  375. package/.versions/2.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  376. package/.versions/2.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  377. package/.versions/2.0.8/.pi/prompts/af-ship.md +17 -0
  378. package/.versions/2.0.8/.pi/prompts/af-spec.md +15 -0
  379. package/.versions/2.0.8/.pi/prompts/af-test.md +19 -0
  380. package/.versions/2.0.8/.pi/skills/bowser/SKILL.md +145 -0
  381. package/.versions/2.0.8/.version +1 -0
  382. package/.versions/2.0.8/agents/architect.md +25 -0
  383. package/.versions/2.0.8/agents/bowser.md +28 -0
  384. package/.versions/2.0.8/agents/builder.md +56 -0
  385. package/.versions/2.0.8/agents/code-reviewer.md +210 -0
  386. package/.versions/2.0.8/agents/deep-researcher.md +33 -0
  387. package/.versions/2.0.8/agents/documenter.md +23 -0
  388. package/.versions/2.0.8/agents/orchestrator.md +23 -0
  389. package/.versions/2.0.8/agents/plan-reviewer.md +84 -0
  390. package/.versions/2.0.8/agents/planner.md +106 -0
  391. package/.versions/2.0.8/agents/releaser.md +25 -0
  392. package/.versions/2.0.8/agents/researcher.md +31 -0
  393. package/.versions/2.0.8/agents/security-auditor.md +168 -0
  394. package/.versions/2.0.8/agents/test-engineer.md +154 -0
  395. package/.versions/2.0.8/agents/web-debugger.md +44 -0
  396. package/.versions/2.0.8/agents/web-performance-auditor.md +194 -0
  397. package/.versions/2.0.8/bin/catalog/harness-runtime-closure.json +32 -0
  398. package/.versions/2.0.8/codex/fleet-session-client/SKILL.md +34 -0
  399. package/.versions/2.0.8/codex/fleet-session-client.zip +0 -0
  400. package/.versions/2.0.8/docs/ARCHITECTURE.md +416 -0
  401. package/.versions/2.0.8/docs/agent-fleet-setup.md +568 -0
  402. package/.versions/2.0.8/docs/claude-code-coms-bridge.md +134 -0
  403. package/.versions/2.0.8/docs/codex-session-bridge.md +219 -0
  404. package/.versions/2.0.8/docs/coms-hermes-bridge.md +188 -0
  405. package/.versions/2.0.8/docs/getting-started.md +126 -0
  406. package/.versions/2.0.8/docs/npm-install.md +356 -0
  407. package/.versions/2.0.8/docs/pi-extensions.md +446 -0
  408. package/.versions/2.0.8/docs/pi-setup.md +76 -0
  409. package/.versions/2.0.8/docs/skill-anatomy.md +150 -0
  410. package/.versions/2.0.8/install-manifest.json +2991 -0
  411. package/.versions/2.0.8/justfile +247 -0
  412. package/.versions/2.0.8/manifest-meta.json +970 -0
  413. package/.versions/2.0.8/references/accessibility-checklist.md +160 -0
  414. package/.versions/2.0.8/references/communication-contract.md +26 -0
  415. package/.versions/2.0.8/references/definition-of-done.md +67 -0
  416. package/.versions/2.0.8/references/fleet-coordination-patterns.md +171 -0
  417. package/.versions/2.0.8/references/observability-checklist.md +92 -0
  418. package/.versions/2.0.8/references/orchestration-patterns.md +370 -0
  419. package/.versions/2.0.8/references/performance-checklist.md +236 -0
  420. package/.versions/2.0.8/references/prompting-patterns.md +380 -0
  421. package/.versions/2.0.8/references/security-checklist.md +245 -0
  422. package/.versions/2.0.8/references/testing-patterns.md +235 -0
  423. package/.versions/2.0.8/references/workflow-authoring.md +304 -0
  424. package/.versions/2.0.8/skills/_internal/grilling.md +59 -0
  425. package/.versions/2.0.8/skills/browser-testing-with-devtools/SKILL.md +351 -0
  426. package/.versions/2.0.8/skills/code-review-and-quality/SKILL.md +396 -0
  427. package/.versions/2.0.8/skills/compound-learning/SKILL.md +137 -0
  428. package/.versions/2.0.8/skills/constraint-driven-development/SKILL.md +338 -0
  429. package/.versions/2.0.8/skills/constraint-driven-development/references/floor-guard.md +99 -0
  430. package/.versions/2.0.8/skills/context-engineering/SKILL.md +341 -0
  431. package/.versions/2.0.8/skills/deprecation-and-migration/SKILL.md +247 -0
  432. package/.versions/2.0.8/skills/designing-agents/SKILL.md +394 -0
  433. package/.versions/2.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  434. package/.versions/2.0.8/skills/drafting-workflows/SKILL.md +143 -0
  435. package/.versions/2.0.8/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  436. package/.versions/2.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  437. package/.versions/2.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  438. package/.versions/2.0.8/skills/idea-refine/SKILL.md +182 -0
  439. package/.versions/2.0.8/skills/idea-refine/examples.md +238 -0
  440. package/.versions/2.0.8/skills/idea-refine/frameworks.md +99 -0
  441. package/.versions/2.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  442. package/.versions/2.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  443. package/.versions/2.0.8/skills/incremental-implementation/SKILL.md +302 -0
  444. package/.versions/2.0.8/skills/interview-me/SKILL.md +226 -0
  445. package/.versions/2.0.8/skills/orchestration-verification/SKILL.md +181 -0
  446. package/.versions/2.0.8/skills/peer-coms/SKILL.md +90 -0
  447. package/.versions/2.0.8/skills/performance-optimization/SKILL.md +496 -0
  448. package/.versions/2.0.8/skills/planning-and-task-breakdown/SKILL.md +289 -0
  449. package/.versions/2.0.8/skills/security-and-hardening/SKILL.md +524 -0
  450. package/.versions/2.0.8/skills/spec-driven-development/SKILL.md +295 -0
  451. package/.versions/2.0.8/skills/using-agent-skills/SKILL.md +198 -0
  452. package/.versions/2.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  453. package/.versions/2.0.8/vendor/agent-skills-upstream/README.md +430 -0
  454. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  455. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  456. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  457. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  458. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  459. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  460. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  461. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  462. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  463. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  464. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  465. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  466. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  467. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  468. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  469. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  470. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  471. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  472. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  473. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  474. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  475. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  476. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  477. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  478. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  479. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  480. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  481. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  482. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  483. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  484. package/CHANGELOG.md +39 -0
  485. package/README.md +10 -9
  486. package/bin/catalog/harness-runtime-closure.json +23 -22
  487. package/bin/cli.js +24 -1
  488. package/bin/lib/apply.js +6 -2
  489. package/bin/lib/detect-agent.js +1 -1
  490. package/bin/lib/doctor.js +3 -3
  491. package/bin/lib/manifest.js +23 -16
  492. package/bin/lib/path-boundaries.js +96 -0
  493. package/bin/lib/personas.js +15 -2
  494. package/bin/lib/set-hermes-telegram.js +2 -2
  495. package/bin/lib/set-hermes-watchdog.js +1 -1
  496. package/bin/lib/state.js +5 -1
  497. package/bin/lib/verify.js +43 -5
  498. package/bin/snapshot-version.js +6 -6
  499. package/codex/fleet-session-client/SKILL.md +3 -3
  500. package/docs/ARCHITECTURE.md +29 -20
  501. package/docs/MIGRATION-agent-fleet.md +11 -7
  502. package/docs/agent-fleet-setup.md +9 -2
  503. package/docs/claude-code-coms-bridge.md +10 -9
  504. package/docs/codex-session-bridge.md +18 -18
  505. package/docs/coms-hermes-bridge.md +6 -6
  506. package/docs/hermes-watchdog-supervisor.md +1 -1
  507. package/docs/npm-install.md +30 -1
  508. package/docs/pi-extensions.md +6 -6
  509. package/docs/workflows.md +9 -5
  510. package/install-manifest.json +202 -97
  511. package/justfile +19 -19
  512. package/manifest-meta.json +50 -38
  513. package/package.json +26 -26
  514. package/references/observability-checklist.md +1 -0
  515. package/references/performance-checklist.md +83 -0
  516. package/references/prompting-patterns.md +1 -1
  517. package/references/security-checklist.md +85 -19
  518. package/references/testing-patterns.md +12 -13
  519. package/references/workflow-authoring.md +5 -5
  520. package/skills/code-review-and-quality/SKILL.md +17 -2
  521. package/skills/constraint-driven-development/SKILL.md +338 -0
  522. package/skills/constraint-driven-development/references/floor-guard.md +99 -0
  523. package/skills/context-engineering/SKILL.md +52 -2
  524. package/skills/deprecation-and-migration/SKILL.md +42 -1
  525. package/skills/designing-agents/SKILL.md +12 -12
  526. package/skills/drafting-workflows/SKILL.md +6 -6
  527. package/skills/drafting-workflows/scripts/make-workflow.ts +3 -3
  528. package/skills/frontend-ui-engineering/SKILL.md +2 -2
  529. package/skills/git-workflow-and-versioning/SKILL.md +1 -1
  530. package/skills/incremental-implementation/SKILL.md +13 -9
  531. package/skills/peer-coms/SKILL.md +4 -4
  532. package/skills/performance-optimization/SKILL.md +152 -6
  533. package/skills/planning-and-task-breakdown/SKILL.md +32 -8
  534. package/skills/security-and-hardening/SKILL.md +84 -21
  535. package/skills/spec-driven-development/SKILL.md +41 -2
  536. package/skills/using-agent-skills/SKILL.md +3 -2
  537. package/vendor/agent-skills-upstream/README.md +427 -8
  538. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +73 -0
  539. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +2 -2
  540. package/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  541. package/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  542. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +49 -1
  543. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +4 -4
  544. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +1 -1
  545. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +12 -2
  546. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +3 -3
  547. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +1 -1
  548. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +1 -1
  549. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +9 -9
  550. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +36 -1
  551. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +151 -5
  552. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +32 -9
  553. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +64 -7
  554. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +26 -6
  555. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +23 -1
  556. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +42 -3
  557. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +18 -3
  558. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +3 -2
  559. package/scripts/lib/hermes-monitor-events.ts +0 -1
  560. package/scripts/lib/hermes-monitor-herdr.ts +0 -2
  561. package/scripts/lib/hermes-monitor-registry.ts +0 -2
  562. package/scripts/lib/hermes-monitor-socket.ts +0 -2
  563. package/scripts/lib/hermes-monitor-store.ts +0 -2
  564. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/plugin.js +0 -0
  565. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/presentation.js +0 -0
  566. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  567. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  568. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/herdr_source.py +0 -0
  569. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/manifest.json +0 -0
  570. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/plugin_api.py +0 -0
  571. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/sessions.py +0 -0
  572. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/tasks.py +0 -0
  573. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/plugin.yaml +0 -0
  574. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  575. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -0
  576. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  577. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  578. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-liaison/SKILL.md +0 -0
  579. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/manifest.json +0 -0
  580. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog.py +0 -0
  581. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_actions.py +0 -0
  582. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_contract.py +0 -0
  583. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_delivery.py +0 -0
  584. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_engine.py +0 -0
  585. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_judgment.py +0 -0
  586. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_recovery.py +0 -0
  587. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_state.py +0 -0
  588. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_transport.py +0 -0
  589. /package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-client.ts +0 -0
  590. /package/{scripts → .pi/agent-fleet/scripts}/hermes-watchdog-capability-probe.ts +0 -0
  591. /package/{scripts → .pi/agent-fleet/scripts}/lib/fake-herdr-server.ts +0 -0
  592. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-catalog.ts +0 -0
  593. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-operations.ts +0 -0
  594. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-session.ts +0 -0
  595. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-command.ts +0 -0
  596. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-command.ts +0 -0
  597. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-maintenance.ts +0 -0
  598. /package/{scripts → .pi/agent-fleet/scripts}/package-lock.json +0 -0
  599. /package/{scripts → .pi/agent-fleet/scripts}/package.json +0 -0
  600. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/changes.ts +0 -0
  601. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/debate.ts +0 -0
  602. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/env.ts +0 -0
  603. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/gates.ts +0 -0
  604. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/git.ts +0 -0
  605. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/merge.ts +0 -0
  606. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-visibility.ts +0 -0
  607. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/permissions.ts +0 -0
  608. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/poll.ts +0 -0
  609. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/quality.ts +0 -0
  610. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/run.ts +0 -0
  611. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/voices.ts +0 -0
  612. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/writer-lease.ts +0 -0
  613. /package/{scripts → .pi/agent-fleet/scripts}/workflows/tsconfig.json +0 -0
  614. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-build-test.ts +0 -0
  615. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-debate.ts +0 -0
  616. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-document.ts +0 -0
  617. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-poll.ts +0 -0
  618. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-quality.ts +0 -0
  619. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-scout.ts +0 -0
@@ -0,0 +1,96 @@
1
+ // path-boundaries.js — the guard that makes a directory move finishable.
2
+ //
3
+ // Moving `scripts/`, `hermes/` and `hooks/` under `.pi/agent-fleet/` broke two
4
+ // classes of reference that nothing else in the repository was watching:
5
+ //
6
+ // 1. Relative import specifiers crossing the boundary. `.pi/harnesses/**`
7
+ // does not move and imports into the fleet runtime that does. Those
8
+ // imports are lazy — `just fleet` starts fine and the failure surfaces
9
+ // only when an operator runs `/debate` or spawns a peer. `tsc` cannot
10
+ // stand in for this: the harness packages are not installed at the
11
+ // repository root, so its resolution errors are all about npm packages.
12
+ //
13
+ // 2. Workspace paths written as text — in the justfile, in the catalogue, in
14
+ // agent-readable markdown. A stale path in a reference file never throws;
15
+ // it just teaches the next agent to write to `agents/` again, and the
16
+ // footprint grows back a session at a time.
17
+ //
18
+ // Both are pure functions over a file list so the test can state the rule and
19
+ // the CLI can reuse it.
20
+
21
+ import { existsSync, readFileSync } from "node:fs";
22
+ import { dirname, join, normalize, relative, resolve } from "node:path";
23
+
24
+ /** Directories that no longer exist at a workspace root. */
25
+ export const RETIRED_ROOTS = Object.freeze(["scripts", "hermes", "hooks"]);
26
+
27
+ /** Where each retired root lives now — used only for the failure message. */
28
+ export const MOVED_TO = Object.freeze({
29
+ scripts: ".pi/agent-fleet/scripts",
30
+ hermes: ".pi/agent-fleet/hermes",
31
+ hooks: ".pi/agent-fleet/hooks",
32
+ agents: ".pi/agents/personas",
33
+ });
34
+
35
+ const SPECIFIER = /(?:\bfrom|\bimport|\brequire)\s*\(?\s*["'](\.\.?\/[^"']+)["']|new URL\(\s*["'](\.\.?[^"']*)["']/g;
36
+
37
+ /**
38
+ * Relative specifiers in `source` that do not resolve to a file on disk.
39
+ *
40
+ * `.js` is accepted for a `.ts` file: that is the NodeNext spelling the
41
+ * harnesses already use, and Node strips types at runtime.
42
+ */
43
+ export function unresolvedSpecifiers({ root, file, source }) {
44
+ const dir = dirname(join(root, file));
45
+ const out = [];
46
+ for (const match of source.matchAll(SPECIFIER)) {
47
+ const spec = match[1] ?? match[2];
48
+ const target = resolve(dir, spec);
49
+ if (existsSync(target)) continue;
50
+ if (target.endsWith(".js") && existsSync(`${target.slice(0, -3)}.ts`)) continue;
51
+ out.push({ file, specifier: spec, resolved: relative(root, target) });
52
+ }
53
+ return out;
54
+ }
55
+
56
+ /**
57
+ * Workspace-relative mentions of a retired root.
58
+ *
59
+ * Matched only at a path boundary, so a skill's own `scripts/` directory
60
+ * (`skills/drafting-workflows/scripts/`), `.claude/hooks/` and the npm scope
61
+ * `@hermes/plugin-sdk` are not hits.
62
+ */
63
+ export function retiredRootMentions({ file, source, roots = RETIRED_ROOTS }) {
64
+ const pattern = new RegExp(String.raw`(^|[^A-Za-z0-9_./\-@])(${roots.join("|")})/`, "gm");
65
+ const out = [];
66
+ source.split("\n").forEach((line, index) => {
67
+ pattern.lastIndex = 0;
68
+ for (const match of line.matchAll(pattern)) {
69
+ out.push({ file, line: index + 1, root: match[2], text: line.trim().slice(0, 120) });
70
+ }
71
+ });
72
+ return out;
73
+ }
74
+
75
+ /** Every `.md` file an item installs into a workspace, as repo-relative paths. */
76
+ export function installedMarkdown({ root, manifest, walk }) {
77
+ const files = new Set();
78
+ for (const item of manifest.items ?? []) {
79
+ for (const binding of Object.values(item.agents ?? {})) {
80
+ if (!binding.target) continue; // operator/external items install nothing
81
+ for (const rel of binding.source ?? []) {
82
+ const abs = join(root, rel);
83
+ if (!existsSync(abs)) continue;
84
+ if (rel.endsWith(".md")) { files.add(normalize(rel)); continue; }
85
+ for (const leaf of walk(abs)) {
86
+ if (leaf.endsWith(".md")) files.add(normalize(`${rel}/${leaf}`));
87
+ }
88
+ }
89
+ }
90
+ }
91
+ return [...files].sort();
92
+ }
93
+
94
+ export function readSource(root, file) {
95
+ return readFileSync(join(root, file), "utf8");
96
+ }
@@ -1,7 +1,10 @@
1
1
  // personas.js — the canonical persona catalogue.
2
2
  //
3
3
  // `agents/*.md` is written in pi's own frontmatter dialect, so installing a
4
- // persona is a plain file copy: source and target carry identical bytes.
4
+ // persona is a plain file copy: source and target carry identical bytes. The
5
+ // package keeps its own personas in `agents/`; a workspace receives them under
6
+ // `.pi/agents/personas/` so the repository root stays clean (the YAML fleet
7
+ // configuration owns `.pi/agents/` itself, hence the subdirectory).
5
8
  // There is no per-agent frontmatter translation any more — the `transform-persona`
6
9
  // CLI subcommand and its mapping table went away with Claude Code as an
7
10
  // install target (docs/claude-code-coms-bridge.md explains what remains).
@@ -13,7 +16,17 @@ import { join } from "node:path";
13
16
 
14
17
  /** Install path for a persona, relative to the workspace root. */
15
18
  export function targetRelPath(name) {
16
- return join("agents", `${name}.md`);
19
+ return join(".pi", "agents", "personas", `${name}.md`);
20
+ }
21
+
22
+ /**
23
+ * Where the installer used to write this persona. Declared on every persona
24
+ * binding so `verify` reports a surviving `agents/<name>.md` instead of letting
25
+ * `scanAgentDirs` silently prefer it over the installed copy — it scans
26
+ * `agents/` first and keeps the first definition per name.
27
+ */
28
+ export function legacyTargetRelPaths(name) {
29
+ return [join("agents", `${name}.md`)];
17
30
  }
18
31
 
19
32
  /**
@@ -164,7 +164,7 @@ async function resolveHermesProfile(requestedProfile, hermes) {
164
164
  export async function inspectHermesTelegram(options) {
165
165
  const hermes = options.hermes ?? (async (args) => runHermesCommand(args));
166
166
  const resolvedProfile = await resolveHermesProfile(options.profile, hermes);
167
- const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", LIAISON_SKILL);
167
+ const sourceDir = options.skillSourceDir ?? join(options.packageRoot, ".pi", "agent-fleet", "hermes", "skills", LIAISON_SKILL);
168
168
  const installedDir = join(resolvedProfile.profilePath, "skills", LIAISON_SKILL);
169
169
  const skill = skillState(sourceDir, installedDir);
170
170
  const [skillsOutput, toolsOutput] = await Promise.all([
@@ -299,7 +299,7 @@ async function controlBridge(options, parsed) {
299
299
  await herdr(["pane", "rename", paneId, BRIDGE_LABEL]);
300
300
  const command = [
301
301
  shellQuote(process.execPath), "--experimental-strip-types",
302
- shellQuote(join(options.packageRoot, "scripts", "coms-hermes-bridge.ts")),
302
+ shellQuote(join(options.packageRoot, ".pi", "agent-fleet", "scripts", "coms-hermes-bridge.ts")),
303
303
  "--project", shellQuote(project), "--hermes-profile", shellQuote(hermesProfile),
304
304
  "--timeout", "1800000", "--to", shellQuote(parsed.target),
305
305
  ].join(" ");
@@ -60,7 +60,7 @@ function receiptState(receipt, installedFingerprint) {
60
60
  /** Read-only inspection: two Hermes reads, no profile, service, or tool mutation. */
61
61
  export async function inspectHermesWatchdog(options) {
62
62
  const resolved = await resolveHermesProfile(options.profile, options.hermes);
63
- const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", NAME);
63
+ const sourceDir = options.skillSourceDir ?? join(options.packageRoot, ".pi", "agent-fleet", "hermes", "skills", NAME);
64
64
  const installedDir = join(resolved.profilePath, "skills", NAME);
65
65
  const receipt = join(resolved.profilePath, "agent-fleet", `${NAME}.receipt.json`);
66
66
  const skill = artifactState(sourceDir, installedDir);
package/bin/lib/state.js CHANGED
@@ -18,7 +18,11 @@ import { createHash } from "node:crypto";
18
18
  import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, lstatSync, realpathSync } from "node:fs";
19
19
  import { dirname, join, relative, resolve, sep } from "node:path";
20
20
 
21
- export const STATE_SCHEMA_VERSION = 1;
21
+ // 2 — the .pi/agent-fleet relocation. The file's shape did not change; the
22
+ // paths recorded in it did, and a workspace still reading 1 is one whose
23
+ // `scripts/`, `hermes/`, `hooks/` and `agents/` copies have not been retired
24
+ // yet. `verify` says so, and the next `setup` re-stamps this on the way out.
25
+ export const STATE_SCHEMA_VERSION = 2;
22
26
  export const STATE_REL_PATH = join(".ai", "agent-fleet-state.json");
23
27
  export const LEGACY_RECORD_REL_PATH = join(".ai", "agent-fleet-setup.md");
24
28
 
package/bin/lib/verify.js CHANGED
@@ -41,6 +41,9 @@ export const BROKEN_STATES = new Set(["missing", "broken-link", "foreign-link",
41
41
  // but they never fail the run — a workspace installed before `.versions/`
42
42
  // retention, or one carrying a hand-edited overrides file, is not broken.
43
43
  export const ADVISORY_FINDINGS = new Set([
44
+ // A relocation is a normal upgrade, not a broken install: the next setup
45
+ // cleans it up, and the item states already carry the severity.
46
+ "relocated-artifacts",
44
47
  "base-snapshot-missing",
45
48
  "source-root-volatile",
46
49
  "symlink-retired",
@@ -105,7 +108,7 @@ export async function runVerify({
105
108
  type: "state-schema",
106
109
  path: STATE_REL_PATH,
107
110
  issue: `state schemaVersion ${state.schemaVersion}, this build speaks ${STATE_SCHEMA_VERSION}`,
108
- fix: "upgrade agent-fleet, or re-run install to rewrite the state file",
111
+ fix: "run `agent-fleet setup` to reconcile the workspace and re-stamp the state file",
109
112
  });
110
113
  }
111
114
  if (state?.sourceRoot && !existsSync(state.sourceRoot)) {
@@ -154,6 +157,25 @@ export async function runVerify({
154
157
  });
155
158
  }
156
159
 
160
+ // One relocation finding for the whole pass. A release that moves a tree
161
+ // produces an obsolete path per file — ninety of them for the .pi/agent-fleet
162
+ // move — and ninety findings is noise, not a report. The per-item lists stay
163
+ // in `items[].obsoleteFiles` for anything that wants to expand them.
164
+ const relocated = items.filter((entry) => (entry.obsoleteFiles ?? []).length > 0);
165
+ if (relocated.length > 0) {
166
+ const all = relocated.flatMap((entry) => entry.obsoleteFiles);
167
+ const kept = all.filter((file) => file.retained).length;
168
+ findings.push({
169
+ type: "relocated-artifacts",
170
+ path: STATE_REL_PATH,
171
+ issue: `${relocated.length} item(s) moved: ${all.length - kept} old file(s) to remove` +
172
+ (kept > 0 ? `, ${kept} kept (locally modified)` : "") +
173
+ ` — ${relocated.map((entry) => entry.id).slice(0, 3).join(", ")}` +
174
+ (relocated.length > 3 ? `, +${relocated.length - 3} more` : ""),
175
+ fix: "re-run setup to retire them (edited files are preserved); `verify --json` lists every path under items[].obsoleteFiles",
176
+ });
177
+ }
178
+
157
179
  for (const entry of items) {
158
180
  for (const rel of entry.legacyTargets ?? []) {
159
181
  findings.push({
@@ -331,9 +353,15 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
331
353
  if (recorded?.method === "symlink" || !pair.isDir) expectedPaths.add(pair.targetRel);
332
354
  else for (const rel of walkTree(pair.sourceAbs)) expectedPaths.add(`${pair.targetRel}/${rel}`);
333
355
  }
334
- const obsoleteFiles = (recorded?.files ?? []).filter((file) =>
335
- !expectedPaths.has(file.path) && inspectPath(join(workspace, file.path)).kind !== "absent"
336
- );
356
+ // `retained` mirrors apply()'s ownership rule: a byte-identical copy is ours
357
+ // to retire, an edited one becomes the user's and is left alone. Deciding it
358
+ // here means `verify` can say how many of the old paths will actually go.
359
+ const obsoleteFiles = (recorded?.files ?? [])
360
+ .filter((file) => !expectedPaths.has(file.path) && inspectPath(join(workspace, file.path)).kind !== "absent")
361
+ .map((file) => ({
362
+ path: file.path,
363
+ retained: Boolean(file.sha256) && hashFile(join(workspace, file.path)) !== file.sha256,
364
+ }));
337
365
 
338
366
  const recordedHashes = new Map((recorded?.files ?? []).map((f) => [f.path, f.sha256]));
339
367
  const agent = agentOf(item, binding);
@@ -384,6 +412,16 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
384
412
  recorded: recordedHashes.get(pair.targetRel) ?? null,
385
413
  })];
386
414
 
415
+ // A directory target can exist because a *different* item writes inside it
416
+ // — `.pi/agents/` holds both the fleet YAML and the installed personas. An
417
+ // item we never installed, none of whose leaves are present, is absent, not
418
+ // half-broken; only a recorded item can go missing.
419
+ const allLeavesMissing = files.length > 0 && files.every((f) => f.state === "missing");
420
+ if (pair.isDir && !recorded && allLeavesMissing) {
421
+ results.push({ state: "absent" });
422
+ continue;
423
+ }
424
+
387
425
  results.push({ state: worstOf(files.map((f) => f.state)) ?? "up-to-date", fileCount: files.length });
388
426
  changed.push(...files.filter((f) => f.state !== "up-to-date"));
389
427
  }
@@ -408,7 +446,7 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
408
446
  changedCount: changed.length + obsoleteFiles.length,
409
447
  };
410
448
  if (obsoleteFiles.length > 0) {
411
- out.obsoleteFiles = obsoleteFiles.map((file) => ({ path: file.path }));
449
+ out.obsoleteFiles = obsoleteFiles.map((file) => ({ path: file.path, retained: file.retained }));
412
450
  out.detail = `${obsoleteFiles.length} previously managed path(s) are no longer in the current binding`;
413
451
  }
414
452
  // A path this item used to install to that is still occupied. The runtime
@@ -28,17 +28,17 @@ const ARTIFACT_PATHS = [
28
28
  "vendor/agent-skills-upstream",
29
29
  "agents",
30
30
  "codex",
31
- "hermes",
31
+ ".pi/agent-fleet/hermes",
32
32
  ".pi/prompts",
33
33
  ".pi/extensions",
34
34
  ".pi/harnesses",
35
35
  ".pi/skills",
36
36
  ".pi/agents",
37
37
  ".pi/damage-control-rules.yaml",
38
- // scripts/ ships runtime helpers like team-up.ts that the pi harness
39
- // recipes shell out to. Test files stay out (filtered below) — they're
40
- // dev-only.
41
- "scripts",
38
+ // .pi/agent-fleet/scripts/ ships runtime helpers like team-up.ts that the
39
+ // pi harness recipes shell out to. Test files stay out (filtered below) —
40
+ // they're dev-only.
41
+ ".pi/agent-fleet/scripts",
42
42
  // justfile carries the pi harness launch recipes. It is a companion of the
43
43
  // harness group in the deterministic installer, so the snapshot must hold a
44
44
  // per-version copy for the upgrade three-way diff (retired-harness recipes
@@ -57,7 +57,7 @@ const ARTIFACT_PATHS = [
57
57
  "docs/getting-started.md",
58
58
  "docs/pi-setup.md",
59
59
  "references",
60
- "hooks",
60
+ ".pi/agent-fleet/hooks",
61
61
  // The generated catalogue. The upgrade three-way merge needs the *recorded
62
62
  // version's* manifest, not just its files: an item that existed then and is
63
63
  // retired now is only resolvable from the base catalogue.
@@ -5,14 +5,14 @@ description: Connect a ChatGPT Desktop or Android conversation to an existing Ag
5
5
 
6
6
  # Fleet session client
7
7
 
8
- Use the installed `scripts/fleet-codex-client.ts` from the workspace root, or its absolute path in an Agent Fleet checkout. Read `docs/codex-session-bridge.md` there for troubleshooting. Requires Node 22.18+ and Python 3.10+, with access to the same local user's existing Pi/herdr sockets. Android supplies human messages through the same ChatGPT conversation; tools execute on its connected desktop host.
8
+ Use the installed `.pi/agent-fleet/scripts/fleet-codex-client.ts` from the workspace root, or its absolute path in an Agent Fleet checkout. Read `docs/codex-session-bridge.md` there for troubleshooting. Requires Node 22.18+ and Python 3.10+, with access to the same local user's existing Pi/herdr sockets. Android supplies human messages through the same ChatGPT conversation; tools execute on its connected desktop host.
9
9
 
10
10
  ## Workflow
11
11
 
12
- - Start with `node scripts/fleet-codex-client.ts --help` for the versioned JSON operation contract. Use `describe` for current per-operation availability and reasons. Both describe supported parameters, remote/local effects and limits; `describe` uses read-only probes and does not update observations or receipts. Availability is a point-in-time prerequisite check, not authorization or guaranteed future acceptance.
12
+ - Start with `node .pi/agent-fleet/scripts/fleet-codex-client.ts --help` for the versioned JSON operation contract. Use `describe` for current per-operation availability and reasons. Both describe supported parameters, remote/local effects and limits; `describe` uses read-only probes and does not update observations or receipts. Availability is a point-in-time prerequisite check, not authorization or guaranteed future acceptance.
13
13
  - Fleet/Hub commands remain documented in the workspace `.pi/harnesses/agent-hub/README.md`, `docs/agents.md` and the repository README. Consult those sources when available; do not maintain another copied slash-command list or assume `send` executes Hub slash commands.
14
14
 
15
- - Discover with `node scripts/fleet-codex-client.ts sessions --project <project>`. Resolve ambiguous project/peer choices with the user; never select only by cwd. Select explicitly with `select --project <project> --peer <peer>`.
15
+ - Discover with `node .pi/agent-fleet/scripts/fleet-codex-client.ts sessions --project <project>`. Resolve ambiguous project/peer choices with the user; never select only by cwd. Select explicitly with `select --project <project> --peer <peer>`.
16
16
  - Keep `CODEX_THREAD_ID` supplied by the execution environment. Never fabricate or override it. `status` shows selected identity, registry freshness and a separate `questionState`; `summary` reads current sources. Presence alone does not mean working or done.
17
17
  - For a human-authorized instruction, write its exact text to a private temporary file. Use `send --id <unique-id> --text-file <path> --wait-ms 1000`. Reuse that same ID after an uncertain tool outcome; a new ID means a new instruction. Never resend automatically under another ID. Remove the temporary text file afterward.
18
18
  - `submitted`/`queued` mean accepted as a Pi follow-up. They do not prove final completion or immediate steering of the active child. `result` is a correlated coms reply. `unknown` requires source inspection, never an automatic retry. Pi retains budgets, permissions and orchestration.
@@ -9,16 +9,16 @@ the runtime responsibilities and where each module lives in the repository.
9
9
  | --- | --- | --- |
10
10
  | **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
11
11
  | **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
12
- | **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` | `scripts/flow.ts`, `scripts/workflows/` — see [workflows.md](workflows.md) |
13
- | **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `scripts/lib/herdr-layout.ts` |
14
- | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `scripts/lib/coms-envelope.ts` and `scripts/coms-cli.ts` |
15
- | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
16
- | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
17
- | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
18
- | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
19
- | **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake | `scripts/fleet-codex-client.ts`, `scripts/lib/fleet-codex-*`, opt-in feature `chatgpt-client` — see [codex-session-bridge.md](codex-session-bridge.md) |
12
+ | **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` | `.pi/agent-fleet/scripts/flow.ts`, `.pi/agent-fleet/scripts/workflows/` — see [workflows.md](workflows.md) |
13
+ | **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `.pi/agent-fleet/scripts/lib/herdr-layout.ts` |
14
+ | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `.pi/agent-fleet/scripts/lib/coms-envelope.ts` and `.pi/agent-fleet/scripts/coms-cli.ts` |
15
+ | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `.pi/agent-fleet/scripts/coms-claude-bridge.ts`, `.pi/agent-fleet/hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
16
+ | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `.pi/agent-fleet/scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `.pi/agent-fleet/hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
17
+ | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `.pi/agent-fleet/scripts/lib/`) — see [Hermes artifacts](../.pi/agent-fleet/hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
18
+ | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `.pi/agent-fleet/scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
19
+ | **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake | `.pi/agent-fleet/scripts/fleet-codex-client.ts`, `.pi/agent-fleet/scripts/lib/fleet-codex-*`, opt-in feature `chatgpt-client` — see [codex-session-bridge.md](codex-session-bridge.md) |
20
20
  | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
21
- | **Personas** | Reusable specialist definitions, installed verbatim | `agents/`, `bin/lib/personas.js` |
21
+ | **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
22
22
 
23
23
  ## One Hub runtime, independent axes
24
24
 
@@ -118,7 +118,7 @@ flowchart TD
118
118
  Hub -.->|"one status line: Assertions: 2✓ 1○ 1✗"| You
119
119
  ```
120
120
 
121
- Every specialist session is one persona from [`agents/`](../agents/) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
121
+ Every specialist session is one persona from [`agents/`](../agents/) (installed to `.pi/agents/personas/`) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
122
122
 
123
123
  The same idea as a tree:
124
124
 
@@ -297,20 +297,29 @@ Cross-harness coms lifecycle remains shared in `.pi/harnesses/lib/coms-core.ts`
297
297
 
298
298
  ```text
299
299
  .pi/ # Pi runtime: harnesses, extensions, agents config, prompts
300
+ .pi/agent-fleet/ # The fleet runtime, mirrored verbatim into a workspace:
301
+ scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
302
+ scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
303
+ hermes/ # Hermes-facing skills/integration assets
304
+ hooks/ # the coms bridge Stop hook
305
+ docs/ # the one doc that installs into a workspace (workflows.md)
300
306
  skills/ # Agent Fleet-native skills (shadow vendored names)
301
- agents/ # Personas/subagents used by Agent Fleet
302
- scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
303
- scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
304
- hermes/ # Hermes-facing skills/integration assets
307
+ agents/ # Personas/subagents; installed to a workspace's .pi/agents/personas/
305
308
  codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
306
309
  systemd/user/ # Owned user-unit template for Codex remote control
307
310
  vendor/agent-skills-upstream/ # Manually imported upstream skills (pinned SHA)
308
311
  bin/ # npm CLI: init/update/doctor + the installer engine
309
- hooks/ # The coms bridge Stop hook
310
312
  references/ # Supplementary checklists, installed with the skills that cite them
311
313
  docs/ # This file, setup guides, bridge references, vendoring policy
312
314
  ```
313
315
 
316
+ The fleet runtime keeps its *source* layout identical to its *installed* layout.
317
+ That is not cosmetic: `companion:harness-runtime-closure` and its siblings copy
318
+ with `preserveLayout`, so a relative import written here resolves the same way in
319
+ a workspace — including the ones reaching from the stationary `.pi/harnesses/`
320
+ into the movable `.pi/agent-fleet/scripts/`. `bin/test/path-boundaries.test.js`
321
+ holds that invariant.
322
+
314
323
  Reserved for future modules (do not repurpose these paths):
315
324
 
316
325
  ```text
@@ -377,8 +386,8 @@ packages/hermes-bridge/ # future Hermes integration package
377
386
  tests are not proof of a durable external identity or live delivery contract. `invoke`, where
378
387
  available, is Hub-owned and queues dispatcher work rather than exposing tools directly.
379
388
  - **Packaged Hermes source is opt-in, never auto-installed.** The npm tarball carries the
380
- `hub-watchdog` skill (`hermes/skills/`) plus the backend and Desktop monitor plugin source
381
- (`hermes/plugins/`, `hermes/desktop-plugins/`) as runtime-only source. Shipping that source
389
+ `hub-watchdog` skill (`.pi/agent-fleet/hermes/skills/`) plus the backend and Desktop monitor plugin source
390
+ (`.pi/agent-fleet/hermes/plugins/`, `.pi/agent-fleet/hermes/desktop-plugins/`) as runtime-only source. Shipping that source
382
391
  makes it available to an operator; installing it into a Hermes profile is always an explicit
383
392
  action through `agent-fleet set-hermes-watchdog` (skill) or the consumer's own flow (plugins).
384
393
  Nothing is enabled, launched, or configured by installing the package.
@@ -402,6 +411,6 @@ packages/hermes-bridge/ # future Hermes integration package
402
411
  Agent Fleet began as a fork of `addyosmani/agent-skills` and was split into a
403
412
  standalone repository in July 2026, with upstream demoted to vendored content.
404
413
  The one-time migration record, including the history-filtering commands, lives
405
- in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md); the product
406
- requirements that drove the split are in
407
- [prd-agent-fleet-split.md](prd-agent-fleet-split.md).
414
+ in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md). The product
415
+ requirements that drove the split were a one-off planning document and are no
416
+ longer maintained.
@@ -111,12 +111,14 @@ is never asked for. References moved from `.claude/references/` to
111
111
  brings `security-checklist.md` and `performance-checklist.md` with it, and
112
112
  uninstall refuses to strand a skill without its checklists. A new `coms-bridge`
113
113
  manifest group holds `skill:peer-coms` and its companion `hook:coms-stop-hook`;
114
- the hook still installs to `.claude/hooks/` under the **pi** agent, because the
115
- pane reading it is a Claude Code process. Registering it in `.claude/settings.json`
116
- remains a manual step — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
117
-
118
- **Unchanged:** the bridge itself — `scripts/coms-claude-bridge.ts`,
119
- `scripts/lib/claude-bridge-core.ts`, `skills/peer-coms/`, the `_claude-peer`
114
+ the hook installs under the **pi** agent like everything else — 2.0 wrote it to
115
+ `.claude/hooks/`, and the runtime relocation moved it to
116
+ `.pi/agent-fleet/hooks/coms-stop-hook.mjs`, which `setup` reconciles for you.
117
+ Registering it in `.claude/settings.json` remains a manual step — see
118
+ [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
119
+
120
+ **Unchanged:** the bridge itself — `.pi/agent-fleet/scripts/coms-claude-bridge.ts`,
121
+ `.pi/agent-fleet/scripts/lib/claude-bridge-core.ts`, `skills/peer-coms/`, the `_claude-peer`
120
122
  recipe, `runner: claude-code` peers in `.pi/agents/peers.yaml`, and the
121
123
  `dispatch-policy.yaml` routing that lets a bridged pane serve a team member's
122
124
  dispatch. Cross-model review through a standing Claude session works as before.
@@ -136,7 +138,9 @@ just fleet deps
136
138
  just fleet doctor
137
139
 
138
140
  # 3. Remove the orphaned Claude Code install by hand, after reviewing it.
139
- # Keep .claude/hooks/ if you use the coms bridge.
141
+ # The coms-bridge Stop hook now lives in .pi/agent-fleet/hooks/, so a
142
+ # leftover .claude/hooks/coms-stop-hook.mjs is safe to drop once
143
+ # .claude/settings.json points at the new path.
140
144
  rm -rf .claude/commands .claude/skills .claude/agents .claude/references
141
145
  rm -f .claude/orchestrate-teams.yaml
142
146
  rm -rf .claude-plugin
@@ -358,8 +358,15 @@ bridge — the one way Claude Code takes part in a fleet. See
358
358
 
359
359
  Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
360
360
  is what gives a bridged pane exact turn text instead of scraped output.
361
- Registering that hook in `.claude/settings.json` stays the user's step — the
362
- installer writes files, and another tool's settings file is not its to merge.
361
+ The hook installs to `.pi/agent-fleet/hooks/coms-stop-hook.mjs` with the rest
362
+ of the fleet runtime. Registering it in `.claude/settings.json` stays the
363
+ user's step — the installer writes files, and another tool's settings file is
364
+ not its to merge. `setup` prints this snippet when the hook is applied:
365
+
366
+ ```json
367
+ { "hooks": { "Stop": [{ "hooks": [{ "type": "command",
368
+ "command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }] } }
369
+ ```
363
370
 
364
371
  ## Templates
365
372
 
@@ -24,9 +24,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
24
24
 
25
25
  | Piece | File | Role |
26
26
  |---|---|---|
27
- | Bridge daemon | `scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
28
- | Envelope CLI | `scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
29
- | Stop hook | `hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
27
+ | Bridge daemon | `.pi/agent-fleet/scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
28
+ | Envelope CLI | `.pi/agent-fleet/scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
29
+ | Stop hook | `.pi/agent-fleet/hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
30
30
  | Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
31
31
  | Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just fleet team` spawns the Claude CLI + its bridge in one pane (`_claude-peer` internally); `model:` maps to `claude --model`, and `just fleet resume` maps the Herdr-captured session id to `claude --resume`. |
32
32
 
@@ -35,8 +35,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
35
35
  The stable `claude-bridge` setup feature selects `peer-coms` and its
36
36
  `coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
37
37
  claude-bridge --yes` (or select it interactively); it puts both halves in place:
38
- `.pi/skills/peer-coms/` and `.claude/hooks/coms-stop-hook.mjs`. The hook file lands under
39
- `.claude/` deliberately — that is where the Claude Code process in the pane looks for it.
38
+ `.pi/skills/peer-coms/` and `.pi/agent-fleet/hooks/coms-stop-hook.mjs`. The hook ships with
39
+ the rest of the fleet runtime; Claude Code reaches it through `.claude/settings.json`,
40
+ which is the one place it looks for hooks.
40
41
 
41
42
  **Registering the hook stays a manual step.** The installer writes the file; it does not
42
43
  touch `.claude/settings.json`, because that file is the user's own Claude Code
@@ -48,7 +49,7 @@ configuration and merging into it is not something a pi install should decide.
48
49
  {
49
50
  "hooks": {
50
51
  "Stop": [{ "hooks": [{ "type": "command",
51
- "command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
52
+ "command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
52
53
  }
53
54
  }
54
55
  ```
@@ -65,7 +66,7 @@ configuration and merging into it is not something a pi install should decide.
65
66
  `just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
66
67
 
67
68
  ```bash
68
- node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
69
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-claude-bridge.ts --name claude-main
69
70
  # (inside the pane: HERDR_PANE_ID is inherited; or pass --pane <id>)
70
71
  ```
71
72
 
@@ -76,14 +77,14 @@ just fleet team docs --no-hub # Pi peers up
76
77
  # pane with: bridge (claude-main) + claude
77
78
  just fleet hub # in another pane: the orchestrator
78
79
  # from the hub (or any shell):
79
- node --experimental-strip-types scripts/coms-cli.ts send claude-main \
80
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send claude-main \
80
81
  "Summarize the failing test output in artifacts/test.log" --await --timeout 300000
81
82
  ```
82
83
 
83
84
  And the reverse — Claude Code, mid-task, asking a pi peer:
84
85
 
85
86
  ```bash
86
- node --experimental-strip-types scripts/coms-cli.ts send researcher \
87
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
87
88
  "Where is the retry logic for webhooks? file:line" --await --timeout 300000
88
89
  ```
89
90
 
@@ -29,17 +29,17 @@ Remove `chatgpt-client` from the workspace's desired features as well if it was
29
29
  Run commands from the workspace root, or use an absolute client path:
30
30
 
31
31
  ```sh
32
- node scripts/fleet-codex-client.ts doctor
33
- node scripts/fleet-codex-client.ts sessions --project af
34
- node scripts/fleet-codex-client.ts select --project af --peer orchestrator
35
- node scripts/fleet-codex-client.ts status
36
- node scripts/fleet-codex-client.ts summary
37
- node scripts/fleet-codex-client.ts send --id task-001 --text-file /private/tmp/instruction.txt --wait-ms 1000
38
- node scripts/fleet-codex-client.ts watch --seconds 30
39
- node scripts/fleet-codex-client.ts resync
40
- node scripts/fleet-codex-client.ts replay
41
- node scripts/fleet-codex-client.ts receipts
42
- node scripts/fleet-codex-client.ts detach
32
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts doctor
33
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts sessions --project af
34
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts select --project af --peer orchestrator
35
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts status
36
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts summary
37
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts send --id task-001 --text-file /private/tmp/instruction.txt --wait-ms 1000
38
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts watch --seconds 30
39
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts resync
40
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts replay
41
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts receipts
42
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts detach
43
43
  ```
44
44
 
45
45
  Create the instruction file privately, preserving the human's exact text, and remove it after sending. The client accepts 1–16000 bytes. Do not put literal user text into a shell command. Use a distinct command ID for each new instruction, and reuse the same ID after an uncertain tool outcome. The same ID with different text or target is refused. `--wait-ms` accepts 100–60000; the default is 1000. The local reply listener exists only for that invocation.
@@ -51,8 +51,8 @@ Create the instruction file privately, preserving the human's exact text, and re
51
51
  ## Machine-readable operations (T14)
52
52
 
53
53
  ```sh
54
- node scripts/fleet-codex-client.ts --help
55
- node scripts/fleet-codex-client.ts describe
54
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts --help
55
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts describe
56
56
  ```
57
57
 
58
58
  Both commands return JSON with `schemaVersion:1`, the client name, and 16 operation descriptors. Each descriptor includes `name`, `description`, generated `usage`, `inputSchema` (properties, required flags, numeric ranges/defaults and ID patterns), `effects.remote`, `effects.local`, `requirements`, and `limitations`. The descriptor module drives help and CLI flag validation, including required flags, unknown/duplicate flags and numeric limits. Operation-specific checks such as file ownership and current question flags still run at execution.
@@ -68,11 +68,11 @@ For Fleet/Hub commands, use the existing [Hub documentation](../.pi/harnesses/ag
68
68
  The client can explicitly read and answer the selected Pi peer's pending `ask_user` calls when that peer runs the updated `ask-user-remote` wrapper and coms/Hub harness. These requests use the existing session-specific coms socket and bypass the LLM instruction queue. An older runtime reports `unsupported`; updating client files alone does not update a running Pi process.
69
69
 
70
70
  ```sh
71
- node scripts/fleet-codex-client.ts questions
72
- node scripts/fleet-codex-client.ts questions --after <nextCursor>
73
- node scripts/fleet-codex-client.ts answer --id answer-001 --question <question-id> --answer-file /private/tmp/answer.json
74
- node scripts/fleet-codex-client.ts cancel-question --id cancel-001 --question <question-id>
75
- node scripts/fleet-codex-client.ts receipts
71
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts questions
72
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts questions --after <nextCursor>
73
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts answer --id answer-001 --question <question-id> --answer-file /private/tmp/answer.json
74
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts cancel-question --id cancel-001 --question <question-id>
75
+ node .pi/agent-fleet/scripts/fleet-codex-client.ts receipts
76
76
  ```
77
77
 
78
78
  The private JSON file must use the exact human response: `{"kind":"selection","selections":["BG"]}` or `{"kind":"freeform","text":"Human text"}`. Selection may include `comment` only when permitted. Effective `allowMultiple`, `allowFreeform` and `allowComment` are returned with the question and checked in Pi. Use `cancel-question` for an explicit human refusal; never translate refusal into an arbitrary option. File ownership, symlink and size checks are the same as instruction files. Remove the private file after use.