@chankov/agent-fleet 2.0.14 → 2.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (617) hide show
  1. package/.pi/agent-fleet/scripts/fleet.ts +2 -1
  2. package/.pi/extensions/compact-and-continue/README.md +2 -2
  3. package/.pi/harnesses/agent-hub/README.md +89 -10
  4. package/.pi/harnesses/agent-hub/budget-recovery.ts +2 -2
  5. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  6. package/.pi/harnesses/agent-hub/commands/recover.ts +13 -4
  7. package/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  8. package/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  9. package/.pi/harnesses/agent-hub/context/budgets.ts +9 -7
  10. package/.pi/harnesses/agent-hub/deterministic-fs.ts +51 -12
  11. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +4 -0
  12. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +14 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +3 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native.ts +9 -1
  15. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +2 -1
  16. package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +2 -0
  17. package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +23 -5
  18. package/.pi/harnesses/agent-hub/docs-lane.js +2 -1
  19. package/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  20. package/.pi/harnesses/agent-hub/filesystem-tool.ts +75 -11
  21. package/.pi/harnesses/agent-hub/index.ts +246 -19
  22. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +13 -5
  23. package/.pi/harnesses/agent-hub/no-progress.ts +232 -28
  24. package/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  25. package/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  26. package/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  27. package/.pi/harnesses/agent-hub/package.json +1 -1
  28. package/.pi/harnesses/agent-hub/policy/work-mode.ts +14 -5
  29. package/.pi/harnesses/agent-hub/process-obligations.ts +116 -15
  30. package/.pi/harnesses/agent-hub/prompts/fragments.ts +9 -11
  31. package/.pi/harnesses/agent-hub/recover-policy.ts +18 -1
  32. package/.pi/harnesses/agent-hub/recover-state.ts +1 -1
  33. package/.pi/harnesses/agent-hub/recovery-contract.ts +70 -0
  34. package/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  35. package/.pi/harnesses/agent-hub/research/runtime.ts +2 -0
  36. package/.pi/harnesses/agent-hub/research/spawn-run.ts +15 -6
  37. package/.pi/harnesses/agent-hub/return-contract.js +27 -5
  38. package/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  39. package/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  40. package/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  41. package/.pi/harnesses/agent-hub/run-budget.js +12 -0
  42. package/.pi/harnesses/agent-hub/scope-gate.js +23 -2
  43. package/.pi/harnesses/agent-hub/session-audit.ts +94 -8
  44. package/.pi/harnesses/agent-hub/spawn.ts +10 -2
  45. package/.pi/harnesses/agent-hub/system1-activity.ts +116 -1
  46. package/.pi/harnesses/agent-hub/system1-communication-store.ts +47 -13
  47. package/.pi/harnesses/agent-hub/system1-report.ts +50 -0
  48. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -2
  49. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  50. package/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
  51. package/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
  52. package/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  53. package/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  54. package/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  55. package/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  56. package/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  57. package/.pi/harnesses/agent-hub/tools/action-executors.ts +33 -10
  58. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  59. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +86 -26
  60. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +9 -0
  61. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +9 -6
  62. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +6 -2
  63. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  64. package/.pi/harnesses/agent-hub/work-mode.ts +13 -8
  65. package/.pi/harnesses/coms/package.json +1 -1
  66. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  67. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +6 -1
  68. package/.pi/harnesses/lib/fleet-dashboard-view.ts +29 -4
  69. package/.pi/harnesses/lib/fleet-read-model.ts +73 -0
  70. package/.pi/harnesses/lib/system1/demo.ts +2 -4
  71. package/.pi/harnesses/lib/system1/selection.js +11 -0
  72. package/.pi/prompts/af-build.md +9 -6
  73. package/.versions/2.0.15/.pi/agent-fleet/hermes/README.md +347 -0
  74. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  75. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  76. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  77. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  78. package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  79. package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  80. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  81. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  82. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  83. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  84. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  85. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  86. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  87. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  88. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  89. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  90. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  91. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  92. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  93. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  94. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  95. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  96. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  97. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  98. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  99. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  100. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  101. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  102. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  103. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  104. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  105. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  106. package/.versions/2.0.15/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  107. package/.versions/2.0.15/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  108. package/.versions/2.0.15/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  109. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  110. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  111. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  112. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  113. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  114. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet.ts +217 -0
  115. package/.versions/2.0.15/.pi/agent-fleet/scripts/flow.ts +157 -0
  116. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  117. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  118. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  119. package/.versions/2.0.15/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  120. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  121. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  122. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  123. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  124. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  125. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  126. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  127. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  128. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  129. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  130. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  131. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  132. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  133. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  134. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  135. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  136. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  137. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  138. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  139. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  140. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  141. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  142. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  143. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  144. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  145. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  146. package/.versions/2.0.15/.pi/agent-fleet/scripts/package-lock.json +35 -0
  147. package/.versions/2.0.15/.pi/agent-fleet/scripts/package.json +9 -0
  148. package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  149. package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  150. package/.versions/2.0.15/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  151. package/.versions/2.0.15/.pi/agent-fleet/scripts/team-up.ts +378 -0
  152. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  153. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  154. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  155. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  156. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  157. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  158. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  159. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  160. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  161. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  162. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  163. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  164. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  165. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  166. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  167. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  168. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  169. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  170. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  171. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  172. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  173. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  174. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  175. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  176. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  177. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  178. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  179. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  180. package/.versions/2.0.15/.pi/agents/dispatch-policy.yaml +32 -0
  181. package/.versions/2.0.15/.pi/agents/model-profiles.yaml +134 -0
  182. package/.versions/2.0.15/.pi/agents/peers.yaml +147 -0
  183. package/.versions/2.0.15/.pi/agents/teams.yaml +41 -0
  184. package/.versions/2.0.15/.pi/agents/voices.yaml +13 -0
  185. package/.versions/2.0.15/.pi/damage-control-rules.yaml +297 -0
  186. package/.versions/2.0.15/.pi/extensions/btw/README.md +120 -0
  187. package/.versions/2.0.15/.pi/extensions/btw/index.ts +914 -0
  188. package/.versions/2.0.15/.pi/extensions/btw/package.json +6 -0
  189. package/.versions/2.0.15/.pi/extensions/btw/state.js +179 -0
  190. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  191. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  192. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  193. package/.versions/2.0.15/.pi/extensions/compact-and-continue/README.md +42 -0
  194. package/.versions/2.0.15/.pi/extensions/compact-and-continue/index.ts +120 -0
  195. package/.versions/2.0.15/.pi/extensions/compact-and-continue/package.json +6 -0
  196. package/.versions/2.0.15/.pi/extensions/mcp-bridge/README.md +46 -0
  197. package/.versions/2.0.15/.pi/extensions/mcp-bridge/index.ts +206 -0
  198. package/.versions/2.0.15/.pi/extensions/mcp-bridge/package.json +6 -0
  199. package/.versions/2.0.15/.pi/extensions/package-lock.json +1175 -0
  200. package/.versions/2.0.15/.pi/extensions/package.json +9 -0
  201. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/README.md +224 -0
  202. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/config.ts +198 -0
  203. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  204. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/index.ts +248 -0
  205. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/package.json +6 -0
  206. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  207. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  208. package/.versions/2.0.15/.pi/harnesses/agent-hub/README.md +1448 -0
  209. package/.versions/2.0.15/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  210. package/.versions/2.0.15/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  211. package/.versions/2.0.15/.pi/harnesses/agent-hub/artifacts.js +146 -0
  212. package/.versions/2.0.15/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  213. package/.versions/2.0.15/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  214. package/.versions/2.0.15/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  215. package/.versions/2.0.15/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  216. package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  217. package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  218. package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  219. package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  220. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  221. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  222. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  223. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  224. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  225. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  226. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  227. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  228. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  229. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  230. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  231. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  232. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  233. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  234. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  235. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  236. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  237. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  238. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  239. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  240. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  241. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  242. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  243. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  244. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  245. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  246. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  247. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  248. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  249. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  250. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  251. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  252. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  253. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  254. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  255. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  256. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  257. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  258. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  259. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-window.js +108 -0
  260. package/.versions/2.0.15/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  261. package/.versions/2.0.15/.pi/harnesses/agent-hub/delegate.ts +467 -0
  262. package/.versions/2.0.15/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
  263. package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  264. package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  265. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  266. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  267. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  268. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
  269. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  270. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
  271. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  272. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  273. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  274. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +76 -0
  275. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  276. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  277. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  278. package/.versions/2.0.15/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  279. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  280. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  281. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  282. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  283. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  284. package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  285. package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  286. package/.versions/2.0.15/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  287. package/.versions/2.0.15/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  288. package/.versions/2.0.15/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
  289. package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/registration-surface.json +64 -0
  290. package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  291. package/.versions/2.0.15/.pi/harnesses/agent-hub/footer.ts +30 -0
  292. package/.versions/2.0.15/.pi/harnesses/agent-hub/helpers.ts +270 -0
  293. package/.versions/2.0.15/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  294. package/.versions/2.0.15/.pi/harnesses/agent-hub/index.ts +2597 -0
  295. package/.versions/2.0.15/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  296. package/.versions/2.0.15/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  297. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  298. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  299. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  300. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  301. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  302. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  303. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  304. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  305. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  306. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  307. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  308. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  309. package/.versions/2.0.15/.pi/harnesses/agent-hub/no-progress.ts +563 -0
  310. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  311. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  312. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  313. package/.versions/2.0.15/.pi/harnesses/agent-hub/package.json +7 -0
  314. package/.versions/2.0.15/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  315. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  316. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  317. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  318. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  319. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/work-mode.ts +135 -0
  320. package/.versions/2.0.15/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  321. package/.versions/2.0.15/.pi/harnesses/agent-hub/presentation.ts +48 -0
  322. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  323. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  324. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  325. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  326. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  327. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  328. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  329. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  330. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  331. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  332. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  333. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  334. package/.versions/2.0.15/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  335. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  336. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/fragments.ts +116 -0
  337. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  338. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  339. package/.versions/2.0.15/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  340. package/.versions/2.0.15/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  341. package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  342. package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  343. package/.versions/2.0.15/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  344. package/.versions/2.0.15/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  345. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  346. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
  347. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
  348. package/.versions/2.0.15/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  349. package/.versions/2.0.15/.pi/harnesses/agent-hub/return-contract.js +349 -0
  350. package/.versions/2.0.15/.pi/harnesses/agent-hub/return-extract.js +77 -0
  351. package/.versions/2.0.15/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  352. package/.versions/2.0.15/.pi/harnesses/agent-hub/review-findings.js +104 -0
  353. package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  354. package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  355. package/.versions/2.0.15/.pi/harnesses/agent-hub/run-budget.js +554 -0
  356. package/.versions/2.0.15/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  357. package/.versions/2.0.15/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  358. package/.versions/2.0.15/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  359. package/.versions/2.0.15/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  360. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  361. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-health.js +110 -0
  362. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-start.ts +42 -0
  363. package/.versions/2.0.15/.pi/harnesses/agent-hub/spawn.ts +534 -0
  364. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  365. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-communication-store.ts +129 -0
  366. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  367. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-runtime.ts +280 -0
  368. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  369. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  370. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
  371. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
  372. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  373. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-closure.user-run.mjs +336 -0
  374. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  375. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  376. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  377. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  378. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  379. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs +157 -0
  380. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  381. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  382. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  383. package/.versions/2.0.15/.pi/harnesses/agent-hub/timeline.ts +72 -0
  384. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  385. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  386. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  387. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
  388. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  389. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  390. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  391. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
  392. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  393. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  394. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  395. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  396. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  397. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  398. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  399. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  400. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  401. package/.versions/2.0.15/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  402. package/.versions/2.0.15/.pi/harnesses/agent-hub/types.ts +66 -0
  403. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  404. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  405. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  406. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  407. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  408. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  409. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  410. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  411. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  412. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  413. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  414. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  415. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  416. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  417. package/.versions/2.0.15/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  418. package/.versions/2.0.15/.pi/harnesses/agent-hub/version.ts +42 -0
  419. package/.versions/2.0.15/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  420. package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  421. package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode.ts +179 -0
  422. package/.versions/2.0.15/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  423. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/README.md +59 -0
  424. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/index.ts +558 -0
  425. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  426. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  427. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  428. package/.versions/2.0.15/.pi/harnesses/coms/README.md +100 -0
  429. package/.versions/2.0.15/.pi/harnesses/coms/index.ts +282 -0
  430. package/.versions/2.0.15/.pi/harnesses/coms/package.json +7 -0
  431. package/.versions/2.0.15/.pi/harnesses/coms/version.ts +42 -0
  432. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/README.md +135 -0
  433. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/index.ts +550 -0
  434. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/package.json +7 -0
  435. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/version.ts +42 -0
  436. package/.versions/2.0.15/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  437. package/.versions/2.0.15/.pi/harnesses/lib/coms-core-io.ts +385 -0
  438. package/.versions/2.0.15/.pi/harnesses/lib/coms-core.ts +577 -0
  439. package/.versions/2.0.15/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  440. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  441. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  442. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-view.ts +107 -0
  443. package/.versions/2.0.15/.pi/harnesses/lib/context-budget.ts +114 -0
  444. package/.versions/2.0.15/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  445. package/.versions/2.0.15/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  446. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  447. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  448. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  449. package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  450. package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  451. package/.versions/2.0.15/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  452. package/.versions/2.0.15/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  453. package/.versions/2.0.15/.pi/harnesses/lib/fleet-panel.ts +34 -0
  454. package/.versions/2.0.15/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  455. package/.versions/2.0.15/.pi/harnesses/lib/fleet-selection.ts +24 -0
  456. package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  457. package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  458. package/.versions/2.0.15/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  459. package/.versions/2.0.15/.pi/harnesses/lib/herdr-client.ts +472 -0
  460. package/.versions/2.0.15/.pi/harnesses/lib/herdr-presence.ts +399 -0
  461. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  462. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  463. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  464. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  465. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  466. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  467. package/.versions/2.0.15/.pi/harnesses/lib/spawned-peers.js +191 -0
  468. package/.versions/2.0.15/.pi/harnesses/lib/system1/config.js +61 -0
  469. package/.versions/2.0.15/.pi/harnesses/lib/system1/contracts.ts +152 -0
  470. package/.versions/2.0.15/.pi/harnesses/lib/system1/demo.ts +104 -0
  471. package/.versions/2.0.15/.pi/harnesses/lib/system1/jev.ts +503 -0
  472. package/.versions/2.0.15/.pi/harnesses/lib/system1/selection.js +11 -0
  473. package/.versions/2.0.15/.pi/harnesses/lib/system1/service.ts +245 -0
  474. package/.versions/2.0.15/.pi/harnesses/lib/update-check.ts +222 -0
  475. package/.versions/2.0.15/.pi/harnesses/package-lock.json +2039 -0
  476. package/.versions/2.0.15/.pi/harnesses/package.json +10 -0
  477. package/.versions/2.0.15/.pi/prompts/af-build.md +27 -0
  478. package/.versions/2.0.15/.pi/prompts/af-code-simplify.md +22 -0
  479. package/.versions/2.0.15/.pi/prompts/af-constraints.md +31 -0
  480. package/.versions/2.0.15/.pi/prompts/af-plan.md +17 -0
  481. package/.versions/2.0.15/.pi/prompts/af-review.md +16 -0
  482. package/.versions/2.0.15/.pi/prompts/af-set-hermes-telegram.md +15 -0
  483. package/.versions/2.0.15/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  484. package/.versions/2.0.15/.pi/prompts/af-setup-rules.md +20 -0
  485. package/.versions/2.0.15/.pi/prompts/af-ship.md +17 -0
  486. package/.versions/2.0.15/.pi/prompts/af-spec.md +15 -0
  487. package/.versions/2.0.15/.pi/prompts/af-test.md +19 -0
  488. package/.versions/2.0.15/.pi/skills/bowser/SKILL.md +145 -0
  489. package/.versions/2.0.15/.version +1 -0
  490. package/.versions/2.0.15/agents/architect.md +24 -0
  491. package/.versions/2.0.15/agents/bowser.md +28 -0
  492. package/.versions/2.0.15/agents/builder.md +55 -0
  493. package/.versions/2.0.15/agents/code-reviewer.md +209 -0
  494. package/.versions/2.0.15/agents/deep-researcher.md +32 -0
  495. package/.versions/2.0.15/agents/documenter.md +22 -0
  496. package/.versions/2.0.15/agents/orchestrator.md +22 -0
  497. package/.versions/2.0.15/agents/plan-reviewer.md +83 -0
  498. package/.versions/2.0.15/agents/planner.md +105 -0
  499. package/.versions/2.0.15/agents/releaser.md +24 -0
  500. package/.versions/2.0.15/agents/researcher.md +30 -0
  501. package/.versions/2.0.15/agents/security-auditor.md +167 -0
  502. package/.versions/2.0.15/agents/test-engineer.md +153 -0
  503. package/.versions/2.0.15/agents/web-debugger.md +44 -0
  504. package/.versions/2.0.15/agents/web-performance-auditor.md +194 -0
  505. package/.versions/2.0.15/bin/catalog/harness-runtime-closure.json +73 -0
  506. package/.versions/2.0.15/codex/fleet-session-client/SKILL.md +34 -0
  507. package/.versions/2.0.15/codex/fleet-session-client.zip +0 -0
  508. package/.versions/2.0.15/docs/ARCHITECTURE.md +829 -0
  509. package/.versions/2.0.15/docs/agent-fleet-setup.md +1090 -0
  510. package/.versions/2.0.15/docs/claude-code-coms-bridge.md +134 -0
  511. package/.versions/2.0.15/docs/codex-session-bridge.md +219 -0
  512. package/.versions/2.0.15/docs/coms-hermes-bridge.md +188 -0
  513. package/.versions/2.0.15/docs/getting-started.md +126 -0
  514. package/.versions/2.0.15/docs/npm-install.md +525 -0
  515. package/.versions/2.0.15/docs/pi-extensions.md +454 -0
  516. package/.versions/2.0.15/docs/pi-setup.md +92 -0
  517. package/.versions/2.0.15/docs/skill-anatomy.md +150 -0
  518. package/.versions/2.0.15/install-manifest.json +3193 -0
  519. package/.versions/2.0.15/justfile +247 -0
  520. package/.versions/2.0.15/manifest-meta.json +1071 -0
  521. package/.versions/2.0.15/references/accessibility-checklist.md +160 -0
  522. package/.versions/2.0.15/references/communication-contract.md +26 -0
  523. package/.versions/2.0.15/references/definition-of-done.md +67 -0
  524. package/.versions/2.0.15/references/fleet-coordination-patterns.md +171 -0
  525. package/.versions/2.0.15/references/observability-checklist.md +92 -0
  526. package/.versions/2.0.15/references/orchestration-patterns.md +370 -0
  527. package/.versions/2.0.15/references/performance-checklist.md +236 -0
  528. package/.versions/2.0.15/references/prompting-patterns.md +380 -0
  529. package/.versions/2.0.15/references/security-checklist.md +245 -0
  530. package/.versions/2.0.15/references/testing-patterns.md +235 -0
  531. package/.versions/2.0.15/references/workflow-authoring.md +304 -0
  532. package/.versions/2.0.15/skills/_internal/grilling.md +59 -0
  533. package/.versions/2.0.15/skills/browser-testing-with-devtools/SKILL.md +351 -0
  534. package/.versions/2.0.15/skills/code-review-and-quality/SKILL.md +396 -0
  535. package/.versions/2.0.15/skills/compound-learning/SKILL.md +137 -0
  536. package/.versions/2.0.15/skills/constraint-driven-development/SKILL.md +338 -0
  537. package/.versions/2.0.15/skills/constraint-driven-development/references/floor-guard.md +99 -0
  538. package/.versions/2.0.15/skills/context-engineering/SKILL.md +341 -0
  539. package/.versions/2.0.15/skills/deprecation-and-migration/SKILL.md +247 -0
  540. package/.versions/2.0.15/skills/designing-agents/SKILL.md +394 -0
  541. package/.versions/2.0.15/skills/designing-agents/pi-harness-authoring.md +222 -0
  542. package/.versions/2.0.15/skills/drafting-workflows/SKILL.md +143 -0
  543. package/.versions/2.0.15/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  544. package/.versions/2.0.15/skills/frontend-ui-engineering/SKILL.md +328 -0
  545. package/.versions/2.0.15/skills/git-workflow-and-versioning/SKILL.md +316 -0
  546. package/.versions/2.0.15/skills/idea-refine/SKILL.md +182 -0
  547. package/.versions/2.0.15/skills/idea-refine/examples.md +238 -0
  548. package/.versions/2.0.15/skills/idea-refine/frameworks.md +99 -0
  549. package/.versions/2.0.15/skills/idea-refine/refinement-criteria.md +113 -0
  550. package/.versions/2.0.15/skills/idea-refine/scripts/idea-refine.sh +15 -0
  551. package/.versions/2.0.15/skills/incremental-implementation/SKILL.md +353 -0
  552. package/.versions/2.0.15/skills/interview-me/SKILL.md +226 -0
  553. package/.versions/2.0.15/skills/orchestration-verification/SKILL.md +182 -0
  554. package/.versions/2.0.15/skills/peer-coms/SKILL.md +90 -0
  555. package/.versions/2.0.15/skills/performance-optimization/SKILL.md +496 -0
  556. package/.versions/2.0.15/skills/planning-and-task-breakdown/SKILL.md +318 -0
  557. package/.versions/2.0.15/skills/repository-ai-setup/SKILL.md +117 -0
  558. package/.versions/2.0.15/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  559. package/.versions/2.0.15/skills/repository-ai-setup/references/apply-contract.md +74 -0
  560. package/.versions/2.0.15/skills/repository-ai-setup/references/provenance-template.md +16 -0
  561. package/.versions/2.0.15/skills/repository-ai-setup/references/setup-flow.md +108 -0
  562. package/.versions/2.0.15/skills/repository-ai-setup/references/verify-setup.md +20 -0
  563. package/.versions/2.0.15/skills/security-and-hardening/SKILL.md +524 -0
  564. package/.versions/2.0.15/skills/spec-driven-development/SKILL.md +295 -0
  565. package/.versions/2.0.15/skills/using-agent-skills/SKILL.md +198 -0
  566. package/.versions/2.0.15/vendor/agent-skills-upstream/LICENSE +21 -0
  567. package/.versions/2.0.15/vendor/agent-skills-upstream/README.md +430 -0
  568. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  569. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  570. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  571. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  572. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  573. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  574. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  575. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  576. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  577. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  578. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  579. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  580. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  581. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  582. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  583. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  584. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  585. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  586. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  587. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  588. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  589. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  590. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  591. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  592. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  593. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  594. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  595. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  596. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  597. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  598. package/CHANGELOG.md +6 -0
  599. package/README.md +1 -1
  600. package/agents/builder.md +2 -2
  601. package/bin/cli.js +16 -2
  602. package/bin/lib/apply.js +5 -0
  603. package/bin/lib/doctor.js +85 -12
  604. package/bin/lib/reconcile.js +9 -1
  605. package/bin/lib/state.js +1 -0
  606. package/bin/lib/task-triage-setup.js +76 -0
  607. package/bin/lib/transaction.js +4 -0
  608. package/docs/ARCHITECTURE.md +99 -24
  609. package/docs/agent-fleet-setup.md +179 -6
  610. package/docs/npm-install.md +64 -15
  611. package/docs/pi-extensions.md +1 -1
  612. package/install-manifest.json +13 -3
  613. package/manifest-meta.json +6 -0
  614. package/package.json +9 -2
  615. package/skills/incremental-implementation/SKILL.md +64 -13
  616. package/skills/planning-and-task-breakdown/SKILL.md +43 -14
  617. package/skills/using-agent-skills/SKILL.md +2 -2
@@ -0,0 +1,76 @@
1
+ export type ScopeBreadth = "narrow" | "cross-cutting" | "wide";
2
+ export type RouteRisk = "low" | "high" | "secret" | "cloud";
3
+
4
+ export interface RouteInputs {
5
+ scopeBreadth: ScopeBreadth;
6
+ risk: RouteRisk;
7
+ reversible: boolean;
8
+ approvedPlan: boolean;
9
+ unresolvedForks: string[];
10
+ selfDeclaredSmall?: boolean;
11
+ }
12
+
13
+ export interface RouteDecision {
14
+ route: "builder-reviewer" | "planner-required";
15
+ reason: string;
16
+ reclassified: boolean;
17
+ record: {
18
+ scopeBreadth: ScopeBreadth;
19
+ risk: RouteRisk;
20
+ reversible: boolean;
21
+ approvedPlan: boolean;
22
+ unresolvedForks: string[];
23
+ };
24
+ }
25
+
26
+ function recordOf(input: RouteInputs): RouteDecision["record"] {
27
+ return {
28
+ scopeBreadth: input.scopeBreadth,
29
+ risk: input.risk,
30
+ reversible: input.reversible,
31
+ approvedPlan: input.approvedPlan,
32
+ unresolvedForks: [...input.unresolvedForks],
33
+ };
34
+ }
35
+
36
+ export function selectSpecialists(input: RouteInputs, signals: { secret?: boolean; cloud?: boolean; contradiction?: boolean } = {}) {
37
+ if ((signals.secret || signals.cloud) && input.risk === "low") {
38
+ return { stages: ["planner", "builder", "reviewer"] as const, reason: "risk was not lowered to bypass a secret or cloud signal" };
39
+ }
40
+ const decision = classifyOrchestrationRoute(input);
41
+ if (signals.contradiction || decision.route === "planner-required") {
42
+ return { stages: ["planner", "builder", "reviewer"] as const, reason: signals.contradiction ? "contradiction requires a planner" : decision.reason };
43
+ }
44
+ return { stages: ["builder", "reviewer"] as const, reason: decision.reason };
45
+ }
46
+
47
+ export function authorizePlanStatusUpdate(input: { planPath: string; allowedScope: string[]; evidenceRefs: string[] }): { allowed: boolean; reason: string } {
48
+ const path = input.planPath.replace(/\\/g, "/");
49
+ const inScope = input.allowedScope.some(root => path === root || path.startsWith(`${root.replace(/\\/g, "/")}/`));
50
+ if (!inScope) return { allowed: false, reason: "plan file is outside the permitted scope" };
51
+ if (!input.evidenceRefs.some(ref => ref.trim())) return { allowed: false, reason: "plan status requires evidence" };
52
+ return { allowed: true, reason: "builder may update plan status" };
53
+ }
54
+
55
+ export function classifyOrchestrationRoute(input: RouteInputs, previous?: RouteDecision): RouteDecision {
56
+ const record = recordOf(input);
57
+ const blockers: string[] = [];
58
+ if (input.scopeBreadth !== "narrow") blockers.push(`scope is ${input.scopeBreadth}`);
59
+ if (input.risk !== "low") blockers.push(`risk is ${input.risk}`);
60
+ if (!input.reversible) blockers.push("change is not reversible");
61
+ if (!input.approvedPlan) blockers.push("approved plan is missing");
62
+ if (input.unresolvedForks.length) blockers.push(`unresolved forks: ${input.unresolvedForks.join(", ")}`);
63
+ const changes = previous
64
+ ? (["scopeBreadth", "risk", "reversible", "approvedPlan"] as const).flatMap(key => previous.record[key] === record[key] ? [] : [`${key} ${String(previous.record[key])} → ${String(record[key])}`])
65
+ : [];
66
+ const forkChange = previous && JSON.stringify(previous.record.unresolvedForks) !== JSON.stringify(record.unresolvedForks)
67
+ ? `unresolvedForks ${previous.record.unresolvedForks.join(", ") || "(none)"} → ${record.unresolvedForks.join(", ") || "(none)"}`
68
+ : "";
69
+ const reclassified = changes.length > 0 || !!forkChange;
70
+ const reason = [
71
+ blockers.length ? `planner required: ${blockers.join("; ")}` : "narrow reversible approved plan with no unresolved forks",
72
+ input.selfDeclaredSmall ? "self-declared small was ignored" : "",
73
+ reclassified ? `reclassified because ${[...changes, forkChange].filter(Boolean).join("; ")}` : "",
74
+ ].filter(Boolean).join(". ");
75
+ return { route: blockers.length ? "planner-required" : "builder-reviewer", reason, reclassified, record };
76
+ }
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "2.0.14"
6
+ "version": "2.0.15"
7
7
  }
@@ -18,6 +18,7 @@ export interface WorkModePolicyPorts {
18
18
  getHerdrReady(): boolean;
19
19
  getAskUserAvailable(): boolean;
20
20
  getDeterministicToolsEnabled?(): boolean;
21
+ getDispatchTriageEnabled?(): boolean;
21
22
  getIdentityLabel(): string | null;
22
23
  getTaskTier(): string | null;
23
24
  getPendingOperations(): PendingOperation[];
@@ -38,6 +39,8 @@ export interface WorkModePolicy {
38
39
  restoreCapabilities(state: PersistedCapabilityRestore): void;
39
40
  resetCapabilities(): void;
40
41
  resolveIncomingCapabilities(userText: string, newTask?: boolean): void;
42
+ /** Recompute state/lease changes without losing the current input's transient compaction intent. */
43
+ refreshCapabilities(): void;
41
44
  provisionalCapabilityRefusal(pack: ConfirmableCapabilityPack): { content: { type: "text"; text: string }[]; details: { status: string; confirmation: string; pack: ConfirmableCapabilityPack } } | null;
42
45
  applyWorkModeTools(): void;
43
46
  updateStatus(ctx: WorkModeUiPort): void;
@@ -57,9 +60,10 @@ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMo
57
60
  let taskPacks: CapabilityPack[] = [];
58
61
  let provisionalPacks: CapabilityPack[] = [];
59
62
  let confirmation: CapabilityConfirmationState = {};
63
+ let currentExplicitCompaction = false;
60
64
  let resolution = resolveCapabilityPacks({ workMode, userText: "", taskPacks: [], comsReady: false, herdrReady: false, pendingOperations: [], contextState: "normal" });
61
65
 
62
- function resolveIncomingCapabilities(userText: string, newTask = false): void {
66
+ function resolveIncomingCapabilities(userText: string, newTask = false, refresh = false): void {
63
67
  resolution = resolveCapabilityPacks({
64
68
  workMode, userText,
65
69
  taskTier: (["trivial", "small", "feature", "project"] as const).find(tier => tier === ports.getTaskTier()),
@@ -67,6 +71,11 @@ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMo
67
71
  comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(),
68
72
  pendingOperations: ports.getPendingOperations(), contextState: ports.getContextState(), newTask,
69
73
  });
74
+ if (refresh && currentExplicitCompaction && !newTask) {
75
+ resolution.active = CAPABILITY_PACKS.filter(pack => pack === "compaction" || resolution.active.includes(pack));
76
+ resolution.reasons.compaction = "explicit-compaction";
77
+ }
78
+ currentExplicitCompaction = resolution.active.includes("compaction") && resolution.reasons.compaction === "explicit-compaction";
70
79
  for (const pack of ["fleet", "peer", "workspace"] as const) {
71
80
  if (confirmation[pack] === "promoted" || confirmation[pack] === "declined") {
72
81
  resolution.provisional = resolution.provisional.filter(candidate => candidate !== pack);
@@ -80,7 +89,7 @@ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMo
80
89
  }
81
90
  function applyWorkModeTools(fromMode: WorkMode = workMode, reason: "refresh" | "mode_switch" = "refresh"): void {
82
91
  const previous = [...(ports.getActiveTools?.() ?? [])];
83
- const requested = resolveWorkModeTools({ workMode, baselineTools: ports.getBaselineTools(), comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(), askUserAvailable: ports.getAskUserAvailable(), deterministicTools: ports.getDeterministicToolsEnabled?.() === true, capabilityPacks: [...resolution.active, ...resolution.provisional] });
92
+ const requested = resolveWorkModeTools({ workMode, baselineTools: ports.getBaselineTools(), comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(), askUserAvailable: ports.getAskUserAvailable(), deterministicTools: ports.getDeterministicToolsEnabled?.() === true, triageEnabled: ports.getDispatchTriageEnabled?.() === true, capabilityPacks: [...resolution.active, ...resolution.provisional] });
84
93
  ports.setActiveTools(requested);
85
94
  ports.recordToolCatalog?.({ fromMode, toMode: workMode, previous, next: [...(ports.getActiveTools?.() ?? requested)], reason });
86
95
  }
@@ -114,9 +123,9 @@ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMo
114
123
  getWorkMode: () => workMode, setRestoredWorkMode: mode => { workMode = mode; },
115
124
  getCapabilityResolution: () => resolution, getCapabilityConfirmation: () => confirmation,
116
125
  setCapabilityConfirmation: (pack, status) => { if (status) confirmation[pack] = status; else delete confirmation[pack]; },
117
- restoreCapabilities: state => { taskPacks = [...state.taskPacks]; provisionalPacks = [...state.provisional]; confirmation = { ...state.confirmation }; },
118
- resetCapabilities: () => { taskPacks = []; provisionalPacks = []; confirmation = {}; },
119
- resolveIncomingCapabilities,
126
+ restoreCapabilities: state => { taskPacks = [...state.taskPacks]; provisionalPacks = [...state.provisional]; confirmation = { ...state.confirmation }; currentExplicitCompaction = false; },
127
+ resetCapabilities: () => { taskPacks = []; provisionalPacks = []; confirmation = {}; currentExplicitCompaction = false; },
128
+ resolveIncomingCapabilities, refreshCapabilities: () => resolveIncomingCapabilities("", false, true),
120
129
  provisionalCapabilityRefusal: pack => { const gate = confirmationGate(confirmation, pack, resolution.provisional.includes(pack)); return gate.allowed ? null : { content: [{ type: "text", text: gate.message }], details: { status: "provisional_confirmation_required", confirmation: gate.status, pack } }; },
121
130
  applyWorkModeTools, updateStatus: ctx => ctx.ui.setStatus("hub-work-mode", `Work Mode: ${workMode}`), statusText,
122
131
  modelWorkBlockedByRosterRecovery: ctx => { if (workMode !== "orchestrator" || !rosterRecoveryRequired) return false; const message = `${rosterRecoveryDiagnostic || "No valid native roster is active."} Select one with /af-agents-team, restart with --agent-team <name>, or switch explicitly with /af-work-mode operator.`; ctx.ui.notify(message, "error"); if (!ctx.hasUI) console.error(`[agent-hub] ${message}`); return true; },
@@ -1,19 +1,24 @@
1
+ import { consumeActionGrant, type ActionContract, type ActionGrant } from "./task-triage-authorization.ts";
2
+
1
3
  export const PROCESS_OBLIGATIONS_SCHEMA = "agent-fleet.process-obligations/v1" as const;
2
4
  export type TaskRisk = "unknown" | "low" | "high";
3
5
  export type TaskScope = "unknown" | "read-only" | "small" | "wide";
4
- export type ObligationStatus = "satisfied" | "open" | "unsupported";
5
- export type ProcessStage = "classify-risk" | "plan" | "execute" | "acceptance" | "review" | "complete";
6
+ export type ObligationStatus = "satisfied" | "open" | "unsupported" | "waived";
7
+ export type ProcessStage = "classify-risk" | "plan" | "execute" | "acceptance" | "review" | "confirm-action" | "complete";
6
8
 
7
9
  export interface ProcessStageState { required: boolean; evidenceRef: string | null; revision: string | null; }
10
+ export interface ProcessAddition { id: string; source: "system1"; taskId: string; evaluationId: string; inputRevision: string; policyVersion: string; questionVersion: string; provider: string; model: string; reason: "security_change" | "wide_change" | "irreversible_execution"; status: "active" | "waived"; waiverReason: string | null; }
8
11
  export interface ProcessObligationState {
9
12
  schema: typeof PROCESS_OBLIGATIONS_SCHEMA; risk: TaskRisk; scope: TaskScope;
10
13
  acceptance: ProcessStageState; review: ProcessStageState; plan: ProcessStageState;
11
14
  reassessments: number; lastReason: string | null; appliedRuleIds: string[]; changedFiles: string[];
15
+ additions?: ProcessAddition[];
12
16
  }
13
17
  export interface ProcessClassificationInput { risk?: string; scope?: string; reason?: string; newTask?: boolean; }
14
18
  export interface ProcessVerdict {
15
19
  accepted: boolean; path: "read-only" | "changed-task"; risk: TaskRisk; scope: TaskScope; budgetTier: string;
16
- obligations: Record<"risk" | "acceptance" | "review" | "plan", { status: ObligationStatus; evidenceRef?: string }>;
20
+ obligations: Record<"risk" | "acceptance" | "review" | "plan", { status: ObligationStatus; evidenceRef?: string }> & { confirmation?: { status: ObligationStatus } };
21
+ additions: Pick<ProcessAddition, "id" | "taskId" | "evaluationId" | "inputRevision" | "reason" | "status">[];
17
22
  appliedRuleIds: string[]; currentStage: ProcessStage; admissibleNextAction: string; auditScope: string[]; explanation: string;
18
23
  }
19
24
  const RISKS = new Set<TaskRisk>(["unknown", "low", "high"]), SCOPES = new Set<TaskScope>(["unknown", "read-only", "small", "wide"]);
@@ -24,7 +29,13 @@ export function createProcessState(): ProcessObligationState { return { schema:
24
29
  export function normalizeProcessState(value: unknown): ProcessObligationState {
25
30
  const row = value && typeof value === "object" ? value as any : {}, state = createProcessState();
26
31
  if (RISKS.has(row.risk)) state.risk = row.risk; if (SCOPES.has(row.scope)) state.scope = row.scope;
27
- for (const key of ["acceptance", "review", "plan"] as const) { const stage = row[key] && typeof row[key] === "object" ? row[key] : {}; state[key] = { required: stage.required === true, evidenceRef: typeof stage.evidenceRef === "string" && stage.evidenceRef ? stage.evidenceRef : null, revision: typeof stage.revision === "string" && stage.revision ? stage.revision : null }; }
32
+ for (const key of ["acceptance", "review", "plan"] as const) { const stage = row[key] && typeof row[key] === "object" ? row[key] : {}; state[key] = { required: key === "acceptance" || stage.required === true || key === "review" && (state.risk === "high" || state.scope === "wide") || key === "plan" && state.scope === "wide", evidenceRef: typeof stage.evidenceRef === "string" && stage.evidenceRef ? stage.evidenceRef : null, revision: typeof stage.revision === "string" && stage.revision ? stage.revision : null }; }
33
+ // Legacy required stages remain independent of S1 and cannot be waived.
34
+ if (Array.isArray(row.additions) && (row.additions.length > 300 || Buffer.byteLength(JSON.stringify(row.additions)) > 64 * 1024)) throw new Error("Process additions exceed the persistence limit; dependent effects are blocked.");
35
+ state.additions = Array.isArray(row.additions) ? row.additions.map((a: any) => {
36
+ if (!a || a.source !== "system1" || typeof a.id !== "string" || !a.id || !["taskId", "evaluationId", "inputRevision", "policyVersion", "questionVersion", "provider", "model"].every(k => typeof a[k] === "string" && a[k]) || !["security_change", "wide_change", "irreversible_execution"].includes(a.reason) || !["active", "waived"].includes(a.status) || a.status === "waived" && (typeof a.waiverReason !== "string" || !a.waiverReason)) throw new Error("Invalid process addition; dependent effects are blocked.");
37
+ return { id: a.id, source: "system1" as const, taskId: a.taskId, evaluationId: a.evaluationId, inputRevision: a.inputRevision, policyVersion: a.policyVersion, questionVersion: a.questionVersion, provider: a.provider, model: a.model, reason: a.reason, status: a.status, waiverReason: a.status === "waived" ? a.waiverReason : null };
38
+ }) : [];
28
39
  state.reassessments = Number.isSafeInteger(row.reassessments) && row.reassessments >= 0 ? row.reassessments : 0; state.lastReason = cleanReason(row.lastReason);
29
40
  state.appliedRuleIds = strings(row.appliedRuleIds); state.changedFiles = strings(row.changedFiles); return state;
30
41
  }
@@ -38,20 +49,110 @@ export function applyProcessClassification(current: ProcessObligationState, inpu
38
49
  const next = normalizeProcessState(base); next.risk = risk; next.scope = scope; next.lastReason = reason ?? next.lastReason; next.appliedRuleIds = rules(risk, scope);
39
50
  if (riskWasExplicit && (riskChanged || scopeExpanded || !!reason) || scopeExpanded) next.reassessments++;
40
51
  if (risk === "high" || scope === "wide") next.review.required = true; if (scope === "wide") next.plan.required = true;
41
- if (scopeExpanded) { next.acceptance = { required: true, evidenceRef: null, revision: null }; if (next.review.required) next.review = { required: true, evidenceRef: null, revision: null }; if (next.plan.required) next.plan = { required: true, evidenceRef: null, revision: null }; }
52
+ if (scopeExpanded) { next.acceptance = { required: true, evidenceRef: null, revision: null }; if (effectiveProcessStage(next, "review")) next.review = { ...next.review, evidenceRef: null, revision: null }; if (effectiveProcessStage(next, "plan")) next.plan = { ...next.plan, evidenceRef: null, revision: null }; }
42
53
  return { ok: true, state: next, message: `Process classified: risk ${next.risk}, scope ${next.scope}.` };
43
54
  }
44
- export function noteProcessStage(state: ProcessObligationState, stage: "acceptance" | "plan" | "review", evidence: { evidenceRef: string; revision: string; changedFiles?: string[] }): ProcessObligationState { const next = normalizeProcessState(state); if (next[stage].required && evidence.evidenceRef && evidence.revision) next[stage] = { required: true, evidenceRef: evidence.evidenceRef, revision: evidence.revision }; if (stage === "acceptance" && evidence.changedFiles) next.changedFiles = strings(evidence.changedFiles); return next; }
45
- export function processOpenObligations(state: ProcessObligationState, revision?: string): string[] { const s = normalizeProcessState(state); return [s.risk === "unknown" ? "risk" : "", s.plan.required && !s.plan.evidenceRef ? "plan" : "", s.acceptance.required && (!s.acceptance.evidenceRef || revision && s.acceptance.revision !== revision) ? "acceptance" : "", s.review.required && (!s.review.evidenceRef || revision && s.review.revision !== revision) ? "review" : ""].filter(Boolean); }
46
- export function processPreEffectGate(state: ProcessObligationState, effect: "write" | "child" | "prove", persona = "", revision?: string): { reason: string; message: string } | null { const s = normalizeProcessState(state); if ((effect === "write" || effect === "child") && s.plan.required && !s.plan.evidenceRef && persona !== "planner") return { reason: "process_plan_open", message: "Process gate refused the dependent effect: the wide-task plan obligation is open. Run the planner first." }; if (effect === "prove") { const open = processOpenObligations(s, revision).filter(x => x !== "acceptance"); if (open.length) return { reason: "process_obligations_open", message: `Assertion cannot become proven while process obligations are open: ${open.join(", ")}.` }; } return null; }
55
+ export function effectiveProcessStage(state: ProcessObligationState, stage: "plan" | "review" | "confirmation"): boolean { const s = normalizeProcessState(state); return (stage !== "confirmation" && s[stage].required) || !!s.additions?.some(a => a.status === "active" && (stage === "confirmation" ? a.reason === "irreversible_execution" : stage === "plan" ? a.reason === "wide_change" : a.reason === "wide_change" || a.reason === "security_change")); }
56
+ export function noteProcessStage(state: ProcessObligationState, stage: "acceptance" | "plan" | "review", evidence: { evidenceRef: string; revision: string; changedFiles?: string[] }): ProcessObligationState { const next = normalizeProcessState(state); if ((stage === "acceptance" || effectiveProcessStage(next, stage)) && evidence.evidenceRef && evidence.revision) next[stage] = { ...next[stage], evidenceRef: evidence.evidenceRef, revision: evidence.revision }; if (stage === "acceptance" && evidence.changedFiles) next.changedFiles = strings(evidence.changedFiles); return next; }
57
+ export function processOpenObligations(state: ProcessObligationState, revision?: string): string[] { const s = normalizeProcessState(state); return [s.risk === "unknown" ? "risk" : "", effectiveProcessStage(s, "plan") && !s.plan.evidenceRef ? "plan" : "", s.acceptance.required && (!s.acceptance.evidenceRef || revision && s.acceptance.revision !== revision) ? "acceptance" : "", effectiveProcessStage(s, "review") && (!s.review.evidenceRef || revision && s.review.revision !== revision) ? "review" : "", effectiveProcessStage(s, "confirmation") ? "action_confirmation" : ""].filter(Boolean); }
58
+ // Recovery guidance is derived from effective obligations, not roster size or model advice.
59
+ export function missingProcessRoleRecoveryHints(state: ProcessObligationState, roster: ReadonlySet<string>): string {
60
+ const open = processOpenObligations(state);
61
+ const missingPlan = open.includes("plan") && !roster.has("planner");
62
+ const missingReview = open.includes("review") && !["code-reviewer", "plan-reviewer", "security-auditor"].some(name => roster.has(name));
63
+ return [
64
+ missingPlan ? "Plan requires planner: ask the human to run /af-agents-add planner or choose a roster with /af-agents-team." : "",
65
+ missingReview ? "Review requires a reviewer: ask the human to run /af-agents-add code-reviewer (or plan-reviewer or security-auditor), or choose a roster with /af-agents-team." : "",
66
+ ].filter(Boolean).join(" ");
67
+ }
68
+
69
+ export const taskTransitionRecoveryHint = "Pending task transition: before dependent effects, call set_task_tier with the current tier and explicit risk/scope to bind this input to the same task; for a genuinely different task use new_task: true with a reason and obtain human supersession authorization if prior obligations are open. Do not waive while pending; bind first, then use only active addition IDs for the bound task.";
70
+ export const TASK_TRANSITION_ENTRY_TYPE = "agent-hub-task-transition";
71
+ export const TRANSITION_DIVERSION_STOP = 2;
72
+
73
+ /** Resume keeps an unbound transition fenced. A missing entry is the legacy clear state; a corrupt entry fails closed. */
74
+ export function latestPendingTaskTransition(entries: readonly unknown[]): boolean {
75
+ for (let i = entries.length - 1; i >= 0; i--) {
76
+ const entry = entries[i] as { type?: unknown; customType?: unknown; data?: { pending?: unknown } } | null;
77
+ if (!entry || entry.type !== "custom" || entry.customType !== TASK_TRANSITION_ENTRY_TYPE) continue;
78
+ return entry.data?.pending !== false;
79
+ }
80
+ return false;
81
+ }
82
+
83
+ /** First non-recovery tool while a transition is pending gets the hint. The next one stops the turn. */
84
+ export function transitionDiversionDecision(count: number, hint: string): { nextCount: number; terminate?: true; reason: string } {
85
+ const nextCount = count + 1;
86
+ if (nextCount >= TRANSITION_DIVERSION_STOP) return { nextCount, terminate: true, reason: `Turn stopped after ${nextCount} tool calls while a task transition was pending. ${hint} Do not call another tool in this turn.` };
87
+ return { nextCount, reason: `${hint} This was diversion ${nextCount} of ${TRANSITION_DIVERSION_STOP}. The next tool that is not set_task_tier or ask_user stops the turn.` };
88
+ }
89
+
90
+ /** One assistant step may emit several tools at once. That step is a single refusal, not a stop:
91
+ * aborting it prevents the model from calling set_task_tier. A later step that still does not bind stops. */
92
+ export function transitionToolDecision(hintDelivered: boolean, count: number, hint: string): { nextCount: number; terminate?: true; reason: string } {
93
+ if (!hintDelivered) return { nextCount: 1, reason: `${hint} Tools in this step are refused, not executed. Call set_task_tier before any other tool. A later step that still does not bind stops the turn.` };
94
+ return transitionDiversionDecision(Math.max(count, 1), hint);
95
+ }
96
+
97
+ export function activeAdditionRecoveryHints(state: ProcessObligationState, taskId: string, inputRevision: string | undefined): string {
98
+ const descriptions = {
99
+ security_change: "Security-sensitive change: independent review before acceptance (not before authoring).",
100
+ wide_change: "Wide change: plan before effects and independent review before acceptance.",
101
+ irreversible_execution: "Potentially irreversible execution: exact action-bound, one-use human confirmation before each effect; unsupported child/peer binding refuses the effect.",
102
+ } as const;
103
+ const active = normalizeProcessState(state).additions!.filter(a => a.status === "active" && a.taskId === taskId);
104
+ if (!active.length) return "";
105
+ return `Active System 1 additions (not baseline): ${active.map(a => `${a.id} — ${descriptions[a.reason]} ${inputRevision && a.inputRevision === inputRevision ? `To contest this exact addition, ask the human to run /af-task-triage-waive ${a.id} <reason>.` : "Waiver unavailable for this input revision; do not reuse a stale authorization."}`).join(" ")} A waiver needs human authorization and cannot remove baseline or other additions.`;
106
+ }
107
+
108
+ /** T5/D2: trusted read-only inspection route for refused shell effects.
109
+ * There is no regex/model-label/operator-mode exemption for arbitrary bash: unknown
110
+ * shell/backend stays a potential effect. The usable route is the effective catalog's
111
+ * deterministic inspection tools with an explicit target path — never the shell string. */
112
+ export function readOnlyInspectionRoute(): string {
113
+ return "Usable read-only route: read/grep/find/ls with an explicit target path (or the filesystem tool when the deterministic-tools opt-in is enabled). Do not execute the shell string; no planner and no slash reset is needed for inspection.";
114
+ }
115
+ export function processActionGate(state: ProcessObligationState, contract?: ActionContract, grant?: ActionGrant): { reason: string; message: string } | null {
116
+ const pending = normalizeProcessState(state).additions!.filter(a => a.status === "active" && a.reason === "irreversible_execution");
117
+ if (!pending.length) return null;
118
+ if (!contract?.actionId || !contract.taskId || !contract.inputRevision || !contract.operation || !contract.target || pending.some(a => a.taskId !== contract.taskId || a.inputRevision !== contract.inputRevision) || !consumeActionGrant(grant, contract)) return { reason: "action_confirmation_unsupported", message: "A task-triage irreversible-action signal requires exact task/revision/action-bound human confirmation; unsupported binding refuses this effect." };
119
+ return null;
120
+ }
121
+ export function processPreEffectGate(state: ProcessObligationState, effect: "write" | "child" | "prove", persona = "", revision?: string): { reason: string; message: string } | null {
122
+ let s: ProcessObligationState;
123
+ try { s = normalizeProcessState(state); } catch { return { reason: "process_state_corrupt", message: "Saved process additions are invalid or oversized; dependent effects are blocked until human recovery of the session state." }; }
124
+ // Only the Hub's direct bash/edit/write effects receive exact-action grants.
125
+ // Only currently needed stage producers may pass the child gate. The native
126
+ // launch restricts their tools to inspection; the Hub persists their output;
127
+ // coms cannot supply this boundary. All other child/peer
128
+ // effects refuse an active confirmation addition as unsupported. Even read-only
129
+ // bash is treated as an effect: no shell-content heuristic grants an exemption.
130
+ const stageProducer = effect === "child" && (persona === "planner"
131
+ ? effectiveProcessStage(s, "plan") && !s.plan.evidenceRef
132
+ : ["code-reviewer", "plan-reviewer", "security-auditor"].includes(persona) && effectiveProcessStage(s, "review") && !s.review.evidenceRef);
133
+ if ((effect === "write" || effect === "child") && effectiveProcessStage(s, "plan") && !s.plan.evidenceRef && persona !== "planner") return { reason: "process_plan_open", message: `Process gate refused the dependent effect: the wide-task plan obligation is open. Run the planner first; if no planner is on the roster, ask the human to use /af-agents-add planner or /af-agents-team. ${readOnlyInspectionRoute()}` };
134
+ if ((effect === "write" || effect === "child") && !stageProducer) { const confirmation = processActionGate(s); if (confirmation) return confirmation; }
135
+ if (effect === "prove") { const open = processOpenObligations(s, revision).filter(x => x !== "acceptance" && x !== "action_confirmation"); if (open.length) return { reason: "process_obligations_open", message: `Assertion cannot become proven while process obligations are open: ${open.join(", ")}.` }; }
136
+ return null;
137
+ }
47
138
  export function evaluateProcessObligations(state: ProcessObligationState, input: { writable: boolean; budgetTier: string; t2Accepted?: boolean; currentRevision?: string }): ProcessVerdict {
48
- const s = normalizeProcessState(state); if (!input.writable) return { accepted: false, path: "read-only", risk: s.risk, scope: s.scope, budgetTier: input.budgetTier, obligations: { risk: { status: "unsupported" }, acceptance: { status: "unsupported" }, review: { status: "unsupported" }, plan: { status: "unsupported" } }, appliedRuleIds: rules(s.risk, "read-only"), currentStage: "acceptance", admissibleNextAction: "continue read-only research; changed-task acceptance is unavailable", auditScope: [], explanation: `Read-only source-traceable path; T2 acceptance is unsupported and fails closed. Budget tier ${input.budgetTier} limits spend only.` };
49
- const status = (stage: ProcessStageState, revisionBound = true): ObligationStatus => !stage.required ? "satisfied" : stage.evidenceRef && (!revisionBound || !input.currentRevision || stage.revision === input.currentRevision) ? "satisfied" : "open";
50
- const obligations: ProcessVerdict["obligations"] = { risk: { status: s.risk === "unknown" ? "open" : "satisfied" }, acceptance: { status: input.t2Accepted || status(s.acceptance) === "satisfied" ? "satisfied" : "open", ...(s.acceptance.evidenceRef ? { evidenceRef: s.acceptance.evidenceRef } : {}) }, review: { status: status(s.review), ...(s.review.evidenceRef ? { evidenceRef: s.review.evidenceRef } : {}) }, plan: { status: status(s.plan, false), ...(s.plan.evidenceRef ? { evidenceRef: s.plan.evidenceRef } : {}) } };
51
- const open = Object.entries(obligations).filter(([,x]) => x.status !== "satisfied").map(([x]) => x), accepted = open.length === 0; const currentStage: ProcessStage = open.includes("risk") ? "classify-risk" : open.includes("plan") ? "plan" : open.includes("acceptance") ? "acceptance" : open.includes("review") ? "review" : "complete";
139
+ const s = normalizeProcessState(state); const additions = s.additions!.map(({ id, taskId, evaluationId, inputRevision, reason, status }) => ({ id, taskId, evaluationId, inputRevision, reason, status })); if (!input.writable) return { accepted: false, path: "read-only", risk: s.risk, scope: s.scope, budgetTier: input.budgetTier, obligations: { risk: { status: "unsupported" }, acceptance: { status: "unsupported" }, review: { status: "unsupported" }, plan: { status: "unsupported" } }, additions, appliedRuleIds: rules(s.risk, "read-only"), currentStage: "acceptance", admissibleNextAction: "continue read-only research; changed-task acceptance is unavailable", auditScope: [], explanation: `Read-only source-traceable path; T2 acceptance is unsupported and fails closed. Budget tier ${input.budgetTier} limits spend only.` };
140
+ const status = (stage: ProcessStageState, required = stage.required, revisionBound = true): ObligationStatus => !required ? "satisfied" : stage.evidenceRef && (!revisionBound || !input.currentRevision || stage.revision === input.currentRevision) ? "satisfied" : "open";
141
+ const obligations: ProcessVerdict["obligations"] = { risk: { status: s.risk === "unknown" ? "open" : "satisfied" }, acceptance: { status: input.t2Accepted || status(s.acceptance) === "satisfied" ? "satisfied" : "open", ...(s.acceptance.evidenceRef ? { evidenceRef: s.acceptance.evidenceRef } : {}) }, review: { status: status(s.review, effectiveProcessStage(s, "review")), ...(s.review.evidenceRef ? { evidenceRef: s.review.evidenceRef } : {}) }, plan: { status: status(s.plan, effectiveProcessStage(s, "plan"), false), ...(s.plan.evidenceRef ? { evidenceRef: s.plan.evidenceRef } : {}) } };
142
+ const waivedOnly = (stage: "plan" | "review" | "confirmation") => !effectiveProcessStage(s, stage) && !((stage === "plan" || stage === "review") && s[stage].required) && s.additions!.some(a => a.status === "waived" && (stage === "confirmation" ? a.reason === "irreversible_execution" : stage === "plan" ? a.reason === "wide_change" : a.reason === "wide_change" || a.reason === "security_change"));
143
+ for (const stage of ["plan", "review"] as const) if (waivedOnly(stage)) obligations[stage] = { status: "waived" };
144
+ if (effectiveProcessStage(s, "confirmation") || waivedOnly("confirmation")) obligations.confirmation = { status: effectiveProcessStage(s, "confirmation") ? "open" : "waived" };
145
+ // Confirmation is checked for each exact effect before execution, not a task-level acceptance stage.
146
+ const open = Object.entries(obligations).filter(([name, x]) => name !== "confirmation" && (x.status === "open" || x.status === "unsupported")).map(([x]) => x), accepted = open.length === 0; const currentStage: ProcessStage = open.includes("risk") ? "classify-risk" : open.includes("plan") ? "plan" : open.includes("acceptance") ? "acceptance" : open.includes("review") ? "review" : "complete";
52
147
  const next = currentStage === "classify-risk" ? "set_task_tier with explicit risk and reason" : currentStage === "plan" ? "dispatch planner" : currentStage === "acceptance" ? "execute and verify the changed task" : currentStage === "review" ? "dispatch an independent reviewer over the current changed scope" : "report completion";
53
- return { accepted, path: "changed-task", risk: s.risk, scope: s.scope, budgetTier: input.budgetTier, obligations, appliedRuleIds: s.appliedRuleIds.length ? s.appliedRuleIds : rules(s.risk,s.scope), currentStage, admissibleNextAction: next, auditScope: s.changedFiles, explanation: `Risk ${s.risk} and scope ${s.scope} determine correctness obligations; budget tier ${input.budgetTier} limits spend only.${open.length ? ` Open: ${open.join(", ")}.` : " All obligations satisfied."}` };
148
+ return { accepted, path: "changed-task", risk: s.risk, scope: s.scope, budgetTier: input.budgetTier, obligations, additions, appliedRuleIds: s.appliedRuleIds.length ? s.appliedRuleIds : rules(s.risk,s.scope), currentStage, admissibleNextAction: next, auditScope: s.changedFiles, explanation: `Risk ${s.risk} and scope ${s.scope} determine correctness obligations; budget tier ${input.budgetTier} limits spend only.${open.length ? ` Open: ${open.join(", ")}.` : " All task-level obligations satisfied; source waivers remain waived, not satisfied."}${obligations.confirmation?.status === "open" ? " Each future effect still requires exact one-use human confirmation." : ""}` };
54
149
  }
55
- export function processAllowsPersona(state: ProcessObligationState, persona: string): boolean { const name = String(persona||"").trim().toLowerCase(), s=normalizeProcessState(state); return s.plan.required && name === "planner" || s.review.required && ["code-reviewer","plan-reviewer","security-auditor"].includes(name); }
56
- export function processAuditRecord(state: ProcessObligationState, verdict: ProcessVerdict) { return { schema: PROCESS_OBLIGATIONS_SCHEMA, risk: verdict.risk, scope: verdict.scope, budgetTier: verdict.budgetTier, obligations: Object.fromEntries(Object.entries(verdict.obligations).map(([k,v])=>[k,{status:v.status}])), appliedRuleIds: verdict.appliedRuleIds, currentStage: verdict.currentStage, admissibleNextAction: verdict.admissibleNextAction, auditScope: verdict.auditScope, explanation: verdict.explanation, state: normalizeProcessState(state) }; }
150
+ export function processAllowsPersona(state: ProcessObligationState, persona: string): boolean { const name = String(persona||"").trim().toLowerCase(), s=normalizeProcessState(state); return effectiveProcessStage(s, "plan") && name === "planner" || effectiveProcessStage(s, "review") && ["code-reviewer","plan-reviewer","security-auditor"].includes(name); }
151
+ export function processAuditRecord(state: ProcessObligationState, verdict: ProcessVerdict) { return { schema: PROCESS_OBLIGATIONS_SCHEMA, risk: verdict.risk, scope: verdict.scope, budgetTier: verdict.budgetTier, obligations: Object.fromEntries(Object.entries(verdict.obligations).map(([k,v])=>[k,{status:v.status}])), additions: verdict.additions, appliedRuleIds: verdict.appliedRuleIds, currentStage: verdict.currentStage, admissibleNextAction: verdict.admissibleNextAction, auditScope: verdict.auditScope, explanation: verdict.explanation, state: normalizeProcessState(state) }; }
57
152
  export function latestProcessState(entries: readonly unknown[]): ProcessObligationState { for(let i=entries.length-1;i>=0;i--){const row=entries[i] as any,type=row?.customType??row?.type;if(type!=="agent-hub-process-state")continue;const data=row?.data;if(data?.schema===PROCESS_OBLIGATIONS_SCHEMA)return normalizeProcessState(data.state??data);}return createProcessState(); }
153
+
154
+ /** A saved addition must never authorize a different or ambiguous recovered task. */
155
+ export function processTaskIdentityConflicts(state: ProcessObligationState, taskId: string): boolean {
156
+ const ids = new Set(state.additions?.map(addition => addition.taskId));
157
+ return ids.size > 1 || ids.size === 1 && !ids.has(taskId);
158
+ }
@@ -35,18 +35,18 @@ ask the human. You MUST instead:
35
35
  export function dispatchFragment(fleetActive: boolean, askUserAvailable: boolean, userLanguage: string): string {
36
36
  if (!fleetActive) return "";
37
37
  return askUserAvailable
38
- ? `- BEFORE dispatching: if anything is ambiguous, missing, or could go several valid
39
- ways, call \`ask_user\` first. Never invent constraints or "reasonable defaults"
40
- the user did not state.
38
+ ? `- BEFORE dispatching: a missing repository fact is not an ambiguity. Use \`spawn_research\`, or \`filesystem\` stat/inventory/excerpt/readback when that tool is listed. Stat first. Above 64 KiB for one file, or 64 KiB already used this turn, a too_large refusal is not self-read: spawn_research for a summary or dispatch_agent with the path only. Call \`ask_user\` first only for a preference, a contradiction, a destructive or costly scope, or a value only the user knows. Never invent those constraints.
39
+ - At trivial/small, do not dispatch planner, architect, security-auditor, or deep-researcher — the runtime refuses them and does not charge the call. Dispatch the working specialist, or call \`set_task_tier\` with a higher tier and a reason first. If the refusal says planner_required, raise the tier before retrying planner. Do not retry the same refused call.
40
+ - Do not invent an assertion ledger or mark an assertion proven unless \`set_assertions\` is in the active tool list. Missing verification tools means the tier has not opened that contract, not that the work is accepted.
41
41
  - Dispatch tasks via \`dispatch_agent\`. Each dispatched task is automatically
42
42
  augmented with clarification/research plus deliverable-to-file protocols. For document handoff, pass artifact paths through the optional \`artifacts\` array; never paste full plan/review/inventory bodies into a task.
43
43
  - For dispatches carrying A1/A2-style assertions, specialist returns arrive pre-parsed as \`details.structuredReturn\` with \`details.contractNotices\`; the full raw output is persisted at \`details.returnPath\` and kept for compatibility in \`details.fullOutput\`. Spawn a reader only when the digest/path is not enough.
44
44
  - After each dispatch, INSPECT the result for ASK_USER questions (also surfaced in
45
45
  the result \`details.questions\`). For each one: call \`ask_user\` in ${userLanguage},
46
- then re-dispatch the specialist with the answer.`
47
- : `- BEFORE dispatching: if anything is ambiguous, missing, or could go several valid
48
- ways, STATE your assumption explicitly in ${userLanguage} and wait for the user
49
- to correct it. Never invent constraints or "reasonable defaults" silently.
46
+ then re-dispatch the specialist with a line \`USER_ANSWER: <dispatchId> :: <question>\`. Prose alone does not authorize the resume.`
47
+ : `- BEFORE dispatching: a missing repository fact is not an ambiguity. Use \`spawn_research\`, or \`filesystem\` stat/inventory/excerpt/readback when that tool is listed. Stat first. Above 64 KiB for one file, or 64 KiB already used this turn, a too_large refusal is not self-read: spawn_research for a summary or dispatch_agent with the path only. If a preference, contradiction, or costly choice is unresolved, STATE the assumption explicitly in ${userLanguage} and wait for the user to correct it. Never invent constraints silently.
48
+ - At trivial/small, do not dispatch planner, architect, security-auditor, or deep-researcher — the runtime refuses them and does not charge the call. Dispatch the working specialist, or call \`set_task_tier\` with a higher tier and a reason first. If the refusal says planner_required, raise the tier before retrying planner. Do not retry the same refused call.
49
+ - Do not invent an assertion ledger or mark an assertion proven unless \`set_assertions\` is in the active tool list. Missing verification tools means the tier has not opened that contract, not that the work is accepted.
50
50
  - Dispatch tasks via \`dispatch_agent\`. Each dispatched task is automatically
51
51
  augmented with clarification/research plus deliverable-to-file protocols. For document handoff, pass artifact paths through the optional \`artifacts\` array; never paste full plan/review/inventory bodies into a task.
52
52
  - For dispatches carrying A1/A2-style assertions, specialist returns arrive pre-parsed as \`details.structuredReturn\` with \`details.contractNotices\`; the full raw output is persisted at \`details.returnPath\` and kept for compatibility in \`details.fullOutput\`. Spawn a reader only when the digest/path is not enough.
@@ -57,10 +57,8 @@ export function dispatchFragment(fleetActive: boolean, askUserAvailable: boolean
57
57
 
58
58
  export function ambiguityFragment(askUserAvailable: boolean, userLanguage: string): string {
59
59
  return askUserAvailable
60
- ? `- NEVER proceed past an ambiguity by guessing. Either call \`ask_user\`, or state
61
- the assumption explicitly in ${userLanguage} and say you'll proceed unless corrected.`
62
- : `- NEVER proceed past an ambiguity by guessing. State the assumption explicitly
63
- in ${userLanguage} and wait for the user to confirm or correct.`;
60
+ ? `- NEVER proceed past an ambiguity by guessing. A fact about the repository is not an ambiguity: inspect it with \`filesystem\` or \`spawn_research\`. Stat before excerpt; above 64 KiB, do not self-read — spawn_research or dispatch the path. Call \`ask_user\` for a preference, contradiction, or costly choice; otherwise state the assumption explicitly in ${userLanguage} and say you'll proceed unless corrected.`
61
+ : `- NEVER proceed past an ambiguity by guessing. A fact about the repository is not an ambiguity: inspect it with \`filesystem\` or \`spawn_research\`. Stat before excerpt; above 64 KiB, do not self-read — spawn_research or dispatch the path. State every remaining assumption explicitly in ${userLanguage} and wait for the user to confirm or correct.`;
64
62
  }
65
63
 
66
64
  export function languageFragment(askUserAvailable: boolean, userLanguage: string): string {
@@ -14,12 +14,29 @@ export function renderRecoveryInvocation(state: RecoverState, operationId: strin
14
14
  if (!operation || !operation.attempts.some(attempt => attempt.attemptId === attemptId)) return null;
15
15
  return command === 'inspect' ? `/af-recover inspect ${operationId}` : `/af-recover ${command} ${operationId} ${attemptId}`;
16
16
  }
17
- /** Human-facing invocation; the tool call is a template, never executed here. */
17
+ /** Human-facing invocation; the tool call is a template, never executed here.
18
+ * T6: abandoned operations never render a replay template; missing/invalid contracts
19
+ * return null so callers can emit their distinct reason (see invocationStatus). */
18
20
  export function renderNextInvocation(guard: NoProgressGuard, operationId: string): string | null {
19
21
  const operation = guard.inspect(operationId), invocation = guard.invocation(operationId);
20
22
  if (!operation || !invocation || operation.abandoned || !ID.test(operationId)) return null;
23
+ const status = (guard as any).invocationStatus?.(operationId);
24
+ if (status && status.status !== 'available') return null;
21
25
  return `${invocation.tool}(${JSON.stringify(invocation.params)})`;
22
26
  }
27
+ /** T6: distinct invocation-availability reason for exact recovery responses. */
28
+ export function describeInvocationAvailability(guard: NoProgressGuard, operationId: string): string {
29
+ const status = (guard as any).invocationStatus?.(operationId);
30
+ if (!status) {
31
+ const operation = guard.inspect(operationId);
32
+ if (!operation) return 'missing_original_runtime_invocation: unknown operation';
33
+ if (operation.abandoned) return 'abandoned_operation: abandon closed the operation; parent obligations remain open';
34
+ if (!guard.invocation(operationId)) return 'missing_original_runtime_invocation: no validated contract was persisted';
35
+ return 'unknown_process: pending or unsettled process';
36
+ }
37
+ if (status.status === 'available') return 'available';
38
+ return `${status.reason}: ${(status.nextActions ?? []).join('; ')}`;
39
+ }
23
40
  export function renderRecoverCommands(guard: NoProgressGuard, operationId: string, attemptId: string): string | null {
24
41
  const op = guard.inspect(operationId);
25
42
  if (!op || !ID.test(operationId) || !ID.test(attemptId) || !op.attempts.some(a => a.attemptId === attemptId)) return null;
@@ -52,7 +52,7 @@ export function createRecoverState(history: readonly RecoverEvent[] = [], append
52
52
  if (attempt.category || attempt.completed || active.get(op.executor) !== attempt.attemptId) throw new Error('Invalid recovery history');
53
53
  attempt.completed = true; active.delete(op.executor); return;
54
54
  case 'failure':
55
- if (attempt.category || active.get(op.executor) !== attempt.attemptId || !['invalid_input','resource_exhausted','operator_cancelled','verification_failed','tool_protocol_error','unknown_tool','indeterminate'].includes(event.category)) throw new Error('Invalid recovery history');
55
+ if (attempt.category || active.get(op.executor) !== attempt.attemptId || !['not_started','invalid_input','resource_exhausted','operator_cancelled','verification_failed','blocked_on_user','tool_protocol_error','unknown_tool','indeterminate'].includes(event.category)) throw new Error('Invalid recovery history');
56
56
  attempt.category = event.category; active.delete(op.executor); return;
57
57
  case 'settled':
58
58
  if (!attempt.category || attempt.settled || !nonempty(event.evidence)) throw new Error('Invalid recovery history');
@@ -1,9 +1,11 @@
1
1
  export const RECOVERY_CATEGORIES = [
2
2
  "busy",
3
+ "not_started",
3
4
  "invalid_input",
4
5
  "resource_exhausted",
5
6
  "operator_cancelled",
6
7
  "verification_failed",
8
+ "blocked_on_user",
7
9
  "tool_protocol_error",
8
10
  "unknown_tool",
9
11
  "indeterminate",
@@ -21,6 +23,9 @@ export interface RecoveryConditions {
21
23
  effectsEstablished?: boolean;
22
24
  processSettled?: boolean;
23
25
  indeterminateGrantUsed?: boolean;
26
+ // Runtime-owned no-launch proof for legacy preflight entries that never
27
+ // produced a process, dispatch, or effect. Missing records alone never set this.
28
+ noLaunchEstablished?: boolean;
24
29
  }
25
30
 
26
31
  export interface RecoveryDecision {
@@ -45,6 +50,8 @@ export function recoveryDecision(category: RecoveryCategory, conditions: Recover
45
50
  switch (category) {
46
51
  case "busy":
47
52
  return { ...base, allowed: explicit && changed && conditions.executorIdle === true, nextStep: "reinvoke_after_change", reason: "executor must be observed idle before an explicit re-invocation" };
53
+ case "not_started":
54
+ return { ...base, allowed: explicit && changed, nextStep: "correct_and_reinvoke", reason: "preflight refused before launch with no process or effects; correct inputs/prerequisites and re-invoke explicitly" };
48
55
  case "invalid_input":
49
56
  return { ...base, allowed: explicit && changed, nextStep: "correct_and_reinvoke", reason: "validated inputs must be materially corrected" };
50
57
  case "resource_exhausted":
@@ -53,6 +60,8 @@ export function recoveryDecision(category: RecoveryCategory, conditions: Recover
53
60
  return { ...base, allowed: explicit && conditions.freshOneUseAuthorization === true, nextStep: "authorize_once_and_reinvoke", reason: "operator cancellation requires fresh one-use authorization for this agent" };
54
61
  case "verification_failed":
55
62
  return { ...base, allowed: explicit && changed, nextStep: "correct_and_reinvoke", reason: "the checked state or evidence must have changed" };
63
+ case "blocked_on_user":
64
+ return { ...base, allowed: explicit && conditions.freshOneUseAuthorization === true, nextStep: "authorize_once_and_reinvoke", reason: "one recorded user answer may resume only the same task and scope; prose or a model switch is not authorization" };
56
65
  case "tool_protocol_error":
57
66
  return { ...base, allowed: explicit && changed && conditions.effectsEstablished === true, nextStep: "correct_and_reinvoke", reason: "requires the T3 trusted event/readback effects artifact plus corrected conditions; /af-retry cannot authorize this failure and already-observed effects must not be replayed blindly" };
58
67
  case "unknown_tool":
@@ -62,6 +71,51 @@ export function recoveryDecision(category: RecoveryCategory, conditions: Recover
62
71
  }
63
72
  }
64
73
 
74
+ const NOT_STARTED_STATUS = new Set([
75
+ "not_started",
76
+ "tier_persona_gate",
77
+ "scope_preflight_failed",
78
+ "artifact_preflight_failed",
79
+ "task_budget_refused",
80
+ "budget_refused",
81
+ "duplicate_refused",
82
+ "research_persona_via_dispatch",
83
+ "unknown_agent",
84
+ "process_plan_open",
85
+ "process_state_unavailable",
86
+ "process_obligations_open",
87
+ "action_confirmation_unsupported",
88
+ "process_state_corrupt",
89
+ "docs_lane",
90
+ "review_round_capped",
91
+ "review_round_cap",
92
+ "scope_gate",
93
+ "preflight_refused",
94
+ ]);
95
+
96
+ /** Runtime lifecycle is trusted only when both facts are explicit booleans.
97
+ * Missing fields are unknown — never inferred from exit, spawnError, or termination. */
98
+ export function explicitProcessLifecycle(value: unknown): { launched: boolean; closeSeen: boolean } | undefined {
99
+ if (!value || typeof value !== "object") return undefined;
100
+ const launched = (value as { launched?: unknown }).launched;
101
+ const closeSeen = (value as { closeSeen?: unknown }).closeSeen;
102
+ if (typeof launched !== "boolean" || typeof closeSeen !== "boolean") return undefined;
103
+ return { launched, closeSeen };
104
+ }
105
+
106
+ /** Post-spawn exceptions must not be rewritten as a proven no-launch. */
107
+ export function lifecycleAfterSpawnException(input: {
108
+ spawnAttempted: boolean;
109
+ spawnLifecycle?: unknown;
110
+ processSeen: boolean;
111
+ }): { launched: boolean; closeSeen: boolean } | undefined {
112
+ if (!input.spawnAttempted) return { launched: false, closeSeen: false };
113
+ const known = explicitProcessLifecycle(input.spawnLifecycle);
114
+ if (input.processSeen || known?.launched === true) return { launched: true, closeSeen: false };
115
+ if (known?.launched === false) return { launched: false, closeSeen: false };
116
+ return undefined;
117
+ }
118
+
65
119
  export function recoveryCategoryFromDetails(details: any): RecoveryCategory | null {
66
120
  if (!details || typeof details !== "object") return null;
67
121
  if (RECOVERY_CATEGORIES.includes(details.recoveryCategory as RecoveryCategory)) return details.recoveryCategory as RecoveryCategory;
@@ -70,8 +124,24 @@ export function recoveryCategoryFromDetails(details: any): RecoveryCategory | nu
70
124
  .map(value => value.toLowerCase());
71
125
  if (values.some(value => value === "busy")) return "busy";
72
126
  if (values.some(value => value.includes("operator_cancel") || value === "cancelled" || value === "canceled")) return "operator_cancelled";
127
+ // T3: explicit runtime lifecycle facts outrank exit-code inference.
128
+ // Never launched (safety refusal, spawn failure, pre-launch cancel) is not_started,
129
+ // never an indeterminate attempt. Launched without close stays uncertain downstream.
130
+ if (details.lifecycle && typeof details.lifecycle === "object" && typeof details.lifecycle.launched === "boolean" && details.lifecycle.launched === false) {
131
+ if (values.some(value => value.includes("unknown_tool"))) return "unknown_tool";
132
+ return "not_started";
133
+ }
134
+ if (values.some(value => NOT_STARTED_STATUS.has(value) || value.includes("not_started") || value.includes("preflight"))) return "not_started";
135
+ // Runtime-owned preflight refusals carry started:false and never had a process.
136
+ // They must not become indeterminate attempts. Explicit cancellation stays
137
+ // cancellation even before launch; unknown_tool keeps its own lane.
138
+ if (details.started === false) {
139
+ if (values.some(value => value.includes("unknown_tool"))) return "unknown_tool";
140
+ return "not_started";
141
+ }
73
142
  if (values.some(value => value.includes("invalid_input") || value.includes("validation"))) return "invalid_input";
74
143
  if (values.some(value => value.includes("resource_exhausted") || value.includes("out_of_memory") || value === "oom")) return "resource_exhausted";
144
+ if (values.some(value => value === "blocked_on_user") || (Array.isArray(details.questions) && details.questions.length > 0 && !values.some(value => value === "verification_failed"))) return "blocked_on_user";
75
145
  if (values.some(value => value.includes("verification_failed") || value.includes("deliverable_failed"))) return "verification_failed";
76
146
  if (values.some(value => value.includes("tool_protocol_error"))) return "tool_protocol_error";
77
147
  if (values.some(value => value.includes("unknown_tool"))) return "unknown_tool";
@@ -0,0 +1,40 @@
1
+ export interface RerunInput {
2
+ impact: "narrow" | "wide";
3
+ sharedCode: boolean;
4
+ selector: string;
5
+ flaky: boolean;
6
+ policyMandate: boolean;
7
+ builderPassed: boolean;
8
+ reviewerRan?: boolean;
9
+ timeSavedMs?: number;
10
+ area?: string;
11
+ }
12
+
13
+ export interface RerunDecision {
14
+ mode: "focused" | "full";
15
+ selector: string;
16
+ independent: true;
17
+ accepted: boolean;
18
+ reason: string;
19
+ }
20
+
21
+ export function chooseReviewerRerun(input: RerunInput): RerunDecision {
22
+ const full = input.impact === "wide" || input.sharedCode || !input.selector.trim() || input.flaky || input.policyMandate;
23
+ const reasons = [
24
+ input.impact === "wide" ? "wide impact" : "",
25
+ input.sharedCode ? "shared code" : "",
26
+ !input.selector.trim() ? "unclear selector" : "",
27
+ input.flaky ? "flaky signal" : "",
28
+ input.policyMandate ? "policy mandate" : "",
29
+ ].filter(Boolean);
30
+ const reviewerRan = input.reviewerRan !== false;
31
+ return {
32
+ mode: full ? "full" : "focused",
33
+ selector: full ? "full" : input.selector,
34
+ independent: true,
35
+ accepted: reviewerRan && !input.builderPassed ? false : reviewerRan,
36
+ reason: full
37
+ ? `full regression required because ${reasons.join(", ")}${input.area ? ` (${input.area})` : ""}`
38
+ : "independent focused rerun of specialist-authored tests",
39
+ };
40
+ }
@@ -68,6 +68,8 @@ export interface ResearchResult {
68
68
  exitCode: number;
69
69
  elapsed: number;
70
70
  termination?: Termination;
71
+ /** T3 runtime lifecycle facts. Safety refusal and spawn failure never launched. */
72
+ lifecycle?: { launched: boolean; closeSeen: boolean };
71
73
  }
72
74
 
73
75
  export interface ResearchFinalizeOutcome {