@chankov/agent-fleet 1.0.4 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (894) hide show
  1. package/.pi/harnesses/agent-hub/README.md +57 -66
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  32. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  38. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  39. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  40. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  41. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  42. package/.pi/harnesses/agent-hub/index.ts +1324 -9645
  43. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  44. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  45. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  51. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  53. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  58. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  59. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  60. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  61. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  62. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  63. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  64. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  65. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  66. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  67. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  68. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  69. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  70. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  71. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  72. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  73. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  75. package/.pi/harnesses/agent-hub/types.ts +60 -0
  76. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  77. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  78. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  79. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  80. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  81. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  82. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  83. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  84. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  85. package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
  86. package/.pi/harnesses/coms/index.ts +139 -1630
  87. package/.pi/harnesses/coms/package.json +1 -1
  88. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  89. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  90. package/.pi/harnesses/lib/coms-core.ts +577 -0
  91. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  92. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  93. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  94. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  95. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  96. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  97. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  98. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  99. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  100. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  101. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  102. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  103. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  104. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  105. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  106. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  107. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  108. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  109. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  110. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  111. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  112. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  113. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  114. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  115. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  116. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  117. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  118. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  119. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  120. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  121. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  122. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  123. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  124. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  125. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  126. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  127. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  128. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  129. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  130. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  131. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  132. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  133. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  134. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  135. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  136. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  137. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  138. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  139. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  140. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  141. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  142. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  143. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  144. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  145. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  146. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  147. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  148. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  149. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  150. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  151. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  152. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  153. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  154. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  155. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  156. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  157. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  158. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  159. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  160. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  161. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  162. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  163. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  164. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  165. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  166. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  167. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  168. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  169. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  170. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  171. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  172. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  173. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  174. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  175. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  176. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  177. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  178. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  179. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  180. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  181. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  182. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  183. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  184. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  185. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  186. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  187. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  188. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  189. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  190. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  191. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  192. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  193. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  194. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  195. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  196. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  197. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  198. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  199. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  200. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  201. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  202. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  203. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  204. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  205. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  206. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  207. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  208. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  209. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  210. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  211. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  212. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  213. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  214. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  215. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  216. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  217. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  218. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  219. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  220. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  221. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  222. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  223. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  224. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  225. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  226. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  227. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  228. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  229. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  230. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  231. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  232. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  233. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  234. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  235. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  236. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  237. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  238. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  239. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  240. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  241. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  242. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  243. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  244. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  245. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  246. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  247. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  248. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  249. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  250. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  251. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  252. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  253. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  254. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  255. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  256. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  257. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  258. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  259. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  260. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  261. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  262. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  263. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  264. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  265. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  266. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  267. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  268. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  269. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  270. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  271. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  272. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  273. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  274. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  275. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  276. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  277. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  278. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  279. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  280. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  281. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  282. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  283. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  284. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  285. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  286. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  287. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  288. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  289. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  290. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  291. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  292. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  293. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  294. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  295. package/.versions/2.0.0/.version +1 -0
  296. package/.versions/2.0.0/agents/architect.md +25 -0
  297. package/.versions/2.0.0/agents/bowser.md +28 -0
  298. package/.versions/2.0.0/agents/builder.md +56 -0
  299. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  300. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  301. package/.versions/2.0.0/agents/documenter.md +19 -0
  302. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  303. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  304. package/.versions/2.0.0/agents/planner.md +71 -0
  305. package/.versions/2.0.0/agents/releaser.md +25 -0
  306. package/.versions/2.0.0/agents/researcher.md +29 -0
  307. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  308. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  309. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  310. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  311. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  312. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  313. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  314. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  315. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  316. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  317. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  318. package/.versions/2.0.0/docs/getting-started.md +98 -0
  319. package/.versions/2.0.0/docs/npm-install.md +292 -0
  320. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  321. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  322. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  323. package/.versions/2.0.0/hermes/README.md +347 -0
  324. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  325. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  326. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  327. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  328. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  329. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  330. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  331. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  332. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  333. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  334. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  335. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  336. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  337. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  338. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  339. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  340. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  341. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  342. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  343. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  344. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  345. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  346. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  347. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  348. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  349. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  350. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  351. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  352. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  353. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  354. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  355. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  356. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  357. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  358. package/.versions/2.0.0/install-manifest.json +2745 -0
  359. package/.versions/2.0.0/justfile +272 -0
  360. package/.versions/2.0.0/manifest-meta.json +882 -0
  361. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  362. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  363. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  364. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  365. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  366. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  367. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  368. package/.versions/2.0.0/references/security-checklist.md +179 -0
  369. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  370. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  371. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  372. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  373. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  374. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  375. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  376. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  377. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  378. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  379. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  380. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  381. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  382. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  383. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  384. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  385. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  386. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  387. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  388. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  389. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  390. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  391. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  392. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  393. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  394. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  395. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  396. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  397. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  398. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  399. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  400. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  401. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  402. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  403. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  404. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  405. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  406. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  407. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  408. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  409. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  410. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  411. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  412. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  413. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  414. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  415. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  416. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  417. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  418. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  419. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  420. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  421. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  422. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  423. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  424. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  425. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  426. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  427. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  428. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  429. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  430. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  431. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  432. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  433. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  434. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  435. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  436. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  437. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  438. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  439. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  440. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  441. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  442. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  443. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  444. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  445. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  446. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  447. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  448. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  449. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  450. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  451. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  452. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  453. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  454. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  455. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  456. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  457. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  458. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  459. package/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  460. package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
  461. package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
  462. package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
  463. package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
  464. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  465. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  466. package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  467. package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
  468. package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
  469. package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
  470. package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
  471. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  472. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  473. package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  474. package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  475. package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  476. package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  477. package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  478. package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  479. package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  480. package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
  481. package/.versions/2.0.1/.pi/extensions/package.json +9 -0
  482. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  483. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  484. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  485. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  486. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  487. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  488. package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  489. package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
  490. package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  491. package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  492. package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  493. package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  494. package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  495. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  496. package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  497. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  498. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  499. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  500. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  501. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  502. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  503. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  504. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  505. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  506. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  507. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  508. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  509. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  510. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  511. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  512. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  513. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  514. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  515. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  516. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  517. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  518. package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  519. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  520. package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  521. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  522. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  523. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  524. package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  525. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  526. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  527. package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  528. package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
  529. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  530. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  531. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  532. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  533. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  534. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  535. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  536. package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  537. package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  538. package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  539. package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  540. package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  541. package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  542. package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  543. package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  544. package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  545. package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
  546. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  547. package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  548. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  549. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  550. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  551. package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  552. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  553. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  554. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  555. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  556. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  557. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  558. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  559. package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  560. package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  561. package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  562. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  563. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  564. package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  565. package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
  566. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  567. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  568. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  569. package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  570. package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  571. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  572. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  573. package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  574. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  575. package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  576. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  577. package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  578. package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  579. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
  580. package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  581. package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  582. package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  583. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  584. package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  585. package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
  586. package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
  587. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  588. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  589. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  590. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  591. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  592. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  593. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  594. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  595. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  596. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  597. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  598. package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  599. package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
  600. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  601. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  602. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  603. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  604. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  605. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  606. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  607. package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  608. package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  609. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  610. package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  611. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  612. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
  613. package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  614. package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
  615. package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
  616. package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
  617. package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
  618. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  619. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  620. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  621. package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  622. package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
  623. package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
  624. package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  625. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  626. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  627. package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
  628. package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
  629. package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  630. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  631. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  632. package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  633. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  634. package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  635. package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  636. package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  637. package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  638. package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  639. package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  640. package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  641. package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  642. package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  643. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  644. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  645. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  646. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  647. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  648. package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  649. package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  650. package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
  651. package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
  652. package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
  653. package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
  654. package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
  655. package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
  656. package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  657. package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  658. package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
  659. package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
  660. package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
  661. package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
  662. package/.versions/2.0.1/.version +1 -0
  663. package/.versions/2.0.1/agents/architect.md +25 -0
  664. package/.versions/2.0.1/agents/bowser.md +28 -0
  665. package/.versions/2.0.1/agents/builder.md +56 -0
  666. package/.versions/2.0.1/agents/code-reviewer.md +210 -0
  667. package/.versions/2.0.1/agents/deep-researcher.md +33 -0
  668. package/.versions/2.0.1/agents/documenter.md +22 -0
  669. package/.versions/2.0.1/agents/orchestrator.md +23 -0
  670. package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
  671. package/.versions/2.0.1/agents/planner.md +73 -0
  672. package/.versions/2.0.1/agents/releaser.md +25 -0
  673. package/.versions/2.0.1/agents/researcher.md +31 -0
  674. package/.versions/2.0.1/agents/security-auditor.md +168 -0
  675. package/.versions/2.0.1/agents/test-engineer.md +154 -0
  676. package/.versions/2.0.1/agents/web-debugger.md +44 -0
  677. package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
  678. package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  679. package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
  680. package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
  681. package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
  682. package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
  683. package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
  684. package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
  685. package/.versions/2.0.1/docs/getting-started.md +119 -0
  686. package/.versions/2.0.1/docs/npm-install.md +292 -0
  687. package/.versions/2.0.1/docs/pi-extensions.md +439 -0
  688. package/.versions/2.0.1/docs/pi-setup.md +74 -0
  689. package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
  690. package/.versions/2.0.1/hermes/README.md +347 -0
  691. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  692. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  693. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  694. package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  695. package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
  696. package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  697. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  698. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  699. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  700. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  701. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  702. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  703. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  704. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  705. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  706. package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  707. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  708. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  709. package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  710. package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  711. package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  712. package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  713. package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  714. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  715. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  716. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  717. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  718. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  719. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  720. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  721. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  722. package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  723. package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
  724. package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
  725. package/.versions/2.0.1/install-manifest.json +2830 -0
  726. package/.versions/2.0.1/justfile +286 -0
  727. package/.versions/2.0.1/manifest-meta.json +913 -0
  728. package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
  729. package/.versions/2.0.1/references/definition-of-done.md +67 -0
  730. package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
  731. package/.versions/2.0.1/references/observability-checklist.md +91 -0
  732. package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
  733. package/.versions/2.0.1/references/performance-checklist.md +153 -0
  734. package/.versions/2.0.1/references/prompting-patterns.md +380 -0
  735. package/.versions/2.0.1/references/security-checklist.md +179 -0
  736. package/.versions/2.0.1/references/testing-patterns.md +236 -0
  737. package/.versions/2.0.1/references/workflow-authoring.md +304 -0
  738. package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
  739. package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
  740. package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
  741. package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
  742. package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
  743. package/.versions/2.0.1/scripts/fleet.ts +198 -0
  744. package/.versions/2.0.1/scripts/flow.ts +121 -0
  745. package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  746. package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  747. package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  748. package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
  749. package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  750. package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
  751. package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
  752. package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
  753. package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  754. package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
  755. package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
  756. package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
  757. package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
  758. package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  759. package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  760. package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  761. package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  762. package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  763. package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  764. package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  765. package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
  766. package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
  767. package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
  768. package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
  769. package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
  770. package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
  771. package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
  772. package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
  773. package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
  774. package/.versions/2.0.1/scripts/team-up.ts +406 -0
  775. package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
  776. package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
  777. package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
  778. package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
  779. package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
  780. package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
  781. package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
  782. package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
  783. package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
  784. package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
  785. package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
  786. package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
  787. package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
  788. package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
  789. package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
  790. package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
  791. package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
  792. package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  793. package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  794. package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
  795. package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
  796. package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  797. package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
  798. package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  799. package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
  800. package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  801. package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  802. package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  803. package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
  804. package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
  805. package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
  806. package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  807. package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  808. package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
  809. package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
  810. package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
  811. package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
  812. package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
  813. package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
  814. package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
  815. package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
  816. package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
  817. package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  818. package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  819. package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
  820. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  821. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  822. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  823. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  824. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  825. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  826. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  827. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  828. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  829. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  830. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  831. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  832. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  833. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  834. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  835. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  836. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  837. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  838. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  839. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  840. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  841. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  842. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  843. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  844. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  845. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  846. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  847. package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  848. package/CHANGELOG.md +40 -0
  849. package/README.md +26 -5
  850. package/agents/code-reviewer.md +1 -0
  851. package/agents/documenter.md +3 -0
  852. package/agents/orchestrator.md +3 -1
  853. package/agents/planner.md +2 -0
  854. package/agents/researcher.md +2 -0
  855. package/bin/lib/overrides.js +2 -0
  856. package/bin/lib/validate-overrides.js +1 -1
  857. package/docs/ARCHITECTURE.md +45 -13
  858. package/docs/MIGRATION-agent-fleet.md +4 -4
  859. package/docs/agent-fleet-setup.md +15 -15
  860. package/docs/getting-started.md +21 -0
  861. package/docs/npm-install.md +1 -1
  862. package/docs/pi-extensions.md +16 -18
  863. package/docs/workflows.md +136 -0
  864. package/install-manifest.json +86 -1
  865. package/justfile +16 -2
  866. package/manifest-meta.json +32 -1
  867. package/package.json +11 -3
  868. package/references/workflow-authoring.md +304 -0
  869. package/scripts/fleet.ts +23 -10
  870. package/scripts/flow.ts +121 -0
  871. package/scripts/lib/fleet-command.ts +15 -11
  872. package/scripts/lib/flow-command.ts +77 -0
  873. package/scripts/lib/flow-maintenance.ts +230 -0
  874. package/scripts/lib/team-project.ts +2 -2
  875. package/scripts/team-up.ts +10 -10
  876. package/scripts/workflows/lib/agent-phase.ts +118 -0
  877. package/scripts/workflows/lib/changes.ts +61 -0
  878. package/scripts/workflows/lib/env.ts +34 -0
  879. package/scripts/workflows/lib/envelopes.ts +141 -0
  880. package/scripts/workflows/lib/gates.ts +81 -0
  881. package/scripts/workflows/lib/git.ts +96 -0
  882. package/scripts/workflows/lib/permissions.ts +130 -0
  883. package/scripts/workflows/lib/personas.ts +44 -0
  884. package/scripts/workflows/lib/quality.ts +64 -0
  885. package/scripts/workflows/lib/run.ts +106 -0
  886. package/scripts/workflows/lib/trace.ts +34 -0
  887. package/scripts/workflows/tsconfig.json +22 -0
  888. package/scripts/workflows/wf-build-test.ts +61 -0
  889. package/scripts/workflows/wf-document.ts +50 -0
  890. package/scripts/workflows/wf-quality.ts +20 -0
  891. package/scripts/workflows/wf-scout.ts +38 -0
  892. package/skills/drafting-workflows/SKILL.md +143 -0
  893. package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  894. package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
@@ -24,7 +24,7 @@ large.
24
24
  ## Unified Fleet runtime configuration
25
25
 
26
26
  A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
27
- plus Agent Hub in **operator** posture, in the current terminal, with no native
27
+ plus Agent Hub in **operator** work mode, in the current terminal, with no native
28
28
  specialists active:
29
29
 
30
30
  ```bash
@@ -32,13 +32,13 @@ just fleet
32
32
  just fleet --project af
33
33
  ```
34
34
 
35
- Posture, native roster, and peer topology are separate controls:
35
+ Work mode, native roster, and peer topology are separate controls:
36
36
 
37
37
  ```bash
38
38
  # Direct tools plus an available native roster.
39
- just fleet --posture operator --agents frontend --project af
39
+ just fleet --work-mode operator --agents frontend --project af
40
40
 
41
- # A roster implies orchestrator when posture is not explicit.
41
+ # A roster implies orchestrator when work mode is not explicit.
42
42
  just fleet --agents frontend --project af
43
43
 
44
44
  # Herdr Hub-only and Hub-plus-peer topologies.
@@ -46,8 +46,8 @@ just fleet --herdr --project af
46
46
  just fleet --agents frontend --peers frontend --project af
47
47
  ```
48
48
 
49
- Startup precedence is deterministic: explicit `--posture` wins; otherwise an
50
- explicit `--agents` roster implies `orchestrator`; otherwise posture is
49
+ Startup precedence is deterministic: explicit `--work-mode` wins; otherwise an
50
+ explicit `--agents` roster implies `orchestrator`; otherwise work mode is
51
51
  `operator`. An orchestrator startup must name a roster. `--herdr` affects only
52
52
  placement, while `--peers <preset>` implies Herdr and starts the selected peer
53
53
  preset. Neither topology option selects a native roster.
@@ -64,7 +64,7 @@ The configuration files have distinct ownership:
64
64
  | `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
65
65
  | `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
66
66
  | `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
67
- | `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budget ceilings, watchdog, and related execution policy. It does not choose startup posture or topology. |
67
+ | `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budget ceilings, watchdog, and related execution policy. It does not choose startup work mode or topology. |
68
68
 
69
69
  For deterministic routing, `backend: "native"` always starts the local Pi
70
70
  specialist even if a same-name peer is visible. `backend: "coms"` requires a
@@ -83,7 +83,7 @@ Capability flags and runtime gates fail closed:
83
83
  - `--browser` adds the browser extension surface and `--all-extensions` opts
84
84
  into the complete approved extension set. Missing optional dependencies do
85
85
  not grant tools merely because a flag was supplied.
86
- - Hub-owned slash commands remain registered in both postures. A missing coms
86
+ - Hub-owned slash commands remain registered in both work modes. A missing coms
87
87
  runtime, Herdr connection, target peer, or native roster produces a
88
88
  capability refusal rather than a missing command.
89
89
 
@@ -116,10 +116,10 @@ synthetic entries to recover from context pressure.
116
116
 
117
117
  A resumed orchestrator session may instead be blocked because its persisted team name no longer
118
118
  resolves against the current `.pi/agents/teams.yaml` and persona files. This is a fail-closed roster
119
- recovery gate: orchestrator posture and its direct-tool restrictions remain in force. Choose a valid
119
+ recovery gate: orchestrator work mode and its direct-tool restrictions remain in force. Choose a valid
120
120
  team with `/af-agents-team`, restart publicly with `just fleet --agents <name>`, or explicitly choose
121
- operator posture with `/af-posture operator` / `just fleet --posture operator`. Direct Pi launches
122
- use `--agent-team <name>` or `--posture operator`. Explicit startup flags win over persisted state;
121
+ operator work mode with `/af-work-mode operator` / `just fleet --work-mode operator`. Direct Pi launches
122
+ use `--agent-team <name>` or `--work-mode operator`. Explicit startup flags win over persisted state;
123
123
  fix missing or renamed team/persona declarations before selecting them.
124
124
 
125
125
  ## The overrides file — `.ai/agent-fleet-overrides.md`
@@ -202,7 +202,7 @@ targets an end-of-session compound pass writes lessons to.
202
202
  | Key | Default | Meaning |
203
203
  |-----|---------|---------|
204
204
  | `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
205
- | `persona-gate` | `off` | When `on`, blocks input at session start until an orchestrator persona is picked. |
205
+ | `persona-gate` | — | **Removed.** Ignored with a doctor warning; dispatcher flavor is no longer selectable. Use `/af-work-mode` for operator vs orchestrator. Delete the key. |
206
206
  | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). If the override reports a model/provider error or aborted request before producing text or starting a tool (including a local-model memory-limit failure), agent-hub restores the child session and retries once with the original frontmatter model; it does not fallback after work starts, cancellation, timeout, drift stop, or process-spawn failure. |
207
207
  | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
208
208
  | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
@@ -210,15 +210,15 @@ targets an end-of-session compound pass writes lessons to.
210
210
  | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
211
211
  | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
212
212
  | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
213
- | `research-keep` | `4` | How many **finished** manual/persona research helpers the hub retains (LRU by finish time) so they stay resumable via `/af-agents-cont rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
213
+ | `research-keep` | `4` | How many **finished** durable/persona research helpers the hub retains (LRU by finish time) for dashboard inspection or a fresh `/af-agents-restart rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
214
214
  | `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
215
215
  | `mode` | — | **Removed.** Ignored with a warning; budgets follow task tier. Delete the key. |
216
216
  | `max-dispatches-per-turn` | tier default (1/2/8/12) | Ceiling on `dispatch_agent` calls per user turn (`min` with the task-tier envelope). Positive integer or `off` (stays at the tier). |
217
- | `max-research-per-turn` | tier default (1/2/4/6) | Ceiling on `spawn_research` calls per user turn (the auto-research pipe and the `/af-research` command are exempt). Positive integer or `off` (stays at the tier). |
217
+ | `max-research-per-turn` | tier default (1/2/4/6) | Ceiling on dispatcher-initiated `spawn_research` calls per user turn. The automatic `NEEDS_RESEARCH:` pipe is exempt from the turn budget but still counts against the task research envelope. Positive integer or `off` (stays at the tier). |
218
218
  | `turn-wall-time-s` | tier default (900/900/3600/5400) | Active-time ceiling, in seconds, per user turn; time blocked in `ask_user` is excluded. Once exceeded, further dispatch/research calls refuse until the one-click continuation is accepted or a new user turn begins. Positive integer or `off` (stays at the tier). |
219
219
  | `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
220
220
  | `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
221
- | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator posture auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
221
+ | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
222
222
  | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
223
223
 
224
224
  Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
@@ -47,6 +47,27 @@ just fleet --agents default --peers docs --project af
47
47
  # Hub + standing Herdr peers
48
48
  ```
49
49
 
50
+ ## Run and maintain deterministic flows
51
+
52
+ When the workflow runtime is selected, `just flow` runs code-owned workflows outside the interactive hub:
53
+
54
+ ```bash
55
+ just flow scout "where is authentication configured?"
56
+ just flow quality
57
+ just flow build-test "add the validated endpoint"
58
+ ```
59
+
60
+ Each run creates a `flow/<name>-<runId>` branch. Use the numbered maintenance selector to remove an empty/integrated branch or squash-merge an accepted result back to the branch from which it started:
61
+
62
+ ```bash
63
+ just flow cleanup # list flow branches and prompt for a number
64
+ just flow cleanup 1 # safely remove selection 1 through Worktrunk
65
+ just flow merge # list flow branches and prompt for a number
66
+ just flow merge 2 # squash-merge selection 2 through Worktrunk
67
+ ```
68
+
69
+ Maintenance requires [Worktrunk](https://worktrunk.dev). It refuses dirty worktrees, rejected runs, and unknown merge targets. See [workflows.md](workflows.md#clean-up-and-merge-flow-branches) for `--discard`, `--target`, full branch selectors, non-interactive `--yes`, and safety details.
70
+
50
71
  ## Update an existing install
51
72
 
52
73
  A pi session tells you when a newer version is published. To act on it:
@@ -63,7 +63,7 @@ just fleet doctor # confirm the workspace is whole
63
63
 
64
64
  ```bash
65
65
  just fleet doctor # exit 0 = nothing to repair, 2 = repairable findings
66
- just fleet # Hub in operator posture, empty native roster
66
+ just fleet # Hub in operator work mode, empty native roster
67
67
  ```
68
68
 
69
69
  From here on `just fleet setup`, `just fleet doctor`, and `just fleet uninstall`
@@ -54,7 +54,7 @@ tool call. The unified `just fleet` entry point composes them with a determinist
54
54
  Fleet Core: `damage-control-continue`, `ask-user-remote`, Compact & Continue,
55
55
  BTW, and the update checker. Voice is an optional feature, not Default Fleet Core.
56
56
  Every public Pi launch through bare `just fleet` also loads
57
- `agent-hub`; operator/orchestrator posture changes its direct tool surface without changing
57
+ `agent-hub`; operator/orchestrator work mode changes its direct tool surface without changing
58
58
  process or session. `just fleet peer` starts a standalone coms peer. Harnesses live in
59
59
  **`.pi/harnesses/`** — a directory pi does
60
60
  *not* auto-discover — so a plain `pi` run still loads no safety/orchestration harness.
@@ -165,11 +165,10 @@ make a harness self-contained: copied target harnesses still require the existin
165
165
  `agent-team` recipe and absorbs the day-to-day pieces that previously required separate
166
166
  harnesses:
167
167
 
168
- - **Two live postures** — bare `just fleet` starts as an operator with direct coding tools and an
169
- empty native roster; `/af-posture operator|orchestrator` switches prompt and tool surface without
170
- restarting or losing session state. Orchestrator removes direct coding tools. `/af-work-mode` and
171
- **Alt+M** are posture shortcuts (operator \| orchestrator). Budgets and nested delegation follow
172
- task tier. All Hub slash commands remain registered in both postures; capability-off actions
168
+ - **Two live Work Modes** — bare `just fleet` starts as an operator with direct coding tools and an
169
+ empty native roster; `/af-work-mode operator|orchestrator` switches prompt and tool surface without
170
+ restarting or losing session state, while `/af-work-mode` without an argument and **Alt+M** open
171
+ the picker. Orchestrator removes direct coding tools. Budgets and nested delegation follow task tier. All Hub slash commands remain registered in both work modes; capability-off actions
173
172
  refuse actionably.
174
173
  - **Fleet Dashboard and compact widget** — **`Alt+A`** or `/af-agents-list` opens a
175
174
  full-screen dashboard of the active native roster, delegates, research helpers, and coms
@@ -181,8 +180,9 @@ harnesses:
181
180
  running agents; **`Alt+Shift+A`** toggles it on/off. See the
182
181
  [agent-hub README](../.pi/harnesses/agent-hub/README.md#fleet-dashboard-and-detail) for
183
182
  keys and action semantics.
184
- - **Specialist delegation** — `dispatch_agent` for writable child-agent work and
185
- `spawn_research` / `/af-research` for read-only investigation.
183
+ - **Specialist delegation** — `dispatch_agent` for writable child-agent work. Read-only
184
+ investigation is automated through dispatcher-invoked `spawn_research` and the specialists'
185
+ `NEEDS_RESEARCH:` pipe; dedicated research lifecycle slash commands are not registered.
186
186
  - **Verification Contract** — the dispatcher owns a ledger of checkable acceptance assertions
187
187
  built before any builder runs, via the `set_assertions` / `update_assertion` tools. Each
188
188
  assertion is tagged (`test` | `runtime-ui` | `code-grep` | `manual`) and advanced only on
@@ -193,10 +193,8 @@ harnesses:
193
193
  assertions — see the [`orchestration-verification`](../skills/orchestration-verification/SKILL.md)
194
194
  skill, which the `orchestrator` persona drives. Advisory in this phase (surfaced, not a hard
195
195
  dispatch refusal).
196
- - **Persona gate** — requires an orchestrator persona at startup unless disabled in the local
197
- override file; the chosen persona also feeds the coms purpose when no explicit `--purpose` is set.
198
196
  - **Operator controls** — `/af-zoom` timeline inspection plus child-agent kill/restart controls. `/af-context` is a separate read-only full-screen context-budget view: provider totals/cache fields are authoritative, component estimates are labelled heuristic or provider-scaled, stable prompt and volatile-state cost are separated, loaded-but-excluded and inactive packs visibly cost zero, and fleet members use separate model-window denominators. It also shows live pressure phase, measured usage, the 80%/90% thresholds, episode, and last recovery outcome. It never reveals or persists raw prompts, schemas, conversation content, error bodies, or compaction summaries.
199
- - **Automatic capability packs** — no activation command is needed. Intent, posture, tier, pending work, and runtime state resolve the model-visible tools before the turn; readiness alone does not make coms/Herdr visible. Ambiguous fleet, peer, or workspace use asks once before its first side effect. The compact pack is transient when explicitly requested or pressure is imminent; ordinary task packs persist until `set_task_tier(new_task: true)`. Managed children receive selected replacement prompts/manifests (`--no-skills` and `--no-context-files` where applicable), not inherited global context.
197
+ - **Automatic capability packs** — no activation command is needed. Intent, work mode, tier, pending work, and runtime state resolve the model-visible tools before the turn; readiness alone does not make coms/Herdr visible. Ambiguous fleet, peer, or workspace use asks once before its first side effect. The compact pack is transient when explicitly requested or pressure is imminent; ordinary task packs persist until `set_task_tier(new_task: true)`. Managed children receive selected replacement prompts/manifests (`--no-skills` and `--no-context-files` where applicable), not inherited global context.
200
198
  - **One-click budget continuation** — turn and task refusals ask one localized Yes/No `ask_user` question. Yes renews the budget in the same tool loop, without a typed `continue` or slash command. Task continuation opens an audited tranche while preserving task tier, assertions, capability packs, blockers, label, and progress; genuinely different work uses `set_task_tier(new_task: true)`. Turn and task active-time clocks both exclude human wait time.
201
199
  - **Damage-control + ask_user by default** — `just fleet` and `just fleet --no-coms` load the
202
200
  `damage-control-continue` safety harness and `ask-user-remote` before `agent-hub`, so the
@@ -212,7 +210,7 @@ harnesses:
212
210
  - **Embedded coms** — peer discovery, `coms_list` / `coms_send` / `coms_get` / `coms_await`,
213
211
  `/af-handoff`, and peer-as-subagent flows.
214
212
  - **No-coms mode** — `just fleet --no-coms` keeps direct operator work, native delegation,
215
- research helpers, persona gate, and controls, but starts without embedded coms. `/af-handoff`
213
+ research helpers, and controls, but starts without embedded coms. `/af-handoff`
216
214
  remains registered and explains why it cannot run. Legacy `--solo` maps to this flag with a warning.
217
215
  - **Optional Hermes local monitor transport** — uses `AGENT_FLEET_PROFILE_ID`, the absolute
218
216
  `AGENT_FLEET_MONITOR_RUNTIME_DIR`, and the Herdr `HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`
@@ -237,21 +235,21 @@ session JSONL under `~/.pi/agent/sessions/` remains the authoritative append-onl
237
235
  overflow does not imply corruption: inspect with `/session`, resume with `/resume` or Pi's session
238
236
  flags, and **never edit, truncate, reorder, or synthesize JSONL entries to recover**.
239
237
 
240
- If resume instead reports that orchestrator posture has no valid native roster, direct tools and
238
+ If resume instead reports that orchestrator work mode has no valid native roster, direct tools and
241
239
  model input intentionally remain blocked. Select a current team with `/af-agents-team`; restart via
242
240
  `just fleet --agents <name>` (direct Pi: `--agent-team <name>`); or explicitly choose operator with
243
- `/af-posture operator` / `just fleet --posture operator`. Repair stale team/persona definitions
244
- before selecting them. The Hub never invents a roster or silently downgrades persisted posture, and
241
+ `/af-work-mode operator` / `just fleet --work-mode operator`. Repair stale team/persona definitions
242
+ before selecting them. The Hub never invents a roster or silently downgrades persisted work mode, and
245
243
  explicit startup flags retain precedence.
246
244
 
247
245
  ### Runtime axes and explicit routing
248
246
 
249
- Posture, native roster, and peer topology are independent:
247
+ Work mode, native roster, and peer topology are independent:
250
248
 
251
249
  ```bash
252
250
  just fleet # operator, empty native roster
253
251
  just fleet --agents frontend # orchestrator inferred
254
- just fleet --posture operator --agents frontend # direct tools + native roster
252
+ just fleet --work-mode operator --agents frontend # direct tools + native roster
255
253
  just fleet --herdr --project af # one Hub pane in Herdr
256
254
  just fleet --agents frontend --peers frontend --project af
257
255
  ```
@@ -268,7 +266,7 @@ Inside a Herdr-backed Hub, `herdr_spawn_peer({ name: "code-reviewer" })` uses th
268
266
  and waits for coms readiness. Then use `coms_send` + `coms_await`, or `/af-handoff
269
267
  code-reviewer`. These actions need a running Herdr server and/or ready coms as appropriate; the
270
268
  commands stay registered and explain missing capability. Arbitrary pane commands use the separate
271
- `herdr_spawn_pane` tool. In orchestrator posture that tool is limited by policy to auxiliary
269
+ `herdr_spawn_pane` tool. In orchestrator work mode that tool is limited by policy to auxiliary
272
270
  processes such as watchers or servers; it must not be used to bypass delegation for code work.
273
271
 
274
272
  ---
@@ -0,0 +1,136 @@
1
+ # Deterministic Workflows
2
+
3
+ Agent Fleet provides a code-owned, headless workflow layer beside the interactive `agent-hub`. Workflow code fixes phase order, bounded retries, executable gates, permissions, and acceptance; agents are used only for phases that require judgment. Nothing in this layer changes `just fleet`.
4
+
5
+ ## Run a flow
6
+
7
+ ```bash
8
+ just flow quality
9
+ just flow scout "where is authentication configured?"
10
+ just flow build-test "add the validated endpoint"
11
+ just flow document
12
+ ```
13
+
14
+ The raw entry point is equivalent and loads `.env` itself:
15
+
16
+ ```bash
17
+ node --experimental-strip-types scripts/flow.ts quality
18
+ ```
19
+
20
+ Options:
21
+
22
+ - `--dry-run` executes the full graph with valid stub agent envelopes and no model calls.
23
+ - `--run-id <id>` assigns a trace id.
24
+ - `--allow-dirty` explicitly bypasses the normal clean-tree refusal.
25
+
26
+ Exit codes are `0` accepted, `1` failed/unaccepted, `2` invalid arguments or unknown flow, and `3` startup refusal. SIGINT/SIGTERM finalize the run trace and return `128 + signal`.
27
+
28
+ ## Clean up and merge flow branches
29
+
30
+ Every run records its source branch and commit before creating `flow/<name>-<runId>`, then records whether the run was accepted or rejected. The reserved `cleanup` and `merge` subcommands use that metadata and [Worktrunk](https://worktrunk.dev) to manage completed branches.
31
+
32
+ List branches and open the numbered prompt in a terminal:
33
+
34
+ ```bash
35
+ just flow cleanup
36
+ ```
37
+
38
+ Example output:
39
+
40
+ ```text
41
+ Flow branches:
42
+ 1. flow/scout-scout-demo accepted clean ↑0 ↓0 target: main
43
+ 2. flow/build-test-api-42 accepted clean ↑1 ↓0 target: feature/api
44
+
45
+ Select with a number or full branch name.
46
+ Clean up which flow branch?
47
+ ```
48
+
49
+ Select by the displayed number or by its stable full name:
50
+
51
+ ```bash
52
+ just flow cleanup 1
53
+ just flow cleanup flow/scout-scout-demo
54
+ ```
55
+
56
+ Normal cleanup calls `wt remove` without force. Worktrunk removes only clean work that is empty or already integrated; otherwise the command fails and keeps the branch. To intentionally discard a clean but unmerged branch, make that destructive intent explicit:
57
+
58
+ ```bash
59
+ just flow cleanup 2 --discard
60
+ ```
61
+
62
+ The wrapper never passes Worktrunk's worktree `--force` flag: a dirty worktree must be committed or stashed manually. In non-interactive automation, listing without a selector only prints options; a selected mutation also requires `--yes`:
63
+
64
+ ```bash
65
+ just flow cleanup flow/scout-scout-demo --yes
66
+ ```
67
+
68
+ Merge presents the same selector:
69
+
70
+ ```bash
71
+ just flow merge
72
+ just flow merge 2
73
+ ```
74
+
75
+ Only an accepted run with a clean worktree can merge. The command invokes Worktrunk's standard `wt merge <target>` pipeline: squash to one commit, rebase onto the recorded source branch when necessary, run configured hooks, fast-forward the target, then remove the flow worktree and branch. If a selected branch is not checked out, Worktrunk first materializes its worktree. Old flow branches without source metadata require an explicit local target rather than a guess:
76
+
77
+ ```bash
78
+ just flow merge flow/build-test-api-42 --target feature/api
79
+ ```
80
+
81
+ Maintenance does not fetch remotes and does not delete `.pi/flow-sessions/<runId>`; traces remain as local execution evidence. `cleanup` and `merge` are reserved maintenance names and cannot be generated as workflow names.
82
+
83
+ ## Shipped flows
84
+
85
+ | Flow | Shape | Purpose |
86
+ | --- | --- | --- |
87
+ | `quality` | `engineer(request) → code(quality)` | Run configured quality evidence without an agent. |
88
+ | `scout` | `engineer(request) → agent(scout)` | Read-only repository reconnaissance. |
89
+ | `build-test` | `engineer(request) → agent(builder) → code(test) → agent(builder-fix, bounded) → code(commit)` | Build, deterministically test, repair within a bound, then commit once. |
90
+ | `document` | `code(changes) → agent(documenter) → code(commit)` | Capture changes deterministically, document them, gate files, then commit. |
91
+
92
+ ## Quality configuration
93
+
94
+ Quality blocks require a non-empty `quality:` command in `## workflows` in `.ai/agent-fleet-overrides.md`; there is **no implicit `npm test` fallback**. A missing override, missing `## workflows` section, or empty `quality:` value is a startup refusal (exit `3`), rather than a fake green command. The value is split into argv using simple shell-style quotes, inherits the operator environment, and runs without a shell.
95
+
96
+ ```markdown
97
+ ## workflows
98
+ quality: npm test
99
+ ```
100
+
101
+ The runtime currently uses its 1,800-second default timeout; `timeout-seconds:` and JSON-array values are not workflow configuration keys. Command output is stored in `.pi/flow-sessions/<runId>/command.log`. A missing executable produces exit `127` and its actual diagnostic.
102
+
103
+ ## Safety and evidence
104
+
105
+ Normal runs require a clean tree and create `flow/<name>-<runId>`. The branch stores its source branch, source commit, flow name, run id, and final acceptance as local Git metadata so maintenance can merge back without guessing. Every agent phase must receive an explicit writes policy from persona frontmatter or its call site; a missing policy is refused before spawn rather than silently treated as unrestricted. `writes: []` is repository read-only, and a non-empty list is an allowlist. Agent writes are checked after each phase against that policy and workflow `protectedGlobs`. `protectedGlobs` reject a path only when no `writes` glob matches it, so `writes: ["**"]` also permits a protected path. `*` stays within one path segment; `**` crosses directories. Out-of-policy changes introduced by the agent are rolled back and terminate the phase. Runtime reports remain writable even for repository-read-only agents. This enforcement exists only in flows; hub behavior is unchanged.
106
+
107
+ Every run writes JSONL under `.pi/flow-sessions/<runId>/trace.jsonl`; this directory is gitignored and separate from hub sessions. Phase success and work acceptance are separate. `run.finish()` produces the exit code, final trace status, and banner from one decision so they cannot disagree.
108
+
109
+ Agent reports use TypeBox envelopes built on the existing return-contract vocabulary. Invalid reports are corrected in the same Pi session with exact field errors. Executable gates inspect artifacts, sizes, JSON, changed-file claims, real test commands, and review-verdict consistency. Permission breaches are terminal rather than correctable.
110
+
111
+ ## Author a workflow
112
+
113
+ Invoke the `drafting-workflows` skill. It first reads this map, lists available `wf-*.ts` shapes one per line, and waits. After the operator supplies intent, use the deterministic generator:
114
+
115
+ ```bash
116
+ node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
117
+ plan-build-review 'agent(plan) → agent(build) → agent(review)'
118
+ ```
119
+
120
+ The generator copies the nearest complete workflow, preserves commas inside parenthesized phase annotations, replaces its phase docstring block, and renames the workflow and optional preflight symbols to the unique camel-cased identity derived from the new filename (for example, `planBuildReviewWorkflow`). Built-in flows are listed in `scripts/flow.ts`; a non-built-in `wf-<name>.ts` is resolved on demand by that same export convention, making a generated draft reachable through `just flow <name>` without editing the built-in map. TODOs remain only for gate, retry, and acceptance judgments. The generator refuses to return a draft unless both of these pass:
121
+
122
+ ```bash
123
+ npx tsc -p scripts/workflows/tsconfig.json --noEmit
124
+ node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
125
+ --verify-draft scripts/workflows/wf-plan-build-review.ts
126
+ ```
127
+
128
+ The scoped TypeScript project checks workflow production sources only; the dry-run resolves the same exact export convention as `just flow`; workflow imports cross into hub seams through typed dynamic imports, so neither check makes `.pi/harnesses/**` part of the typecheck. See [workflow-authoring.md](../references/workflow-authoring.md) for envelopes, correction, gates, permissions, quality, change capture, dry-run, and packaging contracts.
129
+
130
+ ## Architecture boundary
131
+
132
+ `just flow` directly composes `scripts/workflows/lib/` with the clean `spawnPiAgent` and context seams. It does not call `dispatch-native.ts`, use the hub ledger as acceptance, or change hub scope semantics. `just fleet`, coms peers, Herdr, Hermes, budgets, and the Fleet Dashboard continue to operate as before.
133
+
134
+ ## Future `run_flow` tool (D8, design only)
135
+
136
+ A future hub tool may call the exported flow dispatcher module directly with validated arguments. It must never shell through `just`, and it must preserve clean-tree checks, cancellation, trace finalization, permission enforcement, and exact acceptance semantics. This release intentionally registers no `run_flow` tool and modifies no hub implementation; budgeting and cancellation ownership require a separate design/implementation cycle.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "packageVersion": "1.0.4",
3
+ "packageVersion": "2.0.1",
4
4
  "groups": [
5
5
  {
6
6
  "id": "skills",
@@ -650,6 +650,9 @@
650
650
  "strategy": "managed-region"
651
651
  }
652
652
  },
653
+ "companions": [
654
+ "companion:workflow-runtime"
655
+ ],
653
656
  "parents": [
654
657
  "pi-harness:agent-hub",
655
658
  "pi-harness:ask-user-remote",
@@ -899,6 +902,37 @@
899
902
  "pi-extension:pi-voice-stt"
900
903
  ]
901
904
  },
905
+ {
906
+ "id": "companion:workflow-runtime",
907
+ "kind": "companion",
908
+ "group": "companions",
909
+ "subcategory": null,
910
+ "title": "Deterministic workflow runtime",
911
+ "summary": "Headless flow dispatcher, workflow graphs, scoped configuration, and operations guide",
912
+ "recommended": false,
913
+ "stability": "stable",
914
+ "consent": "file",
915
+ "platform": "any",
916
+ "agents": {
917
+ "pi": {
918
+ "source": [
919
+ "scripts/flow.ts",
920
+ "scripts/lib/flow-command.ts",
921
+ "scripts/lib/flow-maintenance.ts",
922
+ "scripts/workflows",
923
+ "docs/workflows.md"
924
+ ],
925
+ "sourceMode": "all",
926
+ "target": null,
927
+ "strategy": "copy-tree",
928
+ "preserveLayout": true
929
+ }
930
+ },
931
+ "parents": [
932
+ "companion:justfile-region",
933
+ "skill:drafting-workflows"
934
+ ]
935
+ },
902
936
  {
903
937
  "id": "external:pi-ask-user",
904
938
  "kind": "external-package",
@@ -2045,6 +2079,31 @@
2045
2079
  "skill:test-driven-development"
2046
2080
  ]
2047
2081
  },
2082
+ {
2083
+ "id": "reference:workflow-authoring",
2084
+ "kind": "reference",
2085
+ "group": "references",
2086
+ "subcategory": null,
2087
+ "title": "workflow-authoring",
2088
+ "summary": "",
2089
+ "recommended": false,
2090
+ "stability": "stable",
2091
+ "consent": "file",
2092
+ "platform": "any",
2093
+ "agents": {
2094
+ "pi": {
2095
+ "source": [
2096
+ "references/workflow-authoring.md"
2097
+ ],
2098
+ "sourceMode": "first",
2099
+ "target": ".pi/references/workflow-authoring.md",
2100
+ "strategy": "copy-file"
2101
+ }
2102
+ },
2103
+ "parents": [
2104
+ "skill:drafting-workflows"
2105
+ ]
2106
+ },
2048
2107
  {
2049
2108
  "id": "skill:api-and-interface-design",
2050
2109
  "kind": "skill",
@@ -2330,6 +2389,32 @@
2330
2389
  "reference:orchestration-patterns"
2331
2390
  ]
2332
2391
  },
2392
+ {
2393
+ "id": "skill:drafting-workflows",
2394
+ "kind": "skill",
2395
+ "group": "skills",
2396
+ "subcategory": "meta",
2397
+ "title": "drafting-workflows",
2398
+ "summary": "Drafts deterministic Agent Fleet workflows by adapting the nearest existing flow and proving the draft compiles and d…",
2399
+ "recommended": false,
2400
+ "stability": "stable",
2401
+ "consent": "file",
2402
+ "platform": "any",
2403
+ "agents": {
2404
+ "pi": {
2405
+ "source": [
2406
+ "skills/drafting-workflows"
2407
+ ],
2408
+ "sourceMode": "first",
2409
+ "target": ".pi/skills/drafting-workflows",
2410
+ "strategy": "copy-tree"
2411
+ }
2412
+ },
2413
+ "companions": [
2414
+ "companion:workflow-runtime",
2415
+ "reference:workflow-authoring"
2416
+ ]
2417
+ },
2333
2418
  {
2334
2419
  "id": "skill:frontend-ui-engineering",
2335
2420
  "kind": "skill",
package/justfile CHANGED
@@ -50,12 +50,12 @@ default:
50
50
 
51
51
  # ---------------------------------------------------------------- unified Fleet interface
52
52
 
53
- # Agent Fleet — one guarded Hub runtime, two postures, independent topology.
53
+ # Agent Fleet — one guarded Hub runtime, two work modes, independent topology.
54
54
  #
55
55
  # UNIFIED HUB (recommended default)
56
56
  # just fleet # operator + empty native roster
57
57
  # just fleet --agents frontend # orchestrator + native roster
58
- # just fleet --posture operator --agents frontend
58
+ # just fleet --work-mode operator --agents frontend
59
59
  # just fleet --no-coms # direct/native work, no peer messaging
60
60
  # just fleet --browser # add live Chrome DevTools tools
61
61
  # just fleet --voice # load installed push-to-talk STT
@@ -76,6 +76,15 @@ default:
76
76
  # just fleet team frontend --project af # use canonical --agents/--peers flags
77
77
  # just fleet team frontend --no-hub # legacy peers-only topology
78
78
  #
79
+ # DETERMINISTIC FLOWS AND BRANCH MAINTENANCE
80
+ # just flow scout "where is authentication configured?"
81
+ # just flow quality
82
+ # just flow build-test "add the validated endpoint"
83
+ # just flow cleanup # numbered selector
84
+ # just flow cleanup 2 # safe Worktrunk removal
85
+ # just flow merge # numbered selector
86
+ # just flow merge 2 # Worktrunk squash merge to recorded source
87
+ #
79
88
  # TEAM LIFECYCLE
80
89
  # just fleet snapshot frontend --project af
81
90
  # just fleet down frontend --project af
@@ -107,6 +116,11 @@ default:
107
116
  fleet *args:
108
117
  @{{node_ts}} scripts/fleet.ts {{args}}
109
118
 
119
+ # Headless workflows plus `flow cleanup` / `flow merge` Worktrunk branch maintenance.
120
+ # Exits 0 accepted/success; 1 rejected/failed; 2 invalid/unknown; 3 refused start.
121
+ flow *args:
122
+ @{{node_ts}} scripts/flow.ts {{args}}
123
+
110
124
  # Hidden Fleet Core launcher. Positional booleans are emitted only by fleet.ts.
111
125
  _fleet-core browser="false" voice="false" all_extensions="false" *args:
112
126
  discovery="--no-extensions"; if [ "{{all_extensions}}" = "true" ]; then discovery=""; fi; browser_ext=""; if [ "{{browser}}" = "true" ]; then browser_ext="{{fleet_browser_extension}}"; fi; voice_ext=""; if [ "{{voice}}" = "true" ]; then voice_ext="{{fleet_voice_extension}}"; fi; pi $discovery {{fleet_core_extensions}} $browser_ext $voice_ext {{args}}
@@ -280,7 +280,8 @@
280
280
  "hermes-plugin:agent-fleet-monitor": "plugin",
281
281
  "hermes-skill:hub-conductor": "skill",
282
282
  "hermes-skill:hub-liaison": "skill",
283
- "hermes-skill:hub-watchdog": "skill"
283
+ "hermes-skill:hub-watchdog": "skill",
284
+ "skill:drafting-workflows": "meta"
284
285
  },
285
286
  "items": {
286
287
  "_comment": "Per-id overrides merged onto the derived item.",
@@ -589,6 +590,17 @@
589
590
  "just fleet conductor codex status # reports requested systemd state only"
590
591
  ],
591
592
  "stability": "experimental"
593
+ },
594
+ "skill:drafting-workflows": {
595
+ "companions": [
596
+ "reference:workflow-authoring",
597
+ "companion:workflow-runtime"
598
+ ]
599
+ },
600
+ "companion:justfile-region": {
601
+ "companions": [
602
+ "companion:workflow-runtime"
603
+ ]
592
604
  }
593
605
  },
594
606
  "companions": {
@@ -745,6 +757,25 @@
745
757
  "put the API key in a gitignored .env under the env-var name stt.json references; never in stt.json itself",
746
758
  "the extension binds Alt+S only once a provider resolves — until then it is a no-op"
747
759
  ]
760
+ },
761
+ "companion:workflow-runtime": {
762
+ "title": "Deterministic workflow runtime",
763
+ "summary": "Headless flow dispatcher, workflow graphs, scoped configuration, and operations guide",
764
+ "agents": {
765
+ "pi": {
766
+ "source": [
767
+ "scripts/flow.ts",
768
+ "scripts/lib/flow-command.ts",
769
+ "scripts/lib/flow-maintenance.ts",
770
+ "scripts/workflows",
771
+ "docs/workflows.md"
772
+ ],
773
+ "sourceMode": "all",
774
+ "preserveLayout": true,
775
+ "target": null,
776
+ "strategy": "copy-tree"
777
+ }
778
+ }
748
779
  }
749
780
  },
750
781
  "externalPackages": {