@chankov/agent-fleet 2.0.3 → 2.0.4

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 (452) hide show
  1. package/.pi/agents/model-profiles.yaml +64 -13
  2. package/.pi/agents/peers.yaml +11 -8
  3. package/.pi/harnesses/agent-hub/README.md +4 -2
  4. package/.pi/harnesses/agent-hub/config/agents.ts +13 -14
  5. package/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  6. package/.pi/harnesses/agent-hub/dispatch-coms.ts +6 -4
  7. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +6 -3
  8. package/.pi/harnesses/agent-hub/dispatch-native.ts +4 -1
  9. package/.pi/harnesses/agent-hub/index.ts +61 -9
  10. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +7 -7
  11. package/.pi/harnesses/agent-hub/package.json +1 -1
  12. package/.pi/harnesses/agent-hub/policy/models.ts +35 -8
  13. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  14. package/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  15. package/.pi/harnesses/agent-hub/provider-semaphore.js +1 -1
  16. package/.pi/harnesses/agent-hub/research/spawn-run.ts +2 -1
  17. package/.pi/harnesses/agent-hub/spawn.ts +17 -1
  18. package/.pi/harnesses/agent-hub/tools/action-executors.ts +2 -0
  19. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -0
  20. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +4 -1
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  23. package/.versions/2.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/2.0.4/.pi/agents/model-profiles.yaml +78 -0
  25. package/.versions/2.0.4/.pi/agents/peers.yaml +145 -0
  26. package/.versions/2.0.4/.pi/agents/teams.yaml +41 -0
  27. package/.versions/2.0.4/.pi/agents/voices.yaml +13 -0
  28. package/.versions/2.0.4/.pi/damage-control-rules.yaml +297 -0
  29. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  30. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  31. package/.versions/2.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  32. package/.versions/2.0.4/.pi/extensions/btw/README.md +120 -0
  33. package/.versions/2.0.4/.pi/extensions/btw/index.ts +914 -0
  34. package/.versions/2.0.4/.pi/extensions/btw/package.json +6 -0
  35. package/.versions/2.0.4/.pi/extensions/btw/state.js +179 -0
  36. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  37. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  38. package/.versions/2.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  39. package/.versions/2.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  40. package/.versions/2.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  41. package/.versions/2.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  42. package/.versions/2.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  43. package/.versions/2.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  44. package/.versions/2.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  45. package/.versions/2.0.4/.pi/extensions/package-lock.json +1175 -0
  46. package/.versions/2.0.4/.pi/extensions/package.json +9 -0
  47. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  48. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  49. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  50. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  51. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  52. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  53. package/.versions/2.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  54. package/.versions/2.0.4/.pi/harnesses/agent-hub/README.md +1160 -0
  55. package/.versions/2.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  56. package/.versions/2.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  57. package/.versions/2.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  58. package/.versions/2.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  59. package/.versions/2.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  60. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  61. package/.versions/2.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  62. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  63. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  64. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  65. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  66. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  67. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  68. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  69. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  70. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  71. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  72. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  73. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  74. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  75. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  76. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  77. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  78. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  79. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  80. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  81. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  82. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  83. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  84. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  85. package/.versions/2.0.4/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  86. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/agents.ts +179 -0
  87. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  88. package/.versions/2.0.4/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  89. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  90. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  91. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  92. package/.versions/2.0.4/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  93. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  94. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  95. package/.versions/2.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  96. package/.versions/2.0.4/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  97. package/.versions/2.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  98. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-coms.ts +234 -0
  99. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  100. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  101. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  102. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  103. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  104. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-native.ts +187 -0
  105. package/.versions/2.0.4/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  106. package/.versions/2.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  107. package/.versions/2.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  108. package/.versions/2.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  109. package/.versions/2.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  110. package/.versions/2.0.4/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  111. package/.versions/2.0.4/.pi/harnesses/agent-hub/footer.ts +30 -0
  112. package/.versions/2.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  113. package/.versions/2.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  114. package/.versions/2.0.4/.pi/harnesses/agent-hub/index.ts +2088 -0
  115. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  116. package/.versions/2.0.4/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  117. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  118. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  119. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  120. package/.versions/2.0.4/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  121. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  122. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  123. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  124. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  125. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  126. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  127. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  128. package/.versions/2.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  129. package/.versions/2.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  130. package/.versions/2.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  131. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  132. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  133. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/profile-runtime.ts +64 -0
  134. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  135. package/.versions/2.0.4/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  136. package/.versions/2.0.4/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  137. package/.versions/2.0.4/.pi/harnesses/agent-hub/presentation.ts +48 -0
  138. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  139. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  140. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  141. package/.versions/2.0.4/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  142. package/.versions/2.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  143. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  144. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  145. package/.versions/2.0.4/.pi/harnesses/agent-hub/research/spawn-run.ts +144 -0
  146. package/.versions/2.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  147. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  148. package/.versions/2.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  149. package/.versions/2.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  150. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  151. package/.versions/2.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  152. package/.versions/2.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  153. package/.versions/2.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  154. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  155. package/.versions/2.0.4/.pi/harnesses/agent-hub/session-start.ts +42 -0
  156. package/.versions/2.0.4/.pi/harnesses/agent-hub/spawn.ts +404 -0
  157. package/.versions/2.0.4/.pi/harnesses/agent-hub/timeline.ts +54 -0
  158. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/action-executors.ts +148 -0
  159. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  160. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  161. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  162. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  163. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  164. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  165. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/herdr-executors.ts +84 -0
  166. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  167. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  168. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  169. package/.versions/2.0.4/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  170. package/.versions/2.0.4/.pi/harnesses/agent-hub/types.ts +61 -0
  171. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  172. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  173. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  174. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  175. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  176. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  177. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  178. package/.versions/2.0.4/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  179. package/.versions/2.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  180. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  181. package/.versions/2.0.4/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  182. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  183. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  184. package/.versions/2.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  185. package/.versions/2.0.4/.pi/harnesses/coms/README.md +100 -0
  186. package/.versions/2.0.4/.pi/harnesses/coms/index.ts +276 -0
  187. package/.versions/2.0.4/.pi/harnesses/coms/package.json +7 -0
  188. package/.versions/2.0.4/.pi/harnesses/coms/version.ts +42 -0
  189. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  190. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  191. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  192. package/.versions/2.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  193. package/.versions/2.0.4/.pi/harnesses/lib/coms-core-io.ts +385 -0
  194. package/.versions/2.0.4/.pi/harnesses/lib/coms-core.ts +577 -0
  195. package/.versions/2.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  196. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  197. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  198. package/.versions/2.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  199. package/.versions/2.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  200. package/.versions/2.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  201. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  202. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  203. package/.versions/2.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  204. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  205. package/.versions/2.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  206. package/.versions/2.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  207. package/.versions/2.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  208. package/.versions/2.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  209. package/.versions/2.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  210. package/.versions/2.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  211. package/.versions/2.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  212. package/.versions/2.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  213. package/.versions/2.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  214. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  215. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  216. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  217. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  218. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  219. package/.versions/2.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  220. package/.versions/2.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  221. package/.versions/2.0.4/.pi/harnesses/package-lock.json +2039 -0
  222. package/.versions/2.0.4/.pi/harnesses/package.json +10 -0
  223. package/.versions/2.0.4/.pi/prompts/af-build.md +24 -0
  224. package/.versions/2.0.4/.pi/prompts/af-code-simplify.md +22 -0
  225. package/.versions/2.0.4/.pi/prompts/af-plan.md +17 -0
  226. package/.versions/2.0.4/.pi/prompts/af-review.md +16 -0
  227. package/.versions/2.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  228. package/.versions/2.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  229. package/.versions/2.0.4/.pi/prompts/af-ship.md +17 -0
  230. package/.versions/2.0.4/.pi/prompts/af-spec.md +15 -0
  231. package/.versions/2.0.4/.pi/prompts/af-test.md +19 -0
  232. package/.versions/2.0.4/.pi/skills/bowser/SKILL.md +145 -0
  233. package/.versions/2.0.4/.version +1 -0
  234. package/.versions/2.0.4/agents/architect.md +25 -0
  235. package/.versions/2.0.4/agents/bowser.md +28 -0
  236. package/.versions/2.0.4/agents/builder.md +56 -0
  237. package/.versions/2.0.4/agents/code-reviewer.md +210 -0
  238. package/.versions/2.0.4/agents/deep-researcher.md +33 -0
  239. package/.versions/2.0.4/agents/documenter.md +22 -0
  240. package/.versions/2.0.4/agents/orchestrator.md +23 -0
  241. package/.versions/2.0.4/agents/plan-reviewer.md +84 -0
  242. package/.versions/2.0.4/agents/planner.md +105 -0
  243. package/.versions/2.0.4/agents/releaser.md +25 -0
  244. package/.versions/2.0.4/agents/researcher.md +31 -0
  245. package/.versions/2.0.4/agents/security-auditor.md +168 -0
  246. package/.versions/2.0.4/agents/test-engineer.md +154 -0
  247. package/.versions/2.0.4/agents/web-debugger.md +44 -0
  248. package/.versions/2.0.4/agents/web-performance-auditor.md +194 -0
  249. package/.versions/2.0.4/bin/catalog/harness-runtime-closure.json +36 -0
  250. package/.versions/2.0.4/codex/CONDUCTOR.md +148 -0
  251. package/.versions/2.0.4/docs/ARCHITECTURE.md +407 -0
  252. package/.versions/2.0.4/docs/agent-fleet-setup.md +547 -0
  253. package/.versions/2.0.4/docs/claude-code-coms-bridge.md +133 -0
  254. package/.versions/2.0.4/docs/codex-remote-conductor.md +170 -0
  255. package/.versions/2.0.4/docs/coms-hermes-bridge.md +189 -0
  256. package/.versions/2.0.4/docs/getting-started.md +124 -0
  257. package/.versions/2.0.4/docs/npm-install.md +299 -0
  258. package/.versions/2.0.4/docs/pi-extensions.md +447 -0
  259. package/.versions/2.0.4/docs/pi-setup.md +74 -0
  260. package/.versions/2.0.4/docs/skill-anatomy.md +150 -0
  261. package/.versions/2.0.4/hermes/README.md +347 -0
  262. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  263. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  264. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  265. package/.versions/2.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  266. package/.versions/2.0.4/hermes/gates/gate-o-capability.md +8 -0
  267. package/.versions/2.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  268. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  269. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  270. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  271. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  272. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  273. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  274. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  275. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  276. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  277. package/.versions/2.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  278. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  279. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  280. package/.versions/2.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  281. package/.versions/2.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  282. package/.versions/2.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  283. package/.versions/2.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  284. package/.versions/2.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  285. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  286. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  287. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  288. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  289. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  290. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  291. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  292. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  293. package/.versions/2.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  294. package/.versions/2.0.4/hermes/watchdog-tests/__init__.py +0 -0
  295. package/.versions/2.0.4/hooks/coms-stop-hook.mjs +84 -0
  296. package/.versions/2.0.4/install-manifest.json +2942 -0
  297. package/.versions/2.0.4/justfile +289 -0
  298. package/.versions/2.0.4/manifest-meta.json +969 -0
  299. package/.versions/2.0.4/references/accessibility-checklist.md +160 -0
  300. package/.versions/2.0.4/references/communication-contract.md +26 -0
  301. package/.versions/2.0.4/references/definition-of-done.md +67 -0
  302. package/.versions/2.0.4/references/fleet-coordination-patterns.md +171 -0
  303. package/.versions/2.0.4/references/observability-checklist.md +91 -0
  304. package/.versions/2.0.4/references/orchestration-patterns.md +370 -0
  305. package/.versions/2.0.4/references/performance-checklist.md +153 -0
  306. package/.versions/2.0.4/references/prompting-patterns.md +380 -0
  307. package/.versions/2.0.4/references/security-checklist.md +179 -0
  308. package/.versions/2.0.4/references/testing-patterns.md +236 -0
  309. package/.versions/2.0.4/references/workflow-authoring.md +304 -0
  310. package/.versions/2.0.4/scripts/claude-code-preflight.ts +70 -0
  311. package/.versions/2.0.4/scripts/codex-conductor.ts +41 -0
  312. package/.versions/2.0.4/scripts/codex-remote-control.ts +167 -0
  313. package/.versions/2.0.4/scripts/coms-claude-bridge.ts +411 -0
  314. package/.versions/2.0.4/scripts/coms-cli.ts +484 -0
  315. package/.versions/2.0.4/scripts/coms-hermes-bridge.ts +413 -0
  316. package/.versions/2.0.4/scripts/fleet.ts +222 -0
  317. package/.versions/2.0.4/scripts/flow.ts +137 -0
  318. package/.versions/2.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  319. package/.versions/2.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  320. package/.versions/2.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  321. package/.versions/2.0.4/scripts/install-hermes-plugin.sh +180 -0
  322. package/.versions/2.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  323. package/.versions/2.0.4/scripts/lib/codex-conductor.ts +88 -0
  324. package/.versions/2.0.4/scripts/lib/codex-remote-control.ts +482 -0
  325. package/.versions/2.0.4/scripts/lib/coms-envelope.ts +582 -0
  326. package/.versions/2.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  327. package/.versions/2.0.4/scripts/lib/fleet-command.ts +270 -0
  328. package/.versions/2.0.4/scripts/lib/flow-command.ts +93 -0
  329. package/.versions/2.0.4/scripts/lib/flow-maintenance.ts +230 -0
  330. package/.versions/2.0.4/scripts/lib/herdr-layout.ts +281 -0
  331. package/.versions/2.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  332. package/.versions/2.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  333. package/.versions/2.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  334. package/.versions/2.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  335. package/.versions/2.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  336. package/.versions/2.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  337. package/.versions/2.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  338. package/.versions/2.0.4/scripts/lib/monitor-env.ts +146 -0
  339. package/.versions/2.0.4/scripts/lib/peer-launch.ts +318 -0
  340. package/.versions/2.0.4/scripts/lib/persona-banner.ts +62 -0
  341. package/.versions/2.0.4/scripts/lib/runtime-dependencies.js +124 -0
  342. package/.versions/2.0.4/scripts/lib/spawn-stagger.ts +101 -0
  343. package/.versions/2.0.4/scripts/lib/team-project.ts +213 -0
  344. package/.versions/2.0.4/scripts/lib/team-snapshot.ts +147 -0
  345. package/.versions/2.0.4/scripts/package-lock.json +35 -0
  346. package/.versions/2.0.4/scripts/package.json +9 -0
  347. package/.versions/2.0.4/scripts/peer-banner.ts +40 -0
  348. package/.versions/2.0.4/scripts/peer-launch.ts +285 -0
  349. package/.versions/2.0.4/scripts/team-snapshot.ts +237 -0
  350. package/.versions/2.0.4/scripts/team-up.ts +406 -0
  351. package/.versions/2.0.4/scripts/workflows/lib/agent-phase.ts +133 -0
  352. package/.versions/2.0.4/scripts/workflows/lib/changes.ts +61 -0
  353. package/.versions/2.0.4/scripts/workflows/lib/debate.ts +149 -0
  354. package/.versions/2.0.4/scripts/workflows/lib/env.ts +34 -0
  355. package/.versions/2.0.4/scripts/workflows/lib/envelopes.ts +169 -0
  356. package/.versions/2.0.4/scripts/workflows/lib/gates.ts +81 -0
  357. package/.versions/2.0.4/scripts/workflows/lib/git.ts +96 -0
  358. package/.versions/2.0.4/scripts/workflows/lib/merge.ts +95 -0
  359. package/.versions/2.0.4/scripts/workflows/lib/model-profile.ts +22 -0
  360. package/.versions/2.0.4/scripts/workflows/lib/model-visibility.ts +92 -0
  361. package/.versions/2.0.4/scripts/workflows/lib/permissions.ts +130 -0
  362. package/.versions/2.0.4/scripts/workflows/lib/personas.ts +57 -0
  363. package/.versions/2.0.4/scripts/workflows/lib/poll.ts +86 -0
  364. package/.versions/2.0.4/scripts/workflows/lib/quality.ts +64 -0
  365. package/.versions/2.0.4/scripts/workflows/lib/run.ts +108 -0
  366. package/.versions/2.0.4/scripts/workflows/lib/trace.ts +34 -0
  367. package/.versions/2.0.4/scripts/workflows/lib/voices.ts +128 -0
  368. package/.versions/2.0.4/scripts/workflows/lib/writer-lease.ts +112 -0
  369. package/.versions/2.0.4/scripts/workflows/tsconfig.json +22 -0
  370. package/.versions/2.0.4/scripts/workflows/wf-build-test.ts +61 -0
  371. package/.versions/2.0.4/scripts/workflows/wf-debate.ts +87 -0
  372. package/.versions/2.0.4/scripts/workflows/wf-document.ts +50 -0
  373. package/.versions/2.0.4/scripts/workflows/wf-poll.ts +95 -0
  374. package/.versions/2.0.4/scripts/workflows/wf-quality.ts +20 -0
  375. package/.versions/2.0.4/scripts/workflows/wf-scout.ts +38 -0
  376. package/.versions/2.0.4/skills/_internal/grilling.md +59 -0
  377. package/.versions/2.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  378. package/.versions/2.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  379. package/.versions/2.0.4/skills/compound-learning/SKILL.md +137 -0
  380. package/.versions/2.0.4/skills/context-engineering/SKILL.md +291 -0
  381. package/.versions/2.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  382. package/.versions/2.0.4/skills/designing-agents/SKILL.md +394 -0
  383. package/.versions/2.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  384. package/.versions/2.0.4/skills/drafting-workflows/SKILL.md +143 -0
  385. package/.versions/2.0.4/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  386. package/.versions/2.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  387. package/.versions/2.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  388. package/.versions/2.0.4/skills/idea-refine/SKILL.md +182 -0
  389. package/.versions/2.0.4/skills/idea-refine/examples.md +238 -0
  390. package/.versions/2.0.4/skills/idea-refine/frameworks.md +99 -0
  391. package/.versions/2.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  392. package/.versions/2.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  393. package/.versions/2.0.4/skills/incremental-implementation/SKILL.md +298 -0
  394. package/.versions/2.0.4/skills/interview-me/SKILL.md +226 -0
  395. package/.versions/2.0.4/skills/orchestration-verification/SKILL.md +181 -0
  396. package/.versions/2.0.4/skills/peer-coms/SKILL.md +90 -0
  397. package/.versions/2.0.4/skills/performance-optimization/SKILL.md +350 -0
  398. package/.versions/2.0.4/skills/planning-and-task-breakdown/SKILL.md +265 -0
  399. package/.versions/2.0.4/skills/security-and-hardening/SKILL.md +461 -0
  400. package/.versions/2.0.4/skills/spec-driven-development/SKILL.md +256 -0
  401. package/.versions/2.0.4/skills/using-agent-skills/SKILL.md +197 -0
  402. package/.versions/2.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  403. package/.versions/2.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  404. package/.versions/2.0.4/vendor/agent-skills-upstream/README.md +11 -0
  405. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  406. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  407. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  408. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  409. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  410. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  411. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  412. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  413. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  414. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  415. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  416. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  417. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  418. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  419. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  420. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  421. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  422. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  423. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  424. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  425. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  426. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  427. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  428. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  429. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  430. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  431. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  432. package/.versions/2.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  433. package/CHANGELOG.md +7 -0
  434. package/bin/catalog/harness-runtime-closure.json +2 -0
  435. package/bin/cli.js +47 -9
  436. package/bin/lib/doctor.js +35 -2
  437. package/bin/lib/reconcile.js +3 -2
  438. package/docs/agent-fleet-setup.md +74 -0
  439. package/docs/claude-code-coms-bridge.md +5 -0
  440. package/docs/getting-started.md +5 -0
  441. package/docs/npm-install.md +12 -5
  442. package/install-manifest.json +3 -1
  443. package/justfile +1 -1
  444. package/package.json +5 -3
  445. package/scripts/claude-code-preflight.ts +70 -0
  446. package/scripts/fleet.ts +23 -0
  447. package/scripts/lib/runtime-dependencies.js +124 -0
  448. package/scripts/peer-launch.ts +27 -1
  449. package/scripts/workflows/lib/agent-phase.ts +2 -1
  450. package/scripts/workflows/lib/model-profile.ts +22 -0
  451. package/scripts/workflows/lib/personas.ts +6 -3
  452. package/scripts/workflows/lib/voices.ts +3 -0
@@ -0,0 +1,128 @@
1
+ import { readActiveProfile, profilePanel } from './model-profile.ts';
2
+ import { existsSync, readFileSync } from "node:fs";
3
+ import { resolve } from "node:path";
4
+ import { parse as parseYaml } from "yaml";
5
+
6
+ export const VOICES_REL = ".pi/agents/voices.yaml";
7
+ export const VOICE_NAME = /^[A-Za-z0-9_-]{1,16}$/;
8
+ export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"] as const;
9
+ export type ThinkingLevel = (typeof THINKING_LEVELS)[number];
10
+ const THINKING = new Set<string>(THINKING_LEVELS);
11
+ const VOICE_KEYS = new Set(["name", "model", "thinking", "integrator"]);
12
+ const MIN_VOICES = 2;
13
+ const MAX_VOICES = 5;
14
+
15
+ export interface Voice {
16
+ name: string;
17
+ model: string;
18
+ thinking?: ThinkingLevel;
19
+ integrator?: boolean;
20
+ }
21
+ export interface VoicesFile { path: string; rel: string; panels: Record<string, Voice[]> }
22
+ export class VoicesError extends Error {
23
+ readonly errors: string[];
24
+ readonly exitCode = 2;
25
+ constructor(errors: string[]) {
26
+ super(errors.join("\n"));
27
+ this.errors = errors;
28
+ this.name = "VoicesError";
29
+ }
30
+ }
31
+
32
+ export function voicesPath(cwd = process.cwd()): string {
33
+ return resolve(cwd, VOICES_REL);
34
+ }
35
+
36
+ export function listPanelNames(cwd = process.cwd()): string[] {
37
+ const active=readActiveProfile();if(active) return [active.name];
38
+ try { return Object.keys(loadVoices(cwd).panels); } catch { return []; }
39
+ }
40
+
41
+ export function resolvePanel(name: string, cwd = process.cwd()): Voice[] {
42
+ const selected=profilePanel(name);if(selected) return selected;
43
+ const file = loadVoices(cwd);
44
+ const voices = file.panels[name];
45
+ if (!voices) {
46
+ const available = Object.keys(file.panels);
47
+ throw new VoicesError([`${file.rel} panel "${name}" was not found. Available panels: ${available.length ? available.join(", ") : "(none)"}`]);
48
+ }
49
+ return voices;
50
+ }
51
+
52
+ export function integratorVoice(voices: Voice[]): Voice | undefined {
53
+ return voices.find(voice => voice.integrator === true);
54
+ }
55
+
56
+ export function loadVoices(cwd = process.cwd()): VoicesFile {
57
+ const path = voicesPath(cwd);
58
+ if (!existsSync(path)) throw new VoicesError([`${VOICES_REL}: file not found`]);
59
+ let raw: unknown;
60
+ try { raw = parseYaml(readFileSync(path, "utf8")); }
61
+ catch (error) { throw new VoicesError([`${VOICES_REL}: invalid YAML (${error instanceof Error ? error.message : String(error)})`]); }
62
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new VoicesError([`${VOICES_REL}: file must be a mapping of panel name to voice lists`]);
63
+ const errors: string[] = [];
64
+ const panels: Record<string, Voice[]> = {};
65
+ for (const [panel, value] of Object.entries(raw as Record<string, unknown>)) {
66
+ const voices = validatePanel(panel, value, errors);
67
+ if (voices) panels[panel] = voices;
68
+ }
69
+ if (errors.length) throw new VoicesError(errors);
70
+ return { path, rel: VOICES_REL, panels };
71
+ }
72
+
73
+ function validatePanel(panel: string, value: unknown, errors: string[]): Voice[] | undefined {
74
+ const prefix = `${VOICES_REL} panel "${panel}"`;
75
+ if (!Array.isArray(value)) {
76
+ errors.push(`${prefix}: must be a list of voices`);
77
+ return undefined;
78
+ }
79
+ if (value.length < MIN_VOICES || value.length > MAX_VOICES) {
80
+ errors.push(`${prefix}: has ${value.length} voices; a panel must have between ${MIN_VOICES} and ${MAX_VOICES}`);
81
+ }
82
+ const voices: Voice[] = [];
83
+ const seen = new Set<string>();
84
+ let integrators = 0;
85
+ for (const [index, entry] of value.entries()) {
86
+ const parsed = validateVoice(prefix, index, entry, errors);
87
+ if (parsed.name) {
88
+ if (seen.has(parsed.name)) errors.push(`${prefix}: duplicate voice name "${parsed.name}"`);
89
+ seen.add(parsed.name);
90
+ }
91
+ if (parsed.integrator) integrators++;
92
+ if (parsed.voice) voices.push(parsed.voice);
93
+ }
94
+ if (integrators > 1) errors.push(`${prefix}: has ${integrators} voices with integrator: true; at most one is allowed`);
95
+ return voices;
96
+ }
97
+
98
+ function validateVoice(prefix: string, index: number, entry: unknown, errors: string[]): { voice?: Voice; name?: string; integrator: boolean } {
99
+ const label = `${prefix} voice[${index}]`;
100
+ if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
101
+ errors.push(`${label}: must be a mapping with name and model`);
102
+ return { integrator: false };
103
+ }
104
+ const raw = entry as Record<string, unknown>;
105
+ for (const key of Object.keys(raw)) {
106
+ if (!VOICE_KEYS.has(key)) errors.push(`${label}: unknown key "${key}"`);
107
+ }
108
+ const name = typeof raw.name === "string" && VOICE_NAME.test(raw.name) ? raw.name : undefined;
109
+ if (!name) errors.push(`${label}: name is required, unique in the panel, and must match ${VOICE_NAME}`);
110
+ const model = raw.model;
111
+ const modelOk = typeof model === "string" && model.includes("/") && !model.startsWith("/") && !model.endsWith("/") && model.split("/").every(part => part);
112
+ if (!modelOk) errors.push(`${label}: model must be fully qualified provider/id (got ${JSON.stringify(raw.model)})`);
113
+ let thinking: ThinkingLevel | undefined;
114
+ if (raw.thinking !== undefined) {
115
+ if (typeof raw.thinking !== "string" || !THINKING.has(raw.thinking)) {
116
+ errors.push(`${label}: thinking must be one of ${[...THINKING_LEVELS].join("|")}`);
117
+ } else thinking = raw.thinking as ThinkingLevel;
118
+ }
119
+ if (raw.integrator !== undefined && typeof raw.integrator !== "boolean") {
120
+ errors.push(`${label}: integrator must be a boolean`);
121
+ }
122
+ const integrator = raw.integrator === true;
123
+ if (!name || !modelOk) return { name, integrator };
124
+ return {
125
+ name, integrator,
126
+ voice: { name, model: model as string, ...(thinking ? { thinking } : {}), ...(integrator ? { integrator: true } : {}) },
127
+ };
128
+ }
@@ -0,0 +1,112 @@
1
+ import { mkdirSync, readFileSync, realpathSync, statSync, unlinkSync, writeFileSync } from "node:fs";
2
+ import { dirname, resolve } from "node:path";
3
+ import { createHash } from "node:crypto";
4
+
5
+ export interface WriterLeaseRecord {
6
+ owner: string;
7
+ pid: number;
8
+ command: string;
9
+ path: string;
10
+ createdAt: string;
11
+ }
12
+
13
+ export interface WriterLeaseHandle {
14
+ file: string;
15
+ record: WriterLeaseRecord;
16
+ }
17
+
18
+ export class WriterLeaseHeldError extends Error {
19
+ readonly record: WriterLeaseRecord;
20
+ readonly file: string;
21
+ constructor(record: WriterLeaseRecord, file: string) {
22
+ super(`Writer lease held by ${record.owner} pid ${record.pid} (${record.command}) at ${file}`);
23
+ this.name = "WriterLeaseHeldError";
24
+ this.record = record;
25
+ this.file = file;
26
+ }
27
+ }
28
+
29
+ export function writerLeaseKey(cwd: string): string {
30
+ return createHash("sha256").update(realpathSync(cwd)).digest("hex");
31
+ }
32
+
33
+ export function writerLeaseFile(cwd: string): string {
34
+ const real = realpathSync(cwd);
35
+ return resolve(real, ".pi", "writer-leases", `${writerLeaseKey(cwd)}.lock`);
36
+ }
37
+
38
+ function pidAlive(pid: number): boolean {
39
+ if (!Number.isInteger(pid) || pid <= 0) return false;
40
+ try {
41
+ process.kill(pid, 0);
42
+ return true;
43
+ } catch (error) {
44
+ return (error as NodeJS.ErrnoException).code === "EPERM";
45
+ }
46
+ }
47
+
48
+ function readRecord(file: string): WriterLeaseRecord | undefined {
49
+ try {
50
+ const value = JSON.parse(readFileSync(file, "utf8")) as WriterLeaseRecord;
51
+ if (!value || typeof value.owner !== "string" || typeof value.command !== "string" || !Number.isInteger(value.pid)) return undefined;
52
+ return value;
53
+ } catch {
54
+ return undefined;
55
+ }
56
+ }
57
+
58
+ function writeExclusive(file: string, record: WriterLeaseRecord): void {
59
+ mkdirSync(dirname(file), { recursive: true });
60
+ writeFileSync(file, `${JSON.stringify(record)}\n`, { flag: "wx", mode: 0o600 });
61
+ }
62
+
63
+ export function acquireWriterLease(options: { cwd: string; owner: string; command: string; pid?: number }): WriterLeaseHandle {
64
+ const path = realpathSync(options.cwd);
65
+ const file = writerLeaseFile(options.cwd);
66
+ const record: WriterLeaseRecord = {
67
+ owner: options.owner,
68
+ pid: options.pid ?? process.pid,
69
+ command: options.command,
70
+ path,
71
+ createdAt: new Date().toISOString(),
72
+ };
73
+ try {
74
+ writeExclusive(file, record);
75
+ return { file, record };
76
+ } catch (error) {
77
+ if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
78
+ }
79
+ const existing = readRecord(file);
80
+ if (existing && pidAlive(existing.pid)) throw new WriterLeaseHeldError(existing, file);
81
+ try { unlinkSync(file); } catch { /* stolen or already gone */ }
82
+ try {
83
+ writeExclusive(file, record);
84
+ return { file, record };
85
+ } catch (error) {
86
+ if ((error as NodeJS.ErrnoException).code === "EEXIST") {
87
+ const raced = readRecord(file);
88
+ if (raced) throw new WriterLeaseHeldError(raced, file);
89
+ }
90
+ throw error;
91
+ }
92
+ }
93
+
94
+ export function releaseWriterLease(handle: WriterLeaseHandle): void {
95
+ const existing = readRecord(handle.file);
96
+ if (!existing) return;
97
+ if (existing.pid !== handle.record.pid || existing.owner !== handle.record.owner) return;
98
+ try { unlinkSync(handle.file); } catch { /* already gone */ }
99
+ }
100
+
101
+ export function writerLeaseMode(file: string): number {
102
+ return statSync(file).mode & 0o777;
103
+ }
104
+
105
+ export async function withWriterLease<T>(options: { cwd: string; owner: string; command: string; pid?: number }, body: (lease: WriterLeaseHandle) => Promise<T> | T): Promise<T> {
106
+ const lease = acquireWriterLease(options);
107
+ try {
108
+ return await body(lease);
109
+ } finally {
110
+ releaseWriterLease(lease);
111
+ }
112
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "compilerOptions": {
3
+ "allowImportingTsExtensions": true,
4
+ "allowJs": true,
5
+ "checkJs": false,
6
+ "esModuleInterop": true,
7
+ "module": "NodeNext",
8
+ "moduleResolution": "NodeNext",
9
+ "noEmit": true,
10
+ "skipLibCheck": true,
11
+ "strict": true,
12
+ "target": "ES2022",
13
+ "types": ["node"]
14
+ },
15
+ "include": [
16
+ "./*.ts",
17
+ "./lib/*.ts"
18
+ ],
19
+ "exclude": [
20
+ "./**/*.test.ts"
21
+ ]
22
+ }
@@ -0,0 +1,61 @@
1
+ import { runAgentPhase } from "./lib/agent-phase.ts";
2
+ import { ENVELOPE_EXAMPLES, validateEnvelope, type BuildEnvelope as BuildEnvelopeSchema } from "./lib/envelopes.ts";
3
+ import { artifactsExist, diffMatchesClaims } from "./lib/gates.ts";
4
+ import { commitAll } from "./lib/git.ts";
5
+ import { snapshot, type PermissionSnapshot } from "./lib/permissions.ts";
6
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
7
+ import { qualityCommand, runTests, type QualityResult } from "./lib/quality.ts";
8
+ import type { FinishResult, Run } from "./lib/run.ts";
9
+ import type { Static } from "@sinclair/typebox";
10
+
11
+ export type BuildReport = Static<typeof BuildEnvelopeSchema>;
12
+ export const MAX_BUILD_FIX_ATTEMPTS = 2;
13
+ const BUILDER_PERMISSION_POLICY = { writes: ["**"] };
14
+ export interface BuildTestDeps {
15
+ agent?: (options: Parameters<typeof runAgentPhase<BuildReport>>[0]) => Promise<BuildReport>;
16
+ tests?: (run: Run, options: { cwd: string }) => Promise<QualityResult>;
17
+ commit?: (message: string, cwd: string, baseline: PermissionSnapshot, policy: { writes?: string[] }) => string | null;
18
+ persona?: PersonaDefinition;
19
+ baseline?: PermissionSnapshot;
20
+ maxFixAttempts?: number;
21
+ }
22
+ export function buildTestWorkflowPreflight(cwd: string): void { resolvePersona("builder", cwd); qualityCommand(cwd); }
23
+ function dryBuild(): BuildReport {
24
+ const parsed = validateEnvelope<BuildReport>("build", JSON.stringify(ENVELOPE_EXAMPLES.build));
25
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
26
+ return parsed.value!;
27
+ }
28
+ function redOutput(result: QualityResult): string { return `${result.stdout}${result.stderr}`; }
29
+
30
+ /** Phases: engineer(request) → agent(builder) → code(test) → agent(builder-fix, bounded) → code(commit) */
31
+ export async function buildTestWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string }, deps: BuildTestDeps = {}): Promise<FinishResult> {
32
+ const request = input.args.join(" ").trim();
33
+ if (!request) throw Object.assign(new Error("build-test flow requires an implementation request"), { exitCode: 2 });
34
+ const persona = deps.persona ?? resolvePersona("builder", input.cwd);
35
+ const baseline = deps.baseline ?? run.repositoryBaseline ?? snapshot(input.cwd);
36
+ const agent = deps.agent ?? runAgentPhase<BuildReport>;
37
+ const tests = deps.tests ?? ((activeRun, options) => runTests(activeRun, options));
38
+ const commit = deps.commit ?? commitAll;
39
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Preserve the exact implementation outcome the operator asked for" }, phase => phase.log(request));
40
+ let report = await run.phase({ name: "build", kind: "agent", owner: "builder", description: "Implement the requested change before deterministic verification" }, () => input.dryRun ? dryBuild() : agent({ run, persona, task: request, envelope: "build", cwd: input.cwd, gates: [artifactsExist, diffMatchesClaims], gateRetries: 1, permissionPolicy: BUILDER_PERMISSION_POLICY }));
41
+ let quality = await run.phase({ name: "test", kind: "code", owner: "quality", description: "Measure the implementation with the configured suite before any commit" }, async phase => {
42
+ if (input.dryRun) { phase.log("dry-run: green quality result stubbed"); return { argv: ["dry-run"], exitCode: 0, stdout: "", stderr: "", logPath: run.trace.file, passed: true }; }
43
+ const result = await tests(run, { cwd: input.cwd }); phase.log(result.passed ? "suite passed" : "suite failed", { exitCode: result.exitCode, logPath: result.logPath }); return result;
44
+ });
45
+ for (let attempt = 1; !quality.passed && attempt <= (deps.maxFixAttempts ?? MAX_BUILD_FIX_ATTEMPTS); attempt++) {
46
+ const output = redOutput(quality);
47
+ report = await run.phase({ name: `builder-fix-${attempt}`, kind: "agent", owner: "builder", description: "Correct the implementation using verbatim evidence from the red suite" }, () => input.dryRun ? dryBuild() : agent({
48
+ run, persona, envelope: "build", cwd: input.cwd, gates: [artifactsExist, diffMatchesClaims], gateRetries: 1, permissionPolicy: BUILDER_PERMISSION_POLICY,
49
+ task: `The deterministic test suite is red. Correct the implementation. The suite output below is forwarded verbatim:\n--- BEGIN VERBATIM TEST OUTPUT ---\n${output}\n--- END VERBATIM TEST OUTPUT ---`,
50
+ }));
51
+ quality = await run.phase({ name: `test-after-fix-${attempt}`, kind: "code", owner: "quality", description: "Re-run the same configured suite to decide whether repair succeeded" }, async () => tests(run, { cwd: input.cwd }));
52
+ }
53
+ if (!quality.passed) return run.finish({ accepted: false, reason: `the suite remained red after ${deps.maxFixAttempts ?? MAX_BUILD_FIX_ATTEMPTS} builder fix attempts` });
54
+ await run.phase({ name: "commit", kind: "code", owner: "git", description: "Create one commit only after deterministic verification is green" }, phase => {
55
+ if (input.dryRun) return phase.log("dry-run: commit skipped");
56
+ const hash = commit(report.commit_message, input.cwd, baseline, { writes: persona.writes });
57
+ if (hash) phase.log("verified work committed", { hash });
58
+ else phase.log("no flow-introduced changes to commit");
59
+ });
60
+ return run.finish({ accepted: true });
61
+ }
@@ -0,0 +1,87 @@
1
+ import { ENVELOPE_EXAMPLES, validateEnvelope, type DebateReport } from "./lib/envelopes.ts";
2
+ import { StartRefusedError } from "./lib/git.ts";
3
+ import { debateVoiceRound, resolveDebateRounds, writeDebateArtifact, type DebateVoiceResult } from "./lib/debate.ts";
4
+ import { checkChildVisibility, type ChildVisibilityReport } from "./lib/model-visibility.ts";
5
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
6
+ import type { FinishResult, Run } from "./lib/run.ts";
7
+ import { listPanelNames, resolvePanel, type Voice } from "./lib/voices.ts";
8
+
9
+ export interface DebateWorkflowDeps {
10
+ persona?: PersonaDefinition;
11
+ voices?: Voice[];
12
+ debate?: typeof debateVoiceRound;
13
+ checkVisibility?: (models: string[]) => ChildVisibilityReport;
14
+ }
15
+
16
+ function stubDebate(): DebateReport {
17
+ const parsed = validateEnvelope<DebateReport>("debate", JSON.stringify(ENVELOPE_EXAMPLES.debate));
18
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
19
+ return parsed.value!;
20
+ }
21
+
22
+ export function debateWorkflowValidate(command: { panel?: string; args: string[]; rounds?: number; apply?: boolean }, cwd: string): void {
23
+ if (command.apply) throw Object.assign(new Error("debate flow is read-only and does not take --apply"), { exitCode: 2 });
24
+ if (!command.panel) {
25
+ const available = listPanelNames(cwd);
26
+ throw Object.assign(new Error(`debate flow requires --panel. Available panels: ${available.length ? available.join(", ") : "(none)"}`), { exitCode: 2 });
27
+ }
28
+ if (!command.args.join(" ").trim()) throw Object.assign(new Error("debate flow requires a question"), { exitCode: 2 });
29
+ resolveDebateRounds(command.rounds);
30
+ resolvePanel(command.panel, cwd);
31
+ }
32
+
33
+ export function debateWorkflowPreflight(cwd: string, command?: { panel?: string }, deps: DebateWorkflowDeps = {}): void {
34
+ resolvePersona("researcher", cwd);
35
+ const panel = command?.panel;
36
+ if (!panel) return;
37
+ const voices = deps.voices ?? resolvePanel(panel, cwd);
38
+ const report = (deps.checkVisibility ?? checkChildVisibility)(voices.map(voice => voice.model));
39
+ if (report.diagnostic) throw new StartRefusedError(`Flow start refused: could not verify clean-room model visibility (${report.diagnostic}).`);
40
+ const hidden = report.models.filter(model => !model.ok);
41
+ if (hidden.length) {
42
+ throw new StartRefusedError(`Flow start refused: panel "${panel}" has models not visible to a clean-room child: ${hidden.map(model => model.reasons[0] ?? model.model).join("; ")}`);
43
+ }
44
+ }
45
+
46
+ /** Phases: engineer(request) → for each round: agent×N(debate) → code(collect). No judge. */
47
+ export async function debateWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }, deps: DebateWorkflowDeps = {}): Promise<FinishResult> {
48
+ const request = input.args.join(" ").trim();
49
+ if (!request) throw Object.assign(new Error("debate flow requires a question"), { exitCode: 2 });
50
+ if (!input.panel) throw Object.assign(new Error("debate flow requires --panel"), { exitCode: 2 });
51
+ if (input.apply) throw Object.assign(new Error("debate flow is read-only and does not take --apply"), { exitCode: 2 });
52
+ const rounds = resolveDebateRounds(input.rounds);
53
+ const persona = deps.persona ?? resolvePersona("researcher", input.cwd);
54
+ const voices = deps.voices ?? resolvePanel(input.panel, input.cwd);
55
+ const debate = deps.debate ?? debateVoiceRound;
56
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Preserve the exact question every panel voice must debate" }, phase => phase.log(request));
57
+ let active = [...voices];
58
+ let previous: Extract<DebateVoiceResult, { ok: true }>[] = [];
59
+ for (let round = 1; round <= rounds; round++) {
60
+ if (active.length < 2) break;
61
+ const results = await Promise.all(active.map(voice => run.phase({
62
+ name: `debate-${voice.name}-r${round}`, kind: "agent", owner: voice.name,
63
+ description: `Collect a labeled debate turn from this panel voice in round ${round}`,
64
+ }, async (): Promise<DebateVoiceResult> => {
65
+ if (input.dryRun) {
66
+ const stub: DebateVoiceResult = { ok: true, voice, round, report: stubDebate(), path: "" };
67
+ stub.path = writeDebateArtifact(input.cwd, run.trace.runId, stub);
68
+ return stub;
69
+ }
70
+ const others = previous.filter(item => item.voice.name !== voice.name);
71
+ return debate({ run, cwd: input.cwd, persona, voice, task: request, panel: input.panel!, round, rounds, others });
72
+ })));
73
+ await run.phase({ name: `collect-r${round}`, kind: "code", owner: "debate", description: `Write round ${round} voice conclusions to disk before the next round` }, phase => {
74
+ phase.log("debate round collected", { round, count: results.length, paths: results.map(item => item.path) });
75
+ });
76
+ const succeeded = results.filter((item): item is Extract<DebateVoiceResult, { ok: true }> => item.ok);
77
+ if (succeeded.length < 2) {
78
+ if (round === 1) {
79
+ return run.finish({ accepted: false, reason: `debate produced ${succeeded.length} of ${active.length} successful voices in round 1; at least 2 are required` });
80
+ }
81
+ break;
82
+ }
83
+ previous = succeeded;
84
+ active = succeeded.map(item => item.voice);
85
+ }
86
+ return run.finish({ accepted: previous.length >= 2 });
87
+ }
@@ -0,0 +1,50 @@
1
+ import type { Static } from "@sinclair/typebox";
2
+ import { runAgentPhase } from "./lib/agent-phase.ts";
3
+ import { asEnvelope as changesEnvelope, capture, type ChangeSet } from "./lib/changes.ts";
4
+ import { DocumentEnvelope as DocumentEnvelopeSchema, ENVELOPE_EXAMPLES, validateEnvelope } from "./lib/envelopes.ts";
5
+ import { artifactsExist, filesNonEmpty } from "./lib/gates.ts";
6
+ import { commitAll } from "./lib/git.ts";
7
+ import { snapshot, type PermissionSnapshot } from "./lib/permissions.ts";
8
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
9
+ import type { FinishResult, Run } from "./lib/run.ts";
10
+
11
+ export type DocumentReport = Static<typeof DocumentEnvelopeSchema>;
12
+ export interface DocumentWorkflowDeps {
13
+ agent?: (options: Parameters<typeof runAgentPhase<DocumentReport>>[0]) => Promise<DocumentReport>;
14
+ capture?: (run: Run, params: { ref: string; cwd: string; maxDiffLines: number }) => ChangeSet;
15
+ commit?: (message: string, cwd: string, baseline: PermissionSnapshot, policy: { writes?: string[] }) => string | null;
16
+ persona?: PersonaDefinition;
17
+ baseline?: PermissionSnapshot;
18
+ baseRef?: string;
19
+ }
20
+ export function documentWorkflowPreflight(cwd: string): void { resolvePersona("documenter", cwd); }
21
+ function dryDocument(): DocumentReport {
22
+ const parsed = validateEnvelope<DocumentReport>("document", JSON.stringify(ENVELOPE_EXAMPLES.document));
23
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
24
+ return parsed.value!;
25
+ }
26
+
27
+ /** Phases: code(changes) → agent(documenter) → code(commit) */
28
+ export async function documentWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string }, deps: DocumentWorkflowDeps = {}): Promise<FinishResult> {
29
+ const persona = deps.persona ?? resolvePersona("documenter", input.cwd);
30
+ const baseline = deps.baseline ?? run.repositoryBaseline ?? snapshot(input.cwd);
31
+ const captureChanges = deps.capture ?? capture;
32
+ const changes = await run.phase({ name: "changes", kind: "code", owner: "git", description: "Resolve and record the exact change set the documentation must explain" }, phase => {
33
+ if (input.dryRun) {
34
+ phase.log("clean tree — falling back to the last commit (HEAD~1)");
35
+ return { base: { ref: deps.baseRef ?? "main", diffBase: "HEAD~1", reason: "clean tree — falling back to the last commit (HEAD~1)", scenario: "fallback" as const }, changedFiles: [], untrackedFiles: [], diff: "", hiddenLines: 0 };
36
+ }
37
+ return captureChanges(run, { ref: deps.baseRef ?? process.env.FLOW_BASE_REF ?? "main", cwd: input.cwd, maxDiffLines: 2000 });
38
+ });
39
+ const envelope = changesEnvelope(changes, input.args.join(" "));
40
+ const task = `Document the captured repository changes accurately. Update only documentation allowed by your writes policy. The document_path must also be listed in artifacts so executable gates can inspect it.\n\nBase reason: ${changes.base.reason}\nChanged files: ${changes.changedFiles.join(", ") || "none"}\n\n${envelope.notes_for_next_agent}`;
41
+ const agent = deps.agent ?? runAgentPhase<DocumentReport>;
42
+ const report = await run.phase({ name: "document", kind: "agent", owner: "documenter", description: "Turn the deterministic change set into maintained project documentation" }, () => input.dryRun ? dryDocument() : agent({ run, persona, task, envelope: "document", cwd: input.cwd, gates: [artifactsExist, filesNonEmpty], gateRetries: 1 }));
43
+ await run.phase({ name: "commit", kind: "code", owner: "git", description: "Commit documentation only after its files pass executable gates" }, phase => {
44
+ if (input.dryRun) return phase.log("dry-run: commit skipped");
45
+ const hash = (deps.commit ?? commitAll)(report.commit_message, input.cwd, baseline, { writes: persona.writes });
46
+ if (hash) phase.log("documentation committed", { hash });
47
+ else phase.log("no documentation changes to commit; documentation was already accurate");
48
+ });
49
+ return run.finish({ accepted: true });
50
+ }
@@ -0,0 +1,95 @@
1
+ import { ENVELOPE_EXAMPLES, validateEnvelope, type MergeReport, type PollReport } from "./lib/envelopes.ts";
2
+ import { StartRefusedError } from "./lib/git.ts";
3
+ import { runMerge, MergeUnavailableError } from "./lib/merge.ts";
4
+ import { checkChildVisibility, type ChildVisibilityReport } from "./lib/model-visibility.ts";
5
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
6
+ import { POLL_PERMISSION_POLICY, pollVoice, writeVoiceArtifact, type PollVoiceResult } from "./lib/poll.ts";
7
+ import type { FinishResult, Run } from "./lib/run.ts";
8
+ import { integratorVoice, listPanelNames, resolvePanel, type Voice } from "./lib/voices.ts";
9
+
10
+ export interface PollWorkflowDeps {
11
+ persona?: PersonaDefinition;
12
+ voices?: Voice[];
13
+ poll?: typeof pollVoice;
14
+ merge?: typeof runMerge;
15
+ checkVisibility?: (models: string[]) => ChildVisibilityReport;
16
+ }
17
+
18
+ function stubPoll(): PollReport {
19
+ const parsed = validateEnvelope<PollReport>("poll", JSON.stringify(ENVELOPE_EXAMPLES.poll));
20
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
21
+ return parsed.value!;
22
+ }
23
+
24
+ function stubMerge(): MergeReport {
25
+ const parsed = validateEnvelope<MergeReport>("merge", JSON.stringify(ENVELOPE_EXAMPLES.merge));
26
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
27
+ return parsed.value!;
28
+ }
29
+
30
+ export function pollWorkflowValidate(command: { panel?: string; args: string[] }, cwd: string): void {
31
+ if (!command.panel) {
32
+ const available = listPanelNames(cwd);
33
+ throw Object.assign(new Error(`poll flow requires --panel. Available panels: ${available.length ? available.join(", ") : "(none)"}`), { exitCode: 2 });
34
+ }
35
+ if (!command.args.join(" ").trim()) throw Object.assign(new Error("poll flow requires a question"), { exitCode: 2 });
36
+ resolvePanel(command.panel, cwd);
37
+ }
38
+
39
+ export function pollWorkflowPreflight(cwd: string, command?: { panel?: string }, deps: PollWorkflowDeps = {}): void {
40
+ resolvePersona("researcher", cwd);
41
+ const panel = command?.panel;
42
+ if (!panel) return;
43
+ const voices = deps.voices ?? resolvePanel(panel, cwd);
44
+ const report = (deps.checkVisibility ?? checkChildVisibility)(voices.map(voice => voice.model));
45
+ if (report.diagnostic) throw new StartRefusedError(`Flow start refused: could not verify clean-room model visibility (${report.diagnostic}).`);
46
+ const hidden = report.models.filter(model => !model.ok);
47
+ if (hidden.length) {
48
+ throw new StartRefusedError(`Flow start refused: panel "${panel}" has models not visible to a clean-room child: ${hidden.map(model => model.reasons[0] ?? model.model).join("; ")}`);
49
+ }
50
+ }
51
+
52
+ /** Phases: engineer(request) → agent×N(poll, parallel) → code(collect) → agent(merge) */
53
+ export async function pollWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; apply?: boolean }, deps: PollWorkflowDeps = {}): Promise<FinishResult> {
54
+ const request = input.args.join(" ").trim();
55
+ if (!request) throw Object.assign(new Error("poll flow requires a question"), { exitCode: 2 });
56
+ if (!input.panel) throw Object.assign(new Error("poll flow requires --panel"), { exitCode: 2 });
57
+ const persona = deps.persona ?? resolvePersona("researcher", input.cwd);
58
+ const voices = deps.voices ?? resolvePanel(input.panel, input.cwd);
59
+ const poll = deps.poll ?? pollVoice;
60
+ const merge = deps.merge ?? runMerge;
61
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Preserve the exact question every panel voice must answer" }, phase => phase.log(request));
62
+ const opinions = await Promise.all(voices.map(voice => run.phase({
63
+ name: `poll-${voice.name}`, kind: "agent", owner: voice.name,
64
+ description: "Collect an independent read-only opinion from this panel voice",
65
+ }, async (): Promise<PollVoiceResult> => {
66
+ if (input.dryRun) {
67
+ const stub: PollVoiceResult = { ok: true, voice, report: stubPoll(), path: "" };
68
+ stub.path = writeVoiceArtifact(input.cwd, run.trace.runId, stub);
69
+ return stub;
70
+ }
71
+ return poll({ run, cwd: input.cwd, persona, voice, task: request, panel: input.panel!, spawn: undefined });
72
+ })));
73
+ const succeeded = opinions.filter(item => item.ok);
74
+ if (succeeded.length < 2) {
75
+ return run.finish({ accepted: false, reason: `poll produced ${succeeded.length} of ${voices.length} successful voices; at least 2 are required` });
76
+ }
77
+ await run.phase({ name: "collect", kind: "code", owner: "poll", description: "Write each voice opinion to disk before the integrator reads them" }, phase => {
78
+ phase.log("voice opinions collected", { count: opinions.length, paths: opinions.map(item => item.path) });
79
+ });
80
+ const integrator = integratorVoice(voices);
81
+ if (!integrator) {
82
+ return run.finish({ accepted: false, reason: new MergeUnavailableError(input.panel).message });
83
+ }
84
+ const merged = await run.phase({
85
+ name: "merge", kind: "agent", owner: integrator.name,
86
+ description: "Synthesize attributed consensus from the independent voice opinions",
87
+ }, async () => {
88
+ if (input.dryRun) return { report: stubMerge(), integrator, path: "" };
89
+ return merge({ run, cwd: input.cwd, persona, panel: input.panel!, task: request, opinions, voices, apply: input.apply });
90
+ });
91
+ run.trace.write("log", { phase: "merge", message: merged.report.summary, recommendation: merged.report.recommendation });
92
+ return run.finish({ accepted: Boolean(merged.report) });
93
+ }
94
+
95
+ export { POLL_PERMISSION_POLICY };
@@ -0,0 +1,20 @@
1
+ import { asEnvelope, qualityCommand, runTests } from "./lib/quality.ts";
2
+ import type { Run, FinishResult } from "./lib/run.ts";
3
+
4
+ export function qualityWorkflowPreflight(cwd: string): void { qualityCommand(cwd); }
5
+
6
+ /** Phases: engineer(request) → code(quality) */
7
+ export async function qualityWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string }): Promise<FinishResult> {
8
+ const request = input.args.join(" ") || "Run the repository quality suite";
9
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Record the quality outcome the operator asked the workflow to prove" }, ph => ph.log(request));
10
+ const result = await run.phase({ name: "quality", kind: "code", owner: "quality", description: "Execute the configured suite as deterministic acceptance evidence" }, async ph => {
11
+ if (input.dryRun) {
12
+ ph.log("dry-run: quality command skipped");
13
+ return { passed: true, exitCode: 0, argv: ["dry-run"], stdout: "", stderr: "", logPath: run.trace.file };
14
+ }
15
+ const quality = await runTests(run, { cwd: input.cwd });
16
+ ph.log(asEnvelope(quality, "quality suite").summary, { exitCode: quality.exitCode, logPath: quality.logPath });
17
+ return quality;
18
+ });
19
+ return run.finish({ accepted: result.passed, reason: result.passed ? undefined : "the quality suite did not pass" });
20
+ }
@@ -0,0 +1,38 @@
1
+ import { runAgentPhase } from "./lib/agent-phase.ts";
2
+ import { ENVELOPE_EXAMPLES, validateEnvelope, type ScoutReport } from "./lib/envelopes.ts";
3
+ import { resolvePersona, type PersonaDefinition } from "./lib/personas.ts";
4
+ import type { PermissionPolicy } from "./lib/permissions.ts";
5
+ import type { FinishResult, Run } from "./lib/run.ts";
6
+
7
+ export const SCOUT_PERMISSION_POLICY: PermissionPolicy = { writes: [] };
8
+ export interface ScoutWorkflowDeps {
9
+ agent?: (options: Parameters<typeof runAgentPhase<ScoutReport>>[0]) => Promise<ScoutReport>;
10
+ persona?: PersonaDefinition;
11
+ }
12
+
13
+ export function scoutWorkflowPreflight(cwd: string): void {
14
+ const persona = resolvePersona("researcher", cwd);
15
+ const tools = persona.tools.split(",").map(tool => tool.trim()).filter(Boolean);
16
+ if (tools.some(tool => ["write", "edit", "bash"].includes(tool))) {
17
+ throw Object.assign(new Error("Flow start refused: scout persona must expose read-only tools."), { exitCode: 3 });
18
+ }
19
+ }
20
+
21
+ /** Phases: engineer(request) → agent(scout) */
22
+ export async function scoutWorkflow(run: Run, input: { args: string[]; dryRun: boolean; cwd: string }, deps: ScoutWorkflowDeps = {}): Promise<FinishResult> {
23
+ const request = input.args.join(" ").trim();
24
+ if (!request) throw Object.assign(new Error("scout flow requires a question"), { exitCode: 2 });
25
+ const persona = deps.persona ?? resolvePersona("researcher", input.cwd);
26
+ const agent = deps.agent ?? runAgentPhase<ScoutReport>;
27
+ await run.phase({ name: "request", kind: "engineer", owner: "operator", description: "Preserve the exact reconnaissance question the operator needs answered" }, ph => ph.log(request));
28
+ const report = await run.phase({ name: "scout", kind: "agent", owner: "researcher", description: "Locate repository evidence without allowing the scout to modify it" }, async () => {
29
+ if (input.dryRun) {
30
+ const parsed = validateEnvelope<ScoutReport>("scout", JSON.stringify(ENVELOPE_EXAMPLES.scout));
31
+ if (!parsed.ok) throw new Error(parsed.errors.join("; "));
32
+ return parsed.value!;
33
+ }
34
+ return agent({ run, persona, task: request, envelope: "scout", cwd: input.cwd, permissionPolicy: SCOUT_PERMISSION_POLICY });
35
+ });
36
+ run.trace.write("log", { phase: "scout", message: report.summary, findings: report.findings });
37
+ return run.finish({ accepted: true });
38
+ }