@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,192 @@
1
+ ---
2
+ name: using-agent-skills
3
+ description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
4
+ ---
5
+
6
+ # Using Agent Skills
7
+
8
+ ## Overview
9
+
10
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
11
+
12
+ ## Skill Discovery
13
+
14
+ When a task arrives, identify the development phase and apply the corresponding skill:
15
+
16
+ ```
17
+ Task arrives
18
+ │
19
+ ├── Don't know what you want yet? ──────→ interview-me
20
+ ├── Have a rough concept, need variants? → idea-refine
21
+ ├── New project/feature/change? ──→ spec-driven-development
22
+ ├── No quality bar written down? ──→ constraint-driven-development
23
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
24
+ ├── Implementing code? ────────────→ incremental-implementation
25
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
26
+ │ ├── API work? ────────────────→ api-and-interface-design
27
+ │ ├── Need better context? ─────→ context-engineering
28
+ │ ├── Need doc-verified code? ───→ source-driven-development
29
+ │ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
30
+ ├── Writing/running tests? ────────→ test-driven-development
31
+ │ └── Browser-based? ───────────→ browser-testing-with-devtools
32
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
33
+ ├── Reviewing code? ───────────────→ code-review-and-quality
34
+ │ ├── Too complex? ─────────────→ code-simplification
35
+ │ ├── Security concerns? ───────→ security-and-hardening
36
+ │ └── Performance concerns? ────→ performance-optimization
37
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
38
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
39
+ ├── Deprecating/migrating? ────────→ deprecation-and-migration
40
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
41
+ ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
42
+ └── Deploying/launching? ─────────→ shipping-and-launch
43
+ ```
44
+
45
+ ## Core Operating Behaviors
46
+
47
+ These behaviors apply at all times, across all skills. They are non-negotiable.
48
+
49
+ ### 1. Surface Assumptions
50
+
51
+ Before implementing anything non-trivial, explicitly state your assumptions:
52
+
53
+ ```
54
+ ASSUMPTIONS I'M MAKING:
55
+ 1. [assumption about requirements]
56
+ 2. [assumption about architecture]
57
+ 3. [assumption about scope]
58
+ → Correct me now or I'll proceed with these.
59
+ ```
60
+
61
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
62
+
63
+ ### 2. Manage Confusion Actively
64
+
65
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
66
+
67
+ 1. **STOP.** Do not proceed with a guess.
68
+ 2. Name the specific confusion.
69
+ 3. Present the tradeoff or ask the clarifying question.
70
+ 4. Wait for resolution before continuing.
71
+
72
+ **Bad:** Silently picking one interpretation and hoping it's right.
73
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
74
+
75
+ ### 3. Push Back When Warranted
76
+
77
+ You are not a yes-machine. When an approach has clear problems:
78
+
79
+ - Point out the issue directly
80
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
81
+ - Propose an alternative
82
+ - Accept the human's decision if they override with full information
83
+
84
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
85
+
86
+ ### 4. Enforce Simplicity
87
+
88
+ Your natural tendency is to overcomplicate. Actively resist it.
89
+
90
+ Before finishing any implementation, ask:
91
+ - Can this be done in fewer lines?
92
+ - Are these abstractions earning their complexity?
93
+ - Would a staff engineer look at this and say "why didn't you just..."?
94
+
95
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
96
+
97
+ ### 5. Maintain Scope Discipline
98
+
99
+ Touch only what you're asked to touch.
100
+
101
+ Do NOT:
102
+ - Remove comments you don't understand
103
+ - "Clean up" code orthogonal to the task
104
+ - Refactor adjacent systems as a side effect
105
+ - Delete code that seems unused without explicit approval
106
+ - Add features not in the spec because they "seem useful"
107
+
108
+ Your job is surgical precision, not unsolicited renovation.
109
+
110
+ ### 6. Verify, Don't Assume
111
+
112
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
113
+
114
+ Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
115
+
116
+ ## Failure Modes to Avoid
117
+
118
+ These are the subtle errors that look like productivity but create problems:
119
+
120
+ 1. Making wrong assumptions without checking
121
+ 2. Not managing your own confusion — plowing ahead when lost
122
+ 3. Not surfacing inconsistencies you notice
123
+ 4. Not presenting tradeoffs on non-obvious decisions
124
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
125
+ 6. Overcomplicating code and APIs
126
+ 7. Modifying code or comments orthogonal to the task
127
+ 8. Removing things you don't fully understand
128
+ 9. Building without a spec because "it's obvious"
129
+ 10. Skipping verification because "it looks right"
130
+
131
+ ## Skill Rules
132
+
133
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
134
+
135
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
136
+
137
+ 3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
138
+
139
+ 4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
140
+
141
+ ## Lifecycle Sequence
142
+
143
+ For a complete feature, the typical skill sequence is:
144
+
145
+ ```
146
+ 1. interview-me → Extract what the user actually wants
147
+ 2. idea-refine → Refine vague ideas
148
+ 3. spec-driven-development → Define what we're building
149
+ 4. planning-and-task-breakdown → Break into verifiable chunks
150
+ 5. context-engineering → Load the right context
151
+ 6. source-driven-development → Verify against official docs
152
+ 7. incremental-implementation → Build slice by slice
153
+ 8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
154
+ 9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
155
+ 10. test-driven-development → Prove each slice works
156
+ 11. code-review-and-quality → Review before merge
157
+ 12. code-simplification → Reduce unnecessary complexity while preserving behavior
158
+ 13. git-workflow-and-versioning → Clean commit history
159
+ 14. documentation-and-adrs → Document decisions
160
+ 15. deprecation-and-migration → Retire old systems and move users safely when needed
161
+ 16. shipping-and-launch → Deploy safely
162
+ ```
163
+
164
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
165
+
166
+ ## Quick Reference
167
+
168
+ | Phase | Skill | One-Line Summary |
169
+ |-------|-------|-----------------|
170
+ | Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
171
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
172
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
173
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
174
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
175
+ | Build | source-driven-development | Verify against official docs before implementing |
176
+ | Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
177
+ | Build | context-engineering | Right context at the right time |
178
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
179
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
180
+ | Verify | test-driven-development | Failing test first, then make it pass |
181
+ | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
182
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
183
+ | Review | code-review-and-quality | Five-axis review with quality gates |
184
+ | Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
185
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
186
+ | Review | performance-optimization | Measure first, optimize only what matters |
187
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
188
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
189
+ | Ship | deprecation-and-migration | Remove old systems and migrate users safely |
190
+ | Ship | documentation-and-adrs | Document the why, not just the what |
191
+ | Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
192
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
package/CHANGELOG.md CHANGED
@@ -1,5 +1,44 @@
1
1
  # Agent Fleet changelog
2
2
 
3
+ ## 2.0.8
4
+
5
+ ### Patch Changes
6
+
7
+ - de60585: Install the whole fleet runtime under `.pi/`, leaving a workspace with five root entries instead of ten.
8
+
9
+ A `--preset full` install used to scatter 90 files across `scripts/`, `agents/`, `hermes/`, `docs/` and `.claude/hooks/` at the root of the project it was installed into. They now land under `.pi/agent-fleet/` (`scripts/`, `hermes/`, `hooks/`, `docs/`) and `.pi/agents/personas/`, so a fresh install leaves `.agents/ .ai/ .pi/ justfile` plus your `.env` and nothing else. `.agents/skills/fleet-session-client/` deliberately stays where it is — that path is the external Codex/ChatGPT client's own discovery convention, not ours to move.
10
+
11
+ **The old files are retired for you.** Changing where an item installs changes its binding, and `setup` already removes recorded files that leave a binding — byte-identical copies only. A file you edited is kept, becomes yours, and is reported by name; `verify` now summarises a relocation in one finding ("19 item(s) moved: 111 old file(s) to remove, 2 kept") instead of one finding per path, with the full list still under `items[].obsoleteFiles`. Run `agent-fleet setup` once and the move is done; the state file's `schemaVersion` goes 1 → 2 as the marker for it.
12
+
13
+ Two things worth knowing:
14
+
15
+ - **Personas.** They install to `.pi/agents/personas/<name>.md`. `agents/` and `.claude/agents/` remain yours and are still scanned _first_, so a persona you wrote keeps overriding ours; if one of your copies of a fleet persona survives the upgrade, `verify` says so rather than letting it silently shadow the installed one.
16
+ - **The Claude Code bridge Stop hook.** It moves from `.claude/hooks/` to `.pi/agent-fleet/hooks/`. Claude Code finds hooks only through `.claude/settings.json`, where the command is a free-form shell string, so nothing breaks until you re-point it — `setup` now prints the snippet with the new path. Nothing installs under `.claude/` any more.
17
+
18
+ Three guards keep the layout from drifting back: every relative import in the repository is resolved against disk, shipped code and data may not name a retired root, and the markdown that installs into a workspace — the part agents read and act on — is checked for stale paths too.
19
+
20
+ - 70c2732: Restore four reference documents that a docs cleanup removed by mistake, and guard the allowlist against the next one.
21
+
22
+ `docs/MIGRATION-agent-fleet.md`, `docs/claude-code-coms-bridge.md`, `docs/coms-hermes-bridge.md` and `docs/codex-session-bridge.md` are part of the published surface — all four are named in `package.json`'s `files` allowlist — but they were deleted alongside a batch of genuinely obsolete planning drafts. `npm pack` ships nothing for an allowlist entry that matches no file and says nothing about it, so the loss surfaced only as two failing tests and 26 dangling links across the README, `CLAUDE.md`, `AGENTS.md` and the docs tree.
23
+
24
+ The restored copies predate the `.pi/` runtime relocation, so they carry the same path rewrite the surviving docs already got: runtime scripts under `.pi/agent-fleet/scripts/`, and the coms-bridge Stop hook at `.pi/agent-fleet/hooks/coms-stop-hook.mjs` rather than `.claude/hooks/`.
25
+
26
+ Two guards now cover the failure mode: every literal markdown entry in the `files` allowlist must exist on disk, and every relative link in the public docs must resolve.
27
+
28
+ - 17535af: Update the vendored upstream skill library to `addyosmani/agent-skills@6ca0cd7` and add `constraint-driven-development`.
29
+
30
+ **New skill and command.** `constraint-driven-development` (phase: Plan) records a project's quality bar as numbers with stated reasons in `CONSTRAINTS.md` and guards the diff against a quietly lowered bar — new suppressions, skipped or deleted tests, stripped assertions, unimplemented stubs, thresholds edited down. It ships with a skill-local `references/floor-guard.md` reference implementation. The new `/af-constraints` command drives it in two modes: `setup` runs the four-question interview and writes the file; `check` runs the guard over the current diff with no interview. In a Fleet project the two halves stay apart on purpose — `CONSTRAINTS.md` holds the dimensions, numbers, and reasoning; `quality:` under `## workflows` stays the single executable gate that `just flow` obeys.
31
+
32
+ **Substantially expanded skills.** `performance-optimization` gains a keep-or-revert verification step, regression budgets, and deeper index, connection-pool, and cache-correctness material. `security-and-hardening` gains a Data Privacy & Compliance section, destructive-operations-on-derived-paths guidance, and shared-store rate limiting. `api-and-interface-design` gains idempotency-key handling. `context-engineering` gains Context Budget Management. `spec-driven-development` gains a Phase 0 scope check with a capability map, adapted to Fleet's own spec output location. `observability-and-instrumentation` gains runbook guidance and entry-point stamping. `shipping-and-launch` gains an error-budget release gate.
33
+
34
+ **Planning task list target.** `planning-and-task-breakdown` now defines a single task list target, selected by the existing `todo` override key, which accepts a third value: `tracker` routes tasks to a designated issue tracker instead of a markdown checklist. It also refuses to overwrite a plan that still has unchecked tasks for different work.
35
+
36
+ **Reference link resolution fixed.** Shared checklists are now addressed as `../../references/<file>.md`, which is what resolves from an installed skill at `.pi/skills/<name>/`. The previous `references/<file>.md` form pointed nowhere. Skill-local `references/` subdirectories keep the relative form.
37
+
38
+ **Shadow cleanup.** `code-review-and-quality`, `deprecation-and-migration`, `frontend-ui-engineering`, `performance-optimization`, and `security-and-hardening` were carrying no Agent Fleet customization — only stale upstream text — and are now synchronized verbatim with the vendored copies.
39
+
40
+ **Install manifest fix.** `companion:fleet-client-runtime` no longer lists a deleted documentation file as a source, which was failing manifest validation and every test that loads the real manifest.
41
+
3
42
  ## 2.0.7
4
43
 
5
44
  ### Patch Changes
package/README.md CHANGED
@@ -283,7 +283,7 @@ flowchart LR
283
283
  **Prerequisites:** Hermes v0.19.0+ (the `hermes` CLI on `PATH`, plus the Desktop app), this repo checked out, and a fleet that has run at least once (so `~/.pi/coms/projects/` exists). [herdr](https://herdr.dev) is optional — without it every row reads `unknown` instead of a live state.
284
284
 
285
285
  ```bash
286
- scripts/install-hermes-plugin.sh agent-fleet-herdr
286
+ .pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr
287
287
  ```
288
288
 
289
289
  That one command backs up `config.yaml`, symlinks **both halves** into the profile (`plugins/` for the FastAPI backend, `desktop-plugins/` for the pane), runs `hermes plugins enable`, and verifies the result — then **prints** the restart steps instead of performing them, because restarting a live gateway is your call:
@@ -303,10 +303,10 @@ just fleet --agents default --peers default # monitored Hub + peers; nothing
303
303
  <summary><b>Options and verification</b></summary>
304
304
 
305
305
  ```bash
306
- scripts/install-hermes-plugin.sh agent-fleet-herdr --profile dev # a non-default profile
307
- scripts/install-hermes-plugin.sh agent-fleet-herdr --copy # no symlinks
308
- scripts/install-hermes-plugin.sh agent-fleet-herdr --dry-run # print, change nothing
309
- scripts/install-hermes-plugin.sh agent-fleet-herdr --uninstall
306
+ .pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr --profile dev # a non-default profile
307
+ .pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr --copy # no symlinks
308
+ .pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr --dry-run # print, change nothing
309
+ .pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr --uninstall
310
310
  ```
311
311
 
312
312
  Working install: `~/.hermes/logs/gui.log` contains `Mounted plugin API routes: /api/plugins/agent-fleet-herdr/` at Desktop start, and `/capabilities` reports both sources. An empty panel with no error means the enable gate 404'd — that is documented, along with every other failure mode that looks identical from the outside, in the runbook.
@@ -319,7 +319,7 @@ Working install: `~/.hermes/logs/gui.log` contains `Mounted plugin API routes: /
319
319
 
320
320
  Separately from the panel, the **Hermes relay** pipes an agent's `ask_user` question — choices intact, not flattened into a message — to Telegram, and races your phone's answer against a local one. Whichever arrives first wins; the fleet keeps working meanwhile.
321
321
 
322
- See [docs/coms-hermes-bridge.md](docs/coms-hermes-bridge.md) and the [screenshots](hermes/README.md#integration-in-action).
322
+ See [docs/coms-hermes-bridge.md](docs/coms-hermes-bridge.md) and the [screenshots](.pi/agent-fleet/hermes/README.md#integration-in-action).
323
323
 
324
324
  <details>
325
325
  <summary><b>Experimental: ChatGPT Desktop/Android session client</b></summary>
@@ -391,6 +391,7 @@ Slash commands map to the development lifecycle; each activates the right skills
391
391
  |-------------------|---------|---------------|
392
392
  | Define what to build | `/af-spec` | Spec before code |
393
393
  | Plan how to build it | `/af-plan` | Small, atomic tasks |
394
+ | Set (or check) the quality bar | `/af-constraints` | Numbers with reasons, guarded against quiet lowering |
394
395
  | Build incrementally | `/af-build` | One slice at a time (`auto` runs the whole plan in one approved pass) |
395
396
  | Prove it works | `/af-test` | Tests are proof |
396
397
  | Review before merge | `/af-review` | Improve code health |
@@ -400,10 +401,10 @@ Slash commands map to the development lifecycle; each activates the right skills
400
401
  | Orchestrate a team | *agent-hub harness* | The hub drives a config-defined roster |
401
402
  | Capture session lessons | `/af-compound` *(agent-hub)* | Every session improves the next |
402
403
 
403
- Under the hood are **29 skills** — each a structured workflow with steps, verification gates, and anti-rationalization tables (never vague advice). Skills also activate automatically from what you're doing: designing an API triggers `api-and-interface-design`, building UI triggers `frontend-ui-engineering`.
404
+ Under the hood are **30 skills** — each a structured workflow with steps, verification gates, and anti-rationalization tables (never vague advice). Skills also activate automatically from what you're doing: designing an API triggers `api-and-interface-design`, building UI triggers `frontend-ui-engineering`.
404
405
 
405
406
  - **Define:** [interview-me](skills/interview-me/SKILL.md) · [idea-refine](skills/idea-refine/SKILL.md) · [spec-driven-development](skills/spec-driven-development/SKILL.md)
406
- - **Plan:** [planning-and-task-breakdown](skills/planning-and-task-breakdown/SKILL.md)
407
+ - **Plan:** [planning-and-task-breakdown](skills/planning-and-task-breakdown/SKILL.md) · [constraint-driven-development](skills/constraint-driven-development/SKILL.md)
407
408
  - **Build:** [incremental-implementation](skills/incremental-implementation/SKILL.md) · [test-driven-development](vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md) · [context-engineering](skills/context-engineering/SKILL.md) · [source-driven-development](vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md) · [doubt-driven-development](vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md) · [frontend-ui-engineering](skills/frontend-ui-engineering/SKILL.md) · [api-and-interface-design](vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md)
408
409
  - **Verify:** [browser-testing-with-devtools](skills/browser-testing-with-devtools/SKILL.md) · [debugging-and-error-recovery](vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md)
409
410
  - **Review:** [code-review-and-quality](skills/code-review-and-quality/SKILL.md) · [code-simplification](vendor/agent-skills-upstream/skills/code-simplification/SKILL.md) · [security-and-hardening](skills/security-and-hardening/SKILL.md) · [performance-optimization](skills/performance-optimization/SKILL.md)
@@ -421,7 +422,7 @@ Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/ski
421
422
 
422
423
  15 pre-configured specialist personas live in [`agents/`](agents/) — reusable subagent definitions your coding agent delegates work to: `planner`, `plan-reviewer`, `builder`, `code-reviewer`, `test-engineer`, `security-auditor`, `web-performance-auditor`, `documenter`, `architect`, `releaser`, `researcher`, `deep-researcher`, plus the pi-only `bowser`, `web-debugger`, and `orchestrator`.
423
424
 
424
- Each persona is one Markdown file in pi's own frontmatter dialect, installed verbatim — there is no per-agent translation step. Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub.
425
+ Each persona is one Markdown file in pi's own frontmatter dialect, installed verbatim to `.pi/agents/personas/` in your workspace — there is no per-agent translation step. A persona you write yourself in `agents/` or `.claude/agents/` is scanned first and wins over an installed one of the same name. Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub.
425
426
 
426
427
  Full roster, skill hooks, install matrix, and team composition: **[docs/agents.md](docs/agents.md)**.
427
428
 
@@ -2,30 +2,31 @@
2
2
  "version": 1,
3
3
  "description": "Runtime closure refreshed with any pi harness selection. Paths are repository-relative and contain no user configuration or credentials.",
4
4
  "directories": [
5
- "hermes/skills"
5
+ ".pi/agent-fleet/hermes/skills"
6
6
  ],
7
7
  "files": [
8
8
  "justfile",
9
- "scripts/claude-code-preflight.ts",
10
- "scripts/coms-claude-bridge.ts",
11
- "scripts/coms-cli.ts",
12
- "scripts/coms-hermes-bridge.ts",
13
- "scripts/fleet.ts",
14
- "scripts/peer-banner.ts",
15
- "scripts/peer-launch.ts",
16
- "scripts/team-snapshot.ts",
17
- "scripts/team-up.ts",
18
- "scripts/lib/claude-bridge-core.ts",
19
- "scripts/lib/coms-envelope.ts",
20
- "scripts/lib/fleet-command.ts",
21
- "scripts/lib/herdr-layout.ts",
22
- "scripts/lib/hermes-bridge-core.ts",
23
- "scripts/lib/monitor-env.ts",
24
- "scripts/lib/peer-launch.ts",
25
- "scripts/lib/persona-banner.ts",
26
- "scripts/lib/runtime-dependencies.js",
27
- "scripts/lib/spawn-stagger.ts",
28
- "scripts/lib/team-project.ts",
29
- "scripts/lib/team-snapshot.ts"
9
+ ".pi/agent-fleet/scripts/claude-code-preflight.ts",
10
+ ".pi/agent-fleet/scripts/coms-claude-bridge.ts",
11
+ ".pi/agent-fleet/scripts/coms-cli.ts",
12
+ ".pi/agent-fleet/scripts/coms-hermes-bridge.ts",
13
+ ".pi/agent-fleet/scripts/fleet.ts",
14
+ ".pi/agent-fleet/scripts/lib/claude-bridge-core.ts",
15
+ ".pi/agent-fleet/scripts/lib/coms-envelope.ts",
16
+ ".pi/agent-fleet/scripts/lib/fleet-command.ts",
17
+ ".pi/agent-fleet/scripts/lib/herdr-layout.ts",
18
+ ".pi/agent-fleet/scripts/lib/hermes-bridge-core.ts",
19
+ ".pi/agent-fleet/scripts/lib/monitor-env.ts",
20
+ ".pi/agent-fleet/scripts/lib/peer-launch.ts",
21
+ ".pi/agent-fleet/scripts/lib/persona-banner.ts",
22
+ ".pi/agent-fleet/scripts/lib/persona-dirs.ts",
23
+ ".pi/agent-fleet/scripts/lib/runtime-dependencies.js",
24
+ ".pi/agent-fleet/scripts/lib/spawn-stagger.ts",
25
+ ".pi/agent-fleet/scripts/lib/team-project.ts",
26
+ ".pi/agent-fleet/scripts/lib/team-snapshot.ts",
27
+ ".pi/agent-fleet/scripts/peer-banner.ts",
28
+ ".pi/agent-fleet/scripts/peer-launch.ts",
29
+ ".pi/agent-fleet/scripts/team-snapshot.ts",
30
+ ".pi/agent-fleet/scripts/team-up.ts"
30
31
  ]
31
32
  }
package/bin/cli.js CHANGED
@@ -32,7 +32,7 @@ import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
32
32
  import { checkAndNotify } from "./lib/update-notifier.js";
33
33
  import { setHermesTelegram, runHermesCommand } from "./lib/set-hermes-telegram.js";
34
34
  import { setHermesWatchdog } from "./lib/set-hermes-watchdog.js";
35
- import { runtimeDependencyFindings } from "../scripts/lib/runtime-dependencies.js";
35
+ import { runtimeDependencyFindings } from "../.pi/agent-fleet/scripts/lib/runtime-dependencies.js";
36
36
 
37
37
  const __dirname = dirname(fileURLToPath(import.meta.url));
38
38
  const pkgRoot = resolve(__dirname, "..");
@@ -355,6 +355,7 @@ async function cmdSetup() {
355
355
  if (opts["allow-exec"] && result.exitCode === 0) result = { ...result, retryRuntimeRepair: retryRuntimeRepairs({ workspace, manifest, output: execOutput }) };
356
356
  if (opts.json) writeJson(publicResult(result));
357
357
  else if (result.exitCode === 0) {
358
+ printComsStopHookSnippet(result.results);
358
359
  const missing = runtimeDependencyFindings({ workspace });
359
360
  console.log(missing.length ? "Files installed; runtime dependencies are missing or unverified. Next: just fleet deps, then just fleet doctor." : "Files installed; existing readiness checks passed.");
360
361
  } else console.log(result.failure?.detail ?? "Setup incomplete.");
@@ -842,6 +843,7 @@ function printApplied(plan, applied) {
842
843
  }
843
844
 
844
845
  printOperatorSteps(plan.actions);
846
+ printComsStopHookSnippet(applied.results);
845
847
 
846
848
  printSection("Summary");
847
849
  console.log(
@@ -985,6 +987,27 @@ function isGitignored(workspace, path) {
985
987
  });
986
988
  }
987
989
 
990
+ /**
991
+ * The bridge Stop hook is a plain file the engine installs, but Claude Code
992
+ * only runs it once it is named in `.claude/settings.json` — a file the engine
993
+ * never touches. The path moved with the rest of the fleet runtime, so print
994
+ * the snippet with the current path rather than leaving the operator to guess.
995
+ */
996
+ function printComsStopHookSnippet(results) {
997
+ // Declared inside the function: this module runs its command at top level,
998
+ // so a const below that line is still in the temporal dead zone when the
999
+ // printers run.
1000
+ const rel = ".pi/agent-fleet/hooks/coms-stop-hook.mjs";
1001
+ const installed = (results ?? []).some(
1002
+ (r) => r.id === "hook:coms-stop-hook" && !["not-reached", "skipped"].includes(r.status),
1003
+ );
1004
+ if (!installed) return;
1005
+ printSection("Register the bridge Stop hook yourself");
1006
+ console.log(" Claude Code reads hooks from .claude/settings.json only. Add:");
1007
+ console.log(' { "hooks": { "Stop": [{ "hooks": [{ "type": "command",');
1008
+ console.log(` "command": "node $CLAUDE_PROJECT_DIR/${rel}" }] }] } }`);
1009
+ }
1010
+
988
1011
  function printOperatorSteps(actions) {
989
1012
  const external = actions.filter((a) => a.kind === "external");
990
1013
  const operator = actions.filter((a) => a.kind === "operator");
package/bin/lib/apply.js CHANGED
@@ -33,6 +33,7 @@ import { renderDesired } from "./desired.js";
33
33
  import {
34
34
  readState, writeState, emptyState, hashFile, hashText, walkTree,
35
35
  inspectPath, isInside, linkPointsInside, STATE_REL_PATH, LEGACY_RECORD_REL_PATH,
36
+ STATE_SCHEMA_VERSION,
36
37
  } from "./state.js";
37
38
 
38
39
  export const APPLY_SCHEMA_VERSION = 1;
@@ -131,7 +132,10 @@ function applyImmediate({ plan, manifest, now = () => new Date().toISOString() }
131
132
  });
132
133
  // The pass re-stamps identity: an install can change agent, method, or the
133
134
  // package doing the writing, and a stale header would misdirect every later
134
- // comparison.
135
+ // comparison. schemaVersion travels with it — this pass has just reconciled
136
+ // the workspace against the current binding, which is exactly what the
137
+ // version asserts.
138
+ state.schemaVersion = STATE_SCHEMA_VERSION;
135
139
  state.agent = agent;
136
140
  state.method = method;
137
141
  state.sourceRoot = sourceRoot;
@@ -713,7 +717,7 @@ function clearTarget(abs) {
713
717
  * only if it is empty", which is exactly the rule wanted here — ENOTEMPTY stops
714
718
  * the walk and the user's files stay.
715
719
  */
716
- function pruneEmptyDirs(workspace, relPaths) {
720
+ export function pruneEmptyDirs(workspace, relPaths) {
717
721
  const dirs = [...new Set(relPaths.map((p) => dirname(p)))].sort((a, b) => b.length - a.length);
718
722
  for (const rel of dirs) {
719
723
  let dir = resolve(workspace, rel);
@@ -2,7 +2,7 @@
2
2
  //
3
3
  // pi is the only coding agent Agent Fleet installs for. Claude Code still
4
4
  // appears in the fleet, but strictly as a coms peer driven by
5
- // scripts/coms-claude-bridge.ts — never as an install target. See
5
+ // .pi/agent-fleet/scripts/coms-claude-bridge.ts — never as an install target. See
6
6
  // docs/claude-code-coms-bridge.md.
7
7
  //
8
8
  // The list and the detection hook stay because the manifest, the state file,
package/bin/lib/doctor.js CHANGED
@@ -34,7 +34,7 @@ import { homedir } from "node:os";
34
34
  import { parse as parseYaml } from "yaml";
35
35
  import { validateOverrides } from "./validate-overrides.js";
36
36
  import { readState, STATE_REL_PATH } from "./state.js";
37
- import { runtimeDependencyFindings } from "../../scripts/lib/runtime-dependencies.js";
37
+ import { runtimeDependencyFindings } from "../../.pi/agent-fleet/scripts/lib/runtime-dependencies.js";
38
38
 
39
39
  export const AGENT_FLEET_PACKAGE_NAME = "@chankov/agent-fleet";
40
40
  const AGENT_FLEET_PACKAGE_PATTERN = /(^|[/:])@chankov\/agent-fleet(@[^/]*)?$/;
@@ -210,7 +210,7 @@ function escapeRe(s) {
210
210
  }
211
211
 
212
212
  // Scan peers.yaml for field lines that sit under a team heading before any
213
- // `- name: ...` list item. scripts/team-up.ts parses this file with a minimal
213
+ // `- name: ...` list item. .pi/agent-fleet/scripts/team-up.ts parses this file with a minimal
214
214
  // hand-rolled parser that only attaches `key: value` lines to the CURRENT list
215
215
  // item — an orphan field block (typically a peer whose leading `- name:` line
216
216
  // was lost in an edit) is dropped without an error and the peer silently
@@ -566,7 +566,7 @@ export function scanPiPackageOwnership({ workspace, sourceRoot, home = homedir()
566
566
  }];
567
567
  }
568
568
 
569
- const AGENT_DIRS = ["agents", ".claude/agents", ".pi/agents"];
569
+ const AGENT_DIRS = ["agents", ".claude/agents", ".pi/agents/personas", ".pi/agents"];
570
570
  const VOICES_REL = ".pi/agents/voices.yaml";
571
571
 
572
572
  /**
@@ -17,7 +17,7 @@
17
17
  import { readdirSync, existsSync, readFileSync } from "node:fs";
18
18
  import { join } from "node:path";
19
19
 
20
- import { listPersonas, targetRelPath } from "./personas.js";
20
+ import { listPersonas, targetRelPath, legacyTargetRelPaths } from "./personas.js";
21
21
 
22
22
  export const MANIFEST_SCHEMA_VERSION = 2;
23
23
  export const SNAPSHOT_SCHEMA_VERSIONS = new Set([1, 2]);
@@ -201,6 +201,11 @@ function derivePersonas(sourceRoot, meta) {
201
201
  source: [`agents/${name}.md`],
202
202
  target: targetRelPath(name).split("\\").join("/"),
203
203
  strategy: "copy-file",
204
+ // Personas used to install to `agents/<name>.md`. The binding diff
205
+ // retires that file on its own, but declaring it keeps `verify` honest
206
+ // about a copy the user edited: `scanAgentDirs` reads `agents/` first
207
+ // and would keep serving the stale definition.
208
+ legacyTargets: legacyTargetRelPaths(name).map((rel) => rel.split("\\").join("/")),
204
209
  };
205
210
  }
206
211
  return makeItem(meta, {
@@ -290,16 +295,17 @@ function deriveReferences(sourceRoot, meta) {
290
295
 
291
296
  function deriveHooks(sourceRoot, meta) {
292
297
  const excluded = new Set(meta.exclude?.hooks ?? []);
293
- return filesIn(join(sourceRoot, "hooks"))
298
+ return filesIn(join(sourceRoot, ".pi", "agent-fleet", "hooks"))
294
299
  .filter((f) => (f.endsWith(".sh") || f.endsWith(".mjs")) && !excluded.has(f))
295
300
  .sort()
296
301
  .map((file) => {
297
302
  const name = file.replace(/\.(sh|mjs)$/, "");
298
- // The one hook left is the Claude Code Stop hook the coms bridge reads,
299
- // so it installs under `.claude/` even though the agent is pi: the
300
- // bridged pane is a Claude Code process, and that is where Claude Code
301
- // looks. Registering it in `.claude/settings.json` stays manual —
302
- // docs/claude-code-coms-bridge.md carries the snippet.
303
+ // The one hook left is the Claude Code Stop hook the coms bridge reads.
304
+ // Claude Code finds a hook only through `.claude/settings.json`, where
305
+ // the command is a free-form shell string — so the file itself does not
306
+ // have to sit under `.claude/`, and it lives with the rest of the fleet
307
+ // runtime instead. Registering it stays manual;
308
+ // docs/claude-code-coms-bridge.md carries the snippet with this path.
303
309
  return makeItem(meta, {
304
310
  id: `hook:${name}`,
305
311
  kind: "hook",
@@ -308,9 +314,10 @@ function deriveHooks(sourceRoot, meta) {
308
314
  summary: "",
309
315
  agents: {
310
316
  pi: {
311
- source: [`hooks/${file}`],
312
- target: `.claude/hooks/${file}`,
317
+ source: [`.pi/agent-fleet/hooks/${file}`],
318
+ target: `.pi/agent-fleet/hooks/${file}`,
313
319
  strategy: "copy-file",
320
+ legacyTargets: [`.claude/hooks/${file}`],
314
321
  },
315
322
  },
316
323
  });
@@ -356,11 +363,11 @@ function deriveOperatorItems(sourceRoot, meta) {
356
363
  const out = [];
357
364
 
358
365
  const pluginIds = new Set([
359
- ...dirsIn(join(sourceRoot, "hermes", "plugins")),
360
- ...dirsIn(join(sourceRoot, "hermes", "desktop-plugins")),
366
+ ...dirsIn(join(sourceRoot, ".pi", "agent-fleet", "hermes", "plugins")),
367
+ ...dirsIn(join(sourceRoot, ".pi", "agent-fleet", "hermes", "desktop-plugins")),
361
368
  ]);
362
369
  for (const id of [...pluginIds].sort()) {
363
- const source = ["hermes/plugins", "hermes/desktop-plugins"]
370
+ const source = [".pi/agent-fleet/hermes/plugins", ".pi/agent-fleet/hermes/desktop-plugins"]
364
371
  .map((root) => `${root}/${id}`)
365
372
  .filter((rel) => existsSync(join(sourceRoot, rel)));
366
373
  out.push(makeItem(meta, {
@@ -374,17 +381,17 @@ function deriveOperatorItems(sourceRoot, meta) {
374
381
  }));
375
382
  }
376
383
 
377
- for (const name of dirsIn(join(sourceRoot, "hermes", "skills")).sort()) {
384
+ for (const name of dirsIn(join(sourceRoot, ".pi", "agent-fleet", "hermes", "skills")).sort()) {
378
385
  out.push(makeItem(meta, {
379
386
  id: `hermes-skill:${name}`,
380
387
  kind: "hermes-skill",
381
388
  group: "hermes",
382
389
  title: name,
383
- summary: frontmatterDescription(join(sourceRoot, "hermes", "skills", name, "SKILL.md")),
390
+ summary: frontmatterDescription(join(sourceRoot, ".pi", "agent-fleet", "hermes", "skills", name, "SKILL.md")),
384
391
  consent: "operator",
385
392
  agents: {
386
393
  pi: {
387
- source: [`hermes/skills/${name}`],
394
+ source: [`.pi/agent-fleet/hermes/skills/${name}`],
388
395
  target: null,
389
396
  targetScope: "hermes-profile",
390
397
  strategy: "operator",
@@ -455,7 +462,7 @@ function deriveCompanions(sourceRoot, meta) {
455
462
  source: [...dirs, ...files],
456
463
  sourceMode: "all",
457
464
  // Every entry keeps its repo-relative path in the workspace, so
458
- // `scripts/lib/team-project.ts` lands where the recipes expect it.
465
+ // `.pi/agent-fleet/scripts/lib/team-project.ts` lands where the recipes expect it.
459
466
  target: null,
460
467
  preserveLayout: true,
461
468
  strategy: "copy-tree",