@chankov/agent-fleet 2.0.6 → 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 (1050) hide show
  1. package/.pi/agent-fleet/hermes/README.md +347 -0
  2. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  3. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  4. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  5. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  6. package/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  7. package/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  8. package/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  9. package/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  10. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  11. package/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  12. package/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  13. package/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  14. package/.pi/agent-fleet/scripts/fleet.ts +216 -0
  15. package/.pi/agent-fleet/scripts/flow.ts +137 -0
  16. package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  17. package/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  18. package/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  19. package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  20. package/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  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/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  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/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  28. package/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  29. package/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  30. package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  31. package/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  32. package/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  33. package/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  34. package/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  35. package/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  36. package/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  37. package/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  38. package/.pi/agent-fleet/scripts/team-up.ts +378 -0
  39. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  40. package/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  41. package/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  42. package/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  43. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  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/README.md +11 -0
  56. package/.pi/harnesses/damage-control-continue/index.ts +5 -0
  57. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  58. package/.pi/harnesses/lib/spawned-peers.js +1 -1
  59. package/.pi/harnesses/lib/update-check.ts +222 -0
  60. package/.pi/prompts/af-constraints.md +31 -0
  61. package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  62. package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
  63. package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
  64. package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
  65. package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
  66. package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
  67. package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
  68. package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
  69. package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
  70. package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
  71. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  72. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  73. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  74. package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  75. package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  76. package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  77. package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  78. package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  79. package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  80. package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
  81. package/.versions/2.0.7/.pi/extensions/package.json +9 -0
  82. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
  83. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  84. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  85. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  86. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  87. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  88. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  89. package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
  90. package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  91. package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  92. package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  93. package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  94. package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  95. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  96. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  97. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  98. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  99. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  100. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  101. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  102. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  103. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  104. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  105. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  106. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  107. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  108. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  109. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  110. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  111. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  112. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  113. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  114. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  115. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  116. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  117. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  118. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  119. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  120. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  121. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  122. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  123. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  124. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  125. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  126. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  127. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  128. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  129. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  130. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  131. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  132. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  133. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  134. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  135. package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  136. package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
  137. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  138. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  139. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  140. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  141. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  142. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  143. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  144. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  145. package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  146. package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  147. package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  148. package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  149. package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  150. package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  151. package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
  152. package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
  153. package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  154. package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
  155. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  156. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  157. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  158. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  159. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  160. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  161. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  162. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  163. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  164. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  165. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  166. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  167. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  168. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  169. package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  170. package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  171. package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  172. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  173. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  174. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  175. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  176. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  177. package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  178. package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
  179. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  180. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  181. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  182. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  183. package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  184. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  185. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  186. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  187. package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  188. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  189. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  190. package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
  191. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
  192. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  193. package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  194. package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  195. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  196. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
  197. package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
  198. package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
  199. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  200. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  201. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  202. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  203. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  204. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  205. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  206. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  207. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  208. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  209. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  210. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  211. package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
  212. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  213. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  214. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  215. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  216. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  217. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  218. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  219. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  220. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  221. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  222. package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
  223. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  224. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  225. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
  226. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
  227. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  228. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  229. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  230. package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
  231. package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
  232. package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
  233. package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
  234. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
  235. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
  236. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  237. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
  238. package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
  239. package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
  240. package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  241. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  242. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  243. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
  244. package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
  245. package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  246. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  247. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  248. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  249. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  250. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  251. package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  252. package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  253. package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
  254. package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  255. package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
  256. package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  257. package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
  258. package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  259. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  260. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  261. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  262. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  263. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  264. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  265. package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
  266. package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
  267. package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
  268. package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
  269. package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
  270. package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
  271. package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
  272. package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
  273. package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  274. package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  275. package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
  276. package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
  277. package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
  278. package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
  279. package/.versions/2.0.7/.version +1 -0
  280. package/.versions/2.0.7/agents/architect.md +25 -0
  281. package/.versions/2.0.7/agents/bowser.md +28 -0
  282. package/.versions/2.0.7/agents/builder.md +56 -0
  283. package/.versions/2.0.7/agents/code-reviewer.md +210 -0
  284. package/.versions/2.0.7/agents/deep-researcher.md +33 -0
  285. package/.versions/2.0.7/agents/documenter.md +23 -0
  286. package/.versions/2.0.7/agents/orchestrator.md +23 -0
  287. package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
  288. package/.versions/2.0.7/agents/planner.md +106 -0
  289. package/.versions/2.0.7/agents/releaser.md +25 -0
  290. package/.versions/2.0.7/agents/researcher.md +31 -0
  291. package/.versions/2.0.7/agents/security-auditor.md +168 -0
  292. package/.versions/2.0.7/agents/test-engineer.md +154 -0
  293. package/.versions/2.0.7/agents/web-debugger.md +44 -0
  294. package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
  295. package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
  296. package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
  297. package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
  298. package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
  299. package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
  300. package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
  301. package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
  302. package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
  303. package/.versions/2.0.7/docs/getting-started.md +126 -0
  304. package/.versions/2.0.7/docs/npm-install.md +327 -0
  305. package/.versions/2.0.7/docs/pi-extensions.md +446 -0
  306. package/.versions/2.0.7/docs/pi-setup.md +76 -0
  307. package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
  308. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  309. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  310. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  311. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  312. package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
  313. package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  314. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  315. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  316. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  317. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  318. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  319. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  320. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  321. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  322. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  323. package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  324. package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  325. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  326. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  327. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  328. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  329. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  330. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  331. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  332. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  333. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  334. package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
  335. package/.versions/2.0.7/install-manifest.json +2886 -0
  336. package/.versions/2.0.7/justfile +247 -0
  337. package/.versions/2.0.7/manifest-meta.json +958 -0
  338. package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
  339. package/.versions/2.0.7/references/communication-contract.md +26 -0
  340. package/.versions/2.0.7/references/definition-of-done.md +67 -0
  341. package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
  342. package/.versions/2.0.7/references/observability-checklist.md +91 -0
  343. package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
  344. package/.versions/2.0.7/references/performance-checklist.md +153 -0
  345. package/.versions/2.0.7/references/prompting-patterns.md +380 -0
  346. package/.versions/2.0.7/references/security-checklist.md +179 -0
  347. package/.versions/2.0.7/references/testing-patterns.md +236 -0
  348. package/.versions/2.0.7/references/workflow-authoring.md +304 -0
  349. package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
  350. package/{scripts → .versions/2.0.7/scripts}/fleet.ts +1 -1
  351. package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  352. package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  353. package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  354. package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
  355. package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  356. package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
  357. package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
  358. package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
  359. package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
  360. package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
  361. package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
  362. package/.versions/2.0.7/scripts/package-lock.json +35 -0
  363. package/.versions/2.0.7/scripts/package.json +9 -0
  364. package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
  365. package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
  366. package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
  367. package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
  368. package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
  369. package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
  370. package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
  371. package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
  372. package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
  373. package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
  374. package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
  375. package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
  376. package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
  377. package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
  378. package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
  379. package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
  380. package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
  381. package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
  382. package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
  383. package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
  384. package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
  385. package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
  386. package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  387. package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
  388. package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
  389. package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  390. package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
  391. package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  392. package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
  393. package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  394. package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  395. package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  396. package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
  397. package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
  398. package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
  399. package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  400. package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  401. package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
  402. package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
  403. package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
  404. package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
  405. package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
  406. package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
  407. package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
  408. package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
  409. package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
  410. package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  411. package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
  412. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  413. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  414. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  415. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  416. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  417. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  418. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  419. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  420. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  421. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  422. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  423. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  424. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  425. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  426. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  427. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  428. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  429. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  430. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  431. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  432. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  433. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  434. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  435. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  436. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  437. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  438. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  439. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  440. package/.versions/2.0.8/.pi/agent-fleet/hermes/README.md +347 -0
  441. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  442. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  443. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  444. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  445. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  446. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  447. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  448. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  449. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  450. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  451. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  452. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  453. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  454. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  455. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  456. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  457. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  458. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  459. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  460. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  461. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  462. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  463. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  464. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  465. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  466. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  467. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  468. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  469. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  470. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  471. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  472. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  473. package/.versions/2.0.8/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  474. package/.versions/2.0.8/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  475. package/.versions/2.0.8/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  476. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  477. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  478. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  479. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  480. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  481. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet.ts +216 -0
  482. package/.versions/2.0.8/.pi/agent-fleet/scripts/flow.ts +137 -0
  483. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  484. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  485. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  486. package/.versions/2.0.8/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  487. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  488. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  489. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  490. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  491. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  492. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  493. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  494. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  495. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  496. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  497. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  498. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  499. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  500. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  501. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  502. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  503. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  504. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  505. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  506. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  507. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  508. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  509. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  510. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  511. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  512. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  513. package/.versions/2.0.8/.pi/agent-fleet/scripts/package-lock.json +35 -0
  514. package/.versions/2.0.8/.pi/agent-fleet/scripts/package.json +9 -0
  515. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  516. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  517. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  518. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-up.ts +378 -0
  519. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  520. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  521. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  522. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  523. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  524. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  525. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  526. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  527. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  528. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  529. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  530. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  531. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  532. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  533. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  534. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  535. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  536. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  537. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  538. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  539. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  540. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  541. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  542. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  543. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  544. package/.versions/2.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  545. package/.versions/2.0.8/.pi/agents/model-profiles.yaml +83 -0
  546. package/.versions/2.0.8/.pi/agents/peers.yaml +147 -0
  547. package/.versions/2.0.8/.pi/agents/teams.yaml +41 -0
  548. package/.versions/2.0.8/.pi/agents/voices.yaml +13 -0
  549. package/.versions/2.0.8/.pi/damage-control-rules.yaml +297 -0
  550. package/.versions/2.0.8/.pi/extensions/btw/README.md +120 -0
  551. package/.versions/2.0.8/.pi/extensions/btw/index.ts +914 -0
  552. package/.versions/2.0.8/.pi/extensions/btw/package.json +6 -0
  553. package/.versions/2.0.8/.pi/extensions/btw/state.js +179 -0
  554. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  555. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  556. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  557. package/.versions/2.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  558. package/.versions/2.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  559. package/.versions/2.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  560. package/.versions/2.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  561. package/.versions/2.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  562. package/.versions/2.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  563. package/.versions/2.0.8/.pi/extensions/package-lock.json +1175 -0
  564. package/.versions/2.0.8/.pi/extensions/package.json +9 -0
  565. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/README.md +205 -0
  566. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  567. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  568. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  569. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  570. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  571. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  572. package/.versions/2.0.8/.pi/harnesses/agent-hub/README.md +1203 -0
  573. package/.versions/2.0.8/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  574. package/.versions/2.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  575. package/.versions/2.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  576. package/.versions/2.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  577. package/.versions/2.0.8/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  578. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  579. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  580. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  581. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  582. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  583. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  584. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  585. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  586. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  587. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  588. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  589. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  590. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  591. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  592. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  593. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  594. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  595. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  596. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  597. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  598. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  599. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  600. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  601. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  602. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  603. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  604. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  605. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  606. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  607. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  608. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  609. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  610. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  611. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  612. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  613. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  614. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  615. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  616. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  617. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  618. package/.versions/2.0.8/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  619. package/.versions/2.0.8/.pi/harnesses/agent-hub/delegate.ts +446 -0
  620. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  621. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  622. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  623. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  624. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  625. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  626. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  627. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  628. package/.versions/2.0.8/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  629. package/.versions/2.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  630. package/.versions/2.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  631. package/.versions/2.0.8/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  632. package/.versions/2.0.8/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  633. package/.versions/2.0.8/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  634. package/.versions/2.0.8/.pi/harnesses/agent-hub/footer.ts +30 -0
  635. package/.versions/2.0.8/.pi/harnesses/agent-hub/helpers.ts +266 -0
  636. package/.versions/2.0.8/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  637. package/.versions/2.0.8/.pi/harnesses/agent-hub/index.ts +2151 -0
  638. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  639. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  640. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  641. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  642. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  643. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  644. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  645. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  646. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  647. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  648. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  649. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  650. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  651. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  652. package/.versions/2.0.8/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  653. package/.versions/2.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  654. package/.versions/2.0.8/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  655. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  656. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  657. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  658. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  659. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  660. package/.versions/2.0.8/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  661. package/.versions/2.0.8/.pi/harnesses/agent-hub/presentation.ts +48 -0
  662. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  663. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  664. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  665. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  666. package/.versions/2.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  667. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  668. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  669. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  670. package/.versions/2.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  671. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  672. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  673. package/.versions/2.0.8/.pi/harnesses/agent-hub/review-findings.js +102 -0
  674. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-budget.js +537 -0
  675. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  676. package/.versions/2.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  677. package/.versions/2.0.8/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  678. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  679. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-start.ts +42 -0
  680. package/.versions/2.0.8/.pi/harnesses/agent-hub/spawn.ts +404 -0
  681. package/.versions/2.0.8/.pi/harnesses/agent-hub/timeline.ts +54 -0
  682. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  683. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  684. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  685. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  686. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  687. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  688. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  689. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  690. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  691. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  692. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  693. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  694. package/.versions/2.0.8/.pi/harnesses/agent-hub/types.ts +63 -0
  695. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  696. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  697. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  698. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  699. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  700. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  701. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  702. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  703. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  704. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  705. package/.versions/2.0.8/.pi/harnesses/agent-hub/version.ts +42 -0
  706. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  707. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  708. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/README.md +59 -0
  709. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/index.ts +558 -0
  710. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  711. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  712. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  713. package/.versions/2.0.8/.pi/harnesses/coms/README.md +100 -0
  714. package/.versions/2.0.8/.pi/harnesses/coms/index.ts +282 -0
  715. package/.versions/2.0.8/.pi/harnesses/coms/package.json +7 -0
  716. package/.versions/2.0.8/.pi/harnesses/coms/version.ts +42 -0
  717. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/README.md +135 -0
  718. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/index.ts +541 -0
  719. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  720. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/version.ts +42 -0
  721. package/.versions/2.0.8/.pi/harnesses/lib/coms-core-io.ts +385 -0
  722. package/.versions/2.0.8/.pi/harnesses/lib/coms-core.ts +577 -0
  723. package/.versions/2.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  724. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  725. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  726. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-view.ts +107 -0
  727. package/.versions/2.0.8/.pi/harnesses/lib/context-budget.ts +114 -0
  728. package/.versions/2.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  729. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  730. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  731. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  732. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  733. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  734. package/.versions/2.0.8/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  735. package/.versions/2.0.8/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  736. package/.versions/2.0.8/.pi/harnesses/lib/fleet-panel.ts +34 -0
  737. package/.versions/2.0.8/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  738. package/.versions/2.0.8/.pi/harnesses/lib/fleet-selection.ts +24 -0
  739. package/.versions/2.0.8/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  740. package/.versions/2.0.8/.pi/harnesses/lib/herdr-client.ts +472 -0
  741. package/.versions/2.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  742. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  743. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  744. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  745. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  746. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  747. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  748. package/.versions/2.0.8/.pi/harnesses/lib/spawned-peers.js +190 -0
  749. package/.versions/2.0.8/.pi/harnesses/lib/update-check.ts +222 -0
  750. package/.versions/2.0.8/.pi/harnesses/package-lock.json +2039 -0
  751. package/.versions/2.0.8/.pi/harnesses/package.json +10 -0
  752. package/.versions/2.0.8/.pi/prompts/af-build.md +24 -0
  753. package/.versions/2.0.8/.pi/prompts/af-code-simplify.md +22 -0
  754. package/.versions/2.0.8/.pi/prompts/af-constraints.md +31 -0
  755. package/.versions/2.0.8/.pi/prompts/af-plan.md +17 -0
  756. package/.versions/2.0.8/.pi/prompts/af-review.md +16 -0
  757. package/.versions/2.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  758. package/.versions/2.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  759. package/.versions/2.0.8/.pi/prompts/af-ship.md +17 -0
  760. package/.versions/2.0.8/.pi/prompts/af-spec.md +15 -0
  761. package/.versions/2.0.8/.pi/prompts/af-test.md +19 -0
  762. package/.versions/2.0.8/.pi/skills/bowser/SKILL.md +145 -0
  763. package/.versions/2.0.8/.version +1 -0
  764. package/.versions/2.0.8/agents/architect.md +25 -0
  765. package/.versions/2.0.8/agents/bowser.md +28 -0
  766. package/.versions/2.0.8/agents/builder.md +56 -0
  767. package/.versions/2.0.8/agents/code-reviewer.md +210 -0
  768. package/.versions/2.0.8/agents/deep-researcher.md +33 -0
  769. package/.versions/2.0.8/agents/documenter.md +23 -0
  770. package/.versions/2.0.8/agents/orchestrator.md +23 -0
  771. package/.versions/2.0.8/agents/plan-reviewer.md +84 -0
  772. package/.versions/2.0.8/agents/planner.md +106 -0
  773. package/.versions/2.0.8/agents/releaser.md +25 -0
  774. package/.versions/2.0.8/agents/researcher.md +31 -0
  775. package/.versions/2.0.8/agents/security-auditor.md +168 -0
  776. package/.versions/2.0.8/agents/test-engineer.md +154 -0
  777. package/.versions/2.0.8/agents/web-debugger.md +44 -0
  778. package/.versions/2.0.8/agents/web-performance-auditor.md +194 -0
  779. package/.versions/2.0.8/bin/catalog/harness-runtime-closure.json +32 -0
  780. package/.versions/2.0.8/codex/fleet-session-client/SKILL.md +34 -0
  781. package/.versions/2.0.8/codex/fleet-session-client.zip +0 -0
  782. package/.versions/2.0.8/docs/ARCHITECTURE.md +416 -0
  783. package/.versions/2.0.8/docs/agent-fleet-setup.md +568 -0
  784. package/.versions/2.0.8/docs/claude-code-coms-bridge.md +134 -0
  785. package/.versions/2.0.8/docs/codex-session-bridge.md +219 -0
  786. package/.versions/2.0.8/docs/coms-hermes-bridge.md +188 -0
  787. package/.versions/2.0.8/docs/getting-started.md +126 -0
  788. package/.versions/2.0.8/docs/npm-install.md +356 -0
  789. package/.versions/2.0.8/docs/pi-extensions.md +446 -0
  790. package/.versions/2.0.8/docs/pi-setup.md +76 -0
  791. package/.versions/2.0.8/docs/skill-anatomy.md +150 -0
  792. package/.versions/2.0.8/install-manifest.json +2991 -0
  793. package/.versions/2.0.8/justfile +247 -0
  794. package/.versions/2.0.8/manifest-meta.json +970 -0
  795. package/.versions/2.0.8/references/accessibility-checklist.md +160 -0
  796. package/.versions/2.0.8/references/communication-contract.md +26 -0
  797. package/.versions/2.0.8/references/definition-of-done.md +67 -0
  798. package/.versions/2.0.8/references/fleet-coordination-patterns.md +171 -0
  799. package/.versions/2.0.8/references/observability-checklist.md +92 -0
  800. package/.versions/2.0.8/references/orchestration-patterns.md +370 -0
  801. package/.versions/2.0.8/references/performance-checklist.md +236 -0
  802. package/.versions/2.0.8/references/prompting-patterns.md +380 -0
  803. package/.versions/2.0.8/references/security-checklist.md +245 -0
  804. package/.versions/2.0.8/references/testing-patterns.md +235 -0
  805. package/.versions/2.0.8/references/workflow-authoring.md +304 -0
  806. package/.versions/2.0.8/skills/_internal/grilling.md +59 -0
  807. package/.versions/2.0.8/skills/browser-testing-with-devtools/SKILL.md +351 -0
  808. package/.versions/2.0.8/skills/code-review-and-quality/SKILL.md +396 -0
  809. package/.versions/2.0.8/skills/compound-learning/SKILL.md +137 -0
  810. package/.versions/2.0.8/skills/constraint-driven-development/SKILL.md +338 -0
  811. package/.versions/2.0.8/skills/constraint-driven-development/references/floor-guard.md +99 -0
  812. package/.versions/2.0.8/skills/context-engineering/SKILL.md +341 -0
  813. package/.versions/2.0.8/skills/deprecation-and-migration/SKILL.md +247 -0
  814. package/.versions/2.0.8/skills/designing-agents/SKILL.md +394 -0
  815. package/.versions/2.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  816. package/.versions/2.0.8/skills/drafting-workflows/SKILL.md +143 -0
  817. package/.versions/2.0.8/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  818. package/.versions/2.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  819. package/.versions/2.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  820. package/.versions/2.0.8/skills/idea-refine/SKILL.md +182 -0
  821. package/.versions/2.0.8/skills/idea-refine/examples.md +238 -0
  822. package/.versions/2.0.8/skills/idea-refine/frameworks.md +99 -0
  823. package/.versions/2.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  824. package/.versions/2.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  825. package/.versions/2.0.8/skills/incremental-implementation/SKILL.md +302 -0
  826. package/.versions/2.0.8/skills/interview-me/SKILL.md +226 -0
  827. package/.versions/2.0.8/skills/orchestration-verification/SKILL.md +181 -0
  828. package/.versions/2.0.8/skills/peer-coms/SKILL.md +90 -0
  829. package/.versions/2.0.8/skills/performance-optimization/SKILL.md +496 -0
  830. package/.versions/2.0.8/skills/planning-and-task-breakdown/SKILL.md +289 -0
  831. package/.versions/2.0.8/skills/security-and-hardening/SKILL.md +524 -0
  832. package/.versions/2.0.8/skills/spec-driven-development/SKILL.md +295 -0
  833. package/.versions/2.0.8/skills/using-agent-skills/SKILL.md +198 -0
  834. package/.versions/2.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  835. package/.versions/2.0.8/vendor/agent-skills-upstream/README.md +430 -0
  836. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  837. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  838. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  839. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  840. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  841. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  842. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  843. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  844. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  845. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  846. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  847. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  848. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  849. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  850. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  851. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  852. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  853. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  854. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  855. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  856. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  857. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  858. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  859. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  860. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  861. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  862. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  863. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  864. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  865. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  866. package/CHANGELOG.md +47 -0
  867. package/README.md +24 -16
  868. package/bin/catalog/harness-runtime-closure.json +23 -22
  869. package/bin/cli.js +173 -79
  870. package/bin/lib/apply.js +59 -64
  871. package/bin/lib/detect-agent.js +1 -1
  872. package/bin/lib/doctor.js +3 -3
  873. package/bin/lib/features.js +2 -2
  874. package/bin/lib/manifest.js +23 -16
  875. package/bin/lib/path-boundaries.js +96 -0
  876. package/bin/lib/personas.js +15 -2
  877. package/bin/lib/public-plan.js +17 -0
  878. package/bin/lib/purge.js +9 -3
  879. package/bin/lib/reconcile.js +4 -10
  880. package/bin/lib/repair-desired.js +73 -0
  881. package/bin/lib/set-hermes-telegram.js +2 -2
  882. package/bin/lib/set-hermes-watchdog.js +1 -1
  883. package/bin/lib/state.js +5 -1
  884. package/bin/lib/stt-wizard.js +25 -11
  885. package/bin/lib/transaction.js +118 -108
  886. package/bin/lib/tui.js +70 -65
  887. package/bin/lib/update-notifier.js +2 -2
  888. package/bin/lib/verify.js +43 -5
  889. package/bin/lib/workspace-safety.js +72 -0
  890. package/bin/snapshot-version.js +6 -6
  891. package/codex/fleet-session-client/SKILL.md +3 -3
  892. package/docs/ARCHITECTURE.md +29 -20
  893. package/docs/MIGRATION-agent-fleet.md +11 -7
  894. package/docs/agent-fleet-setup.md +9 -2
  895. package/docs/claude-code-coms-bridge.md +10 -9
  896. package/docs/codex-session-bridge.md +18 -18
  897. package/docs/coms-hermes-bridge.md +6 -6
  898. package/docs/hermes-watchdog-supervisor.md +1 -1
  899. package/docs/npm-install.md +71 -16
  900. package/docs/pi-extensions.md +9 -9
  901. package/docs/pi-setup.md +2 -2
  902. package/docs/workflows.md +9 -5
  903. package/install-manifest.json +202 -135
  904. package/justfile +22 -22
  905. package/manifest-meta.json +51 -57
  906. package/package.json +26 -26
  907. package/references/observability-checklist.md +1 -0
  908. package/references/performance-checklist.md +83 -0
  909. package/references/prompting-patterns.md +1 -1
  910. package/references/security-checklist.md +85 -19
  911. package/references/testing-patterns.md +12 -13
  912. package/references/workflow-authoring.md +5 -5
  913. package/skills/code-review-and-quality/SKILL.md +17 -2
  914. package/skills/constraint-driven-development/SKILL.md +338 -0
  915. package/skills/constraint-driven-development/references/floor-guard.md +99 -0
  916. package/skills/context-engineering/SKILL.md +52 -2
  917. package/skills/deprecation-and-migration/SKILL.md +42 -1
  918. package/skills/designing-agents/SKILL.md +12 -12
  919. package/skills/drafting-workflows/SKILL.md +6 -6
  920. package/skills/drafting-workflows/scripts/make-workflow.ts +3 -3
  921. package/skills/frontend-ui-engineering/SKILL.md +2 -2
  922. package/skills/git-workflow-and-versioning/SKILL.md +1 -1
  923. package/skills/incremental-implementation/SKILL.md +13 -9
  924. package/skills/peer-coms/SKILL.md +4 -4
  925. package/skills/performance-optimization/SKILL.md +152 -6
  926. package/skills/planning-and-task-breakdown/SKILL.md +32 -8
  927. package/skills/security-and-hardening/SKILL.md +84 -21
  928. package/skills/spec-driven-development/SKILL.md +41 -2
  929. package/skills/using-agent-skills/SKILL.md +3 -2
  930. package/vendor/agent-skills-upstream/README.md +427 -8
  931. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +73 -0
  932. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +2 -2
  933. package/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  934. package/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  935. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +49 -1
  936. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +4 -4
  937. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +1 -1
  938. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +12 -2
  939. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +3 -3
  940. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +1 -1
  941. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +1 -1
  942. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +9 -9
  943. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +36 -1
  944. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +151 -5
  945. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +32 -9
  946. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +64 -7
  947. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +26 -6
  948. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +23 -1
  949. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +42 -3
  950. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +18 -3
  951. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +3 -2
  952. package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
  953. package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
  954. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/plugin.js +0 -0
  955. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/presentation.js +0 -0
  956. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  957. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  958. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/herdr_source.py +0 -0
  959. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/manifest.json +0 -0
  960. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/plugin_api.py +0 -0
  961. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/sessions.py +0 -0
  962. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/tasks.py +0 -0
  963. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/plugin.yaml +0 -0
  964. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  965. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -0
  966. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  967. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  968. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-liaison/SKILL.md +0 -0
  969. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/manifest.json +0 -0
  970. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog.py +0 -0
  971. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_actions.py +0 -0
  972. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_contract.py +0 -0
  973. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_delivery.py +0 -0
  974. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_engine.py +0 -0
  975. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_judgment.py +0 -0
  976. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_recovery.py +0 -0
  977. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_state.py +0 -0
  978. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_transport.py +0 -0
  979. /package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-client.ts +0 -0
  980. /package/{scripts → .pi/agent-fleet/scripts}/hermes-watchdog-capability-probe.ts +0 -0
  981. /package/{scripts → .pi/agent-fleet/scripts}/lib/fake-herdr-server.ts +0 -0
  982. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-catalog.ts +0 -0
  983. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-operations.ts +0 -0
  984. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-session.ts +0 -0
  985. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-command.ts +0 -0
  986. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-command.ts +0 -0
  987. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-maintenance.ts +0 -0
  988. /package/{scripts → .pi/agent-fleet/scripts}/package-lock.json +0 -0
  989. /package/{scripts → .pi/agent-fleet/scripts}/package.json +0 -0
  990. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/changes.ts +0 -0
  991. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/debate.ts +0 -0
  992. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/env.ts +0 -0
  993. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/gates.ts +0 -0
  994. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/git.ts +0 -0
  995. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/merge.ts +0 -0
  996. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-visibility.ts +0 -0
  997. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/permissions.ts +0 -0
  998. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/poll.ts +0 -0
  999. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/quality.ts +0 -0
  1000. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/run.ts +0 -0
  1001. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/voices.ts +0 -0
  1002. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/writer-lease.ts +0 -0
  1003. /package/{scripts → .pi/agent-fleet/scripts}/workflows/tsconfig.json +0 -0
  1004. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-build-test.ts +0 -0
  1005. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-debate.ts +0 -0
  1006. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-document.ts +0 -0
  1007. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-poll.ts +0 -0
  1008. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-quality.ts +0 -0
  1009. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-scout.ts +0 -0
  1010. /package/{hermes → .versions/2.0.7/hermes}/README.md +0 -0
  1011. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +0 -0
  1012. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +0 -0
  1013. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +0 -0
  1014. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +0 -0
  1015. /package/{hermes → .versions/2.0.7/hermes}/skills/hub-conductor/SKILL.md +0 -0
  1016. /package/{hermes → .versions/2.0.7/hermes}/skills/hub-watchdog/SKILL.md +0 -0
  1017. /package/{hooks → .versions/2.0.7/hooks}/coms-stop-hook.mjs +0 -0
  1018. /package/{scripts → .versions/2.0.7/scripts}/claude-code-preflight.ts +0 -0
  1019. /package/{scripts → .versions/2.0.7/scripts}/coms-claude-bridge.ts +0 -0
  1020. /package/{scripts → .versions/2.0.7/scripts}/coms-cli.ts +0 -0
  1021. /package/{scripts → .versions/2.0.7/scripts}/coms-hermes-bridge.ts +0 -0
  1022. /package/{scripts → .versions/2.0.7/scripts}/fleet-codex-read.py +0 -0
  1023. /package/{scripts → .versions/2.0.7/scripts}/flow.ts +0 -0
  1024. /package/{scripts → .versions/2.0.7/scripts}/lib/claude-bridge-core.ts +0 -0
  1025. /package/{scripts → .versions/2.0.7/scripts}/lib/coms-envelope.ts +0 -0
  1026. /package/{scripts → .versions/2.0.7/scripts}/lib/fleet-codex-transport.ts +0 -0
  1027. /package/{scripts → .versions/2.0.7/scripts}/lib/herdr-layout.ts +0 -0
  1028. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-bridge-core.ts +0 -0
  1029. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-events.ts +0 -0
  1030. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-herdr.ts +0 -0
  1031. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-model.ts +0 -0
  1032. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-registry.ts +0 -0
  1033. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-socket.ts +0 -0
  1034. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-store.ts +0 -0
  1035. /package/{scripts → .versions/2.0.7/scripts}/lib/monitor-env.ts +0 -0
  1036. /package/{scripts → .versions/2.0.7/scripts}/lib/peer-launch.ts +0 -0
  1037. /package/{scripts → .versions/2.0.7/scripts}/lib/persona-banner.ts +0 -0
  1038. /package/{scripts → .versions/2.0.7/scripts}/lib/runtime-dependencies.js +0 -0
  1039. /package/{scripts → .versions/2.0.7/scripts}/lib/spawn-stagger.ts +0 -0
  1040. /package/{scripts → .versions/2.0.7/scripts}/lib/team-project.ts +0 -0
  1041. /package/{scripts → .versions/2.0.7/scripts}/lib/team-snapshot.ts +0 -0
  1042. /package/{scripts → .versions/2.0.7/scripts}/peer-banner.ts +0 -0
  1043. /package/{scripts → .versions/2.0.7/scripts}/peer-launch.ts +0 -0
  1044. /package/{scripts → .versions/2.0.7/scripts}/team-snapshot.ts +0 -0
  1045. /package/{scripts → .versions/2.0.7/scripts}/team-up.ts +0 -0
  1046. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/agent-phase.ts +0 -0
  1047. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/envelopes.ts +0 -0
  1048. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/model-profile.ts +0 -0
  1049. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/personas.ts +0 -0
  1050. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/trace.ts +0 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: designing-agents
3
- description: Designs and writes a focused artifact another agent runs — an agent persona in agents/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
3
+ description: Designs and writes a focused artifact another agent runs — an agent persona in .pi/agents/personas/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
4
4
  ---
5
5
 
6
6
  # Designing Agents
@@ -9,7 +9,7 @@ description: Designs and writes a focused artifact another agent runs — an age
9
9
 
10
10
  This repo has three kinds of artifacts that shape how an agent works. Each is authored, versioned, and invoked deliberately:
11
11
 
12
- - **Agent personas** live in `agents/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
12
+ - **Agent personas** live in `.pi/agents/personas/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
13
13
  - **Skills** live in `skills/<name>/SKILL.md`. They define a *workflow* — a repeatable process with gated steps, anti-rationalization guardrails, and verification. Example: `spec-driven-development`, `test-driven-development`, `context-engineering`.
14
14
  - **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control-continue`, `coms`.
15
15
 
@@ -17,7 +17,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
17
17
 
18
18
  ## When to Use
19
19
 
20
- - Creating a new persona file in `agents/` (reviewer, auditor, domain specialist)
20
+ - Creating a new persona file in `.pi/agents/personas/` (reviewer, auditor, domain specialist)
21
21
  - Creating a new skill directory in `skills/` (a process, checklist, or workflow)
22
22
  - Creating a new pi harness in `.pi/harnesses/` (a footer, focus gate, safety check, orchestrator, or messaging layer)
23
23
  - An existing persona, skill, or harness is vague, overlaps another, or is being ignored in practice
@@ -32,7 +32,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
32
32
 
33
33
  ## The Workflow
34
34
 
35
- This workflow is abstracted from the three reference personas (`agents/code-reviewer.md`, `agents/security-auditor.md`, `agents/test-engineer.md`), from `docs/skill-anatomy.md`, and from the ported harnesses under `.pi/harnesses/` (catalogued in `docs/pi-extensions.md`). Do not advance to the next step until the current one is settled.
35
+ This workflow is abstracted from the three reference personas (`code-reviewer`, `security-auditor`, `test-engineer`), from `docs/skill-anatomy.md`, and from the ported harnesses under `.pi/harnesses/` (catalogued in `docs/pi-extensions.md`). Do not advance to the next step until the current one is settled.
36
36
 
37
37
  ### 1. Choose the target type
38
38
 
@@ -40,7 +40,7 @@ Ask: is this a *role* the agent should adopt, a *process* it should follow, or a
40
40
 
41
41
  | Target | Choose when | Output |
42
42
  |---|---|---|
43
- | Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) | `agents/<name>.md` |
43
+ | Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) | `.pi/agents/personas/<name>.md` |
44
44
  | Skill | The agent needs to follow a repeatable process with gated steps, verification, and anti-rationalization guards | `skills/<name>/SKILL.md` |
45
45
  | pi harness | The session itself must change — footer, status, a blocking gate on tool calls, a new tool or `/command`, or sub-agent orchestration | `.pi/harnesses/<name>/` (a directory) |
46
46
 
@@ -59,7 +59,7 @@ Do not proceed until the one-sentence purpose is locked. If the requester cannot
59
59
  ### 3. Scan for overlap
60
60
 
61
61
  Read every existing artifact of the target type:
62
- - For a persona: every file under `agents/`.
62
+ - For a persona: every persona file already in the workspace.
63
63
  - For a skill: every `skills/*/SKILL.md` (start with the Quick Reference table in `skills/using-agent-skills/SKILL.md`).
64
64
  - For a harness: the catalog table in `docs/pi-extensions.md`, then the `README.md` of each `.pi/harnesses/*` that looks close.
65
65
 
@@ -103,7 +103,7 @@ This step branches by target type.
103
103
 
104
104
  #### 6a. Persona body (four-block structure)
105
105
 
106
- Used by every persona in `agents/`. See the Persona Template below.
106
+ Used by every installed persona. See the Persona Template below.
107
107
 
108
108
  ```markdown
109
109
  # <Role Heading>
@@ -165,7 +165,7 @@ A harness also has wiring steps that personas and skills do not — step 9 cover
165
165
 
166
166
  ### 7. Apply prompting-patterns
167
167
 
168
- Before finalizing, read `references/prompting-patterns.md` and check the artifact against these sections. This applies to all three types — for a harness, to the prose it injects (system-prompt text, tool descriptions, block reasons), not the TypeScript itself.
168
+ Before finalizing, read `../../references/prompting-patterns.md` and check the artifact against these sections. This applies to all three types — for a harness, to the prose it injects (system-prompt text, tool descriptions, block reasons), not the TypeScript itself.
169
169
 
170
170
  - **§2.2** — Positive instructions, not prohibitions. Rewrite every "don't do X" as "do Y".
171
171
  - **§2.3** — Explain *why* for any non-obvious rule. One short clause is enough.
@@ -185,7 +185,7 @@ Cut every sentence that does not change behavior. Read each rule and ask: "If I
185
185
 
186
186
  ### 9. Write the file(s)
187
187
 
188
- - Persona → `agents/<name>.md`.
188
+ - Persona → `.pi/agents/personas/<name>.md`.
189
189
  - Skill → `skills/<name>/SKILL.md` (create the directory; supporting files only if the skill exceeds ~300 lines or needs separate reference material).
190
190
  - Harness → `.pi/harnesses/<name>/` with `index.ts`, `package.json`, and `README.md`. Then add a `just ext-<name>` recipe to the `justfile` under the matching category header, add a catalog row to `docs/pi-extensions.md`, and add any new runtime dependency to `.pi/harnesses/package.json`. Never place a harness under `.pi/extensions/` — pi auto-discovers that directory and would load every harness at once.
191
191
 
@@ -321,7 +321,7 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
321
321
  | "I'll skip the harness README and catalog row — `index.ts` is the real artifact" | A harness with no row in `docs/pi-extensions.md` is undiscoverable; no agent will load it. The README is its discovery surface — the same role frontmatter plays for a skill. |
322
322
  | "I'll copy an existing artifact and tweak it" | For prose artifacts, copy-paste creates silent duplication and drift — read the existing files to learn the pattern, then write fresh. For a harness, copying the nearest `index.ts` *is* the recommended start; just rename it cleanly and cut what you don't use. |
323
323
  | "I don't need to read prompting-patterns, I know how to write prompts" | Every author thinks this. The reference exists because recurring, measurable mistakes happen anyway. Spend 3 minutes skimming §2 and §6. |
324
- | "I'll add every tool and capability — flexibility is good" | This repo's `agents/*.md` don't declare tools at all; scope creep happens through the prompt body. Skills and harnesses that try to cover many domains lose their force. Bloated artifacts get skimmed. |
324
+ | "I'll add every tool and capability — flexibility is good" | Agent Fleet's own personas don't declare tools at all; scope creep happens through the prompt body. Skills and harnesses that try to cover many domains lose their force. Bloated artifacts get skimmed. |
325
325
  | "The purpose is hard to state in one sentence because it covers a lot" | If you cannot state it in one sentence, the artifact covers too much. Split it or scope it down. |
326
326
  | "I'll leave the rules/steps section light so the artifact can be flexible" | Empty Rules or vague steps become empty behavior. The specifics are what differentiate this artifact from a general agent. |
327
327
  | "My skill is mostly reference material — I'll inline a 200-line checklist" | Reference material belongs in `references/`. Skills are workflows, not reference docs. Move the long content out and cite it. |
@@ -360,13 +360,13 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
360
360
 
361
361
  - [ ] Name is kebab-case and matches the file/directory, the `name` field (frontmatter or `package.json`), and the H1 title.
362
362
  - [ ] The discovery surface (description, or README + catalog row) is action-oriented and ends with a concrete trigger.
363
- - [ ] Cross-checked against `references/prompting-patterns.md` §2.2, §2.3, §2.4, §2.5, §3.1, §6.4 — no prohibitions, no contradictions, no ALL-CAPS, role/overview is specific.
363
+ - [ ] Cross-checked against `../../references/prompting-patterns.md` §2.2, §2.3, §2.4, §2.5, §3.1, §6.4 — no prohibitions, no contradictions, no ALL-CAPS, role/overview is specific.
364
364
  - [ ] Scanned against existing files of the same type — no >30% overlap.
365
365
  - [ ] Every sentence, if removed, would visibly change the artifact's behavior.
366
366
 
367
367
  ### Persona-specific checklist
368
368
 
369
- - [ ] File exists at `agents/<name>.md`.
369
+ - [ ] File exists at `.pi/agents/personas/<name>.md`.
370
370
  - [ ] Body has: Role opening paragraph, Framework/Approach, Output Format, Rules.
371
371
  - [ ] Output Format contains a concrete markdown template, not a description of one.
372
372
  - [ ] If the persona classifies findings (Critical / High / etc.), the severity table is present with explicit criteria and required action.
@@ -11,7 +11,7 @@ Draft code-owned workflows by copying a proven flow shape, then edit only the de
11
11
 
12
12
  ## When to Use
13
13
 
14
- - Creating a new `scripts/workflows/wf-*.ts` flow.
14
+ - Creating a new `.pi/agent-fleet/scripts/workflows/wf-*.ts` flow.
15
15
  - Changing a flow's phase order, gates, retries, or acceptance rule.
16
16
  - Translating an operator request into a prompt for an agent phase.
17
17
 
@@ -21,7 +21,7 @@ Do not use this skill to improvise an interactive hub dispatch. `just fleet` rem
21
21
 
22
22
  ### 1. Map, list, and stop
23
23
 
24
- Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
24
+ Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `.pi/agent-fleet/scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
25
25
 
26
26
  At this point:
27
27
 
@@ -79,7 +79,7 @@ The draft marks only three classes of decisions:
79
79
 
80
80
  Edit the copied phase bodies so the declared shape is real. Remove each TODO only after making that decision. Do not add TODOs for imports, envelope wiring, trace calls, dry-run stubs, or other boilerplate.
81
81
 
82
- For the complete contracts, read `references/workflow-authoring.md`.
82
+ For the complete contracts, read `../../references/workflow-authoring.md`.
83
83
 
84
84
  ### 6. Keep the envelope triad synchronized
85
85
 
@@ -96,9 +96,9 @@ Use existing return-contract vocabulary. A parsed envelope with `status: "fail"`
96
96
  The generator refuses handoff unless both gates pass:
97
97
 
98
98
  ```bash
99
- npx tsc -p scripts/workflows/tsconfig.json --noEmit
99
+ npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
100
100
  node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
101
- --verify-draft scripts/workflows/wf-<name>.ts
101
+ --verify-draft .pi/agent-fleet/scripts/workflows/wf-<name>.ts
102
102
  ```
103
103
 
104
104
  The second command resolves the exact `wf-<name>.ts` entry export used by the flow registry, then executes it with stubbed agent phases and `dryRun: true`; it makes no model call. If either gate fails, the generator deletes the draft and reports the exact failure. Repair the source decision or rerun the generator—never bypass either gate. A handed-off draft is immediately reachable as `just flow <name>`; no central registry edit is required.
@@ -138,6 +138,6 @@ Before presenting a workflow draft, confirm:
138
138
  - [ ] Every agent phase has an explicit persona or call-site writes policy; omission is a startup error, never unrestricted by accident.
139
139
  - [ ] Writes policy and protected paths are enforced around agent phases.
140
140
  - [ ] The generated export is uniquely named for the file and resolves through `just flow <name>`.
141
- - [ ] `npx tsc -p scripts/workflows/tsconfig.json --noEmit` passes.
141
+ - [ ] `npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit` passes.
142
142
  - [ ] The generated workflow's stubbed dry run is accepted with zero model calls.
143
143
  - [ ] The exact commands and outcomes are included in the handoff.
@@ -73,7 +73,7 @@ function editDistance(left: PhaseKind[], right: PhaseKind[]): number {
73
73
  }
74
74
 
75
75
  export function selectNearestWorkflow(shapes: WorkflowShape[], requestedPhases: string[]): WorkflowShape {
76
- if (!shapes.length) throw new Error("No scripts/workflows/wf-*.ts sources were found.");
76
+ if (!shapes.length) throw new Error("No .pi/agent-fleet/scripts/workflows/wf-*.ts sources were found.");
77
77
  const requestedKinds = requestedPhases.map(phaseKind);
78
78
  return [...shapes].sort((left, right) => {
79
79
  const leftScore = editDistance(left.kinds, requestedKinds) * 100 + Math.abs(left.kinds.length - requestedKinds.length) * 10;
@@ -118,7 +118,7 @@ export function makeWorkflow(options: {
118
118
  }): { outputPath: string; sourcePath: string; phases: string[] } {
119
119
  if (!SAFE_NAME.test(options.name)) throw new Error(`Invalid workflow name: ${options.name}`);
120
120
  if (RESERVED_FLOW_NAMES.has(options.name)) throw new Error(`Workflow name is reserved for maintenance: ${options.name}`);
121
- const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, "scripts/workflows"));
121
+ const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, ".pi/agent-fleet/scripts/workflows"));
122
122
  const outputPath = resolve(workflowsDir, `wf-${options.name}.ts`);
123
123
  if (existsSync(outputPath)) throw new Error(`Refusing to overwrite existing workflow: ${outputPath}`);
124
124
  const nearest = selectNearestWorkflow(readWorkflowShapes(workflowsDir), options.phases);
@@ -141,7 +141,7 @@ export function makeWorkflow(options: {
141
141
  export async function verifyDraft(path: string, cwd = process.cwd()): Promise<void> {
142
142
  const resolvedPath = resolve(path);
143
143
  const workflowName = basename(resolvedPath).replace(/^wf-/, "").replace(/\.ts$/, "");
144
- const flowModulePath = resolve(cwd, "scripts/flow.ts");
144
+ const flowModulePath = resolve(cwd, ".pi/agent-fleet/scripts/flow.ts");
145
145
  const { resolveWorkflow } = await import(`${pathToFileURL(flowModulePath).href}?verify=${Date.now()}`) as {
146
146
  resolveWorkflow(name: string, workflowsDir?: string): Promise<{ run: (run: unknown, input: { args: string[]; dryRun: boolean; cwd: string }) => Promise<{ accepted: boolean }> } | undefined>;
147
147
  };
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: frontend-ui-engineering
3
- description: Builds production-quality UIs. Use when building or modifying user-facing interfaces. Use when creating components, implementing layouts, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
3
+ description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
4
4
  ---
5
5
 
6
6
  # Frontend UI Engineering
@@ -294,7 +294,7 @@ function useToggleTask() {
294
294
 
295
295
  ## See Also
296
296
 
297
- For detailed accessibility requirements and testing tools, see `references/accessibility-checklist.md`.
297
+ For detailed accessibility requirements and testing tools, see `../../references/accessibility-checklist.md`.
298
298
 
299
299
  ## Common Rationalizations
300
300
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: git-workflow-and-versioning
3
- description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.
3
+ description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams.
4
4
  ---
5
5
 
6
6
  # Git Workflow and Versioning
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: incremental-implementation
3
- description: Delivers changes incrementally and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
3
+ description: Delivers changes incrementally in thin, verifiable slices and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
4
4
  ---
5
5
 
6
6
  # Incremental Implementation
@@ -226,8 +226,8 @@ When directing an agent to implement incrementally:
226
226
  Start with just the database schema change and the API endpoint.
227
227
  Don't touch the UI yet — we'll do that in the next increment.
228
228
 
229
- After implementing, run `npm test` and `npm run build` to verify
230
- nothing is broken, then present the Standard Slice Summary and
229
+ After implementing, run the repository's test and build commands to
230
+ verify nothing is broken, then present the Standard Slice Summary and
231
231
  wait for my approval before the next slice. Do not stage or
232
232
  commit — I'll handle git manually after reviewing."
233
233
  ```
@@ -236,13 +236,17 @@ Be explicit about what's in scope and what's NOT in scope for each increment.
236
236
 
237
237
  ## Increment Checklist
238
238
 
239
- After each increment, verify:
239
+ After each increment, verify with the repository's own commands. **Where the project
240
+ defines `quality:` under `## workflows` in `.ai/agent-fleet-overrides.md`, that command
241
+ *is* the verification — run it rather than guessing.** Only outside a configured project
242
+ should you discover the stack yourself (see the `test-driven-development` skill's
243
+ *Discover the Stack First* section). Never fall back to an assumed `npm test`.
240
244
 
241
245
  - [ ] The change does one thing and does it completely
242
- - [ ] All existing tests still pass (`npm test`)
243
- - [ ] The build succeeds (`npm run build`)
244
- - [ ] Type checking passes (`npx tsc --noEmit`)
245
- - [ ] Linting passes (`npm run lint`)
246
+ - [ ] All existing tests still pass (the project's `quality:` command, or the repository's test command: `npm test`, `./gradlew test`, `pytest`, ...)
247
+ - [ ] The build succeeds (the repository's build command)
248
+ - [ ] Type checking passes, where the stack has one (`npx tsc --noEmit`, `mypy`, ...)
249
+ - [ ] Linting passes (the repository's lint command)
246
250
  - [ ] The new functionality works as expected
247
251
  - [ ] Unspecified load-bearing forks were grilled (or grilling found none); already-stated requirements were not re-asked
248
252
  - [ ] The Standard Slice Summary was presented to the user
@@ -295,4 +299,4 @@ After completing all increments for a task:
295
299
 
296
300
  ## See Also
297
301
 
298
- Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See `references/definition-of-done.md`.
302
+ Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See `../../references/definition-of-done.md`.
@@ -30,14 +30,14 @@ yourself** — pane lifecycle (herdr) belongs to the orchestrator and the human.
30
30
  **Discover** who is alive (name, model, purpose):
31
31
 
32
32
  ```bash
33
- node --experimental-strip-types scripts/coms-cli.ts list
33
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts list
34
34
  ```
35
35
 
36
36
  **Ask and wait** (blocking round trip — usually what you want; generous timeout, peers
37
37
  run real turns):
38
38
 
39
39
  ```bash
40
- node --experimental-strip-types scripts/coms-cli.ts send researcher \
40
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
41
41
  "Where is the retry logic for outbound webhooks? file:line please" \
42
42
  --await --timeout 300000
43
43
  ```
@@ -45,9 +45,9 @@ node --experimental-strip-types scripts/coms-cli.ts send researcher \
45
45
  **Fire-and-collect** (returns a `msg_id` immediately; a detached waiter holds the reply):
46
46
 
47
47
  ```bash
48
- node --experimental-strip-types scripts/coms-cli.ts send documenter "Draft a README section on X"
48
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send documenter "Draft a README section on X"
49
49
  # … keep working …
50
- node --experimental-strip-types scripts/coms-cli.ts await <msg_id> --timeout 300000
50
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts await <msg_id> --timeout 300000
51
51
  ```
52
52
 
53
53
  **Answer inbound prompts** by simply replying in the conversation — your final message
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: performance-optimization
3
- description: Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing.
3
+ description: Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.
4
4
  ---
5
5
 
6
6
  # Performance Optimization
@@ -33,7 +33,7 @@ Measure before optimizing. Performance work without measurement is guessing —
33
33
  1. MEASURE → Establish baseline with real data
34
34
  2. IDENTIFY → Find the actual bottleneck (not assumed)
35
35
  3. FIX → Address the specific bottleneck
36
- 4. VERIFY → Measure again, confirm improvement
36
+ 4. VERIFY → Measure again; keep or revert
37
37
  5. GUARD → Add monitoring or tests to prevent regression
38
38
  ```
39
39
 
@@ -149,6 +149,58 @@ const tasks = await db.tasks.findMany({
149
149
  });
150
150
  ```
151
151
 
152
+ #### Queries That Ignore Their Index
153
+
154
+ "Add an index" is the guess. The query plan is the measurement:
155
+
156
+ ```sql
157
+ EXPLAIN ANALYZE
158
+ SELECT id, title FROM tasks
159
+ WHERE owner_id = 42 ORDER BY created_at DESC LIMIT 20;
160
+ ```
161
+
162
+ Three things in the output decide the fix:
163
+
164
+ | What you see | What it means |
165
+ |---|---|
166
+ | `Seq Scan` on a large table where you expected an index | No usable index for this predicate |
167
+ | Estimated `rows=` off from actual by an order of magnitude | Stale statistics; the planner is choosing on bad information |
168
+ | A `Sort` node above the scan | The index covers the filter but not the `ORDER BY` |
169
+
170
+ Index for the **shape of the query**, not the column in isolation. In a composite index, equality columns come first, then the range or sort column:
171
+
172
+ ```sql
173
+ CREATE INDEX idx_tasks_owner_created ON tasks (owner_id, created_at DESC);
174
+ ```
175
+
176
+ **When an index will not help:**
177
+
178
+ | Situation | Why |
179
+ |---|---|
180
+ | Low selectivity, querying the dominant value (a `status` column that is 95% `active`, filtered on `active`) | A sequential scan is genuinely cheaper; the planner will ignore the index. Filtering on the rare value is the opposite case, and a partial index serves it well |
181
+ | Leading wildcard (`LIKE '%term'`) | A B-tree cannot seek without a prefix; needs trigram or full-text |
182
+ | Function on the column (`WHERE lower(email) = ?`) | The plain column index is unusable; index the expression instead |
183
+ | Write-heavy table | Every index is a tax on every `INSERT`/`UPDATE`; measure the write cost, not just the read gain |
184
+
185
+ Re-run `EXPLAIN ANALYZE` after. An index that did not change the plan is a revert (Step 4), and it is not free: it still costs on every write.
186
+
187
+ #### Connection Pool Exhaustion
188
+
189
+ The signature is distinctive: **every** endpoint slows at once, the slow time is spent waiting for a connection rather than executing, and the database reports mostly idle sessions.
190
+
191
+ ```typescript
192
+ // BAD: a pool per request or per module — under serverless this multiplies
193
+ // by instance count and exhausts the database's connection limit
194
+ // GOOD: one pool per process, sized against the database's ceiling
195
+ const pool = new Pool({
196
+ max: 10, // instances × max must stay under max_connections
197
+ idleTimeoutMillis: 30_000,
198
+ connectionTimeoutMillis: 5_000, // fail fast instead of queueing forever
199
+ });
200
+ ```
201
+
202
+ **Bigger is not faster.** A pool larger than what the database can execute concurrently just relocates the queue from your app to the database, where it is harder to see. When instance count is unbounded (serverless, autoscaling), a proxy that multiplexes connections (pgbouncer, RDS Proxy) is the fix, not a higher `max`.
203
+
152
204
  #### Missing Image Optimization (Frontend)
153
205
 
154
206
  ```html
@@ -264,6 +316,16 @@ function App() {
264
316
 
265
317
  #### Missing Caching (Backend)
266
318
 
319
+ Cache what is expensive to produce and read far more often than it changes. Caching a query that was already fast adds a network hop, a staleness bug, and an eviction policy to maintain, in exchange for nothing.
320
+
321
+ **Pick the layer deliberately:**
322
+
323
+ | Layer | Visible to | Use when | Cost |
324
+ |---|---|---|---|
325
+ | In-process (`Map`, LRU) | One instance | Small, hot, per-instance staleness is acceptable | Each instance drifts independently; invalidation reaches only one |
326
+ | Shared (Redis, Memcached) | All instances | Instances must agree, or the value is expensive to recompute | A network hop, and another service to run and monitor |
327
+ | CDN / edge | Everyone, per URL | Responses are public and identical for a given key | Invalidation is the hard part; assume you cannot recall a bad response quickly |
328
+
267
329
  ```typescript
268
330
  // Cache frequently-read, rarely-changed data
269
331
  const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
@@ -289,9 +351,73 @@ app.use('/static', express.static('public', {
289
351
  res.set('Cache-Control', 'public, max-age=300'); // 5 minutes
290
352
  ```
291
353
 
292
- ## Performance Budget
354
+ **Key design decides correctness.** Every input that changes the response belongs in the key: tenant, locale, permissions, feature flags. A key that omits the viewer is how one user's data gets served to another, and that ships as a performance win.
355
+
356
+ **Choose one invalidation strategy, not three:**
357
+
358
+ | Strategy | Trade-off |
359
+ |---|---|
360
+ | TTL | Simplest. You accept staleness up to the TTL, so state the acceptable window explicitly |
361
+ | Event or tag based | Fresh on write, but writers now have to know the cache topology |
362
+ | Versioned keys (`user:42:profile:v7`) | Never invalidate, just stop reading old keys. Costs memory until eviction |
363
+
364
+ **Guard against the stampede.** A hot key expires, every concurrent request misses together, and the origin takes the full load at once, which is how a cache turns into an outage instead of preventing one. Serve stale while a single request recomputes (`stale-while-revalidate`), or coalesce concurrent misses behind one in-flight promise so N waiters cause one recompute.
365
+
366
+ **Do not cache:** anything whose staleness is a correctness bug (balances, permissions, inventory at checkout), or per-user data under a key that does not identify the user. See `../../references/performance-checklist.md` for request coalescing, write strategies, negative caching, and the cache checklist.
367
+
368
+ ### Step 4: Verify (Keep or Revert)
369
+
370
+ A fix is a hypothesis until you re-measure. This step decides whether it survives.
371
+
372
+ **Re-measure the way you measured the baseline:** same command, same conditions, same fixed budget (wall-clock, sample count, or request count). A baseline taken on a cold cache against a result taken on a warm one measures the cache, not your change.
373
+
374
+ **Change one thing at a time.** Three optimizations landed together produce one number, and you cannot attribute it. If they must ship together, measure each in isolation first.
375
+
376
+ **Beat the noise, not just the mean.** Repeat the measurement and compare the delta against run-to-run variance. A 3% gain inside ±5% variance is not a gain; it is a different sample.
377
+
378
+ Then decide, strictly:
379
+
380
+ | Result vs. baseline | Action |
381
+ |---|---|
382
+ | Past the threshold, tests green | **Keep.** Commit with the before/after numbers in the message. |
383
+ | Within noise (no measurable change) | **Revert.** |
384
+ | Worse | **Revert.** |
385
+ | Improved, but a test went red | **Revert.** A regression wearing a win's clothing. |
386
+
387
+ **"Neutral" is a revert, not a keep.** This is the step teams skip: the change is already written, throwing it away feels wasteful, so it lands unmeasured, and the codebase accretes complexity that never bought anything. Code you keep, you maintain forever. Make it pay for itself.
388
+
389
+ **Correctness gates the metric.** The suite stays green *and* the number moves. An "optimization" that wins by dropping work the product needed (skipping a validation, caching something that must be fresh, removing an `await` that was load-bearing) is a regression, not a win.
390
+
391
+ #### Log every attempt, including the reverted ones
392
+
393
+ Reverted work leaves no trace in git history, which is exactly why the same dead idea gets tried again next quarter. Keep a short ledger so a discarded idea stays discarded:
394
+
395
+ | Idea | Baseline → Result | Verdict | Why |
396
+ |---|---|---|---|
397
+ | Memoize the row component | INP 240ms → 235ms | reverted | Inside noise (±15ms). Rows weren't the bottleneck. |
398
+ | Virtualize the list | INP 240ms → 90ms | kept | Long tasks gone from the trace. |
399
+ | Preconnect to the API origin | LCP 2.8s → 2.8s | reverted | Already same-origin. |
400
+
401
+ A section in the PR description or a `PERF.md` in the repo both work. What matters is that the next person (or the next agent) reads it before proposing an experiment, and doesn't re-run one that already failed.
402
+
403
+ ### Step 5: Guard Against Regression
404
+
405
+ Guard the metric the user actually feels, not every available number. Use the
406
+ same LCP, INP, p95 latency, or other primary metric that justified the fix.
407
+
408
+ Use two complementary layers when the surface is user-facing:
409
+
410
+ - **Synthetic CI gate:** Catch reproducible regressions before merge with a
411
+ performance budget. Repeat noisy measurements or compare a median/trend so
412
+ normal run-to-run variance does not turn the gate into a flaky check.
413
+ - **Field monitoring:** Alert on a meaningful p75 movement in RUM data. Use
414
+ attributed `web-vitals` data to locate the cause; treat CrUX's rolling window
415
+ as confirmation rather than an immediate alert.
416
+
417
+ When either guard fires, return to Step 1 and establish a fresh baseline before
418
+ proposing another fix.
293
419
 
294
- Set budgets and enforce them:
420
+ **Set budgets and enforce them:**
295
421
 
296
422
  ```
297
423
  JavaScript bundle: < 200KB gzipped (initial load)
@@ -314,7 +440,7 @@ npx lhci autorun
314
440
 
315
441
  ## See Also
316
442
 
317
- For detailed performance checklists, optimization commands, and anti-pattern reference, see `references/performance-checklist.md`.
443
+ For detailed performance checklists, optimization commands, and anti-pattern reference, see `../../references/performance-checklist.md`.
318
444
 
319
445
 
320
446
  ## Common Rationalizations
@@ -326,25 +452,45 @@ For detailed performance checklists, optimization commands, and anti-pattern ref
326
452
  | "This optimization is obvious" | If you didn't measure, you don't know. Profile first. |
327
453
  | "Users won't notice 100ms" | Research shows 100ms delays impact conversion rates. Users notice more than you think. |
328
454
  | "The framework handles performance" | Frameworks prevent some issues but can't fix N+1 queries or oversized bundles. |
455
+ | "The query is slow, add an index" | Read the plan first. The index may already exist and be unusable, and every index taxes writes forever. |
456
+ | "Just cache it" | Caching an already-cheap call buys nothing and adds a staleness bug. Cache what is expensive *and* re-read far more than written. |
457
+ | "Raise the pool size, we're running out of connections" | A pool bigger than the database can serve moves the queue somewhere less visible. Find what holds connections. |
458
+ | "It didn't help much, but it doesn't hurt" | Neutral changes are a revert. You pay maintenance on them forever and got nothing back. |
459
+ | "We already wrote it, may as well keep it" | Sunk cost. The measurement doesn't care how long the change took to write. |
460
+ | "The improvement is obvious, no need to re-measure" | Then re-measuring is cheap and proves it. Unmeasured wins are how neutral complexity lands. |
329
461
 
330
462
  ## Red Flags
331
463
 
332
464
  - Optimization without profiling data to justify it
333
465
  - N+1 query patterns in data fetching
466
+ - An index added without a query plan before and after to justify it
467
+ - A cache key that omits an input the response depends on (tenant, locale, viewer)
468
+ - A cache with no stated staleness window and no invalidation strategy
469
+ - Connection pool size raised in response to exhaustion, without finding what holds connections
334
470
  - List endpoints without pagination
335
471
  - Images without dimensions, lazy loading, or responsive sizes
336
472
  - Bundle size growing without review
337
473
  - No performance monitoring in production
338
474
  - `React.memo` and `useMemo` everywhere (overusing is as bad as underusing)
475
+ - Optimizations kept without a re-measurement that justifies them
476
+ - Several optimizations bundled into one measurement, so no single change can be attributed
477
+ - A "win" that required a test to be changed, skipped, or deleted
478
+ - The same failed optimization attempted more than once because nobody recorded the first attempt
339
479
 
340
480
  ## Verification
341
481
 
342
482
  After any performance-related change:
343
483
 
344
484
  - [ ] Before and after measurements exist (specific numbers)
485
+ - [ ] The result was re-measured the same way as the baseline (same command, same conditions)
486
+ - [ ] The improvement exceeds run-to-run variance, not just the mean
487
+ - [ ] Changes that didn't beat the baseline were reverted, not kept as neutral
488
+ - [ ] Attempts are logged, kept and reverted alike, so a dead idea isn't re-run
345
489
  - [ ] The specific bottleneck is identified and addressed
346
490
  - [ ] Core Web Vitals are within "Good" thresholds
347
491
  - [ ] Bundle size hasn't increased significantly
348
492
  - [ ] No N+1 queries in new data fetching code
349
- - [ ] Performance budget passes in CI (if configured)
493
+ - [ ] Any new index is justified by a query plan before and after, and its write cost was considered
494
+ - [ ] Any new cache states what it keys on and how it goes stale
495
+ - [ ] The measured user-facing metric has a synthetic budget or field monitor that can detect regression
350
496
  - [ ] Existing tests still pass (optimization didn't break behavior)
@@ -51,7 +51,24 @@ The task list is **embedded** in the plan file as the `## Task List` section. Do
51
51
 
52
52
  Match the project's existing `docs` vs `Docs` capitalization, and create the directory if it does not exist.
53
53
 
54
- **Project overrides:** if `.ai/agent-fleet-overrides.md` has a `## planning-and-task-breakdown` section, its keys (`plan-dir`, `naming`, `todo`) override these defaults — `todo: separate` restores a standalone `todo.md`. See [docs/agent-fleet-setup.md](../../docs/agent-fleet-setup.md).
54
+ **Project overrides:** if `.ai/agent-fleet-overrides.md` has a `## planning-and-task-breakdown` section, its keys (`plan-dir`, `naming`, `todo`) override these defaults — `todo: separate` restores a standalone `todo.md`, and `todo: tracker` routes tasks to an external issue tracker (below). See [docs/agent-fleet-setup.md](../../docs/agent-fleet-setup.md).
55
+
56
+ ### Task List Target
57
+
58
+ The **task list target** is where tasks and checkpoints are recorded. It is defined once, here; every other reference in this skill defers to it.
59
+
60
+ - **Default (`todo: embedded`)** — the `## Task List` section of the plan file itself. No separate file.
61
+ - **`todo: separate`** — a standalone checklist-style `todo.md` next to the plan.
62
+ - **`todo: tracker`** — one item per task in the designated issue tracker (GitHub Issues, Jira, Linear, `bd`/beads). Map the Step 4 structure onto the tracker's fields: acceptance criteria and verification steps in the item body, dependencies via the tracker's linking mechanism (`bd dep add`, "blocked by", etc.). Record Step 5 checkpoints as tracker items too, or keep them as a checklist in the plan document if the tracker has no natural equivalent.
63
+
64
+ With a tracker, name it in the plan (e.g. "Tasks tracked in Linear project FOO") so downstream steps and future sessions know where to look, and keep the plan's `## Task List` section as an ordered index of tracker item IDs or links rather than a duplicate checklist.
65
+
66
+ **Never overwrite an incomplete plan.** Before writing the resolved plan path, check whether it already exists and still contains unchecked tasks:
67
+
68
+ - Same work being replanned (the user asked to revise or extend this plan) → update the existing file in place.
69
+ - Different work → **stop and ask.** The unchecked tasks may be mid-build in another session or another flow worktree. Do not delete, overwrite, or rename the existing plan on your own; present the conflict and let the user decide (finish the old plan first, explicitly discard it, or say where the new plan should go).
70
+
71
+ The same rule applies to a tracker target: never bulk-close or delete another plan's open items to make room for new ones.
55
72
 
56
73
  ## The Planning Process
57
74
 
@@ -64,11 +81,11 @@ Before writing any code, operate in read-only mode:
64
81
  - Map dependencies between components
65
82
  - Note risks and unknowns
66
83
 
67
- **Do NOT write code during planning.** The output is a plan document, not implementation.
84
+ **Do NOT write code during planning.** The output is a plan document and a task list recorded in the task list target (see Output Location), not implementation.
68
85
 
69
86
  **Grilling (required before writing tasks):** Read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md). Inventory load-bearing decisions. Skip anything already explicit in chat, prompt, PRD, spec, or rules. Grill every remaining fork (multiple valid ways, contradiction, competing code patterns) one question at a time, with a recommended option. Do not write tasks while a load-bearing choice is still silently assumed. Update Architecture Decisions, Risks, and Open Questions with accepted, rejected, or deferred choices. If nothing is open, note that grilling found no unspecified forks and continue.
70
87
 
71
- **Model poll (planner, when `delegate` is available):** On an unresolved architectural fork at task tier `feature` or `project`, run `voice-1`, `voice-2`, and `voice-3` **after** recon (`scout`/`rules`), never in the same message, with a character-for-character identical instruction. Do not poll on `trivial`/`small` (delegation is off) and do not invent a poll if `delegate` is missing. Agreement becomes an accepted architectural decision in the plan, naming the voices; write a `POLL-{prd-name}.md` digest next to the plan and cite it. Divergence becomes one `ASK_USER:` question with one option per position plus a recommendation and reason — do not write the plan in that same turn. The optional communication contract at [`references/communication-contract.md`](../../references/communication-contract.md) is not loaded automatically; enable it with `append-prompt: references/communication-contract.md` in `## agent-hub`.
88
+ **Model poll (planner, when `delegate` is available):** On an unresolved architectural fork at task tier `feature` or `project`, run `voice-1`, `voice-2`, and `voice-3` **after** recon (`scout`/`rules`), never in the same message, with a character-for-character identical instruction. Do not poll on `trivial`/`small` (delegation is off) and do not invent a poll if `delegate` is missing. Agreement becomes an accepted architectural decision in the plan, naming the voices; write a `POLL-{prd-name}.md` digest next to the plan and cite it. Divergence becomes one `ASK_USER:` question with one option per position plus a recommendation and reason — do not write the plan in that same turn. The optional communication contract at [`../../references/communication-contract.md`](../../references/communication-contract.md) is not loaded automatically; enable it with `append-prompt: references/communication-contract.md` in `## agent-hub`.
72
89
 
73
90
  ### Step 2: Identify the Dependency Graph
74
91
 
@@ -116,7 +133,7 @@ Each vertical slice delivers working, testable functionality.
116
133
 
117
134
  ### Step 4: Write Tasks
118
135
 
119
- Each task follows this structure:
136
+ Each task follows this structure, whether it lands in the plan's `## Task List`, a standalone `todo.md`, or an external tracker item (see Output Location):
120
137
 
121
138
  ```markdown
122
139
  ## Task [N]: [Short descriptive title]
@@ -128,8 +145,8 @@ Each task follows this structure:
128
145
  - [ ] [Specific, testable condition]
129
146
 
130
147
  **Verification:**
131
- - [ ] Tests pass: `npm test -- --grep "feature-name"`
132
- - [ ] Build succeeds: `npm run build`
148
+ - [ ] Tests pass: [the project's `quality:` command, or the repository's focused-test command]
149
+ - [ ] Build succeeds: [the repository's build command]
133
150
  - [ ] Manual check: [description of what to verify]
134
151
 
135
152
  **Dependencies:** [Task numbers this depends on, or "None"]
@@ -148,7 +165,7 @@ Arrange tasks so that:
148
165
  3. Verification checkpoints occur after every 2-3 tasks
149
166
  4. High-risk tasks are early (fail fast)
150
167
 
151
- Add explicit checkpoints:
168
+ Add explicit checkpoints to the task list target:
152
169
 
153
170
  ```markdown
154
171
  ## Checkpoint: After Tasks 1-3
@@ -213,6 +230,8 @@ If a task is 5-8 files (Multi-component feature , such as Search with filtering
213
230
  - [Question needing human input]
214
231
  ```
215
232
 
233
+ When tasks live in an external tracker, keep the Task List section above as an ordered index of tracker item IDs or links instead of a duplicate checklist.
234
+
216
235
  ## Parallelization Opportunities
217
236
 
218
237
  When multiple agents or sessions are available:
@@ -229,6 +248,7 @@ When multiple agents or sessions are available:
229
248
  | "The tasks are obvious" | Write them down anyway. Explicit tasks surface hidden dependencies and forgotten edge cases. |
230
249
  | "Planning is overhead" | Planning is the task. Implementation without a plan is just typing. |
231
250
  | "I can hold it all in my head" | Context windows are finite. Written plans survive session boundaries and compaction. |
251
+ | "The old plan is stale, I'll just replace it" | Unchecked tasks may be mid-build in another session or flow worktree. Overwriting them destroys work state that exists nowhere else. Stop and ask. |
232
252
  | "The PRD already covers everything, no need to grill" | Then grilling produces zero questions. Still run the inventory so silent forks do not slip through. |
233
253
  | "I'll pick the obvious variant and note it in Architecture Decisions" | If more than one variant exists and none was mandated, it is not obvious to the programmer who was not in the room. Ask, then record the choice. |
234
254
  | "Re-confirming the PRD points shows thoroughness" | Re-asking settled requirements wastes the user and implies the agent did not read them. Skip them. |
@@ -236,6 +256,8 @@ When multiple agents or sessions are available:
236
256
  ## Red Flags
237
257
 
238
258
  - Starting implementation without a written task list
259
+ - Overwriting a plan that still has unchecked tasks for different work, without asking
260
+ - Writing a `todo.md` when the project has designated an external tracker (or scattering tasks across both)
239
261
  - Tasks that say "implement the feature" without acceptance criteria
240
262
  - No verification steps in the plan
241
263
  - All tasks touches more than 8+ files
@@ -252,6 +274,8 @@ Before starting implementation, confirm:
252
274
  - [ ] Every task has acceptance criteria
253
275
  - [ ] Every task has a verification step
254
276
  - [ ] Task dependencies are identified and ordered correctly
277
+ - [ ] Tasks are recorded in the task list target resolved from `todo` (default: the plan's `## Task List`)
278
+ - [ ] No pre-existing incomplete plan was overwritten without explicit user confirmation
255
279
  - [ ] No task touches more than ~5 files
256
280
  - [ ] Checkpoints exist between major phases
257
281
  - [ ] The human has reviewed and approved the plan
@@ -262,4 +286,4 @@ Before starting implementation, confirm:
262
286
 
263
287
  ## See Also
264
288
 
265
- Acceptance criteria are per-task and answer "did we build the right thing?". They sit on top of the project-wide Definition of Done, the standing bar every task clears before it counts as done. See `references/definition-of-done.md`.
289
+ Acceptance criteria are per-task and answer "did we build the right thing?". They sit on top of the project-wide Definition of Done, the standing bar every task clears before it counts as done. See `../../references/definition-of-done.md`.