@chankov/agent-fleet 2.0.4 → 2.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (449) hide show
  1. package/.pi/agents/model-profiles.yaml +39 -34
  2. package/.pi/harnesses/agent-hub/README.md +11 -32
  3. package/.pi/harnesses/agent-hub/context/agent-state.ts +1 -1
  4. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  5. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +1 -0
  6. package/.pi/harnesses/agent-hub/dispatch-native.ts +31 -19
  7. package/.pi/harnesses/agent-hub/dispatch-observability.ts +6 -1
  8. package/.pi/harnesses/agent-hub/footer.ts +2 -2
  9. package/.pi/harnesses/agent-hub/index.ts +69 -42
  10. package/.pi/harnesses/agent-hub/input/shortcuts.ts +0 -29
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +59 -3
  13. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  14. package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -0
  15. package/.pi/harnesses/agent-hub/tools/action-executors.ts +5 -4
  16. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +34 -1
  17. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +4 -2
  18. package/.pi/harnesses/agent-hub/types.ts +1 -0
  19. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  20. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +4 -2
  21. package/.pi/harnesses/agent-hub/ui/grid.ts +16 -118
  22. package/.pi/harnesses/agent-hub/ui/pool.ts +1 -6
  23. package/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  24. package/.pi/harnesses/coms/package.json +1 -1
  25. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  26. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +0 -5
  27. package/.pi/harnesses/lib/fleet-dashboard-view.ts +8 -2
  28. package/.versions/2.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  29. package/.versions/2.0.5/.pi/agents/model-profiles.yaml +83 -0
  30. package/.versions/2.0.5/.pi/agents/peers.yaml +145 -0
  31. package/.versions/2.0.5/.pi/agents/teams.yaml +41 -0
  32. package/.versions/2.0.5/.pi/agents/voices.yaml +13 -0
  33. package/.versions/2.0.5/.pi/damage-control-rules.yaml +297 -0
  34. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  35. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  36. package/.versions/2.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  37. package/.versions/2.0.5/.pi/extensions/btw/README.md +120 -0
  38. package/.versions/2.0.5/.pi/extensions/btw/index.ts +914 -0
  39. package/.versions/2.0.5/.pi/extensions/btw/package.json +6 -0
  40. package/.versions/2.0.5/.pi/extensions/btw/state.js +179 -0
  41. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  42. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  43. package/.versions/2.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  44. package/.versions/2.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  45. package/.versions/2.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  46. package/.versions/2.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  47. package/.versions/2.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  48. package/.versions/2.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  49. package/.versions/2.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  50. package/.versions/2.0.5/.pi/extensions/package-lock.json +1175 -0
  51. package/.versions/2.0.5/.pi/extensions/package.json +9 -0
  52. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/README.md +205 -0
  53. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  54. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  55. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  56. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  57. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  58. package/.versions/2.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  59. package/.versions/2.0.5/.pi/harnesses/agent-hub/README.md +1139 -0
  60. package/.versions/2.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  61. package/.versions/2.0.5/.pi/harnesses/agent-hub/artifacts.js +146 -0
  62. package/.versions/2.0.5/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  63. package/.versions/2.0.5/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  64. package/.versions/2.0.5/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  65. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  66. package/.versions/2.0.5/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  67. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  68. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  69. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  70. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  71. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  72. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  73. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  74. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  75. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  76. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  77. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  78. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  79. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  80. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  81. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  82. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  83. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  84. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  85. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  86. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  87. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  88. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  89. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  90. package/.versions/2.0.5/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  91. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  92. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  93. package/.versions/2.0.5/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  94. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  95. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  96. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  97. package/.versions/2.0.5/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  98. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  99. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  100. package/.versions/2.0.5/.pi/harnesses/agent-hub/context-window.js +106 -0
  101. package/.versions/2.0.5/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  102. package/.versions/2.0.5/.pi/harnesses/agent-hub/delegate.ts +446 -0
  103. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  104. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  105. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  106. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  107. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  108. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native-types.ts +208 -0
  109. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-native.ts +199 -0
  110. package/.versions/2.0.5/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  111. package/.versions/2.0.5/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  112. package/.versions/2.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  113. package/.versions/2.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  114. package/.versions/2.0.5/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  115. package/.versions/2.0.5/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  116. package/.versions/2.0.5/.pi/harnesses/agent-hub/footer.ts +30 -0
  117. package/.versions/2.0.5/.pi/harnesses/agent-hub/helpers.ts +266 -0
  118. package/.versions/2.0.5/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  119. package/.versions/2.0.5/.pi/harnesses/agent-hub/index.ts +2115 -0
  120. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  121. package/.versions/2.0.5/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  122. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  123. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  124. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  125. package/.versions/2.0.5/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  126. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  127. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  128. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  129. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  130. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  131. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  132. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  133. package/.versions/2.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  134. package/.versions/2.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  135. package/.versions/2.0.5/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  136. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  137. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  138. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  139. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  140. package/.versions/2.0.5/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  141. package/.versions/2.0.5/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  142. package/.versions/2.0.5/.pi/harnesses/agent-hub/presentation.ts +48 -0
  143. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  144. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  145. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  146. package/.versions/2.0.5/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  147. package/.versions/2.0.5/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  148. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  149. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/runtime.ts +177 -0
  150. package/.versions/2.0.5/.pi/harnesses/agent-hub/research/spawn-run.ts +148 -0
  151. package/.versions/2.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  152. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-contract.js +293 -0
  153. package/.versions/2.0.5/.pi/harnesses/agent-hub/return-extract.js +75 -0
  154. package/.versions/2.0.5/.pi/harnesses/agent-hub/review-findings.js +102 -0
  155. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-budget.js +537 -0
  156. package/.versions/2.0.5/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  157. package/.versions/2.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  158. package/.versions/2.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  159. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-health.js +110 -0
  160. package/.versions/2.0.5/.pi/harnesses/agent-hub/session-start.ts +42 -0
  161. package/.versions/2.0.5/.pi/harnesses/agent-hub/spawn.ts +404 -0
  162. package/.versions/2.0.5/.pi/harnesses/agent-hub/timeline.ts +54 -0
  163. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  164. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  165. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  166. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  167. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +232 -0
  168. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  169. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  170. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  171. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  172. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  173. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  174. package/.versions/2.0.5/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  175. package/.versions/2.0.5/.pi/harnesses/agent-hub/types.ts +62 -0
  176. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  177. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  178. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  179. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  180. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  181. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  182. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  183. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/pool.ts +98 -0
  184. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  185. package/.versions/2.0.5/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  186. package/.versions/2.0.5/.pi/harnesses/agent-hub/version.ts +42 -0
  187. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  188. package/.versions/2.0.5/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  189. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/README.md +53 -0
  190. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/index.ts +532 -0
  191. package/.versions/2.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  192. package/.versions/2.0.5/.pi/harnesses/coms/README.md +100 -0
  193. package/.versions/2.0.5/.pi/harnesses/coms/index.ts +276 -0
  194. package/.versions/2.0.5/.pi/harnesses/coms/package.json +7 -0
  195. package/.versions/2.0.5/.pi/harnesses/coms/version.ts +42 -0
  196. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/README.md +124 -0
  197. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  198. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  199. package/.versions/2.0.5/.pi/harnesses/damage-control-continue/version.ts +42 -0
  200. package/.versions/2.0.5/.pi/harnesses/lib/coms-core-io.ts +385 -0
  201. package/.versions/2.0.5/.pi/harnesses/lib/coms-core.ts +577 -0
  202. package/.versions/2.0.5/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  203. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  204. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  205. package/.versions/2.0.5/.pi/harnesses/lib/context-budget-view.ts +107 -0
  206. package/.versions/2.0.5/.pi/harnesses/lib/context-budget.ts +114 -0
  207. package/.versions/2.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  208. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  209. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  210. package/.versions/2.0.5/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  211. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  212. package/.versions/2.0.5/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  213. package/.versions/2.0.5/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  214. package/.versions/2.0.5/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  215. package/.versions/2.0.5/.pi/harnesses/lib/fleet-panel.ts +34 -0
  216. package/.versions/2.0.5/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  217. package/.versions/2.0.5/.pi/harnesses/lib/fleet-selection.ts +24 -0
  218. package/.versions/2.0.5/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  219. package/.versions/2.0.5/.pi/harnesses/lib/herdr-client.ts +472 -0
  220. package/.versions/2.0.5/.pi/harnesses/lib/herdr-presence.ts +399 -0
  221. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  222. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  223. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  224. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  225. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  226. package/.versions/2.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  227. package/.versions/2.0.5/.pi/harnesses/lib/spawned-peers.js +190 -0
  228. package/.versions/2.0.5/.pi/harnesses/package-lock.json +2039 -0
  229. package/.versions/2.0.5/.pi/harnesses/package.json +10 -0
  230. package/.versions/2.0.5/.pi/prompts/af-build.md +24 -0
  231. package/.versions/2.0.5/.pi/prompts/af-code-simplify.md +22 -0
  232. package/.versions/2.0.5/.pi/prompts/af-plan.md +17 -0
  233. package/.versions/2.0.5/.pi/prompts/af-review.md +16 -0
  234. package/.versions/2.0.5/.pi/prompts/af-set-hermes-telegram.md +15 -0
  235. package/.versions/2.0.5/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  236. package/.versions/2.0.5/.pi/prompts/af-ship.md +17 -0
  237. package/.versions/2.0.5/.pi/prompts/af-spec.md +15 -0
  238. package/.versions/2.0.5/.pi/prompts/af-test.md +19 -0
  239. package/.versions/2.0.5/.pi/skills/bowser/SKILL.md +145 -0
  240. package/.versions/2.0.5/.version +1 -0
  241. package/.versions/2.0.5/agents/architect.md +25 -0
  242. package/.versions/2.0.5/agents/bowser.md +28 -0
  243. package/.versions/2.0.5/agents/builder.md +56 -0
  244. package/.versions/2.0.5/agents/code-reviewer.md +210 -0
  245. package/.versions/2.0.5/agents/deep-researcher.md +33 -0
  246. package/.versions/2.0.5/agents/documenter.md +23 -0
  247. package/.versions/2.0.5/agents/orchestrator.md +23 -0
  248. package/.versions/2.0.5/agents/plan-reviewer.md +84 -0
  249. package/.versions/2.0.5/agents/planner.md +106 -0
  250. package/.versions/2.0.5/agents/releaser.md +25 -0
  251. package/.versions/2.0.5/agents/researcher.md +31 -0
  252. package/.versions/2.0.5/agents/security-auditor.md +168 -0
  253. package/.versions/2.0.5/agents/test-engineer.md +154 -0
  254. package/.versions/2.0.5/agents/web-debugger.md +44 -0
  255. package/.versions/2.0.5/agents/web-performance-auditor.md +194 -0
  256. package/.versions/2.0.5/bin/catalog/harness-runtime-closure.json +36 -0
  257. package/.versions/2.0.5/codex/CONDUCTOR.md +148 -0
  258. package/.versions/2.0.5/docs/ARCHITECTURE.md +407 -0
  259. package/.versions/2.0.5/docs/agent-fleet-setup.md +561 -0
  260. package/.versions/2.0.5/docs/claude-code-coms-bridge.md +133 -0
  261. package/.versions/2.0.5/docs/codex-remote-conductor.md +170 -0
  262. package/.versions/2.0.5/docs/coms-hermes-bridge.md +189 -0
  263. package/.versions/2.0.5/docs/getting-started.md +124 -0
  264. package/.versions/2.0.5/docs/npm-install.md +299 -0
  265. package/.versions/2.0.5/docs/pi-extensions.md +446 -0
  266. package/.versions/2.0.5/docs/pi-setup.md +74 -0
  267. package/.versions/2.0.5/docs/skill-anatomy.md +150 -0
  268. package/.versions/2.0.5/hermes/README.md +347 -0
  269. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  270. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  271. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  272. package/.versions/2.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  273. package/.versions/2.0.5/hermes/gates/gate-o-capability.md +8 -0
  274. package/.versions/2.0.5/hermes/gates/gate-o-validator-fixtures.json +1 -0
  275. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  276. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  277. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  278. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  279. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  280. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  281. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  282. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  283. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  284. package/.versions/2.0.5/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  285. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  286. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  287. package/.versions/2.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  288. package/.versions/2.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  289. package/.versions/2.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  290. package/.versions/2.0.5/hermes/skills/hub-watchdog/SKILL.md +76 -0
  291. package/.versions/2.0.5/hermes/skills/hub-watchdog/manifest.json +1 -0
  292. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  293. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  294. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  295. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  296. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  297. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  298. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  299. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  300. package/.versions/2.0.5/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  301. package/.versions/2.0.5/hermes/watchdog-tests/__init__.py +0 -0
  302. package/.versions/2.0.5/hooks/coms-stop-hook.mjs +84 -0
  303. package/.versions/2.0.5/install-manifest.json +2942 -0
  304. package/.versions/2.0.5/justfile +289 -0
  305. package/.versions/2.0.5/manifest-meta.json +969 -0
  306. package/.versions/2.0.5/references/accessibility-checklist.md +160 -0
  307. package/.versions/2.0.5/references/communication-contract.md +26 -0
  308. package/.versions/2.0.5/references/definition-of-done.md +67 -0
  309. package/.versions/2.0.5/references/fleet-coordination-patterns.md +171 -0
  310. package/.versions/2.0.5/references/observability-checklist.md +91 -0
  311. package/.versions/2.0.5/references/orchestration-patterns.md +370 -0
  312. package/.versions/2.0.5/references/performance-checklist.md +153 -0
  313. package/.versions/2.0.5/references/prompting-patterns.md +380 -0
  314. package/.versions/2.0.5/references/security-checklist.md +179 -0
  315. package/.versions/2.0.5/references/testing-patterns.md +236 -0
  316. package/.versions/2.0.5/references/workflow-authoring.md +304 -0
  317. package/.versions/2.0.5/scripts/claude-code-preflight.ts +70 -0
  318. package/.versions/2.0.5/scripts/codex-conductor.ts +41 -0
  319. package/.versions/2.0.5/scripts/codex-remote-control.ts +167 -0
  320. package/.versions/2.0.5/scripts/coms-claude-bridge.ts +411 -0
  321. package/.versions/2.0.5/scripts/coms-cli.ts +484 -0
  322. package/.versions/2.0.5/scripts/coms-hermes-bridge.ts +413 -0
  323. package/.versions/2.0.5/scripts/fleet.ts +222 -0
  324. package/.versions/2.0.5/scripts/flow.ts +137 -0
  325. package/.versions/2.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  326. package/.versions/2.0.5/scripts/hermes-monitor-scenario.ts +474 -0
  327. package/.versions/2.0.5/scripts/hermes-watchdog-capability-probe.ts +45 -0
  328. package/.versions/2.0.5/scripts/install-hermes-plugin.sh +180 -0
  329. package/.versions/2.0.5/scripts/lib/claude-bridge-core.ts +210 -0
  330. package/.versions/2.0.5/scripts/lib/codex-conductor.ts +88 -0
  331. package/.versions/2.0.5/scripts/lib/codex-remote-control.ts +482 -0
  332. package/.versions/2.0.5/scripts/lib/coms-envelope.ts +582 -0
  333. package/.versions/2.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  334. package/.versions/2.0.5/scripts/lib/fleet-command.ts +270 -0
  335. package/.versions/2.0.5/scripts/lib/flow-command.ts +93 -0
  336. package/.versions/2.0.5/scripts/lib/flow-maintenance.ts +230 -0
  337. package/.versions/2.0.5/scripts/lib/herdr-layout.ts +281 -0
  338. package/.versions/2.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  339. package/.versions/2.0.5/scripts/lib/hermes-monitor-events.ts +1 -0
  340. package/.versions/2.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  341. package/.versions/2.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  342. package/.versions/2.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  343. package/.versions/2.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  344. package/.versions/2.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  345. package/.versions/2.0.5/scripts/lib/monitor-env.ts +146 -0
  346. package/.versions/2.0.5/scripts/lib/peer-launch.ts +318 -0
  347. package/.versions/2.0.5/scripts/lib/persona-banner.ts +62 -0
  348. package/.versions/2.0.5/scripts/lib/runtime-dependencies.js +124 -0
  349. package/.versions/2.0.5/scripts/lib/spawn-stagger.ts +101 -0
  350. package/.versions/2.0.5/scripts/lib/team-project.ts +213 -0
  351. package/.versions/2.0.5/scripts/lib/team-snapshot.ts +147 -0
  352. package/.versions/2.0.5/scripts/package-lock.json +35 -0
  353. package/.versions/2.0.5/scripts/package.json +9 -0
  354. package/.versions/2.0.5/scripts/peer-banner.ts +40 -0
  355. package/.versions/2.0.5/scripts/peer-launch.ts +285 -0
  356. package/.versions/2.0.5/scripts/team-snapshot.ts +237 -0
  357. package/.versions/2.0.5/scripts/team-up.ts +406 -0
  358. package/.versions/2.0.5/scripts/workflows/lib/agent-phase.ts +133 -0
  359. package/.versions/2.0.5/scripts/workflows/lib/changes.ts +61 -0
  360. package/.versions/2.0.5/scripts/workflows/lib/debate.ts +149 -0
  361. package/.versions/2.0.5/scripts/workflows/lib/env.ts +34 -0
  362. package/.versions/2.0.5/scripts/workflows/lib/envelopes.ts +169 -0
  363. package/.versions/2.0.5/scripts/workflows/lib/gates.ts +81 -0
  364. package/.versions/2.0.5/scripts/workflows/lib/git.ts +96 -0
  365. package/.versions/2.0.5/scripts/workflows/lib/merge.ts +95 -0
  366. package/.versions/2.0.5/scripts/workflows/lib/model-profile.ts +22 -0
  367. package/.versions/2.0.5/scripts/workflows/lib/model-visibility.ts +92 -0
  368. package/.versions/2.0.5/scripts/workflows/lib/permissions.ts +130 -0
  369. package/.versions/2.0.5/scripts/workflows/lib/personas.ts +57 -0
  370. package/.versions/2.0.5/scripts/workflows/lib/poll.ts +86 -0
  371. package/.versions/2.0.5/scripts/workflows/lib/quality.ts +64 -0
  372. package/.versions/2.0.5/scripts/workflows/lib/run.ts +108 -0
  373. package/.versions/2.0.5/scripts/workflows/lib/trace.ts +34 -0
  374. package/.versions/2.0.5/scripts/workflows/lib/voices.ts +128 -0
  375. package/.versions/2.0.5/scripts/workflows/lib/writer-lease.ts +112 -0
  376. package/.versions/2.0.5/scripts/workflows/tsconfig.json +22 -0
  377. package/.versions/2.0.5/scripts/workflows/wf-build-test.ts +61 -0
  378. package/.versions/2.0.5/scripts/workflows/wf-debate.ts +87 -0
  379. package/.versions/2.0.5/scripts/workflows/wf-document.ts +50 -0
  380. package/.versions/2.0.5/scripts/workflows/wf-poll.ts +95 -0
  381. package/.versions/2.0.5/scripts/workflows/wf-quality.ts +20 -0
  382. package/.versions/2.0.5/scripts/workflows/wf-scout.ts +38 -0
  383. package/.versions/2.0.5/skills/_internal/grilling.md +59 -0
  384. package/.versions/2.0.5/skills/browser-testing-with-devtools/SKILL.md +351 -0
  385. package/.versions/2.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  386. package/.versions/2.0.5/skills/compound-learning/SKILL.md +137 -0
  387. package/.versions/2.0.5/skills/context-engineering/SKILL.md +291 -0
  388. package/.versions/2.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  389. package/.versions/2.0.5/skills/designing-agents/SKILL.md +394 -0
  390. package/.versions/2.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  391. package/.versions/2.0.5/skills/drafting-workflows/SKILL.md +143 -0
  392. package/.versions/2.0.5/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  393. package/.versions/2.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  394. package/.versions/2.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  395. package/.versions/2.0.5/skills/idea-refine/SKILL.md +182 -0
  396. package/.versions/2.0.5/skills/idea-refine/examples.md +238 -0
  397. package/.versions/2.0.5/skills/idea-refine/frameworks.md +99 -0
  398. package/.versions/2.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  399. package/.versions/2.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  400. package/.versions/2.0.5/skills/incremental-implementation/SKILL.md +298 -0
  401. package/.versions/2.0.5/skills/interview-me/SKILL.md +226 -0
  402. package/.versions/2.0.5/skills/orchestration-verification/SKILL.md +181 -0
  403. package/.versions/2.0.5/skills/peer-coms/SKILL.md +90 -0
  404. package/.versions/2.0.5/skills/performance-optimization/SKILL.md +350 -0
  405. package/.versions/2.0.5/skills/planning-and-task-breakdown/SKILL.md +265 -0
  406. package/.versions/2.0.5/skills/security-and-hardening/SKILL.md +461 -0
  407. package/.versions/2.0.5/skills/spec-driven-development/SKILL.md +256 -0
  408. package/.versions/2.0.5/skills/using-agent-skills/SKILL.md +197 -0
  409. package/.versions/2.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  410. package/.versions/2.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  411. package/.versions/2.0.5/vendor/agent-skills-upstream/README.md +11 -0
  412. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  413. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  414. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  415. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  416. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  417. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  418. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  419. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  420. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  421. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  422. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  423. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  424. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  425. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  426. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  427. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  428. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  429. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  430. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  431. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  432. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  433. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  434. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  435. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  436. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  437. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  438. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  439. package/.versions/2.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  440. package/CHANGELOG.md +6 -0
  441. package/README.md +1 -1
  442. package/agents/builder.md +2 -2
  443. package/agents/documenter.md +2 -1
  444. package/agents/planner.md +2 -1
  445. package/agents/releaser.md +2 -2
  446. package/docs/agent-fleet-setup.md +28 -14
  447. package/docs/pi-extensions.md +3 -4
  448. package/install-manifest.json +1 -1
  449. package/package.json +2 -2
@@ -0,0 +1,149 @@
1
+ import { mkdirSync, writeFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { runAgentPhase, type SpawnAgent } from "./agent-phase.ts";
4
+ import type { DebateReport } from "./envelopes.ts";
5
+ import type { PersonaDefinition } from "./personas.ts";
6
+ import { POLL_PERMISSION_POLICY, POLL_TOOLS, pollArtifactDir } from "./poll.ts";
7
+ import type { Run } from "./run.ts";
8
+ import { resolvePanel, type Voice } from "./voices.ts";
9
+
10
+ export const DEBATE_DEFAULT_ROUNDS = 3;
11
+ export const DEBATE_MIN_ROUNDS = 2;
12
+ export const DEBATE_MAX_ROUNDS = 5;
13
+ export const DEBATE_FOREIGN_PACKET_MAX_BYTES = 16_384;
14
+
15
+ export interface DebateVoiceSuccess { ok: true; voice: Voice; round: number; report: DebateReport; path: string }
16
+ export interface DebateVoiceFailure { ok: false; voice: Voice; round: number; reason: string; path: string }
17
+ export type DebateVoiceResult = DebateVoiceSuccess | DebateVoiceFailure;
18
+ export interface DebateRoundResult { round: number; results: DebateVoiceResult[] }
19
+ export interface DebateResult { panel: string; directory: string; rounds: number; roundsRun: DebateRoundResult[] }
20
+
21
+ export interface DebateVoiceRoundOptions {
22
+ run: Run; cwd: string; persona: PersonaDefinition; voice: Voice; task: string; panel: string;
23
+ round: number; rounds: number; others: DebateVoiceSuccess[];
24
+ spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<DebateReport>;
25
+ }
26
+ export interface DebateOptions {
27
+ run: Run; cwd: string; persona: PersonaDefinition; panel: string; task: string;
28
+ rounds?: number; voices?: Voice[];
29
+ spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<DebateReport>;
30
+ onVoice?: (result: DebateVoiceResult, round: number) => void | Promise<void>;
31
+ }
32
+
33
+ export function resolveDebateRounds(value?: number): number {
34
+ const rounds = value ?? DEBATE_DEFAULT_ROUNDS;
35
+ if (!Number.isInteger(rounds) || rounds < DEBATE_MIN_ROUNDS || rounds > DEBATE_MAX_ROUNDS) {
36
+ throw Object.assign(new Error(`debate --rounds must be an integer from ${DEBATE_MIN_ROUNDS} to ${DEBATE_MAX_ROUNDS} (got ${value ?? rounds})`), { exitCode: 2 });
37
+ }
38
+ return rounds;
39
+ }
40
+
41
+ export function debateArtifactDir(cwd: string, runId: string): string {
42
+ return resolve(pollArtifactDir(cwd, runId), "debate");
43
+ }
44
+
45
+ export function debateRoundDir(cwd: string, runId: string, round: number): string {
46
+ return resolve(debateArtifactDir(cwd, runId), `round-${round}`);
47
+ }
48
+
49
+ export function debateVoicePath(cwd: string, runId: string, round: number, voiceName: string): string {
50
+ return resolve(debateRoundDir(cwd, runId, round), `${voiceName}.md`);
51
+ }
52
+
53
+ export function formatForeignPacket(others: DebateVoiceSuccess[]): string {
54
+ if (!others.length) return "";
55
+ const blocks = others.map(item => `## ${item.voice.name} (${item.voice.model})\n\n\`\`\`json\n${JSON.stringify(item.report, null, 2)}\n\`\`\``);
56
+ return ["Labeled positions from the previous round:", "", ...blocks].join("\n");
57
+ }
58
+
59
+ export function assertForeignPacketSize(packet: string): void {
60
+ const bytes = Buffer.byteLength(packet, "utf8");
61
+ if (bytes > DEBATE_FOREIGN_PACKET_MAX_BYTES) {
62
+ throw new Error(`Debate refused: foreign opinion packet is ${bytes} bytes (cap ${DEBATE_FOREIGN_PACKET_MAX_BYTES})`);
63
+ }
64
+ }
65
+
66
+ export function debateRoundTask(question: string, round: number, total: number, others: DebateVoiceSuccess[]): string {
67
+ const packet = formatForeignPacket(others);
68
+ assertForeignPacketSize(packet);
69
+ return [
70
+ `Debate round ${round} of ${total}.`,
71
+ "You are one voice answering the same question. When labeled positions from other voices are present, address them by name.",
72
+ "Keep your own session; do not pretend to be another voice. There is no judge.",
73
+ "",
74
+ `Question:\n${question}`,
75
+ packet ? `\n${packet}` : "",
76
+ ].filter(Boolean).join("\n");
77
+ }
78
+
79
+ function readOnlyPersona(persona: PersonaDefinition): PersonaDefinition {
80
+ return { ...persona, tools: POLL_TOOLS, writes: [] };
81
+ }
82
+
83
+ export function formatDebateArtifact(result: DebateVoiceResult): string {
84
+ const header = [`# ${result.voice.name}`, "", `- model: ${result.voice.model}`, `- round: ${result.round}`, `- thinking: ${result.voice.thinking ?? "medium"}`];
85
+ if (!result.ok) return `${header.join("\n")}\n- status: failed\n- reason: ${result.reason}\n`;
86
+ return `${header.join("\n")}\n- status: success\n\n## Report\n\n\`\`\`json\n${JSON.stringify(result.report, null, 2)}\n\`\`\`\n`;
87
+ }
88
+
89
+ export function writeDebateArtifact(cwd: string, runId: string, result: DebateVoiceResult): string {
90
+ const directory = debateRoundDir(cwd, runId, result.round);
91
+ mkdirSync(directory, { recursive: true });
92
+ const path = debateVoicePath(cwd, runId, result.round, result.voice.name);
93
+ writeFileSync(path, formatDebateArtifact(result), "utf8");
94
+ return path;
95
+ }
96
+
97
+ export async function debateVoiceRound(options: DebateVoiceRoundOptions): Promise<DebateVoiceResult> {
98
+ const path = debateVoicePath(options.cwd, options.run.trace.runId, options.round, options.voice.name);
99
+ const agent = options.runAgent ?? runAgentPhase<DebateReport>;
100
+ try {
101
+ const report = await agent({
102
+ run: options.run, persona: readOnlyPersona(options.persona),
103
+ task: debateRoundTask(options.task, options.round, options.rounds, options.others),
104
+ envelope: "debate", cwd: options.cwd, spawn: options.spawn,
105
+ model: options.voice.model, thinking: options.voice.thinking,
106
+ sessionTag: options.voice.name, permissionPolicy: POLL_PERMISSION_POLICY,
107
+ });
108
+ const result: DebateVoiceSuccess = { ok: true, voice: options.voice, round: options.round, report, path };
109
+ result.path = writeDebateArtifact(options.cwd, options.run.trace.runId, result);
110
+ return result;
111
+ } catch (error) {
112
+ const result: DebateVoiceFailure = {
113
+ ok: false, voice: options.voice, round: options.round,
114
+ reason: error instanceof Error ? error.message : String(error), path,
115
+ };
116
+ result.path = writeDebateArtifact(options.cwd, options.run.trace.runId, result);
117
+ return result;
118
+ }
119
+ }
120
+
121
+ export async function runDebate(options: DebateOptions): Promise<DebateResult> {
122
+ const rounds = resolveDebateRounds(options.rounds);
123
+ const voices = options.voices ?? resolvePanel(options.panel, options.cwd);
124
+ let active = [...voices];
125
+ const roundsRun: DebateRoundResult[] = [];
126
+ let previousSuccesses: DebateVoiceSuccess[] = [];
127
+ for (let round = 1; round <= rounds; round++) {
128
+ if (active.length < 2) break;
129
+ const results = await Promise.all(active.map(async voice => {
130
+ const others = previousSuccesses.filter(item => item.voice.name !== voice.name);
131
+ assertForeignPacketSize(formatForeignPacket(others));
132
+ const result = await debateVoiceRound({ ...options, voice, round, rounds, others });
133
+ try { await options.onVoice?.(result, round); } catch { /* progress is best-effort */ }
134
+ return result;
135
+ }));
136
+ roundsRun.push({ round, results });
137
+ const succeeded = results.filter((item): item is DebateVoiceSuccess => item.ok);
138
+ if (succeeded.length < 2) {
139
+ if (round === 1) {
140
+ const failures = results.filter(item => !item.ok).map(item => `${item.voice.name}: ${item.reason}`).join("; ");
141
+ throw new Error(`Debate failed: ${succeeded.length} of ${active.length} voices succeeded in round 1${failures ? ` (${failures})` : ""}`);
142
+ }
143
+ break;
144
+ }
145
+ previousSuccesses = succeeded;
146
+ active = succeeded.map(item => item.voice);
147
+ }
148
+ return { panel: options.panel, directory: debateArtifactDir(options.cwd, options.run.trace.runId), rounds, roundsRun };
149
+ }
@@ -0,0 +1,34 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+
4
+ export function parseEnv(text: string): Record<string, string> {
5
+ const values: Record<string, string> = {};
6
+ for (const raw of text.split(/\r?\n/)) {
7
+ const line = raw.trim();
8
+ if (!line || line.startsWith("#")) continue;
9
+ const match = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
10
+ if (!match) continue;
11
+ let value = match[2].trim();
12
+ if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
13
+ const quote = value[0];
14
+ value = value.slice(1, -1);
15
+ if (quote === '"') value = value.replace(/\\n/g, "\n").replace(/\\r/g, "\r").replace(/\\t/g, "\t").replace(/\\"/g, '"').replace(/\\\\/g, "\\");
16
+ } else {
17
+ value = value.replace(/\s+#.*$/, "").trim();
18
+ }
19
+ values[match[1]] = value;
20
+ }
21
+ return values;
22
+ }
23
+
24
+ export function loadEnv(cwd = process.cwd(), env: NodeJS.ProcessEnv = process.env): Record<string, string> {
25
+ const file = resolve(cwd, ".env");
26
+ if (!existsSync(file)) return {};
27
+ const loaded: Record<string, string> = {};
28
+ for (const [key, value] of Object.entries(parseEnv(readFileSync(file, "utf8")))) {
29
+ if (env[key] !== undefined) continue;
30
+ env[key] = value;
31
+ loaded[key] = value;
32
+ }
33
+ return loaded;
34
+ }
@@ -0,0 +1,169 @@
1
+ import { Type, type Static, type TSchema } from "@sinclair/typebox";
2
+ import { Value } from "@sinclair/typebox/value";
3
+ const returnContractPath: string = "../../../.pi/harnesses/agent-hub/return-contract.js";
4
+ const { parseStructuredReturn } = await import(returnContractPath) as { parseStructuredReturn(text: string): Record<string, unknown> | null };
5
+ const StringArray = Type.Array(Type.String());
6
+ const EnvelopeBase = Type.Object({
7
+ status: Type.Union([Type.Literal("success"), Type.Literal("fail")]),
8
+ summary: Type.String(),
9
+ artifacts: StringArray,
10
+ notes_for_next_agent: Type.String(),
11
+ });
12
+ export const PlanEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ commit_message: Type.String() })]);
13
+ export const BuildEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ changed_files: StringArray, commit_message: Type.String() })]);
14
+ export const ReviewEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
15
+ approved: Type.Boolean(), assertions_proven: StringArray, assertions_unproven: StringArray,
16
+ assertions_failed: StringArray, open_risks: StringArray, requires_user_decision: StringArray,
17
+ })]);
18
+ export const ScoutEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ findings: StringArray })]);
19
+ export const DocumentEnvelope = Type.Intersect([EnvelopeBase, Type.Object({ document_path: Type.String(), documented_files: StringArray, commit_message: Type.String() })]);
20
+ const AttributedClaim = Type.Object({ voice: Type.String({ minLength: 1 }), statement: Type.String({ minLength: 1 }) });
21
+ const RejectedClaim = Type.Object({ voice: Type.String({ minLength: 1 }), statement: Type.String({ minLength: 1 }), reason: Type.String({ minLength: 1 }) });
22
+ export const PollEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
23
+ position: Type.String(), case: StringArray,
24
+ confidence: Type.Union([Type.Literal("low"), Type.Literal("medium"), Type.Literal("high")]),
25
+ would_change_my_mind: StringArray,
26
+ })]);
27
+ export const DebateEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
28
+ position: Type.String(), changed: Type.Boolean(), aligned_with: StringArray, refutes: StringArray, evidence_that_moved_me: StringArray,
29
+ })]);
30
+ export const MergeEnvelope = Type.Intersect([EnvelopeBase, Type.Object({
31
+ consensus: Type.Array(AttributedClaim), divergence: Type.Array(AttributedClaim), minority: Type.Array(AttributedClaim),
32
+ rejected: Type.Array(RejectedClaim), recommendation: Type.String(),
33
+ })]);
34
+
35
+ export const ENVELOPES = { plan: PlanEnvelope, build: BuildEnvelope, review: ReviewEnvelope, scout: ScoutEnvelope, document: DocumentEnvelope, poll: PollEnvelope, debate: DebateEnvelope, merge: MergeEnvelope } as const;
36
+ export type EnvelopeName = keyof typeof ENVELOPES;
37
+ export type ScoutReport = Static<typeof ScoutEnvelope>;
38
+ export type PollReport = Static<typeof PollEnvelope>;
39
+ export type DebateReport = Static<typeof DebateEnvelope>;
40
+ export type MergeReport = Static<typeof MergeEnvelope>;
41
+ export const JSON_FIX_ATTEMPTS = 2;
42
+
43
+ export const ENVELOPE_EXAMPLES: Record<EnvelopeName, Record<string, unknown>> = {
44
+ plan: { status: "success", summary: "Plan ready", artifacts: [], notes_for_next_agent: "", commit_message: "docs: add plan" },
45
+ build: { status: "success", summary: "Build complete", artifacts: [], notes_for_next_agent: "", changed_files: ["src/app.ts"], commit_message: "feat: build" },
46
+ review: { status: "success", summary: "Review clean", artifacts: [], notes_for_next_agent: "", approved: true, assertions_proven: [], assertions_unproven: [], assertions_failed: [], open_risks: [], requires_user_decision: [] },
47
+ scout: { status: "success", summary: "Scout complete", artifacts: [], notes_for_next_agent: "", findings: ["X lives in src/x.ts"] },
48
+ document: { status: "success", summary: "Docs complete", artifacts: [], notes_for_next_agent: "", document_path: "docs/x.md", documented_files: ["src/x.ts"], commit_message: "docs: explain x" },
49
+ poll: { status: "success", summary: "Opinion recorded", artifacts: [], notes_for_next_agent: "", position: "Prefer approach A.", case: ["It matches existing seams", "Less migration risk"], confidence: "high", would_change_my_mind: ["Evidence that A breaks the permission model"] },
50
+ debate: { status: "success", summary: "Round complete", artifacts: [], notes_for_next_agent: "", position: "Still prefer A.", changed: false, aligned_with: ["opus"], refutes: ["grok's rewrite is out of scope"], evidence_that_moved_me: [] },
51
+ merge: { status: "success", summary: "Merge complete", artifacts: [], notes_for_next_agent: "", consensus: [{ voice: "sol", statement: "Use approach A" }, { voice: "opus", statement: "Use approach A" }], divergence: [{ voice: "grok", statement: "Prefer approach B" }], minority: [{ voice: "grok", statement: "Approach B isolates failure better" }], rejected: [{ voice: "grok", statement: "Rewrite the module", reason: "Out of scope for this change" }], recommendation: "Adopt approach A; keep grok's isolation concern as a follow-up." },
52
+ };
53
+
54
+ export function envelopePrompt(name: EnvelopeName): string {
55
+ return `Finish by emitting ONLY your Report JSON with exactly this shape:\n${JSON.stringify(ENVELOPE_EXAMPLES[name], null, 2)}`;
56
+ }
57
+
58
+ function reportJsonCandidates(text: string): unknown[] {
59
+ const candidates: unknown[] = [];
60
+ for (let start = text.indexOf("{"); start >= 0; start = text.indexOf("{", start + 1)) {
61
+ let depth = 0, inString = false, escaped = false;
62
+ for (let end = start; end < text.length; end++) {
63
+ const char = text[end];
64
+ if (inString) {
65
+ if (escaped) escaped = false;
66
+ else if (char === "\\") escaped = true;
67
+ else if (char === '"') inString = false;
68
+ continue;
69
+ }
70
+ if (char === '"') { inString = true; continue; }
71
+ if (char === "{") { depth++; continue; }
72
+ if (char !== "}" || --depth !== 0) continue;
73
+ try { candidates.push(JSON.parse(text.slice(start, end + 1))); } catch {}
74
+ break;
75
+ }
76
+ }
77
+ return candidates;
78
+ }
79
+
80
+ function explicitlyParsedHubFields(text: string, parsed: Record<string, unknown>): Record<string, unknown> {
81
+ const candidate: Record<string, unknown> = {};
82
+ for (const [field, value] of Object.entries(parsed)) {
83
+ const label = field.replaceAll("_", "[_ -]");
84
+ const declared = new RegExp(`(?:^|\\n)\\s*(?:#{1,6}\\s+)?${label}\\s*:`, "i").test(text)
85
+ || (Array.isArray(value) && value.length > 0);
86
+ if (declared) candidate[field] = value;
87
+ }
88
+ return candidate;
89
+ }
90
+
91
+ const BASE_FIELDS = ["status", "summary", "artifacts", "notes_for_next_agent"];
92
+ const ENVELOPE_FIELDS: Record<EnvelopeName, string[]> = {
93
+ plan: [...BASE_FIELDS, "commit_message"],
94
+ build: [...BASE_FIELDS, "changed_files", "commit_message"],
95
+ review: [...BASE_FIELDS, "approved", "assertions_proven", "assertions_unproven", "assertions_failed", "open_risks", "requires_user_decision"],
96
+ scout: [...BASE_FIELDS, "findings"],
97
+ document: [...BASE_FIELDS, "document_path", "documented_files", "commit_message"],
98
+ poll: [...BASE_FIELDS, "position", "case", "confidence", "would_change_my_mind"],
99
+ debate: [...BASE_FIELDS, "position", "changed", "aligned_with", "refutes", "evidence_that_moved_me"],
100
+ merge: [...BASE_FIELDS, "consensus", "divergence", "minority", "rejected", "recommendation"],
101
+ };
102
+
103
+ export interface EnvelopeValidation<T = unknown> { ok: boolean; value?: T; errors: string[] }
104
+
105
+ export function envelopeErrorField(error: { path?: unknown }): string {
106
+ const path = typeof error.path === "string" ? error.path : "";
107
+ return path.replace(/^\//, "").replaceAll("/", ".") || "response";
108
+ }
109
+
110
+ function schemaErrors(name: EnvelopeName, candidate: unknown): string[] {
111
+ if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return ["response: expected one complete Report JSON object"];
112
+ const schema: TSchema = ENVELOPES[name];
113
+ const typeErrors = [...Value.Errors(schema, candidate)];
114
+ const specificErrors = typeErrors.filter(error => typeof error.path === "string" && error.path.length > 0);
115
+ const errors = [...new Set((specificErrors.length ? specificErrors : typeErrors).map(error => {
116
+ const field = envelopeErrorField(error);
117
+ return error.type === 45 || /required/i.test(String(error.message ?? "")) ? `missing required field: ${field}` : `${field}: ${error.message}`;
118
+ }))];
119
+ const allowed = new Set(ENVELOPE_FIELDS[name]);
120
+ for (const field of Object.keys(candidate)) if (!allowed.has(field)) errors.push(`${field}: unexpected field for ${name} envelope`);
121
+ return errors;
122
+ }
123
+
124
+ function selectCandidate(name: EnvelopeName, output: string, hubParsed: Record<string, unknown> | null): unknown {
125
+ const jsonCandidates = reportJsonCandidates(output).filter(candidate => candidate && typeof candidate === "object" && !Array.isArray(candidate));
126
+ for (let index = jsonCandidates.length - 1; index >= 0; index--) {
127
+ if (schemaErrors(name, jsonCandidates[index]).length === 0) return jsonCandidates[index];
128
+ }
129
+ const hubCandidate = hubParsed ? explicitlyParsedHubFields(output, hubParsed) : null;
130
+ const candidates = hubCandidate && Object.keys(hubCandidate).length > 0 ? [...jsonCandidates, hubCandidate] : jsonCandidates;
131
+ const expected = new Set(ENVELOPE_FIELDS[name]);
132
+ return candidates.reduce<unknown>((best, candidate) => {
133
+ if (!best) return candidate;
134
+ const score = Object.keys(candidate as object).filter(field => expected.has(field)).length;
135
+ const bestScore = Object.keys(best as object).filter(field => expected.has(field)).length;
136
+ return score >= bestScore ? candidate : best;
137
+ }, null);
138
+ }
139
+
140
+ export function validateEnvelope<T = unknown>(name: EnvelopeName, output: string): EnvelopeValidation<T> {
141
+ // The shared hub parser is deliberately the first parser. Its normalized result is
142
+ // only an input to selection: required flow fields must still exist in the emitted
143
+ // object and pass the exact TypeBox envelope below.
144
+ const hubParsed = parseStructuredReturn(output);
145
+ const candidate = selectCandidate(name, output, hubParsed);
146
+ if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return { ok: false, errors: ["response: expected one complete Report JSON object"] };
147
+ const errors = schemaErrors(name, candidate);
148
+ if (errors.length) return { ok: false, errors };
149
+ const value = candidate as T;
150
+ if ((value as { status: string }).status === "fail") return { ok: false, errors: [`status: agent declared fail${(value as any).summary ? ` — ${(value as any).summary}` : ""}`] };
151
+ return { ok: true, value, errors: [] };
152
+ }
153
+
154
+ export function correctionPrompt(errors: string[]): string {
155
+ return `Your previous response failed validation:\n${errors.map(error => `- ${error}`).join("\n")}\nFix these problems, then re-emit ONLY your Report JSON.`;
156
+ }
157
+
158
+ export async function parseWithCorrections<T>(name: EnvelopeName, initialOutput: string, correct: (prompt: string, attempt: number) => Promise<string>, onInvalid?: (attempt: number, errors: string[]) => void): Promise<T> {
159
+ let output = initialOutput;
160
+ for (let attempt = 0; attempt <= JSON_FIX_ATTEMPTS; attempt++) {
161
+ const result = validateEnvelope<T>(name, output);
162
+ if (result.ok) return result.value!;
163
+ onInvalid?.(attempt, result.errors);
164
+ if (result.errors.some(error => error.startsWith("status: agent declared fail"))) throw Object.assign(new Error(result.errors[0]), { terminal: true });
165
+ if (attempt === JSON_FIX_ATTEMPTS) throw Object.assign(new Error(`${name} envelope invalid after ${attempt + 1} attempts: ${result.errors.join("; ")}`), { terminal: true });
166
+ output = await correct(correctionPrompt(result.errors), attempt + 1);
167
+ }
168
+ throw new Error(`${name} envelope validation exhausted`);
169
+ }
@@ -0,0 +1,81 @@
1
+ import { statSync, readFileSync } from "node:fs";
2
+ import { isAbsolute, resolve } from "node:path";
3
+ import type { Run } from "./run.ts";
4
+ import { executeQuality } from "./quality.ts";
5
+
6
+ export interface GateCheck { item: string; ok: boolean; note: string }
7
+ export class GateReport {
8
+ readonly gate: string;
9
+ readonly checks: GateCheck[] = [];
10
+ constructor(gate: string) { this.gate = gate; }
11
+ check(item: string, ok: boolean, note: string): this { this.checks.push({ item, ok, note }); return this; }
12
+ get ok(): boolean { return this.checks.length > 0 && this.checks.every(check => check.ok); }
13
+ failures(): GateCheck[] { return this.checks.filter(check => !check.ok); }
14
+ }
15
+
16
+ export type Gate<T = any> = (envelope: T, run: Run) => GateReport | Promise<GateReport>;
17
+
18
+ function artifactPath(path: string, run: Run): string { return isAbsolute(path) ? path : resolve(run.trace.cwd, path); }
19
+
20
+ export const artifactsExist: Gate<{ artifacts?: string[] }> = (envelope, run) => {
21
+ const report = new GateReport("artifactsExist");
22
+ for (const item of envelope.artifacts ?? []) {
23
+ try { const stat = statSync(artifactPath(item, run)); report.check(item, true, `${stat.size} bytes`); }
24
+ catch { report.check(item, false, "declared artifact does not exist"); }
25
+ }
26
+ return envelope.artifacts?.length ? report : report.check("artifacts", true, "no artifacts declared");
27
+ };
28
+
29
+ export const filesNonEmpty: Gate<{ artifacts?: string[] }> = (envelope, run) => {
30
+ const report = new GateReport("filesNonEmpty");
31
+ for (const item of envelope.artifacts ?? []) {
32
+ try { const size = statSync(artifactPath(item, run)).size; report.check(item, size > 0, `${size} bytes`); }
33
+ catch { report.check(item, false, "file cannot be read"); }
34
+ }
35
+ return envelope.artifacts?.length ? report : report.check("artifacts", true, "no artifacts declared");
36
+ };
37
+
38
+ export const jsonParses: Gate<{ artifacts?: string[] }> = (envelope, run) => {
39
+ const report = new GateReport("jsonParses");
40
+ const items = (envelope.artifacts ?? []).filter(item => item.toLowerCase().endsWith(".json"));
41
+ for (const item of items) {
42
+ try { JSON.parse(readFileSync(artifactPath(item, run), "utf8")); report.check(item, true, "JSON.parse succeeded"); }
43
+ catch (error) { report.check(item, false, error instanceof Error ? error.message : String(error)); }
44
+ }
45
+ return items.length ? report : report.check("json artifacts", true, "no JSON artifacts declared");
46
+ };
47
+
48
+ export const diffMatchesClaims: Gate<{ changed_files?: string[] }> = (envelope, run) => {
49
+ const report = new GateReport("diffMatchesClaims");
50
+ for (const item of envelope.changed_files ?? []) {
51
+ try { const stat = statSync(artifactPath(item, run)); report.check(item, true, `${stat.size} bytes on disk`); }
52
+ catch { report.check(item, false, "claimed changed file does not exist"); }
53
+ }
54
+ return envelope.changed_files?.length ? report : report.check("changed_files", true, "no changed files claimed");
55
+ };
56
+
57
+ export function testsPass(argv: string[], options: { cwd?: string; timeoutSeconds?: number } = {}): Gate {
58
+ return async (_envelope, run) => {
59
+ const logPath = resolve(run.trace.directory, `gate-tests-${Date.now()}.log`);
60
+ const result = await executeQuality(argv, { cwd: options.cwd ?? run.trace.cwd, logPath, timeoutSeconds: options.timeoutSeconds, signal: run.signal });
61
+ const evidence = result.passed ? `exit 0; ${logPath}` : `${(result.stderr || result.stdout).slice(-4000)}\n${logPath}`;
62
+ return new GateReport("testsPass").check(argv.join(" "), result.passed, evidence);
63
+ };
64
+ }
65
+
66
+ export const verdictConsistent: Gate<{ approved?: boolean; assertions_failed?: unknown[]; assertions_unproven?: unknown[]; open_risks?: unknown[]; requires_user_decision?: unknown[] }> = envelope => {
67
+ const report = new GateReport("verdictConsistent");
68
+ const failed = envelope.assertions_failed ?? [];
69
+ const unproven = envelope.assertions_unproven ?? [];
70
+ const decisions = envelope.requires_user_decision ?? [];
71
+ const problems = [...failed, ...unproven, ...(envelope.open_risks ?? []), ...decisions];
72
+ report.check("approved vs failed assertions", !envelope.approved || failed.length === 0, envelope.approved && failed.length ? "approved verdict has blocking failed assertions" : "consistent");
73
+ report.check("approved vs unresolved work", !envelope.approved || (unproven.length === 0 && decisions.length === 0), envelope.approved && (unproven.length || decisions.length) ? "approved verdict has unresolved assertions or decisions" : "consistent");
74
+ report.check("rejection names a problem", envelope.approved !== false || problems.length > 0, envelope.approved === false && problems.length === 0 ? "rejected verdict names no problem" : "consistent");
75
+ return report;
76
+ };
77
+
78
+ export function gateCorrectionPrompt(reports: GateReport[]): string {
79
+ const failures = reports.flatMap(report => report.failures().map(check => `- ${report.gate} / ${check.item}: ${check.note}`));
80
+ return `Your previous work failed executable gates:\n${failures.join("\n")}\nCorrect the work in this same session, then re-emit ONLY your Report JSON.`;
81
+ }
@@ -0,0 +1,96 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { changedPaths, permitted, rollBack, snapshot, type PermissionPolicy, type PermissionSnapshot } from "./permissions.ts";
3
+
4
+ export class StartRefusedError extends Error {
5
+ readonly exitCode = 3;
6
+ }
7
+ export class GitOperationError extends Error {}
8
+
9
+ export interface FlowBranchMetadata {
10
+ branch: string;
11
+ flowName?: string;
12
+ runId?: string;
13
+ baseBranch?: string;
14
+ baseCommit?: string;
15
+ result?: "accepted" | "rejected";
16
+ }
17
+
18
+ function git(cwd: string, args: string[]): string {
19
+ const result = spawnSync("git", args, { cwd, encoding: "utf8" });
20
+ if (result.status !== 0) throw new GitOperationError((result.stderr || result.stdout || `git ${args.join(" ")} failed`).trim());
21
+ return result.stdout.trim();
22
+ }
23
+ function asStartRefusal(action: () => string): string {
24
+ try { return action(); }
25
+ catch (error) { throw new StartRefusedError(error instanceof Error ? error.message : String(error)); }
26
+ }
27
+
28
+ export function isClean(cwd = process.cwd()): boolean {
29
+ return asStartRefusal(() => git(cwd, ["status", "--porcelain", "--untracked-files=all"])) === "";
30
+ }
31
+
32
+ export function requireCleanTree(cwd = process.cwd(), allowDirty = false): void {
33
+ if (!allowDirty && !isClean(cwd)) throw new StartRefusedError("Flow start refused: working tree is dirty; commit/stash it or pass --allow-dirty.");
34
+ }
35
+
36
+ export function flowBranchName(name: string, runId: string): string {
37
+ return `flow/${name}-${runId}`;
38
+ }
39
+
40
+ function configKey(branch: string, name: string): string { return `branch.${branch}.agentFleet${name}`; }
41
+ function optionalGit(cwd: string, args: string[]): string | undefined {
42
+ try { return git(cwd, args); } catch { return undefined; }
43
+ }
44
+ function writeBranchConfig(cwd: string, branch: string, name: string, value: string): void {
45
+ git(cwd, ["config", "--local", "--replace-all", configKey(branch, name), value]);
46
+ }
47
+
48
+ export function readFlowBranchMetadata(branch: string, cwd = process.cwd()): FlowBranchMetadata {
49
+ const value = (name: string) => optionalGit(cwd, ["config", "--local", "--get", configKey(branch, name)]);
50
+ const flowName = value("FlowName"), runId = value("RunId"), baseBranch = value("BaseBranch"), baseCommit = value("BaseCommit"), result = value("Result");
51
+ return {
52
+ branch,
53
+ ...(flowName ? { flowName } : {}), ...(runId ? { runId } : {}), ...(baseBranch ? { baseBranch } : {}), ...(baseCommit ? { baseCommit } : {}),
54
+ ...(result === "accepted" || result === "rejected" ? { result } : {}),
55
+ };
56
+ }
57
+
58
+ export function recordFlowResult(branch: string, result: "accepted" | "rejected", cwd = process.cwd()): void {
59
+ writeBranchConfig(cwd, branch, "Result", result);
60
+ }
61
+
62
+ export function createFlowBranch(name: string, runId: string, cwd = process.cwd()): string {
63
+ const branch = flowBranchName(name, runId);
64
+ const baseBranch = optionalGit(cwd, ["branch", "--show-current"]);
65
+ const baseCommit = asStartRefusal(() => git(cwd, ["rev-parse", "HEAD"]));
66
+ asStartRefusal(() => git(cwd, ["switch", "-c", branch]));
67
+ try {
68
+ writeBranchConfig(cwd, branch, "FlowName", name);
69
+ writeBranchConfig(cwd, branch, "RunId", runId);
70
+ writeBranchConfig(cwd, branch, "BaseCommit", baseCommit);
71
+ if (baseBranch) writeBranchConfig(cwd, branch, "BaseBranch", baseBranch);
72
+ } catch (error) {
73
+ throw new GitOperationError(`Flow branch was created but its metadata could not be recorded: ${error instanceof Error ? error.message : String(error)}`);
74
+ }
75
+ return branch;
76
+ }
77
+
78
+ export function commitAll(message: string, cwd: string, baseline: PermissionSnapshot, policy: PermissionPolicy = {}): string | null {
79
+ let after = snapshot(cwd);
80
+ const changed = changedPaths(baseline, after);
81
+ const preDirtyChanged = changed.filter(path => baseline.paths.has(path));
82
+ if (preDirtyChanged.length) {
83
+ rollBack(baseline, preDirtyChanged);
84
+ after = snapshot(cwd);
85
+ }
86
+ const introduced = changedPaths(baseline, after).filter(path => !baseline.paths.has(path));
87
+ const violations = introduced.filter(path => !permitted(path, policy, cwd));
88
+ if (violations.length) {
89
+ rollBack(baseline, violations);
90
+ throw new GitOperationError(`Flow introduced paths outside the commit policy: ${violations.join(", ")}`);
91
+ }
92
+ if (!introduced.length) return null;
93
+ git(cwd, ["add", "--", ...introduced]);
94
+ git(cwd, ["commit", "--only", "-m", message, "--", ...introduced]);
95
+ return git(cwd, ["rev-parse", "HEAD"]);
96
+ }
@@ -0,0 +1,95 @@
1
+ import { mkdirSync, writeFileSync } from "node:fs";
2
+ import { runAgentPhase, type SpawnAgent } from "./agent-phase.ts";
3
+ import type { MergeReport } from "./envelopes.ts";
4
+ import type { PermissionPolicy } from "./permissions.ts";
5
+ import type { PersonaDefinition } from "./personas.ts";
6
+ import type { Run } from "./run.ts";
7
+ import { integratorVoice, resolvePanel, type Voice } from "./voices.ts";
8
+ import { POLL_PERMISSION_POLICY, POLL_TOOLS, pollArtifactDir, type PollVoiceResult } from "./poll.ts";
9
+ import { withWriterLease, writerLeaseFile, WriterLeaseHeldError } from "./writer-lease.ts";
10
+
11
+ export const MERGE_APPLY_TOOLS = "read,grep,find,ls,edit,write";
12
+ export const MERGE_APPLY_PERMISSION_POLICY: PermissionPolicy = { writes: ["**"] };
13
+
14
+ export class MergeUnavailableError extends Error {
15
+ constructor(panel: string) {
16
+ super(`Merge is unavailable: panel "${panel}" has no voice with integrator: true.`);
17
+ this.name = "MergeUnavailableError";
18
+ }
19
+ }
20
+
21
+ export interface MergeOptions {
22
+ run: Run; cwd: string; persona: PersonaDefinition; panel: string; task: string; opinions: PollVoiceResult[];
23
+ voices?: Voice[]; spawn?: SpawnAgent; runAgent?: typeof runAgentPhase<MergeReport>;
24
+ apply?: boolean; command?: string;
25
+ }
26
+
27
+ export function mergedPath(cwd: string, runId: string): string {
28
+ return `${pollArtifactDir(cwd, runId)}/merged.md`;
29
+ }
30
+
31
+ export function mergeTask(question: string, opinions: PollVoiceResult[], apply = false): string {
32
+ const blocks = opinions.map(opinion => {
33
+ const body = opinion.ok ? `\`\`\`json\n${JSON.stringify(opinion.report, null, 2)}\n\`\`\`` : `FAILED: ${opinion.reason}`;
34
+ return `## ${opinion.voice.name} (${opinion.voice.model})\n\n${body}`;
35
+ });
36
+ return [
37
+ "Merge the independent poll opinions below into one attributed recommendation.",
38
+ "Do not invent claims that no voice made. Every consensus, divergence, minority, and rejected item must name a voice.",
39
+ "A minority opinion must not be dropped silently; rejecting it requires a reason.",
40
+ apply ? "You have write tools. Apply the recommendation to the working tree; stay inside the writes policy." : "You are read-only. Do not modify the working tree.",
41
+ "",
42
+ `Question:\n${question}`,
43
+ "",
44
+ "Opinions:",
45
+ ...blocks,
46
+ ].join("\n");
47
+ }
48
+
49
+ function writeMerged(cwd: string, runId: string, integrator: Voice, report: MergeReport): string {
50
+ const directory = pollArtifactDir(cwd, runId);
51
+ mkdirSync(directory, { recursive: true });
52
+ const path = mergedPath(cwd, runId);
53
+ writeFileSync(path, `# Merge (${integrator.name})\n\n- model: ${integrator.model}\n\n\`\`\`json\n${JSON.stringify(report, null, 2)}\n\`\`\`\n`, "utf8");
54
+ return path;
55
+ }
56
+
57
+ export async function runMerge(options: MergeOptions): Promise<{ report: MergeReport; integrator: Voice; path: string }> {
58
+ const voices = options.voices ?? resolvePanel(options.panel, options.cwd);
59
+ const integrator = integratorVoice(voices);
60
+ if (!integrator) throw new MergeUnavailableError(options.panel);
61
+ const apply = Boolean(options.apply);
62
+ const agent = options.runAgent ?? runAgentPhase<MergeReport>;
63
+ const spawnIntegrator = () => agent({
64
+ run: options.run,
65
+ persona: {
66
+ ...options.persona,
67
+ tools: apply ? MERGE_APPLY_TOOLS : POLL_TOOLS,
68
+ writes: apply ? MERGE_APPLY_PERMISSION_POLICY.writes : [],
69
+ },
70
+ task: mergeTask(options.task, options.opinions, apply),
71
+ envelope: "merge", cwd: options.cwd, spawn: options.spawn,
72
+ model: integrator.model, thinking: integrator.thinking,
73
+ sessionTag: "merge",
74
+ permissionPolicy: apply ? MERGE_APPLY_PERMISSION_POLICY : POLL_PERMISSION_POLICY,
75
+ });
76
+ if (!apply) {
77
+ const report = await spawnIntegrator();
78
+ return { report, integrator, path: writeMerged(options.cwd, options.run.trace.runId, integrator, report) };
79
+ }
80
+ const command = options.command ?? (options.run.command.join(" ") || "flow poll --apply");
81
+ try {
82
+ const merged = await withWriterLease({ cwd: options.cwd, owner: `merge:${integrator.name}`, command }, async lease => {
83
+ options.run.trace.write("log", { phase: "merge", message: "writer lease acquired", lease: lease.file, owner: lease.record.owner, ownerCommand: lease.record.command });
84
+ const report = await spawnIntegrator();
85
+ return { report, integrator, path: writeMerged(options.cwd, options.run.trace.runId, integrator, report) };
86
+ });
87
+ options.run.trace.write("log", { phase: "merge", message: "writer lease released", lease: writerLeaseFile(options.cwd) });
88
+ return merged;
89
+ } catch (error) {
90
+ if (error instanceof WriterLeaseHeldError) {
91
+ options.run.trace.write("error", { phase: "merge", message: error.message, lease: error.file, owner: error.record.owner, ownerCommand: error.record.command });
92
+ }
93
+ throw error;
94
+ }
95
+ }
@@ -0,0 +1,22 @@
1
+ // The same inherited profile governs CLI workflows spawned by the hub and their children.
2
+ // Dynamic loading follows agent-phase.ts so the standalone workflow TS build stays local.
3
+ import type { Voice } from './voices.ts';
4
+ const runtimePath: string = '../../../.pi/harnesses/agent-hub/policy/profile-runtime.ts';
5
+ export const { readActiveProfile, profileAgent, profileFallback, assertProfileModel, profilePanel } = await import(runtimePath) as {
6
+ readActiveProfile(): {
7
+ name: string;
8
+ profile: {
9
+ defaults: {
10
+ model: string;
11
+ thinking?: string;
12
+ };
13
+ };
14
+ } | undefined;
15
+ profileAgent(name: string): {
16
+ model: string;
17
+ thinking?: string;
18
+ } | undefined;
19
+ profileFallback(model: string | undefined): string | undefined;
20
+ assertProfileModel(model: string): void;
21
+ profilePanel(name: string): Voice[] | undefined;
22
+ };