@chankov/agent-fleet 1.0.4 → 2.0.1

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 (894) hide show
  1. package/.pi/harnesses/agent-hub/README.md +57 -66
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  32. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  38. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  39. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  40. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  41. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  42. package/.pi/harnesses/agent-hub/index.ts +1324 -9645
  43. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  44. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  45. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  51. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  53. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  58. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  59. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  60. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  61. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  62. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  63. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  64. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  65. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  66. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  67. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  68. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  69. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  70. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  71. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  72. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  73. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  75. package/.pi/harnesses/agent-hub/types.ts +60 -0
  76. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  77. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  78. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  79. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  80. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  81. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  82. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  83. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  84. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  85. package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
  86. package/.pi/harnesses/coms/index.ts +139 -1630
  87. package/.pi/harnesses/coms/package.json +1 -1
  88. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  89. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  90. package/.pi/harnesses/lib/coms-core.ts +577 -0
  91. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  92. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  93. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  94. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  95. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  96. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  97. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  98. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  99. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  100. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  101. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  102. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  103. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  104. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  105. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  106. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  107. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  108. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  109. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  110. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  111. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  112. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  113. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  114. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  115. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  116. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  117. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  118. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  119. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  120. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  121. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  122. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  123. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  124. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  125. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  126. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  127. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  128. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  129. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  130. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  131. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  132. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  133. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  134. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  135. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  136. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  137. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  138. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  139. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  140. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  141. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  142. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  143. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  144. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  145. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  146. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  147. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  148. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  149. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  150. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  151. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  152. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  153. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  154. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  155. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  156. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  157. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  158. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  159. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  160. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  161. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  162. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  163. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  164. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  165. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  166. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  167. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  168. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  169. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  170. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  171. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  172. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  173. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  174. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  175. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  176. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  177. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  178. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  179. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  180. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  181. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  182. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  183. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  184. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  185. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  186. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  187. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  188. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  189. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  190. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  191. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  192. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  193. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  194. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  195. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  196. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  197. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  198. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  199. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  200. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  201. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  202. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  203. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  204. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  205. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  206. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  207. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  208. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  209. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  210. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  211. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  212. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  213. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  214. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  215. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  216. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  217. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  218. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  219. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  220. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  221. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  222. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  223. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  224. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  225. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  226. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  227. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  228. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  229. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  230. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  231. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  232. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  233. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  234. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  235. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  236. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  237. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  238. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  239. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  240. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  241. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  242. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  243. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  244. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  245. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  246. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  247. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  248. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  249. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  250. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  251. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  252. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  253. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  254. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  255. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  256. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  257. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  258. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  259. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  260. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  261. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  262. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  263. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  264. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  265. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  266. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  267. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  268. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  269. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  270. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  271. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  272. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  273. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  274. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  275. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  276. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  277. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  278. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  279. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  280. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  281. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  282. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  283. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  284. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  285. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  286. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  287. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  288. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  289. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  290. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  291. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  292. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  293. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  294. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  295. package/.versions/2.0.0/.version +1 -0
  296. package/.versions/2.0.0/agents/architect.md +25 -0
  297. package/.versions/2.0.0/agents/bowser.md +28 -0
  298. package/.versions/2.0.0/agents/builder.md +56 -0
  299. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  300. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  301. package/.versions/2.0.0/agents/documenter.md +19 -0
  302. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  303. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  304. package/.versions/2.0.0/agents/planner.md +71 -0
  305. package/.versions/2.0.0/agents/releaser.md +25 -0
  306. package/.versions/2.0.0/agents/researcher.md +29 -0
  307. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  308. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  309. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  310. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  311. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  312. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  313. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  314. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  315. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  316. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  317. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  318. package/.versions/2.0.0/docs/getting-started.md +98 -0
  319. package/.versions/2.0.0/docs/npm-install.md +292 -0
  320. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  321. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  322. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  323. package/.versions/2.0.0/hermes/README.md +347 -0
  324. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  325. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  326. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  327. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  328. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  329. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  330. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  331. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  332. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  333. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  334. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  335. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  336. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  337. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  338. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  339. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  340. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  341. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  342. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  343. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  344. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  345. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  346. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  347. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  348. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  349. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  350. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  351. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  352. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  353. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  354. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  355. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  356. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  357. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  358. package/.versions/2.0.0/install-manifest.json +2745 -0
  359. package/.versions/2.0.0/justfile +272 -0
  360. package/.versions/2.0.0/manifest-meta.json +882 -0
  361. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  362. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  363. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  364. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  365. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  366. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  367. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  368. package/.versions/2.0.0/references/security-checklist.md +179 -0
  369. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  370. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  371. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  372. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  373. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  374. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  375. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  376. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  377. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  378. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  379. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  380. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  381. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  382. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  383. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  384. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  385. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  386. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  387. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  388. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  389. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  390. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  391. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  392. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  393. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  394. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  395. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  396. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  397. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  398. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  399. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  400. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  401. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  402. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  403. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  404. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  405. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  406. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  407. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  408. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  409. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  410. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  411. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  412. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  413. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  414. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  415. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  416. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  417. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  418. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  419. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  420. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  421. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  422. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  423. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  424. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  425. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  426. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  427. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  428. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  429. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  430. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  431. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  432. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  433. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  434. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  435. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  436. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  437. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  438. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  439. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  440. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  441. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  442. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  443. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  444. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  445. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  446. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  447. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  448. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  449. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  450. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  451. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  452. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  453. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  454. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  455. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  456. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  457. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  458. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  459. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  460. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  461. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  462. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  463. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  464. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  465. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  466. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  467. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  468. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  469. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  470. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  471. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  472. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  473. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  474. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  475. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  476. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  477. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  478. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  479. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  480. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  481. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  482. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  483. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  484. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  485. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  486. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  487. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  488. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  489. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  490. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  491. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  492. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  493. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  494. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  495. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  496. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  497. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  498. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  499. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  500. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  501. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  502. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  503. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  504. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  505. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  506. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  507. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  508. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  509. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  510. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  511. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  512. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  513. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  514. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  515. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  516. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  517. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  518. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  519. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  520. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  521. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  522. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  523. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  524. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  525. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  526. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  527. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  528. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  529. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  530. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  531. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  532. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  533. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  534. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  535. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  536. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  537. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  538. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  539. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  540. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  541. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  542. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  543. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  544. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  545. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  546. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  547. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  548. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  549. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  550. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  551. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  552. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  553. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  554. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  555. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  556. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  557. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  558. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  559. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  560. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  561. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  562. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  563. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  564. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  565. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  566. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  567. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  568. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  569. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  570. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  571. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  572. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  573. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  574. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  575. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  576. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  577. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  578. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  579. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  580. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  581. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  582. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  583. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  584. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  585. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  586. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  587. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  588. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  589. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  590. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  591. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  592. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  593. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  594. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  595. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  596. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  597. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  598. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  599. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  600. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  601. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  602. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  603. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  604. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  605. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  606. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  607. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  608. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  609. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  610. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  611. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  612. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  613. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  614. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  615. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  616. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  617. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  618. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  619. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  620. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  621. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  622. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  623. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  624. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  625. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  626. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  627. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  628. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  629. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  630. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  631. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  632. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  633. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  634. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  635. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  636. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  637. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  638. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  639. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  640. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  641. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  642. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  643. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  644. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  645. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  646. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  647. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  648. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  649. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  650. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  651. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  652. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  653. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  654. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  655. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  656. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  657. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  658. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  659. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  660. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  661. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  662. package/.versions/2.0.1/.version +1 -0
  663. package/.versions/2.0.1/agents/architect.md +25 -0
  664. package/.versions/2.0.1/agents/bowser.md +28 -0
  665. package/.versions/2.0.1/agents/builder.md +56 -0
  666. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  667. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  668. package/.versions/2.0.1/agents/documenter.md +22 -0
  669. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  670. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  671. package/.versions/2.0.1/agents/planner.md +73 -0
  672. package/.versions/2.0.1/agents/releaser.md +25 -0
  673. package/.versions/2.0.1/agents/researcher.md +31 -0
  674. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  675. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  676. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  677. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  678. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  679. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  680. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  681. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  682. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  683. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  684. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  685. package/.versions/2.0.1/docs/getting-started.md +119 -0
  686. package/.versions/2.0.1/docs/npm-install.md +292 -0
  687. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  688. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  689. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  690. package/.versions/2.0.1/hermes/README.md +347 -0
  691. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  692. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  693. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  694. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  695. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  696. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  697. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  698. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  699. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  700. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  701. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  702. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  703. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  704. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  705. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  706. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  707. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  708. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  709. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  710. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  711. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  712. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  713. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  714. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  715. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  716. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  717. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  718. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  719. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  720. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  721. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  722. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  723. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  724. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  725. package/.versions/2.0.1/install-manifest.json +2830 -0
  726. package/.versions/2.0.1/justfile +286 -0
  727. package/.versions/2.0.1/manifest-meta.json +913 -0
  728. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  729. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  730. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  731. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  732. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  733. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  734. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  735. package/.versions/2.0.1/references/security-checklist.md +179 -0
  736. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  737. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  738. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  739. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  740. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  741. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  742. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  743. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  744. package/.versions/2.0.1/scripts/flow.ts +121 -0
  745. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  746. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  747. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  748. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  749. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  750. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  751. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  752. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  753. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  754. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  755. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  756. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  757. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  758. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  759. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  760. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  761. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  762. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  763. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  764. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  765. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  766. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  767. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  768. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  769. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  770. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  771. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  772. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  773. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  774. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  775. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  776. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  777. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  778. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  779. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  780. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  781. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  782. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  783. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  784. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  785. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  786. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  787. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  788. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  789. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  790. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  791. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  792. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  793. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  794. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  795. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  796. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  797. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  798. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  799. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  800. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  801. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  802. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  803. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  804. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  805. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  806. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  807. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  808. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  809. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  810. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  811. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  812. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  813. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  814. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  815. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  816. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  817. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  818. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  819. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  820. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  821. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  822. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  823. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  824. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  825. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  826. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  827. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  828. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  829. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  830. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  831. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  832. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  833. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  834. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  835. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  836. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  837. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  838. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  839. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  840. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  841. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  842. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  843. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  844. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  845. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  846. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  847. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  848. package/CHANGELOG.md +40 -0
  849. package/README.md +26 -5
  850. package/agents/code-reviewer.md +1 -0
  851. package/agents/documenter.md +3 -0
  852. package/agents/orchestrator.md +3 -1
  853. package/agents/planner.md +2 -0
  854. package/agents/researcher.md +2 -0
  855. package/bin/lib/overrides.js +2 -0
  856. package/bin/lib/validate-overrides.js +1 -1
  857. package/docs/ARCHITECTURE.md +45 -13
  858. package/docs/MIGRATION-agent-fleet.md +4 -4
  859. package/docs/agent-fleet-setup.md +15 -15
  860. package/docs/getting-started.md +21 -0
  861. package/docs/npm-install.md +1 -1
  862. package/docs/pi-extensions.md +16 -18
  863. package/docs/workflows.md +136 -0
  864. package/install-manifest.json +86 -1
  865. package/justfile +16 -2
  866. package/manifest-meta.json +32 -1
  867. package/package.json +11 -3
  868. package/references/workflow-authoring.md +304 -0
  869. package/scripts/fleet.ts +23 -10
  870. package/scripts/flow.ts +121 -0
  871. package/scripts/lib/fleet-command.ts +15 -11
  872. package/scripts/lib/flow-command.ts +77 -0
  873. package/scripts/lib/flow-maintenance.ts +230 -0
  874. package/scripts/lib/team-project.ts +2 -2
  875. package/scripts/team-up.ts +10 -10
  876. package/scripts/workflows/lib/agent-phase.ts +118 -0
  877. package/scripts/workflows/lib/changes.ts +61 -0
  878. package/scripts/workflows/lib/env.ts +34 -0
  879. package/scripts/workflows/lib/envelopes.ts +141 -0
  880. package/scripts/workflows/lib/gates.ts +81 -0
  881. package/scripts/workflows/lib/git.ts +96 -0
  882. package/scripts/workflows/lib/permissions.ts +130 -0
  883. package/scripts/workflows/lib/personas.ts +44 -0
  884. package/scripts/workflows/lib/quality.ts +64 -0
  885. package/scripts/workflows/lib/run.ts +106 -0
  886. package/scripts/workflows/lib/trace.ts +34 -0
  887. package/scripts/workflows/tsconfig.json +22 -0
  888. package/scripts/workflows/wf-build-test.ts +61 -0
  889. package/scripts/workflows/wf-document.ts +50 -0
  890. package/scripts/workflows/wf-quality.ts +20 -0
  891. package/scripts/workflows/wf-scout.ts +38 -0
  892. package/skills/drafting-workflows/SKILL.md +143 -0
  893. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  894. package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
@@ -0,0 +1,106 @@
1
+ import type { ChildProcess } from "node:child_process";
2
+ import type { PermissionSnapshot } from "./permissions.ts";
3
+ import { FlowTrace } from "./trace.ts";
4
+
5
+ export type PhaseKind = "engineer" | "agent" | "code";
6
+ export interface PhaseParams { name: string; kind: PhaseKind; owner: string; description: string; retries?: number }
7
+ export interface FinishResult { accepted: boolean; reason?: string; exitCode: number; status: "accepted" | "rejected"; banner: string; signal?: NodeJS.Signals }
8
+
9
+ function words(value: string): string[] {
10
+ return value.toLowerCase().replace(/[_-]+/g, " ").replace(/[^a-z0-9 ]/g, "").split(/\s+/).filter(Boolean);
11
+ }
12
+
13
+ export function validateDescription(name: string, description: string): void {
14
+ if (!description.trim()) throw new Error("Phase description must explain why the phase exists");
15
+ const nameWords = words(name);
16
+ const descriptionWords = words(description).filter(word => !["a", "an", "the", "to", "of"].includes(word));
17
+ if (nameWords.length > 0 && descriptionWords.join(" ") === nameWords.join(" ")) {
18
+ throw new Error("Phase description must explain why, not merely repeat its name");
19
+ }
20
+ }
21
+
22
+ export class PhaseContext {
23
+ status: "fail" | "success" = "fail";
24
+ readonly params: PhaseParams;
25
+ private readonly trace: FlowTrace;
26
+ constructor(params: PhaseParams, trace: FlowTrace) { this.params = params; this.trace = trace; }
27
+ log(message: string, data: Record<string, unknown> = {}): void { this.trace.write("log", { phase: this.params.name, message, ...data }); }
28
+ }
29
+
30
+ export class Run {
31
+ readonly trace: FlowTrace;
32
+ readonly repositoryBaseline?: PermissionSnapshot;
33
+ private finished = false;
34
+ private phaseFailed = false;
35
+ private lastResult?: FinishResult;
36
+ private readonly cancellation = new AbortController();
37
+ readonly signal = this.cancellation.signal;
38
+
39
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; repositoryBaseline?: PermissionSnapshot } = {}) {
40
+ this.trace = options.trace ?? new FlowTrace(options);
41
+ this.repositoryBaseline = options.repositoryBaseline;
42
+ }
43
+
44
+ async phase<T>(params: PhaseParams, body: (phase: PhaseContext) => Promise<T> | T): Promise<T> {
45
+ if (this.finished) throw new Error("Cannot start a phase after finish()");
46
+ validateDescription(params.name, params.description);
47
+ const retries = params.retries ?? 0;
48
+ if (!Number.isInteger(retries) || retries < 0) throw new Error("Phase retries must be a non-negative integer");
49
+ const phase = new PhaseContext(params, this.trace);
50
+ this.trace.write("phase_start", { phase: params.name, kind: params.kind, owner: params.owner, description: params.description, retries, status: phase.status });
51
+ for (let attempt = 0; attempt <= retries; attempt++) {
52
+ try {
53
+ const value = await body(phase);
54
+ if (this.finished) throw new Error("Run ended while phase was active");
55
+ phase.status = "success";
56
+ this.trace.write("phase_end", { phase: params.name, status: phase.status, attempt: attempt + 1 });
57
+ return value;
58
+ } catch (error) {
59
+ if (this.finished) throw error;
60
+ const message = error instanceof Error ? error.message : String(error);
61
+ this.trace.write("error", { phase: params.name, message, attempt: attempt + 1 });
62
+ const terminal = typeof error === "object" && error !== null && (error as { terminal?: boolean }).terminal === true;
63
+ if (attempt < retries && !terminal) {
64
+ this.trace.write("log", { phase: params.name, message: "retrying failed phase", nextAttempt: attempt + 2 });
65
+ continue;
66
+ }
67
+ this.phaseFailed = true;
68
+ this.trace.write("phase_end", { phase: params.name, status: phase.status, attempt: attempt + 1, error: message });
69
+ if (!this.finished) this.finalize(false, message);
70
+ throw error;
71
+ }
72
+ }
73
+ throw new Error("unreachable phase retry state");
74
+ }
75
+
76
+ registerProcess(process: ChildProcess, phase: string): void {
77
+ this.trace.write("agent_process", { phase, pid: process.pid ?? null, processGroup: process.pid == null ? null : -process.pid });
78
+ }
79
+
80
+ finish(input: { accepted: boolean; reason?: string }): FinishResult {
81
+ if (this.finished) throw new Error("finish() may be called exactly once");
82
+ return this.finalize(input.accepted && !this.phaseFailed, input.reason);
83
+ }
84
+
85
+ abort(reason: string, exitCode = 1): FinishResult {
86
+ this.cancellation.abort(reason);
87
+ if (this.finished) return this.lastResult!;
88
+ return this.finalize(false, reason, exitCode);
89
+ }
90
+
91
+ interrupt(signal: NodeJS.Signals): FinishResult {
92
+ const exitCode = 128 + (signal === "SIGINT" ? 2 : 15);
93
+ this.cancellation.abort(signal);
94
+ if (this.finished) return this.lastResult!;
95
+ return this.finalize(false, `interrupted by ${signal}`, exitCode, signal);
96
+ }
97
+
98
+ private finalize(accepted: boolean, reason?: string, exitCode = accepted ? 0 : 1, signal?: NodeJS.Signals): FinishResult {
99
+ this.finished = true;
100
+ const status = accepted ? "accepted" : "rejected";
101
+ const banner = accepted ? `FLOW ACCEPTED (${this.trace.runId})` : `FLOW REJECTED (${this.trace.runId})${reason ? `: ${reason}` : ""}`;
102
+ this.lastResult = { accepted, reason, exitCode, status, banner, ...(signal ? { signal } : {}) };
103
+ this.trace.write("run_end", { accepted, status, exitCode, reason: reason ?? "", banner, ...(signal ? { signal } : {}) });
104
+ return this.lastResult;
105
+ }
106
+ }
@@ -0,0 +1,34 @@
1
+ import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ const runNamespacePath: string = "../../../.pi/harnesses/agent-hub/run-namespace.js";
4
+ const { makeRunId } = await import(runNamespacePath) as { makeRunId(): string };
5
+
6
+ export type TraceEvent = Record<string, unknown> & { type: string; at: string; runId: string };
7
+
8
+ export class FlowTrace {
9
+ readonly runId: string;
10
+ readonly cwd: string;
11
+ readonly directory: string;
12
+ readonly file: string;
13
+ private ended = false;
14
+
15
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; pid?: number } = {}) {
16
+ this.runId = options.runId ?? makeRunId();
17
+ this.cwd = resolve(options.cwd ?? process.cwd());
18
+ this.directory = resolve(this.cwd, ".pi", "flow-sessions", this.runId);
19
+ this.file = resolve(this.directory, "trace.jsonl");
20
+ mkdirSync(this.directory, { recursive: true });
21
+ this.write("run_start", { pid: options.pid ?? process.pid, command: options.command ?? process.argv });
22
+ }
23
+
24
+ write(type: string, data: Record<string, unknown> = {}): void {
25
+ if (this.ended) return;
26
+ const event: TraceEvent = { type, at: new Date().toISOString(), runId: this.runId, ...data };
27
+ appendFileSync(this.file, `${JSON.stringify(event)}\n`, "utf8");
28
+ if (type === "run_end") this.ended = true;
29
+ }
30
+
31
+ events(): TraceEvent[] {
32
+ return readFileSync(this.file, "utf8").trim().split("\n").filter(Boolean).map(line => JSON.parse(line));
33
+ }
34
+ }
@@ -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,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,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
+ }
@@ -0,0 +1,143 @@
1
+ ---
2
+ name: drafting-workflows
3
+ description: Drafts deterministic Agent Fleet workflows by adapting the nearest existing flow and proving the draft compiles and dry-runs. Use when creating or changing a `just flow` workflow or translating an operator request into agent phase prompts.
4
+ ---
5
+
6
+ # Drafting Workflows
7
+
8
+ ## Overview
9
+
10
+ Draft code-owned workflows by copying a proven flow shape, then edit only the decisions that actually require judgment. The operator owns intent; code owns phase order, retries, gates, permissions, and acceptance.
11
+
12
+ ## When to Use
13
+
14
+ - Creating a new `scripts/workflows/wf-*.ts` flow.
15
+ - Changing a flow's phase order, gates, retries, or acceptance rule.
16
+ - Translating an operator request into a prompt for an agent phase.
17
+
18
+ Do not use this skill to improvise an interactive hub dispatch. `just fleet` remains a separate orchestration surface.
19
+
20
+ ## Process
21
+
22
+ ### 1. Map, list, and stop
23
+
24
+ Read the workflow map in `docs/workflows.md`, then list every available `scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
25
+
26
+ At this point:
27
+
28
+ - Do not open flow traces.
29
+ - Do not inventory the repository.
30
+ - Do not volunteer a dashboard or a guessed “current state.”
31
+
32
+ This discipline matters for three independent reasons: volunteered state is guessed state; reconnaissance spends context the real request will need; and a status dump is stale as soon as it is printed.
33
+
34
+ ### 2. Preserve the request exactly
35
+
36
+ Translate the request into this four-line prompt:
37
+
38
+ ```text
39
+ <the request — one imperative sentence, retaining their exact words wherever they were specific>
40
+ Where: <files/directories you actually checked>
41
+ Done means: <the observable outcome>
42
+ Out of scope: <the tempting addition you will not add>
43
+ ```
44
+
45
+ **The intent is theirs. The precision is yours.** You may improve grammar, order, and verbosity. You may not silently omit a requirement, weaken a strong request (`rewrite` must not become `lightly refactor`), or invent an outcome.
46
+
47
+ Before running an agent phase, report the exact prompt you will send **verbatim**. Exact-prompt fidelity is evidence: a bad translation can be corrected before it reaches a commit phase.
48
+
49
+ ### 3. Describe the phase shape
50
+
51
+ Write phases in execution order with explicit kinds, for example:
52
+
53
+ ```text
54
+ agent(plan) → agent(build) → agent(review)
55
+ ```
56
+
57
+ Use `engineer(...)` only for operator-owned input, `agent(...)` for judgment, and `code(...)` for known deterministic commands or repository calculations. A known test command is code, not an agent.
58
+
59
+ ### 4. Generate from the nearest shape
60
+
61
+ Run:
62
+
63
+ ```bash
64
+ node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
65
+ <name> 'agent(plan) → agent(build) → agent(review)'
66
+ ```
67
+
68
+ The generator reads `Phases:` docstrings, compares phase-kind sequences deterministically, and breaks ties by workflow name. Commas inside phase parentheses (for example `agent(builder-fix, bounded)`) remain part of that phase. It copies the nearest source in full, replaces the phase docstring block, and renames the workflow/preflight entry symbols to match the new file. It never overwrites an existing workflow.
69
+
70
+ Do not regenerate boilerplate from memory. Copying the entire nearest flow preserves imports, envelopes, explicit permission enforcement, gates, correction behavior, dry-run stubs, and finish semantics that a partial template can accidentally omit. The symbol rename is the sole identity change required to make `just flow <name>` discover the new module.
71
+
72
+ ### 5. Resolve judgment-only TODOs
73
+
74
+ The draft marks only three classes of decisions:
75
+
76
+ - executable gates for claims that need repository evidence;
77
+ - bounded retry limits for safely correctable phases;
78
+ - the final acceptance condition, separate from phase completion.
79
+
80
+ Edit the copied phase bodies so the declared shape is real. Remove each TODO only after making that decision. Do not add TODOs for imports, envelope wiring, trace calls, dry-run stubs, or other boilerplate.
81
+
82
+ For the complete contracts, read `references/workflow-authoring.md`.
83
+
84
+ ### 6. Keep the envelope triad synchronized
85
+
86
+ For every agent phase, keep these three sites identical:
87
+
88
+ 1. the TypeBox schema in `lib/envelopes.ts`;
89
+ 2. the JSON example emitted by the phase prompt;
90
+ 3. the `envelope:` name at the workflow call site.
91
+
92
+ Use existing return-contract vocabulary. A parsed envelope with `status: "fail"` is a failed phase, not a successful parse.
93
+
94
+ ### 7. Prove the draft before handoff
95
+
96
+ The generator refuses handoff unless both gates pass:
97
+
98
+ ```bash
99
+ npx tsc -p scripts/workflows/tsconfig.json --noEmit
100
+ node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
101
+ --verify-draft scripts/workflows/wf-<name>.ts
102
+ ```
103
+
104
+ The second command resolves the exact `wf-<name>.ts` entry export used by the flow registry, then executes it with stubbed agent phases and `dryRun: true`; it makes no model call. If either gate fails, the generator deletes the draft and reports the exact failure. Repair the source decision or rerun the generator—never bypass either gate. A handed-off draft is immediately reachable as `just flow <name>`; no central registry edit is required.
105
+
106
+ ## Common Rationalizations
107
+
108
+ | Rationalization | Reality |
109
+ |---|---|
110
+ | “I should inspect traces first so I understand the state.” | Volunteered state is guessed, costly, and immediately stale. Map, list, stop. |
111
+ | “The operator clearly meant a smaller refactor.” | Weakening the request changes intent. Preserve their exact strong wording. |
112
+ | “A fresh template is cleaner than copying.” | A template silently drops proven safety wiring. Copy the nearest whole flow. |
113
+ | “The TypeScript is obvious; dry-run is enough.” | Type and runtime gates catch different failures. Both are mandatory. |
114
+ | “This TODO is harmless boilerplate.” | Boilerplate TODOs shift syntax work back to the operator. TODOs are for judgment only. |
115
+ | “The phases passed, so acceptance is implied.” | Phase completion and accepted work are deliberately separate facts. |
116
+
117
+ ## Red Flags
118
+
119
+ - Reporting repository or trace state before the operator asks for a flow.
120
+ - Sending a paraphrased prompt without showing its exact text.
121
+ - A phase docstring that does not match the implemented phase order.
122
+ - Shell command strings where an argv list is available.
123
+ - Agent phases used to rediscover a known test command.
124
+ - Unbounded correction loops or retries after a permission breach.
125
+ - An approved review with blocking findings.
126
+ - A draft handed off after only one of compile or dry-run succeeds.
127
+
128
+ ## Verification
129
+
130
+ Before presenting a workflow draft, confirm:
131
+
132
+ - [ ] The workflow map was read, available flows were listed one per line, and work stopped for operator direction.
133
+ - [ ] The four-line phase prompt preserves every explicit requirement and was reported verbatim.
134
+ - [ ] The nearest existing flow was copied in full; only its phase docstring block was initially replaced.
135
+ - [ ] Every remaining `// TODO:` is a gate, retry-bound, or acceptance judgment.
136
+ - [ ] Implemented phase order matches the `Phases:` docstring.
137
+ - [ ] Envelope schema, JSON prompt example, and call-site name agree.
138
+ - [ ] Every agent phase has an explicit persona or call-site writes policy; omission is a startup error, never unrestricted by accident.
139
+ - [ ] Writes policy and protected paths are enforced around agent phases.
140
+ - [ ] The generated export is uniquely named for the file and resolves through `just flow <name>`.
141
+ - [ ] `npx tsc -p scripts/workflows/tsconfig.json --noEmit` passes.
142
+ - [ ] The generated workflow's stubbed dry run is accepted with zero model calls.
143
+ - [ ] The exact commands and outcomes are included in the handoff.