@chankov/agent-fleet 2.0.0 → 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 (428) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  4. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  5. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  6. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  7. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  8. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  9. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  10. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  11. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  12. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  13. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  14. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  15. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  16. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  17. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  18. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  19. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  20. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  21. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  22. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  23. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  24. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  25. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  26. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  27. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  28. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  29. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  30. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  31. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  32. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  33. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  34. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  35. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  36. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  37. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  38. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  39. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  40. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  41. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  42. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  43. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  44. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  45. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  46. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  47. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  48. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  49. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  50. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  51. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  52. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  53. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  54. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  55. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  56. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  57. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  58. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  59. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  60. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  61. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  62. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  63. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  64. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  65. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  66. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  67. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  68. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  69. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  70. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  71. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  72. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  73. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  74. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  75. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  76. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  77. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  78. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  79. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  80. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  81. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  82. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  83. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  84. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  85. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  86. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  87. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  88. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  89. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  90. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  91. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  92. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  93. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  94. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  95. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  96. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  97. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  98. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  99. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  100. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  101. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  102. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  103. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  104. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  105. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  106. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  107. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  108. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  109. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  110. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  111. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  112. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  113. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  114. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  115. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  116. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  117. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  118. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  119. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  120. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  121. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  122. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  123. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  124. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  125. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  126. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  127. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  128. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  129. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  130. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  131. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  132. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  133. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  134. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  135. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  136. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  137. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  138. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  139. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  140. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  141. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  142. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  143. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  144. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  145. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  146. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  147. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  148. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  149. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  150. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  151. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  152. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  153. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  154. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  155. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  156. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  157. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  158. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  159. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  160. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  161. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  162. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  163. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  164. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  165. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  166. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  167. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  168. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  169. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  170. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  171. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  172. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  173. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  174. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  175. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  176. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  177. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  178. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  179. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  180. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  181. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  182. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  183. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  184. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  185. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  186. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  187. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  188. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  189. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  190. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  191. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  192. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  193. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  194. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  195. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  196. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  197. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  198. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  199. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  200. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  201. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  202. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  203. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  204. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  205. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  206. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  207. package/.versions/2.0.1/.version +1 -0
  208. package/.versions/2.0.1/agents/architect.md +25 -0
  209. package/.versions/2.0.1/agents/bowser.md +28 -0
  210. package/.versions/2.0.1/agents/builder.md +56 -0
  211. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  212. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  213. package/.versions/2.0.1/agents/documenter.md +22 -0
  214. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  215. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  216. package/.versions/2.0.1/agents/planner.md +73 -0
  217. package/.versions/2.0.1/agents/releaser.md +25 -0
  218. package/.versions/2.0.1/agents/researcher.md +31 -0
  219. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  220. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  221. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  222. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  223. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  224. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  225. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  226. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  227. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  228. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  229. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  230. package/.versions/2.0.1/docs/getting-started.md +119 -0
  231. package/.versions/2.0.1/docs/npm-install.md +292 -0
  232. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  233. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  234. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  235. package/.versions/2.0.1/hermes/README.md +347 -0
  236. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  237. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  238. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  239. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  240. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  241. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  242. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  243. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  244. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  245. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  246. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  247. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  248. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  249. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  250. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  251. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  252. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  253. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  254. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  255. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  256. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  257. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  258. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  259. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  260. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  261. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  262. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  263. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  264. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  265. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  266. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  267. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  268. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  269. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  270. package/.versions/2.0.1/install-manifest.json +2830 -0
  271. package/.versions/2.0.1/justfile +286 -0
  272. package/.versions/2.0.1/manifest-meta.json +913 -0
  273. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  274. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  275. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  276. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  277. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  278. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  279. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  280. package/.versions/2.0.1/references/security-checklist.md +179 -0
  281. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  282. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  283. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  284. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  285. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  286. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  287. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  288. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  289. package/.versions/2.0.1/scripts/flow.ts +121 -0
  290. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  291. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  292. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  293. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  294. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  295. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  296. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  297. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  298. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  299. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  300. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  301. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  302. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  303. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  304. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  305. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  306. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  307. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  308. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  309. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  310. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  311. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  312. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  313. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  314. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  315. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  316. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  317. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  318. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  319. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  320. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  321. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  322. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  323. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  324. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  325. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  326. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  327. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  328. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  329. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  330. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  331. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  332. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  333. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  334. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  335. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  336. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  337. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  338. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  339. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  340. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  341. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  342. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  343. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  344. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  345. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  346. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  347. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  348. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  349. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  350. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  351. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  352. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  353. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  354. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  355. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  356. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  357. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  358. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  359. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  360. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  361. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  362. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  363. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  364. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  365. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  366. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  367. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  368. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  369. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  370. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  371. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  372. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  373. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  374. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  375. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  376. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  377. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  378. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  379. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  380. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  381. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  382. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  383. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  384. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  385. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  386. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  387. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  388. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  389. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  390. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  391. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  392. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  393. package/CHANGELOG.md +7 -0
  394. package/README.md +21 -0
  395. package/agents/code-reviewer.md +1 -0
  396. package/agents/documenter.md +3 -0
  397. package/agents/planner.md +2 -0
  398. package/agents/researcher.md +2 -0
  399. package/docs/ARCHITECTURE.md +3 -0
  400. package/docs/getting-started.md +21 -0
  401. package/docs/workflows.md +136 -0
  402. package/install-manifest.json +86 -1
  403. package/justfile +14 -0
  404. package/manifest-meta.json +32 -1
  405. package/package.json +10 -3
  406. package/references/workflow-authoring.md +304 -0
  407. package/scripts/fleet.ts +13 -0
  408. package/scripts/flow.ts +121 -0
  409. package/scripts/lib/flow-command.ts +77 -0
  410. package/scripts/lib/flow-maintenance.ts +230 -0
  411. package/scripts/workflows/lib/agent-phase.ts +118 -0
  412. package/scripts/workflows/lib/changes.ts +61 -0
  413. package/scripts/workflows/lib/env.ts +34 -0
  414. package/scripts/workflows/lib/envelopes.ts +141 -0
  415. package/scripts/workflows/lib/gates.ts +81 -0
  416. package/scripts/workflows/lib/git.ts +96 -0
  417. package/scripts/workflows/lib/permissions.ts +130 -0
  418. package/scripts/workflows/lib/personas.ts +44 -0
  419. package/scripts/workflows/lib/quality.ts +64 -0
  420. package/scripts/workflows/lib/run.ts +106 -0
  421. package/scripts/workflows/lib/trace.ts +34 -0
  422. package/scripts/workflows/tsconfig.json +22 -0
  423. package/scripts/workflows/wf-build-test.ts +61 -0
  424. package/scripts/workflows/wf-document.ts +50 -0
  425. package/scripts/workflows/wf-quality.ts +20 -0
  426. package/scripts/workflows/wf-scout.ts +38 -0
  427. package/skills/drafting-workflows/SKILL.md +143 -0
  428. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
@@ -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.
@@ -0,0 +1,177 @@
1
+ #!/usr/bin/env node
2
+ import { spawnSync } from "node:child_process";
3
+ import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
4
+ import { basename, dirname, resolve } from "node:path";
5
+ import { pathToFileURL } from "node:url";
6
+
7
+ const PHASE_DOCSTRING = /\/\*\*\s*Phases:\s*([^\n*]+)[\s\S]*?\*\//;
8
+ const SAFE_NAME = /^[a-z][a-z0-9-]*$/;
9
+ const RESERVED_FLOW_NAMES = new Set(["cleanup", "merge"]);
10
+ export type PhaseKind = "engineer" | "agent" | "code";
11
+ export interface WorkflowShape { path: string; name: string; source: string; phases: string[]; kinds: PhaseKind[] }
12
+ export interface CommandResult { status: number | null; stdout?: string; stderr?: string }
13
+ export type CommandRunner = (command: string, args: string[], cwd: string) => CommandResult;
14
+
15
+ export function parsePhaseList(value: string): string[] {
16
+ const phases: string[] = [];
17
+ let start = 0;
18
+ let depth = 0;
19
+ for (let index = 0; index < value.length; index++) {
20
+ if (value[index] === "(") depth++;
21
+ else if (value[index] === ")") {
22
+ if (depth === 0) throw new Error("Unbalanced phase parentheses.");
23
+ depth--;
24
+ } else if (depth === 0 && (value[index] === "→" || value[index] === "," || value.slice(index, index + 2) === "->")) {
25
+ const phase = value.slice(start, index).trim();
26
+ if (phase) phases.push(phase);
27
+ if (value.slice(index, index + 2) === "->") index++;
28
+ start = index + 1;
29
+ }
30
+ }
31
+ if (depth !== 0) throw new Error("Unbalanced phase parentheses.");
32
+ const finalPhase = value.slice(start).trim();
33
+ if (finalPhase) phases.push(finalPhase);
34
+ if (!phases.length) throw new Error("At least one phase is required.");
35
+ return phases;
36
+ }
37
+
38
+ export function phaseKind(phase: string): PhaseKind {
39
+ const explicit = phase.match(/^\s*(engineer|agent|code)\s*\(/i)?.[1]?.toLowerCase() as PhaseKind | undefined;
40
+ if (explicit) return explicit;
41
+ const name = phase.toLowerCase().replace(/[^a-z0-9-]/g, "");
42
+ if (/^(request|input|brief|goal)/.test(name)) return "engineer";
43
+ if (/^(test|quality|verify|lint|typecheck|commit|changes|capture)/.test(name)) return "code";
44
+ return "agent";
45
+ }
46
+
47
+ export function readWorkflowShapes(workflowsDir: string): WorkflowShape[] {
48
+ return readdirSync(workflowsDir)
49
+ .filter(file => /^wf-[a-z0-9-]+\.ts$/.test(file))
50
+ .sort()
51
+ .map(file => {
52
+ const path = resolve(workflowsDir, file);
53
+ const source = readFileSync(path, "utf8");
54
+ const match = source.match(PHASE_DOCSTRING);
55
+ if (!match) throw new Error(`${file} has no /** Phases: ... */ docstring.`);
56
+ const phases = parsePhaseList(match[1]);
57
+ return { path, name: file.slice(3, -3), source, phases, kinds: phases.map(phaseKind) };
58
+ });
59
+ }
60
+
61
+ function editDistance(left: PhaseKind[], right: PhaseKind[]): number {
62
+ const row = Array.from({ length: right.length + 1 }, (_, index) => index);
63
+ for (let i = 1; i <= left.length; i++) {
64
+ let diagonal = row[0];
65
+ row[0] = i;
66
+ for (let j = 1; j <= right.length; j++) {
67
+ const above = row[j];
68
+ row[j] = Math.min(row[j] + 1, row[j - 1] + 1, diagonal + (left[i - 1] === right[j - 1] ? 0 : 1));
69
+ diagonal = above;
70
+ }
71
+ }
72
+ return row[right.length];
73
+ }
74
+
75
+ export function selectNearestWorkflow(shapes: WorkflowShape[], requestedPhases: string[]): WorkflowShape {
76
+ if (!shapes.length) throw new Error("No scripts/workflows/wf-*.ts sources were found.");
77
+ const requestedKinds = requestedPhases.map(phaseKind);
78
+ return [...shapes].sort((left, right) => {
79
+ const leftScore = editDistance(left.kinds, requestedKinds) * 100 + Math.abs(left.kinds.length - requestedKinds.length) * 10;
80
+ const rightScore = editDistance(right.kinds, requestedKinds) * 100 + Math.abs(right.kinds.length - requestedKinds.length) * 10;
81
+ return leftScore - rightScore || left.name.localeCompare(right.name);
82
+ })[0];
83
+ }
84
+
85
+ export function workflowExportName(name: string): string {
86
+ return `${name.replace(/-([a-z0-9])/g, (_, char: string) => char.toUpperCase())}Workflow`;
87
+ }
88
+
89
+ export function renameWorkflowSymbols(source: string, sourceName: string, targetName: string): string {
90
+ const sourceWorkflow = workflowExportName(sourceName);
91
+ const targetWorkflow = workflowExportName(targetName);
92
+ const sourcePreflight = `${sourceWorkflow}Preflight`;
93
+ const targetPreflight = `${targetWorkflow}Preflight`;
94
+ return source
95
+ .replace(new RegExp(`\\b${sourcePreflight}\\b`, "g"), targetPreflight)
96
+ .replace(new RegExp(`\\b${sourceWorkflow}\\b`, "g"), targetWorkflow);
97
+ }
98
+
99
+ export function replacePhaseDocstring(source: string, phases: string[]): string {
100
+ if (!PHASE_DOCSTRING.test(source)) throw new Error("Source workflow has no phase docstring to replace.");
101
+ const phaseList = phases.join(" → ");
102
+ const replacement = `/** Phases: ${phaseList}\n * TODO: Choose executable gates for claims that require repository evidence.\n * TODO: Choose bounded retry limits for phases that can be corrected safely.\n * TODO: Define the final acceptance condition independently from phase completion.\n */`;
103
+ return source.replace(PHASE_DOCSTRING, replacement);
104
+ }
105
+
106
+ const defaultRunner: CommandRunner = (command, args, cwd) => {
107
+ const result = spawnSync(command, args, { cwd, encoding: "utf8", env: process.env });
108
+ return { status: result.status, stdout: result.stdout, stderr: result.stderr || result.error?.message };
109
+ };
110
+
111
+ function gateFailure(label: string, result: CommandResult): Error {
112
+ const detail = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
113
+ return new Error(`${label} failed${result.status === null ? " to start" : ` with exit ${result.status}`}${detail ? `:\n${detail}` : "."}`);
114
+ }
115
+
116
+ export function makeWorkflow(options: {
117
+ cwd: string; name: string; phases: string[]; workflowsDir?: string; runner?: CommandRunner;
118
+ }): { outputPath: string; sourcePath: string; phases: string[] } {
119
+ if (!SAFE_NAME.test(options.name)) throw new Error(`Invalid workflow name: ${options.name}`);
120
+ if (RESERVED_FLOW_NAMES.has(options.name)) throw new Error(`Workflow name is reserved for maintenance: ${options.name}`);
121
+ const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, "scripts/workflows"));
122
+ const outputPath = resolve(workflowsDir, `wf-${options.name}.ts`);
123
+ if (existsSync(outputPath)) throw new Error(`Refusing to overwrite existing workflow: ${outputPath}`);
124
+ const nearest = selectNearestWorkflow(readWorkflowShapes(workflowsDir), options.phases);
125
+ const copied = renameWorkflowSymbols(nearest.source, nearest.name, options.name);
126
+ writeFileSync(outputPath, replacePhaseDocstring(copied, options.phases), "utf8");
127
+ const runner = options.runner ?? defaultRunner;
128
+ try {
129
+ const tsc = resolve(options.cwd, "node_modules/.bin/tsc");
130
+ const compile = runner(tsc, ["-p", resolve(workflowsDir, "tsconfig.json"), "--noEmit"], options.cwd);
131
+ if (compile.status !== 0) throw gateFailure("Scoped workflow typecheck", compile);
132
+ const dryRun = runner(process.execPath, ["--experimental-strip-types", resolve(options.cwd, "skills/drafting-workflows/scripts/make-workflow.ts"), "--verify-draft", outputPath], options.cwd);
133
+ if (dryRun.status !== 0) throw gateFailure("Generated workflow dry run", dryRun);
134
+ return { outputPath, sourcePath: nearest.path, phases: [...options.phases] };
135
+ } catch (error) {
136
+ rmSync(outputPath, { force: true });
137
+ throw error;
138
+ }
139
+ }
140
+
141
+ export async function verifyDraft(path: string, cwd = process.cwd()): Promise<void> {
142
+ const resolvedPath = resolve(path);
143
+ const workflowName = basename(resolvedPath).replace(/^wf-/, "").replace(/\.ts$/, "");
144
+ const flowModulePath = resolve(cwd, "scripts/flow.ts");
145
+ const { resolveWorkflow } = await import(`${pathToFileURL(flowModulePath).href}?verify=${Date.now()}`) as {
146
+ resolveWorkflow(name: string, workflowsDir?: string): Promise<{ run: (run: unknown, input: { args: string[]; dryRun: boolean; cwd: string }) => Promise<{ accepted: boolean }> } | undefined>;
147
+ };
148
+ const entry = await resolveWorkflow(workflowName, dirname(resolvedPath));
149
+ if (!entry) throw new Error(`${basename(path)} is not reachable as flow ${workflowName}.`);
150
+ const runModulePath: string = resolve(dirname(path), "lib/run.ts");
151
+ const { Run } = await import(pathToFileURL(runModulePath).href) as { Run: new (options: { cwd: string; runId: string; command: string[] }) => unknown };
152
+ const run = new Run({ cwd, runId: `draft-${process.pid}-${Date.now()}`, command: ["make-workflow", "--verify-draft", path] });
153
+ const result = await entry.run(run, {
154
+ args: ["generated workflow acceptance request"], dryRun: true, cwd,
155
+ });
156
+ if (!result?.accepted) throw new Error(`${basename(path)} dry run was not accepted.`);
157
+ }
158
+
159
+ async function main(argv: string[]): Promise<number> {
160
+ try {
161
+ if (argv[0] === "--verify-draft") {
162
+ if (!argv[1]) throw new Error("--verify-draft requires a workflow path.");
163
+ await verifyDraft(argv[1]);
164
+ return 0;
165
+ }
166
+ if (argv.length < 2) throw new Error("Usage: make-workflow <name> '<phase → phase → phase>'");
167
+ const phases = parsePhaseList(argv.slice(1).join(" "));
168
+ const result = makeWorkflow({ cwd: process.cwd(), name: argv[0], phases });
169
+ console.log(JSON.stringify({ workflow: result.outputPath, copiedFrom: result.sourcePath, phases: result.phases }));
170
+ return 0;
171
+ } catch (error) {
172
+ console.error(error instanceof Error ? error.message : String(error));
173
+ return 1;
174
+ }
175
+ }
176
+
177
+ if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) process.exitCode = await main(process.argv.slice(2));