@chankov/agent-fleet 2.0.14 → 2.0.15

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 (617) hide show
  1. package/.pi/agent-fleet/scripts/fleet.ts +2 -1
  2. package/.pi/extensions/compact-and-continue/README.md +2 -2
  3. package/.pi/harnesses/agent-hub/README.md +89 -10
  4. package/.pi/harnesses/agent-hub/budget-recovery.ts +2 -2
  5. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  6. package/.pi/harnesses/agent-hub/commands/recover.ts +13 -4
  7. package/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  8. package/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  9. package/.pi/harnesses/agent-hub/context/budgets.ts +9 -7
  10. package/.pi/harnesses/agent-hub/deterministic-fs.ts +51 -12
  11. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +4 -0
  12. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +14 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +3 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native.ts +9 -1
  15. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +2 -1
  16. package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +2 -0
  17. package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +23 -5
  18. package/.pi/harnesses/agent-hub/docs-lane.js +2 -1
  19. package/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  20. package/.pi/harnesses/agent-hub/filesystem-tool.ts +75 -11
  21. package/.pi/harnesses/agent-hub/index.ts +246 -19
  22. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +13 -5
  23. package/.pi/harnesses/agent-hub/no-progress.ts +232 -28
  24. package/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  25. package/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  26. package/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  27. package/.pi/harnesses/agent-hub/package.json +1 -1
  28. package/.pi/harnesses/agent-hub/policy/work-mode.ts +14 -5
  29. package/.pi/harnesses/agent-hub/process-obligations.ts +116 -15
  30. package/.pi/harnesses/agent-hub/prompts/fragments.ts +9 -11
  31. package/.pi/harnesses/agent-hub/recover-policy.ts +18 -1
  32. package/.pi/harnesses/agent-hub/recover-state.ts +1 -1
  33. package/.pi/harnesses/agent-hub/recovery-contract.ts +70 -0
  34. package/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  35. package/.pi/harnesses/agent-hub/research/runtime.ts +2 -0
  36. package/.pi/harnesses/agent-hub/research/spawn-run.ts +15 -6
  37. package/.pi/harnesses/agent-hub/return-contract.js +27 -5
  38. package/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  39. package/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  40. package/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  41. package/.pi/harnesses/agent-hub/run-budget.js +12 -0
  42. package/.pi/harnesses/agent-hub/scope-gate.js +23 -2
  43. package/.pi/harnesses/agent-hub/session-audit.ts +94 -8
  44. package/.pi/harnesses/agent-hub/spawn.ts +10 -2
  45. package/.pi/harnesses/agent-hub/system1-activity.ts +116 -1
  46. package/.pi/harnesses/agent-hub/system1-communication-store.ts +47 -13
  47. package/.pi/harnesses/agent-hub/system1-report.ts +50 -0
  48. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -2
  49. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  50. package/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
  51. package/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
  52. package/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  53. package/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  54. package/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  55. package/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  56. package/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  57. package/.pi/harnesses/agent-hub/tools/action-executors.ts +33 -10
  58. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  59. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +86 -26
  60. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +9 -0
  61. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +9 -6
  62. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +6 -2
  63. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  64. package/.pi/harnesses/agent-hub/work-mode.ts +13 -8
  65. package/.pi/harnesses/coms/package.json +1 -1
  66. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  67. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +6 -1
  68. package/.pi/harnesses/lib/fleet-dashboard-view.ts +29 -4
  69. package/.pi/harnesses/lib/fleet-read-model.ts +73 -0
  70. package/.pi/harnesses/lib/system1/demo.ts +2 -4
  71. package/.pi/harnesses/lib/system1/selection.js +11 -0
  72. package/.pi/prompts/af-build.md +9 -6
  73. package/.versions/2.0.15/.pi/agent-fleet/hermes/README.md +347 -0
  74. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  75. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  76. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  77. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  78. package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  79. package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  80. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  81. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  82. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  83. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  84. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  85. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  86. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  87. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  88. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  89. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  90. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  91. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  92. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  93. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  94. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  95. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  96. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  97. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  98. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  99. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  100. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  101. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  102. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  103. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  104. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  105. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  106. package/.versions/2.0.15/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  107. package/.versions/2.0.15/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  108. package/.versions/2.0.15/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  109. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  110. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  111. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  112. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  113. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  114. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet.ts +217 -0
  115. package/.versions/2.0.15/.pi/agent-fleet/scripts/flow.ts +157 -0
  116. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  117. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  118. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  119. package/.versions/2.0.15/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  120. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  121. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  122. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  123. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  124. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  125. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  126. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  127. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  128. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  129. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  130. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  131. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  132. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  133. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  134. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  135. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  136. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  137. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  138. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  139. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  140. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  141. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  142. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  143. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  144. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  145. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  146. package/.versions/2.0.15/.pi/agent-fleet/scripts/package-lock.json +35 -0
  147. package/.versions/2.0.15/.pi/agent-fleet/scripts/package.json +9 -0
  148. package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  149. package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  150. package/.versions/2.0.15/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  151. package/.versions/2.0.15/.pi/agent-fleet/scripts/team-up.ts +378 -0
  152. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  153. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  154. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  155. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  156. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  157. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  158. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  159. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  160. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  161. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  162. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  163. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  164. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  165. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  166. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  167. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  168. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  169. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  170. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  171. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  172. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  173. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  174. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  175. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  176. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  177. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  178. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  179. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  180. package/.versions/2.0.15/.pi/agents/dispatch-policy.yaml +32 -0
  181. package/.versions/2.0.15/.pi/agents/model-profiles.yaml +134 -0
  182. package/.versions/2.0.15/.pi/agents/peers.yaml +147 -0
  183. package/.versions/2.0.15/.pi/agents/teams.yaml +41 -0
  184. package/.versions/2.0.15/.pi/agents/voices.yaml +13 -0
  185. package/.versions/2.0.15/.pi/damage-control-rules.yaml +297 -0
  186. package/.versions/2.0.15/.pi/extensions/btw/README.md +120 -0
  187. package/.versions/2.0.15/.pi/extensions/btw/index.ts +914 -0
  188. package/.versions/2.0.15/.pi/extensions/btw/package.json +6 -0
  189. package/.versions/2.0.15/.pi/extensions/btw/state.js +179 -0
  190. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  191. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  192. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  193. package/.versions/2.0.15/.pi/extensions/compact-and-continue/README.md +42 -0
  194. package/.versions/2.0.15/.pi/extensions/compact-and-continue/index.ts +120 -0
  195. package/.versions/2.0.15/.pi/extensions/compact-and-continue/package.json +6 -0
  196. package/.versions/2.0.15/.pi/extensions/mcp-bridge/README.md +46 -0
  197. package/.versions/2.0.15/.pi/extensions/mcp-bridge/index.ts +206 -0
  198. package/.versions/2.0.15/.pi/extensions/mcp-bridge/package.json +6 -0
  199. package/.versions/2.0.15/.pi/extensions/package-lock.json +1175 -0
  200. package/.versions/2.0.15/.pi/extensions/package.json +9 -0
  201. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/README.md +224 -0
  202. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/config.ts +198 -0
  203. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  204. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/index.ts +248 -0
  205. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/package.json +6 -0
  206. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  207. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  208. package/.versions/2.0.15/.pi/harnesses/agent-hub/README.md +1448 -0
  209. package/.versions/2.0.15/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  210. package/.versions/2.0.15/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  211. package/.versions/2.0.15/.pi/harnesses/agent-hub/artifacts.js +146 -0
  212. package/.versions/2.0.15/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  213. package/.versions/2.0.15/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  214. package/.versions/2.0.15/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  215. package/.versions/2.0.15/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  216. package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  217. package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  218. package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  219. package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  220. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  221. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  222. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  223. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  224. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  225. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  226. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  227. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  228. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  229. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  230. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  231. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  232. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  233. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  234. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  235. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  236. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  237. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  238. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  239. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  240. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  241. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  242. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  243. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  244. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  245. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  246. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  247. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  248. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  249. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  250. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  251. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  252. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  253. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  254. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  255. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  256. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  257. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  258. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  259. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-window.js +108 -0
  260. package/.versions/2.0.15/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  261. package/.versions/2.0.15/.pi/harnesses/agent-hub/delegate.ts +467 -0
  262. package/.versions/2.0.15/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
  263. package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  264. package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  265. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  266. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  267. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  268. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
  269. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  270. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
  271. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  272. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  273. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  274. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +76 -0
  275. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  276. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  277. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  278. package/.versions/2.0.15/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  279. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  280. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  281. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  282. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  283. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  284. package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  285. package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  286. package/.versions/2.0.15/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  287. package/.versions/2.0.15/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  288. package/.versions/2.0.15/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
  289. package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/registration-surface.json +64 -0
  290. package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  291. package/.versions/2.0.15/.pi/harnesses/agent-hub/footer.ts +30 -0
  292. package/.versions/2.0.15/.pi/harnesses/agent-hub/helpers.ts +270 -0
  293. package/.versions/2.0.15/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  294. package/.versions/2.0.15/.pi/harnesses/agent-hub/index.ts +2597 -0
  295. package/.versions/2.0.15/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  296. package/.versions/2.0.15/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  297. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  298. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  299. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  300. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  301. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  302. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  303. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  304. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  305. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  306. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  307. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  308. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  309. package/.versions/2.0.15/.pi/harnesses/agent-hub/no-progress.ts +563 -0
  310. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  311. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  312. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  313. package/.versions/2.0.15/.pi/harnesses/agent-hub/package.json +7 -0
  314. package/.versions/2.0.15/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  315. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  316. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  317. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  318. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  319. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/work-mode.ts +135 -0
  320. package/.versions/2.0.15/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  321. package/.versions/2.0.15/.pi/harnesses/agent-hub/presentation.ts +48 -0
  322. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  323. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  324. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  325. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  326. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  327. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  328. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  329. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  330. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  331. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  332. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  333. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  334. package/.versions/2.0.15/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  335. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  336. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/fragments.ts +116 -0
  337. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  338. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  339. package/.versions/2.0.15/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  340. package/.versions/2.0.15/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  341. package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  342. package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  343. package/.versions/2.0.15/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  344. package/.versions/2.0.15/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  345. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  346. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
  347. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
  348. package/.versions/2.0.15/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  349. package/.versions/2.0.15/.pi/harnesses/agent-hub/return-contract.js +349 -0
  350. package/.versions/2.0.15/.pi/harnesses/agent-hub/return-extract.js +77 -0
  351. package/.versions/2.0.15/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  352. package/.versions/2.0.15/.pi/harnesses/agent-hub/review-findings.js +104 -0
  353. package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  354. package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  355. package/.versions/2.0.15/.pi/harnesses/agent-hub/run-budget.js +554 -0
  356. package/.versions/2.0.15/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  357. package/.versions/2.0.15/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  358. package/.versions/2.0.15/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  359. package/.versions/2.0.15/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  360. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  361. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-health.js +110 -0
  362. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-start.ts +42 -0
  363. package/.versions/2.0.15/.pi/harnesses/agent-hub/spawn.ts +534 -0
  364. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  365. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-communication-store.ts +129 -0
  366. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  367. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-runtime.ts +280 -0
  368. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  369. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  370. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
  371. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
  372. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  373. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-closure.user-run.mjs +336 -0
  374. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  375. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  376. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  377. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  378. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  379. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs +157 -0
  380. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  381. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  382. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  383. package/.versions/2.0.15/.pi/harnesses/agent-hub/timeline.ts +72 -0
  384. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  385. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  386. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  387. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
  388. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  389. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  390. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  391. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
  392. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  393. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  394. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  395. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  396. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  397. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  398. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  399. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  400. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  401. package/.versions/2.0.15/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  402. package/.versions/2.0.15/.pi/harnesses/agent-hub/types.ts +66 -0
  403. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  404. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  405. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  406. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  407. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  408. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  409. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  410. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  411. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  412. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  413. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  414. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  415. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  416. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  417. package/.versions/2.0.15/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  418. package/.versions/2.0.15/.pi/harnesses/agent-hub/version.ts +42 -0
  419. package/.versions/2.0.15/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  420. package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  421. package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode.ts +179 -0
  422. package/.versions/2.0.15/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  423. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/README.md +59 -0
  424. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/index.ts +558 -0
  425. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  426. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  427. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  428. package/.versions/2.0.15/.pi/harnesses/coms/README.md +100 -0
  429. package/.versions/2.0.15/.pi/harnesses/coms/index.ts +282 -0
  430. package/.versions/2.0.15/.pi/harnesses/coms/package.json +7 -0
  431. package/.versions/2.0.15/.pi/harnesses/coms/version.ts +42 -0
  432. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/README.md +135 -0
  433. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/index.ts +550 -0
  434. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/package.json +7 -0
  435. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/version.ts +42 -0
  436. package/.versions/2.0.15/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  437. package/.versions/2.0.15/.pi/harnesses/lib/coms-core-io.ts +385 -0
  438. package/.versions/2.0.15/.pi/harnesses/lib/coms-core.ts +577 -0
  439. package/.versions/2.0.15/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  440. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  441. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  442. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-view.ts +107 -0
  443. package/.versions/2.0.15/.pi/harnesses/lib/context-budget.ts +114 -0
  444. package/.versions/2.0.15/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  445. package/.versions/2.0.15/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  446. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  447. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  448. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  449. package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  450. package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  451. package/.versions/2.0.15/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  452. package/.versions/2.0.15/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  453. package/.versions/2.0.15/.pi/harnesses/lib/fleet-panel.ts +34 -0
  454. package/.versions/2.0.15/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  455. package/.versions/2.0.15/.pi/harnesses/lib/fleet-selection.ts +24 -0
  456. package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  457. package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  458. package/.versions/2.0.15/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  459. package/.versions/2.0.15/.pi/harnesses/lib/herdr-client.ts +472 -0
  460. package/.versions/2.0.15/.pi/harnesses/lib/herdr-presence.ts +399 -0
  461. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  462. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  463. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  464. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  465. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  466. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  467. package/.versions/2.0.15/.pi/harnesses/lib/spawned-peers.js +191 -0
  468. package/.versions/2.0.15/.pi/harnesses/lib/system1/config.js +61 -0
  469. package/.versions/2.0.15/.pi/harnesses/lib/system1/contracts.ts +152 -0
  470. package/.versions/2.0.15/.pi/harnesses/lib/system1/demo.ts +104 -0
  471. package/.versions/2.0.15/.pi/harnesses/lib/system1/jev.ts +503 -0
  472. package/.versions/2.0.15/.pi/harnesses/lib/system1/selection.js +11 -0
  473. package/.versions/2.0.15/.pi/harnesses/lib/system1/service.ts +245 -0
  474. package/.versions/2.0.15/.pi/harnesses/lib/update-check.ts +222 -0
  475. package/.versions/2.0.15/.pi/harnesses/package-lock.json +2039 -0
  476. package/.versions/2.0.15/.pi/harnesses/package.json +10 -0
  477. package/.versions/2.0.15/.pi/prompts/af-build.md +27 -0
  478. package/.versions/2.0.15/.pi/prompts/af-code-simplify.md +22 -0
  479. package/.versions/2.0.15/.pi/prompts/af-constraints.md +31 -0
  480. package/.versions/2.0.15/.pi/prompts/af-plan.md +17 -0
  481. package/.versions/2.0.15/.pi/prompts/af-review.md +16 -0
  482. package/.versions/2.0.15/.pi/prompts/af-set-hermes-telegram.md +15 -0
  483. package/.versions/2.0.15/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  484. package/.versions/2.0.15/.pi/prompts/af-setup-rules.md +20 -0
  485. package/.versions/2.0.15/.pi/prompts/af-ship.md +17 -0
  486. package/.versions/2.0.15/.pi/prompts/af-spec.md +15 -0
  487. package/.versions/2.0.15/.pi/prompts/af-test.md +19 -0
  488. package/.versions/2.0.15/.pi/skills/bowser/SKILL.md +145 -0
  489. package/.versions/2.0.15/.version +1 -0
  490. package/.versions/2.0.15/agents/architect.md +24 -0
  491. package/.versions/2.0.15/agents/bowser.md +28 -0
  492. package/.versions/2.0.15/agents/builder.md +55 -0
  493. package/.versions/2.0.15/agents/code-reviewer.md +209 -0
  494. package/.versions/2.0.15/agents/deep-researcher.md +32 -0
  495. package/.versions/2.0.15/agents/documenter.md +22 -0
  496. package/.versions/2.0.15/agents/orchestrator.md +22 -0
  497. package/.versions/2.0.15/agents/plan-reviewer.md +83 -0
  498. package/.versions/2.0.15/agents/planner.md +105 -0
  499. package/.versions/2.0.15/agents/releaser.md +24 -0
  500. package/.versions/2.0.15/agents/researcher.md +30 -0
  501. package/.versions/2.0.15/agents/security-auditor.md +167 -0
  502. package/.versions/2.0.15/agents/test-engineer.md +153 -0
  503. package/.versions/2.0.15/agents/web-debugger.md +44 -0
  504. package/.versions/2.0.15/agents/web-performance-auditor.md +194 -0
  505. package/.versions/2.0.15/bin/catalog/harness-runtime-closure.json +73 -0
  506. package/.versions/2.0.15/codex/fleet-session-client/SKILL.md +34 -0
  507. package/.versions/2.0.15/codex/fleet-session-client.zip +0 -0
  508. package/.versions/2.0.15/docs/ARCHITECTURE.md +829 -0
  509. package/.versions/2.0.15/docs/agent-fleet-setup.md +1090 -0
  510. package/.versions/2.0.15/docs/claude-code-coms-bridge.md +134 -0
  511. package/.versions/2.0.15/docs/codex-session-bridge.md +219 -0
  512. package/.versions/2.0.15/docs/coms-hermes-bridge.md +188 -0
  513. package/.versions/2.0.15/docs/getting-started.md +126 -0
  514. package/.versions/2.0.15/docs/npm-install.md +525 -0
  515. package/.versions/2.0.15/docs/pi-extensions.md +454 -0
  516. package/.versions/2.0.15/docs/pi-setup.md +92 -0
  517. package/.versions/2.0.15/docs/skill-anatomy.md +150 -0
  518. package/.versions/2.0.15/install-manifest.json +3193 -0
  519. package/.versions/2.0.15/justfile +247 -0
  520. package/.versions/2.0.15/manifest-meta.json +1071 -0
  521. package/.versions/2.0.15/references/accessibility-checklist.md +160 -0
  522. package/.versions/2.0.15/references/communication-contract.md +26 -0
  523. package/.versions/2.0.15/references/definition-of-done.md +67 -0
  524. package/.versions/2.0.15/references/fleet-coordination-patterns.md +171 -0
  525. package/.versions/2.0.15/references/observability-checklist.md +92 -0
  526. package/.versions/2.0.15/references/orchestration-patterns.md +370 -0
  527. package/.versions/2.0.15/references/performance-checklist.md +236 -0
  528. package/.versions/2.0.15/references/prompting-patterns.md +380 -0
  529. package/.versions/2.0.15/references/security-checklist.md +245 -0
  530. package/.versions/2.0.15/references/testing-patterns.md +235 -0
  531. package/.versions/2.0.15/references/workflow-authoring.md +304 -0
  532. package/.versions/2.0.15/skills/_internal/grilling.md +59 -0
  533. package/.versions/2.0.15/skills/browser-testing-with-devtools/SKILL.md +351 -0
  534. package/.versions/2.0.15/skills/code-review-and-quality/SKILL.md +396 -0
  535. package/.versions/2.0.15/skills/compound-learning/SKILL.md +137 -0
  536. package/.versions/2.0.15/skills/constraint-driven-development/SKILL.md +338 -0
  537. package/.versions/2.0.15/skills/constraint-driven-development/references/floor-guard.md +99 -0
  538. package/.versions/2.0.15/skills/context-engineering/SKILL.md +341 -0
  539. package/.versions/2.0.15/skills/deprecation-and-migration/SKILL.md +247 -0
  540. package/.versions/2.0.15/skills/designing-agents/SKILL.md +394 -0
  541. package/.versions/2.0.15/skills/designing-agents/pi-harness-authoring.md +222 -0
  542. package/.versions/2.0.15/skills/drafting-workflows/SKILL.md +143 -0
  543. package/.versions/2.0.15/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  544. package/.versions/2.0.15/skills/frontend-ui-engineering/SKILL.md +328 -0
  545. package/.versions/2.0.15/skills/git-workflow-and-versioning/SKILL.md +316 -0
  546. package/.versions/2.0.15/skills/idea-refine/SKILL.md +182 -0
  547. package/.versions/2.0.15/skills/idea-refine/examples.md +238 -0
  548. package/.versions/2.0.15/skills/idea-refine/frameworks.md +99 -0
  549. package/.versions/2.0.15/skills/idea-refine/refinement-criteria.md +113 -0
  550. package/.versions/2.0.15/skills/idea-refine/scripts/idea-refine.sh +15 -0
  551. package/.versions/2.0.15/skills/incremental-implementation/SKILL.md +353 -0
  552. package/.versions/2.0.15/skills/interview-me/SKILL.md +226 -0
  553. package/.versions/2.0.15/skills/orchestration-verification/SKILL.md +182 -0
  554. package/.versions/2.0.15/skills/peer-coms/SKILL.md +90 -0
  555. package/.versions/2.0.15/skills/performance-optimization/SKILL.md +496 -0
  556. package/.versions/2.0.15/skills/planning-and-task-breakdown/SKILL.md +318 -0
  557. package/.versions/2.0.15/skills/repository-ai-setup/SKILL.md +117 -0
  558. package/.versions/2.0.15/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  559. package/.versions/2.0.15/skills/repository-ai-setup/references/apply-contract.md +74 -0
  560. package/.versions/2.0.15/skills/repository-ai-setup/references/provenance-template.md +16 -0
  561. package/.versions/2.0.15/skills/repository-ai-setup/references/setup-flow.md +108 -0
  562. package/.versions/2.0.15/skills/repository-ai-setup/references/verify-setup.md +20 -0
  563. package/.versions/2.0.15/skills/security-and-hardening/SKILL.md +524 -0
  564. package/.versions/2.0.15/skills/spec-driven-development/SKILL.md +295 -0
  565. package/.versions/2.0.15/skills/using-agent-skills/SKILL.md +198 -0
  566. package/.versions/2.0.15/vendor/agent-skills-upstream/LICENSE +21 -0
  567. package/.versions/2.0.15/vendor/agent-skills-upstream/README.md +430 -0
  568. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  569. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  570. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  571. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  572. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  573. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  574. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  575. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  576. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  577. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  578. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  579. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  580. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  581. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  582. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  583. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  584. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  585. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  586. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  587. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  588. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  589. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  590. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  591. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  592. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  593. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  594. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  595. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  596. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  597. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  598. package/CHANGELOG.md +6 -0
  599. package/README.md +1 -1
  600. package/agents/builder.md +2 -2
  601. package/bin/cli.js +16 -2
  602. package/bin/lib/apply.js +5 -0
  603. package/bin/lib/doctor.js +85 -12
  604. package/bin/lib/reconcile.js +9 -1
  605. package/bin/lib/state.js +1 -0
  606. package/bin/lib/task-triage-setup.js +76 -0
  607. package/bin/lib/transaction.js +4 -0
  608. package/docs/ARCHITECTURE.md +99 -24
  609. package/docs/agent-fleet-setup.md +179 -6
  610. package/docs/npm-install.md +64 -15
  611. package/docs/pi-extensions.md +1 -1
  612. package/install-manifest.json +13 -3
  613. package/manifest-meta.json +6 -0
  614. package/package.json +9 -2
  615. package/skills/incremental-implementation/SKILL.md +64 -13
  616. package/skills/planning-and-task-breakdown/SKILL.md +43 -14
  617. package/skills/using-agent-skills/SKILL.md +2 -2
@@ -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 `.pi/agent-fleet/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 managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `.pi/agent-fleet/scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
25
+
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 .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
100
+ node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
101
+ --verify-draft .pi/agent-fleet/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 .pi/agent-fleet/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 .pi/agent-fleet/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, ".pi/agent-fleet/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, ".pi/agent-fleet/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));
@@ -0,0 +1,328 @@
1
+ ---
2
+ name: frontend-ui-engineering
3
+ description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
4
+ ---
5
+
6
+ # Frontend UI Engineering
7
+
8
+ ## Overview
9
+
10
+ Build production-quality user interfaces that are accessible, performant, and visually polished. The goal is UI that looks like it was built by a design-aware engineer at a top company — not like it was generated by an AI. This means real design system adherence, proper accessibility, thoughtful interaction patterns, and no generic "AI aesthetic."
11
+
12
+ ## When to Use
13
+
14
+ - Building new UI components or pages
15
+ - Modifying existing user-facing interfaces
16
+ - Implementing responsive layouts
17
+ - Adding interactivity or state management
18
+ - Fixing visual or UX issues
19
+
20
+ ## Component Architecture
21
+
22
+ ### File Structure
23
+
24
+ Colocate everything related to a component:
25
+
26
+ ```
27
+ src/components/
28
+ TaskList/
29
+ TaskList.tsx # Component implementation
30
+ TaskList.test.tsx # Tests
31
+ TaskList.stories.tsx # Storybook stories (if using)
32
+ use-task-list.ts # Custom hook (if complex state)
33
+ types.ts # Component-specific types (if needed)
34
+ ```
35
+
36
+ ### Component Patterns
37
+
38
+ **Prefer composition over configuration:**
39
+
40
+ ```tsx
41
+ // Good: Composable
42
+ <Card>
43
+ <CardHeader>
44
+ <CardTitle>Tasks</CardTitle>
45
+ </CardHeader>
46
+ <CardBody>
47
+ <TaskList tasks={tasks} />
48
+ </CardBody>
49
+ </Card>
50
+
51
+ // Avoid: Over-configured
52
+ <Card
53
+ title="Tasks"
54
+ headerVariant="large"
55
+ bodyPadding="md"
56
+ content={<TaskList tasks={tasks} />}
57
+ />
58
+ ```
59
+
60
+ **Keep components focused:**
61
+
62
+ ```tsx
63
+ // Good: Does one thing
64
+ export function TaskItem({ task, onToggle, onDelete }: TaskItemProps) {
65
+ return (
66
+ <li className="flex items-center gap-3 p-3">
67
+ <Checkbox checked={task.done} onChange={() => onToggle(task.id)} />
68
+ <span className={task.done ? 'line-through text-muted' : ''}>{task.title}</span>
69
+ <Button variant="ghost" size="sm" onClick={() => onDelete(task.id)}>
70
+ <TrashIcon />
71
+ </Button>
72
+ </li>
73
+ );
74
+ }
75
+ ```
76
+
77
+ **Separate data fetching from presentation:**
78
+
79
+ ```tsx
80
+ // Container: handles data
81
+ export function TaskListContainer() {
82
+ const { tasks, isLoading, error } = useTasks();
83
+
84
+ if (isLoading) return <TaskListSkeleton />;
85
+ if (error) return <ErrorState message="Failed to load tasks" retry={refetch} />;
86
+ if (tasks.length === 0) return <EmptyState message="No tasks yet" />;
87
+
88
+ return <TaskList tasks={tasks} />;
89
+ }
90
+
91
+ // Presentation: handles rendering
92
+ export function TaskList({ tasks }: { tasks: Task[] }) {
93
+ return (
94
+ <ul role="list" className="divide-y">
95
+ {tasks.map(task => <TaskItem key={task.id} task={task} />)}
96
+ </ul>
97
+ );
98
+ }
99
+ ```
100
+
101
+ ## State Management
102
+
103
+ **Choose the simplest approach that works:**
104
+
105
+ ```
106
+ Local state (useState) → Component-specific UI state
107
+ Lifted state → Shared between 2-3 sibling components
108
+ Context → Theme, auth, locale (read-heavy, write-rare)
109
+ URL state (searchParams) → Filters, pagination, shareable UI state
110
+ Server state (React Query, SWR) → Remote data with caching
111
+ Global store (Zustand, Redux) → Complex client state shared app-wide
112
+ ```
113
+
114
+ **Avoid prop drilling deeper than 3 levels.** If you're passing props through components that don't use them, introduce context or restructure the component tree.
115
+
116
+ ## Design System Adherence
117
+
118
+ ### Avoid the AI Aesthetic
119
+
120
+ AI-generated UI has recognizable patterns. Avoid all of them:
121
+
122
+ | AI Default | Why It Is a Problem | Production Quality |
123
+ |---|---|---|
124
+ | Purple/indigo everything | Models default to visually "safe" palettes, making every app look identical | Use the project's actual color palette |
125
+ | Excessive gradients | Gradients add visual noise and clash with most design systems | Flat or subtle gradients matching the design system |
126
+ | Rounded everything (rounded-2xl) | Maximum rounding signals "friendly" but ignores the hierarchy of corner radii in real designs | Consistent border-radius from the design system |
127
+ | Generic hero sections | Template-driven layout with no connection to the actual content or user need | Content-first layouts |
128
+ | Lorem ipsum-style copy | Placeholder text hides layout problems that real content reveals (length, wrapping, overflow) | Realistic placeholder content |
129
+ | Oversized padding everywhere | Equal generous padding destroys visual hierarchy and wastes screen space | Consistent spacing scale |
130
+ | Stock card grids | Uniform grids are a layout shortcut that ignores information priority and scanning patterns | Purpose-driven layouts |
131
+ | Shadow-heavy design | Layered shadows add depth that competes with content and slows rendering on low-end devices | Subtle or no shadows unless the design system specifies |
132
+
133
+ ### Spacing and Layout
134
+
135
+ Use a consistent spacing scale. Don't invent values:
136
+
137
+ ```css
138
+ /* Use the scale: 0.25rem increments (or whatever the project uses) */
139
+ /* Good */ padding: 1rem; /* 16px */
140
+ /* Good */ gap: 0.75rem; /* 12px */
141
+ /* Bad */ padding: 13px; /* Not on any scale */
142
+ /* Bad */ margin-top: 2.3rem; /* Not on any scale */
143
+ ```
144
+
145
+ ### Typography
146
+
147
+ Respect the type hierarchy:
148
+
149
+ ```
150
+ h1 → Page title (one per page)
151
+ h2 → Section title
152
+ h3 → Subsection title
153
+ body → Default text
154
+ small → Secondary/helper text
155
+ ```
156
+
157
+ Don't skip heading levels. Don't use heading styles for non-heading content.
158
+
159
+ ### Color
160
+
161
+ - Use semantic color tokens: `text-primary`, `bg-surface`, `border-default` — not raw hex values
162
+ - Ensure sufficient contrast (4.5:1 for normal text, 3:1 for large text)
163
+ - Don't rely solely on color to convey information (use icons, text, or patterns too)
164
+
165
+ ## Accessibility (WCAG 2.1 AA)
166
+
167
+ Every component must meet these standards:
168
+
169
+ ### Keyboard Navigation
170
+
171
+ ```tsx
172
+ // Every interactive element must be keyboard accessible
173
+ <button onClick={handleClick}>Click me</button> // ✓ Focusable by default
174
+ <div onClick={handleClick}>Click me</div> // ✗ Not focusable
175
+ <div role="button" tabIndex={0} onClick={handleClick} // ✓ But prefer <button>
176
+ onKeyDown={e => {
177
+ if (e.key === 'Enter') handleClick();
178
+ if (e.key === ' ') e.preventDefault();
179
+ }}
180
+ onKeyUp={e => {
181
+ if (e.key === ' ') handleClick();
182
+ }}>
183
+ Click me
184
+ </div>
185
+ ```
186
+
187
+ ### ARIA Labels
188
+
189
+ ```tsx
190
+ // Label interactive elements that lack visible text
191
+ <button aria-label="Close dialog"><XIcon /></button>
192
+
193
+ // Label form inputs
194
+ <label htmlFor="email">Email</label>
195
+ <input id="email" type="email" />
196
+
197
+ // Or use aria-label when no visible label exists
198
+ <input aria-label="Search tasks" type="search" />
199
+ ```
200
+
201
+ ### Focus Management
202
+
203
+ ```tsx
204
+ // Move focus when content changes
205
+ function Dialog({ isOpen, onClose }: DialogProps) {
206
+ const closeRef = useRef<HTMLButtonElement>(null);
207
+
208
+ useEffect(() => {
209
+ if (isOpen) closeRef.current?.focus();
210
+ }, [isOpen]);
211
+
212
+ // Trap focus inside dialog when open
213
+ return (
214
+ <dialog open={isOpen}>
215
+ <button ref={closeRef} onClick={onClose}>Close</button>
216
+ {/* dialog content */}
217
+ </dialog>
218
+ );
219
+ }
220
+ ```
221
+
222
+ ### Meaningful Empty and Error States
223
+
224
+ ```tsx
225
+ // Don't show blank screens
226
+ function TaskList({ tasks }: { tasks: Task[] }) {
227
+ if (tasks.length === 0) {
228
+ return (
229
+ <div role="status" className="text-center py-12">
230
+ <TasksEmptyIcon className="mx-auto h-12 w-12 text-muted" />
231
+ <h3 className="mt-2 text-sm font-medium">No tasks</h3>
232
+ <p className="mt-1 text-sm text-muted">Get started by creating a new task.</p>
233
+ <Button className="mt-4" onClick={onCreateTask}>Create Task</Button>
234
+ </div>
235
+ );
236
+ }
237
+
238
+ return <ul role="list">...</ul>;
239
+ }
240
+ ```
241
+
242
+ ## Responsive Design
243
+
244
+ Design for mobile first, then expand:
245
+
246
+ ```tsx
247
+ // Tailwind: mobile-first responsive
248
+ <div className="
249
+ grid grid-cols-1 /* Mobile: single column */
250
+ sm:grid-cols-2 /* Small: 2 columns */
251
+ lg:grid-cols-3 /* Large: 3 columns */
252
+ gap-4
253
+ ">
254
+ ```
255
+
256
+ Test at these breakpoints: 320px, 768px, 1024px, 1440px.
257
+
258
+ ## Loading and Transitions
259
+
260
+ ```tsx
261
+ // Skeleton loading (not spinners for content)
262
+ function TaskListSkeleton() {
263
+ return (
264
+ <div className="space-y-3" aria-busy="true" aria-label="Loading tasks">
265
+ {Array.from({ length: 3 }).map((_, i) => (
266
+ <div key={i} className="h-12 bg-muted animate-pulse rounded" />
267
+ ))}
268
+ </div>
269
+ );
270
+ }
271
+
272
+ // Optimistic updates for perceived speed
273
+ function useToggleTask() {
274
+ const queryClient = useQueryClient();
275
+
276
+ return useMutation({
277
+ mutationFn: toggleTask,
278
+ onMutate: async (taskId) => {
279
+ await queryClient.cancelQueries({ queryKey: ['tasks'] });
280
+ const previous = queryClient.getQueryData(['tasks']);
281
+
282
+ queryClient.setQueryData(['tasks'], (old: Task[]) =>
283
+ old.map(t => t.id === taskId ? { ...t, done: !t.done } : t)
284
+ );
285
+
286
+ return { previous };
287
+ },
288
+ onError: (_err, _taskId, context) => {
289
+ queryClient.setQueryData(['tasks'], context?.previous);
290
+ },
291
+ });
292
+ }
293
+ ```
294
+
295
+ ## See Also
296
+
297
+ For detailed accessibility requirements and testing tools, see `../../references/accessibility-checklist.md`.
298
+
299
+ ## Common Rationalizations
300
+
301
+ | Rationalization | Reality |
302
+ |---|---|
303
+ | "Accessibility is a nice-to-have" | It's a legal requirement in many jurisdictions and an engineering quality standard. |
304
+ | "We'll make it responsive later" | Retrofitting responsive design is 3x harder than building it from the start. |
305
+ | "The design isn't final, so I'll skip styling" | Use the design system defaults. Unstyled UI creates a broken first impression for reviewers. |
306
+ | "This is just a prototype" | Prototypes become production code. Build the foundation right. |
307
+ | "The AI aesthetic is fine for now" | It signals low quality. Use the project's actual design system from the start. |
308
+
309
+ ## Red Flags
310
+
311
+ - Components with more than 200 lines (split them)
312
+ - Inline styles or arbitrary pixel values
313
+ - Missing error states, loading states, or empty states
314
+ - No keyboard navigation testing
315
+ - Color as the sole indicator of state (red/green without text or icons)
316
+ - Generic "AI look" (purple gradients, oversized cards, stock layouts)
317
+
318
+ ## Verification
319
+
320
+ After building UI:
321
+
322
+ - [ ] Component renders without console errors
323
+ - [ ] All interactive elements are keyboard accessible (Tab through the page)
324
+ - [ ] Screen reader can convey the page's content and structure
325
+ - [ ] Responsive: works at 320px, 768px, 1024px, 1440px
326
+ - [ ] Loading, error, and empty states all handled
327
+ - [ ] Follows the project's design system (spacing, colors, typography)
328
+ - [ ] No accessibility warnings in dev tools or axe-core