@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
@@ -4,7 +4,7 @@ import { readFileSync } from "node:fs";
4
4
  import { posix, resolve, relative } from "node:path";
5
5
  import { worktreeRevision } from "./scope-gate.js";
6
6
  import { checkTaskBudget, checkTurnBudget } from "./run-budget.js";
7
- import { recoveryCategoryFromDetails, recoveryDecision, type RecoveryCategory } from "./recovery-contract.ts";
7
+ import { explicitProcessLifecycle, recoveryCategoryFromDetails, recoveryDecision, type RecoveryCategory } from "./recovery-contract.ts";
8
8
  import { createRecoverState, type RecoverEvent } from './recover-state.ts';
9
9
  import { readBackDeliverables } from './acceptance.ts';
10
10
  import type { DispatchExecutorDeps } from "./tools/dispatch-execution.ts";
@@ -20,6 +20,10 @@ interface Failure {
20
20
  effectsEstablished?: boolean;
21
21
  catalogVersion?: string;
22
22
  toolStateChanged?: boolean;
23
+ // Runtime-owned proof that no process launched and no effects occurred.
24
+ // Set only from trusted lifecycle facts or an explicit no-launch port,
25
+ // never from missing records alone.
26
+ noLaunchEstablished?: boolean;
23
27
  }
24
28
  interface Ticket { allowed: boolean; key: string; executorKey: string; scope: string[]; generation: object; id: object; operationId?: string; attemptId?: string; failure?: Failure; refusal?: "busy" | "recovery"; }
25
29
  interface RecordedFailure { fingerprint: string; failure: Failure; authorized: boolean; }
@@ -41,8 +45,59 @@ export function projectRecoveryRows(entries: readonly unknown[]): any[] {
41
45
  if (rows.some(row => !row || !['ledger', 'guard'].includes(row.kind))) throw new Error('Invalid recovery history');
42
46
  return rows;
43
47
  }
44
- export type GuardHistory = { type: 'failure' | 'authorize' | 'evidence' | 'task' | 'consume' | 'invocation'; key?: string; fingerprint?: string; failure?: Failure; executorKey?: string; scope?: string[]; dispatchId?: string; taskId?: string; evidence?: DispatchEvidence; operationId?: string; invocation?: { tool: 'dispatch_agent' | 'spawn_research'; params: DispatchAgentParams | SpawnResearchParams } };
48
+ export type GuardHistory = { type: 'failure' | 'authorize' | 'evidence' | 'task' | 'consume' | 'invocation' | 'no_launch'; key?: string; fingerprint?: string; failure?: Failure; executorKey?: string; scope?: string[]; dispatchId?: string; taskId?: string; evidence?: DispatchEvidence; operationId?: string; evidenceRef?: string; invocation?: { tool: 'dispatch_agent' | 'spawn_research'; params: DispatchAgentParams | SpawnResearchParams } };
49
+
50
+ /** Canonical executor identity shared by the wrapper and evidence producers.
51
+ * Resolves the F3 mismatch: previously the wrapper used canonical([cwd, actor])
52
+ * while the evidence writer used raw p.agent, so production reconcile always failed. */
53
+ export function canonicalExecutor(cwd: string, actor: string): string {
54
+ return canonical([resolve(cwd), actor.trim().toLowerCase().replace(/[\s_]+/g, "-")]);
55
+ }
56
+
57
+ /** Distinct invocation availability for exact recovery responses (T6). */
58
+ export type InvocationStatus =
59
+ | { status: 'available'; invocation: NonNullable<GuardHistory['invocation']> }
60
+ | { status: 'missing'; reason: string; nextActions: string[] }
61
+ | { status: 'invalid'; reason: string; nextActions: string[] }
62
+ | { status: 'abandoned'; reason: string; nextActions: string[] }
63
+ | { status: 'unknown_process'; reason: string; nextActions: string[] };
45
64
  export interface DispatchEvidence { dispatchId: string; taskId: string; executor: string; revision: string; changedScope: string[]; readback: TechnicalEvidence['readback']; concurrentWriters: boolean; effectsRef?: string; completed: boolean; blockingFindings: number; coveredScope: string[]; edited: boolean; evidenceRef: string; openRequirements: string[] };
65
+ const EFFECT_FENCE = new Set<RecoveryCategory>(["operator_cancelled", "indeterminate", "tool_protocol_error", "unknown_tool"]);
66
+ const NO_EFFECT_CATEGORY = new Set<RecoveryCategory>(["not_started", "invalid_input"]);
67
+ type FenceAttempt = { category?: RecoveryCategory; dispatchId: string; completed?: boolean };
68
+ function latestEffectFenceIndex(attempts: readonly FenceAttempt[] | undefined): number {
69
+ if (!attempts) return -1;
70
+ for (let i = attempts.length - 1; i >= 0; i--) {
71
+ const category = attempts[i].category;
72
+ if (category && EFFECT_FENCE.has(category)) return i;
73
+ }
74
+ return -1;
75
+ }
76
+ function laterAttemptLaunched(attempts: readonly FenceAttempt[], index: number): boolean {
77
+ return attempts.slice(index + 1).some(attempt => {
78
+ const category = attempt.category;
79
+ return attempt.completed || (!!category && !NO_EFFECT_CATEGORY.has(category));
80
+ });
81
+ }
82
+ /** A new task may drop a contract only when every attempt is a proven no-effect refusal. */
83
+ function phantomSafeAttempts(attempts: readonly FenceAttempt[] | undefined, noLaunchEstablished: boolean): boolean {
84
+ if (!attempts?.length || attempts.some(attempt => { const category = attempt.category; return !category || !NO_EFFECT_CATEGORY.has(category); })) return false;
85
+ if (attempts.some(attempt => attempt.category === "invalid_input") && !noLaunchEstablished) return false;
86
+ return true;
87
+ }
88
+ function retainedFenceFailure(attempt: FenceAttempt, previous?: Failure): Failure {
89
+ return {
90
+ dispatchId: attempt.dispatchId,
91
+ reason: previous?.dispatchId === attempt.dispatchId ? previous.reason : "effect_fence_retained",
92
+ category: attempt.category as RecoveryCategory,
93
+ evidencePath: previous?.dispatchId === attempt.dispatchId ? previous.evidencePath : undefined,
94
+ // A no-launch retry must not spend a prior effects/catalog unlock.
95
+ effectsEstablished: false,
96
+ toolStateChanged: false,
97
+ noLaunchEstablished: false,
98
+ catalogVersion: previous?.dispatchId === attempt.dispatchId ? previous.catalogVersion : undefined,
99
+ };
100
+ }
46
101
  function validInvocation(value: NonNullable<GuardHistory['invocation']>): boolean {
47
102
  if (!value || !['dispatch_agent', 'spawn_research'].includes(value.tool) || !value.params || typeof value.params !== 'object' || Array.isArray(value.params)) return false;
48
103
  const params = value.params as unknown as Record<string, unknown>;
@@ -55,51 +110,84 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
55
110
  let recovery = createRecoverState([], event => persist?.(RECOVER_ENTRY, { kind: 'ledger', event }));
56
111
  let generation = {};
57
112
  let taskId: string = randomUUID();
113
+ let taskIdentityPersisted = false;
58
114
  const pending = new Map<string, object>();
59
115
  const pendingExecutors = new Map<string, object>();
60
116
  const pendingLineages = new Map<string, { operationId: string; attemptId: string }>();
61
117
  const failures = new Map<string, RecordedFailure>();
118
+ const heldFences = new Map<string, RecordedFailure>();
62
119
  const dispatchEvidence = new Map<string, DispatchEvidence>();
63
120
  const invocations = new Map<string, NonNullable<GuardHistory['invocation']>>();
64
121
  const cancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
122
+ const userGrants: { dispatchId: string; question: string; taskId: string; scope: string[]; used: boolean; cancelled: boolean }[] = [];
123
+ const sameScope = (left: string[], right: string[]) => JSON.stringify([...left].map(path => path.replace(/\\/g, "/")).sort()) === JSON.stringify([...right].map(path => path.replace(/\\/g, "/")).sort());
65
124
  return {
66
125
  taskToken: () => generation,
67
126
  taskId: () => taskId,
127
+ /** The first task has no reset event. Save its identity before binding any
128
+ * pre-model assessment so a resumed session cannot mint another task ID. */
129
+ persistTaskIdentity() {
130
+ if (taskIdentityPersisted) return;
131
+ persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'task', taskId } satisfies GuardHistory });
132
+ taskIdentityPersisted = true;
133
+ },
68
134
  begin(key: string, fingerprint: string, executorKey = key, scope: string[] = [], currentRevision?: string): Ticket {
135
+ let userGrant: (typeof userGrants)[number] | undefined;
69
136
  const cancelled = [...cancellations.values()].filter(item => item.executorKey === executorKey);
70
137
  const old = cancelled.find(item => !item.entry.authorized)?.entry ?? cancelled[0]?.entry ?? failures.get(key), id = {};
71
138
  if (pendingExecutors.has(executorKey)) return { allowed: false, key, executorKey, scope, generation, id, refusal: "busy" };
72
139
  // An interrupted append can leave a ledger failure without its guard snapshot.
73
140
  // Never treat that as a fresh contract or an unlocked replay.
74
- if (!old && recovery.findContract(key)?.attempts.at(-1)?.category) {
75
- const last = recovery.findContract(key)!.attempts.at(-1)!;
76
- return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery', failure: { category: last.category!, dispatchId: last.dispatchId, reason: 'guard_history_missing' } };
141
+ if (!old) {
142
+ const op = recovery.findContract(key);
143
+ const fenceIndex = latestEffectFenceIndex(op?.attempts);
144
+ const fence = op && fenceIndex >= 0 ? op.attempts[fenceIndex] : undefined;
145
+ if (op && fence?.category && !laterAttemptLaunched(op.attempts, fenceIndex)) {
146
+ return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery', failure: { category: fence.category, dispatchId: fence.dispatchId, reason: 'effect_fence_retained' } };
147
+ }
148
+ const last = op?.attempts.at(-1);
149
+ if (last?.category) return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery', failure: { category: last.category, dispatchId: last.dispatchId, reason: 'guard_history_missing' } };
77
150
  }
78
151
  if (old) {
79
152
  const category = old.failure.category ?? "indeterminate";
80
- const changed = old.fingerprint !== fingerprint || (category === "unknown_tool" && old.failure.toolStateChanged === true);
153
+ const changed = old.fingerprint !== fingerprint || old.failure.noLaunchEstablished === true || (category === "unknown_tool" && old.failure.toolStateChanged === true);
154
+ userGrant = category === "blocked_on_user" ? userGrants.find(grant => grant.dispatchId === old.failure.dispatchId && !grant.used && !grant.cancelled && grant.taskId === taskId && sameScope(grant.scope, scope)) : undefined;
81
155
  const decision = recoveryDecision(category, {
82
156
  explicitInvocation: true,
83
157
  relevantConditionsChanged: changed || category === "busy" || (category === 'verification_failed' && !!currentRevision && recovery.findContract(key)?.technical?.status === 'cleared' && recovery.findContract(key)?.technical?.revision === currentRevision),
84
- freshOneUseAuthorization: old.authorized || (category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId),
158
+ freshOneUseAuthorization: old.authorized || !!userGrant || (category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId),
85
159
  processSettled: category === 'indeterminate' && !!recovery.findContract(key)?.attempts.at(-1)?.settled,
86
160
  indeterminateGrantUsed: category === 'indeterminate' && recovery.findContract(key)?.grantedAttemptId === recovery.findContract(key)?.attempts.at(-1)?.attemptId,
87
161
  effectsEstablished: old.failure.effectsEstablished === true,
88
162
  toolStateChanged: old.failure.toolStateChanged === true,
163
+ noLaunchEstablished: old.failure.noLaunchEstablished === true,
89
164
  executorIdle: !pendingExecutors.has(executorKey),
90
165
  });
91
166
  if (!decision.allowed) return { allowed: false, key, executorKey, scope, generation, id, failure: { ...old.failure, category }, refusal: "recovery" };
92
167
  }
93
- const lineage = recovery.start(recovery.findContract(key)?.taskId ?? taskId, key, executorKey, randomUUID());
168
+ // T2: task-scoped logical identity vs persistent effect fence.
169
+ // A phantom not_started attempt from another task never had a process or effects,
170
+ // so a truly new safe task must not inherit it. Cancel/unknown-write/indeterminate
171
+ // fences survive task/model/scope changes and are reused via the old taskId.
172
+ const existing = recovery.findContract(key);
173
+ const phantomFromOtherTask = !!existing && existing.taskId !== taskId && phantomSafeAttempts(existing.attempts, failures.get(key)?.failure.noLaunchEstablished === true);
174
+ const lineageTaskId = phantomFromOtherTask ? taskId : (existing?.taskId ?? taskId);
175
+ const lineage = recovery.start(lineageTaskId, key, executorKey, randomUUID());
94
176
  if (!lineage) return { allowed: false, key, executorKey, scope, generation, id, refusal: 'recovery' };
177
+ if (userGrant) userGrant.used = true;
95
178
  for (const item of cancelled) {
96
179
  const failedKey = [...failures].find(([, entry]) => entry === item.entry)?.[0];
97
180
  if (failedKey) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key: failedKey, dispatchId: item.entry.failure.dispatchId } satisfies GuardHistory });
98
181
  cancellations.delete(item.entry.failure.dispatchId);
99
182
  if (failedKey) failures.delete(failedKey);
100
183
  }
101
- if (failures.has(key)) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key, dispatchId: failures.get(key)!.failure.dispatchId } satisfies GuardHistory });
102
- failures.delete(key);
184
+ if (failures.has(key)) {
185
+ const prior = failures.get(key)!;
186
+ if (EFFECT_FENCE.has(prior.failure.category)) heldFences.set(key, prior);
187
+ else heldFences.delete(key);
188
+ persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'consume', key, dispatchId: prior.failure.dispatchId } satisfies GuardHistory });
189
+ failures.delete(key);
190
+ } else heldFences.delete(key);
103
191
  pending.set(key, id);
104
192
  pendingExecutors.set(executorKey, id);
105
193
  pendingLineages.set(executorKey, lineage);
@@ -110,16 +198,30 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
110
198
  pending.delete(ticket.key);
111
199
  pendingExecutors.delete(ticket.executorKey);
112
200
  pendingLineages.delete(ticket.executorKey);
201
+ const held = heldFences.get(ticket.key);
202
+ heldFences.delete(ticket.key);
203
+ if (failure && ticket.operationId && ticket.attemptId) {
204
+ recovery.bindDispatch(ticket.operationId, ticket.attemptId, failure.dispatchId);
205
+ recovery.fail(ticket.operationId, ticket.attemptId, failure.category);
206
+ } else if (!failure && ticket.operationId && ticket.attemptId) recovery.complete(ticket.operationId, ticket.attemptId);
207
+ const attempts = recovery.findContract(ticket.key)?.attempts;
208
+ const fenceIndex = latestEffectFenceIndex(attempts);
209
+ const fence = fenceIndex >= 0 ? attempts![fenceIndex] : undefined;
210
+ const retain = !!failure && NO_EFFECT_CATEGORY.has(failure.category) && !!fence?.category && !laterAttemptLaunched(attempts!, fenceIndex);
211
+ if (retain && fence?.category) {
212
+ const retained = retainedFenceFailure(fence, held?.failure);
213
+ const entry = { fingerprint: held?.fingerprint ?? fingerprint, failure: retained, authorized: false };
214
+ failures.set(ticket.key, entry);
215
+ if (retained.category === "operator_cancelled") cancellations.set(retained.dispatchId, { executorKey: ticket.executorKey, scope: held ? ticket.scope : ticket.scope, entry });
216
+ persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'failure', key: ticket.key, fingerprint: entry.fingerprint, failure: retained, executorKey: ticket.executorKey, scope: ticket.scope } satisfies GuardHistory });
217
+ return;
218
+ }
113
219
  if (failure) {
114
- if (ticket.operationId && ticket.attemptId) {
115
- recovery.bindDispatch(ticket.operationId, ticket.attemptId, failure.dispatchId);
116
- recovery.fail(ticket.operationId, ticket.attemptId, failure.category);
117
- }
118
220
  const entry = { fingerprint, failure, authorized: false };
119
221
  failures.set(ticket.key, entry);
120
222
  if (failure.category === "operator_cancelled") cancellations.set(failure.dispatchId, { executorKey: ticket.executorKey, scope: ticket.scope, entry });
121
- persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'failure', key: ticket.key, fingerprint, failure, executorKey: ticket.executorKey, scope: ticket.scope } satisfies GuardHistory });
122
- } else if (ticket.operationId && ticket.attemptId) recovery.complete(ticket.operationId, ticket.attemptId);
223
+ persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'failure', key: ticket.key, fingerprint, failure, executorKey: ticket.executorKey, scope: ticket.scope } satisfies GuardHistory });
224
+ }
123
225
  },
124
226
  /** Internal runtime port, not model input. Caller must retain an effects inspection artifact;
125
227
  * unchanged conditions still cannot retry or replay observed effects. */
@@ -132,6 +234,33 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
132
234
  return true;
133
235
  }
134
236
  return false;
237
+ },
238
+ /** Runtime-owned no-launch proof (T8). Frees a phantom preflight entry only with
239
+ * positive evidence of no process/dispatch/effects — never from missing records.
240
+ * Unknown-write/cancel/indeterminate-with-possible-effects are never freed here. */
241
+ establishNoLaunch(dispatchId: string, token: object, evidenceRef: string): boolean {
242
+ if (token !== generation || !evidenceRef.trim()) return false;
243
+ for (const [key, entry] of failures) {
244
+ if (entry.failure.dispatchId !== dispatchId) continue;
245
+ if (entry.failure.category !== "not_started" && entry.failure.category !== "invalid_input") return false;
246
+ entry.failure.noLaunchEstablished = true;
247
+ entry.failure.evidencePath = evidenceRef;
248
+ persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'no_launch', key, dispatchId, evidenceRef } satisfies GuardHistory });
249
+ return true;
250
+ }
251
+ return false;
252
+ },
253
+ /** Exact invocation availability (T6): missing/invalid/abandoned/unknown-process differ. */
254
+ invocationStatus(operationId: string): InvocationStatus {
255
+ const op = recovery.inspect(operationId);
256
+ if (!op) return { status: 'missing', reason: 'unknown_operation', nextActions: ['inspect the operation id', 're-establish the contract before dispatching'] };
257
+ if (op.abandoned) return { status: 'abandoned', reason: 'operation_abandoned', nextActions: ['abandon closed the operation; parent obligations remain open', 'start a new task for new work; do not replay the abandoned invocation'] };
258
+ const attempt = op.attempts.at(-1);
259
+ if (!attempt?.category) return { status: 'unknown_process', reason: 'pending_or_unknown_process', nextActions: ['settle the live process before recovery', 'independent inspection is allowed; replay is not'] };
260
+ const invocation = invocations.get(operationId);
261
+ if (!invocation) return { status: 'missing', reason: 'missing_original_runtime_invocation', nextActions: ['re-establish the validated contract', 'independent inspection is allowed; replay without a contract is not'] };
262
+ if (!validInvocation(invocation)) return { status: 'invalid', reason: 'invalid_original_invocation', nextActions: ['correct the invocation shape before dispatching'] };
263
+ return { status: 'available', invocation: structuredClone(invocation) };
135
264
  },
136
265
  establishToolStateChange(previousCatalogVersion: string, nextCatalogVersion: string, evidenceRef: string): number {
137
266
  if (!previousCatalogVersion || !nextCatalogVersion || previousCatalogVersion === nextCatalogVersion || !evidenceRef.trim()) return 0;
@@ -149,7 +278,7 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
149
278
  const rows = projectRecoveryRows(entries);
150
279
  persist?.(RECOVER_ENTRY, { kind: 'snapshot', rows: structuredClone(rows) });
151
280
  },
152
- restore(entries: readonly unknown[]) {
281
+ restore(entries: readonly unknown[], initialTaskId?: string) {
153
282
  const rows = projectRecoveryRows(entries);
154
283
  const ledger = rows.filter(row => row?.kind === 'ledger').map(row => row.event as RecoverEvent);
155
284
  const validated = createRecoverState(ledger, event => persist?.(RECOVER_ENTRY, { kind: 'ledger', event }));
@@ -157,18 +286,28 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
157
286
  const nextCancellations = new Map<string, { executorKey: string; scope: string[]; entry: RecordedFailure }>();
158
287
  const nextEvidence = new Map<string, DispatchEvidence>();
159
288
  const nextInvocations = new Map<string, NonNullable<GuardHistory['invocation']>>();
160
- let nextTaskId = taskId;
289
+ // Legacy pre-model sessions may have process additions but no dispatch,
290
+ // reset, or recovery event yet. Their sole persisted task binding is
291
+ // authoritative only when there is no recovery history to contradict it.
292
+ let nextTaskId = rows.length === 0 && initialTaskId ? initialTaskId : taskId;
161
293
  for (const row of rows.filter(row => row?.kind === 'guard')) {
162
294
  const event = row.event as GuardHistory;
163
295
  if (event.type === 'failure' && event.failure && event.key && event.fingerprint && event.executorKey && validated.byDispatch(event.failure.dispatchId)?.contract === event.key && validated.byDispatch(event.failure.dispatchId)?.executor === event.executorKey && validated.byDispatch(event.failure.dispatchId)?.attempts.some(a => a.dispatchId === event.failure!.dispatchId && a.category === event.failure!.category)) {
296
+ const existing = nextFailures.get(event.key);
297
+ const keepFence = existing && EFFECT_FENCE.has(existing.failure.category) && NO_EFFECT_CATEGORY.has(event.failure.category);
298
+ if (!keepFence) {
164
299
  const entry = { fingerprint: event.fingerprint, failure: event.failure, authorized: false };
165
300
  nextFailures.set(event.key, entry);
166
301
  if (event.failure.category === 'operator_cancelled') nextCancellations.set(event.failure.dispatchId, { executorKey: event.executorKey, scope: event.scope ?? [], entry });
302
+ }
167
303
  } else if (event.type === 'consume' && event.key && event.dispatchId && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId) {
168
304
  nextFailures.delete(event.key);
169
305
  for (const [id, item] of nextCancellations) if (item.entry.failure.dispatchId === event.dispatchId) nextCancellations.delete(id);
170
306
  } else if (event.type === 'authorize' && event.dispatchId && event.key && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId) {
171
307
  nextFailures.get(event.key)!.authorized = true;
308
+ } else if (event.type === 'no_launch' && event.dispatchId && event.key && event.evidenceRef && nextFailures.get(event.key)?.failure.dispatchId === event.dispatchId && (nextFailures.get(event.key)!.failure.category === 'not_started' || nextFailures.get(event.key)!.failure.category === 'invalid_input')) {
309
+ nextFailures.get(event.key)!.failure.noLaunchEstablished = true;
310
+ nextFailures.get(event.key)!.failure.evidencePath = event.evidenceRef;
172
311
  } else if (event.type === 'task' && event.taskId) {
173
312
  nextTaskId = event.taskId;
174
313
  } else if (event.type === 'invocation' && event.operationId && event.key && event.invocation && validated.inspect(event.operationId)?.contract === event.key && !nextInvocations.has(event.operationId) && validInvocation(event.invocation)) {
@@ -181,7 +320,19 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
181
320
  const latest = [...ledger].reverse().find(event => event.type === 'start');
182
321
  if (latest?.type === 'start') nextTaskId = latest.taskId;
183
322
  }
323
+ for (const operationId of new Set(validated.events().filter(event => event.type === 'start').map(event => event.operationId))) {
324
+ const op = validated.inspect(operationId);
325
+ const fenceIndex = latestEffectFenceIndex(op?.attempts);
326
+ if (!op || fenceIndex < 0 || laterAttemptLaunched(op.attempts, fenceIndex)) continue;
327
+ const current = nextFailures.get(op.contract);
328
+ if (current && EFFECT_FENCE.has(current.failure.category)) continue;
329
+ const failure = retainedFenceFailure(op.attempts[fenceIndex], current?.failure);
330
+ const entry = { fingerprint: current?.fingerprint ?? '', failure, authorized: false };
331
+ nextFailures.set(op.contract, entry);
332
+ if (failure.category === 'operator_cancelled') nextCancellations.set(failure.dispatchId, { executorKey: op.executor, scope: [], entry });
333
+ }
184
334
  recovery = validated; taskId = nextTaskId;
335
+ taskIdentityPersisted = rows.some(row => row?.kind === 'guard' && row.event?.type === 'task' && row.event.taskId === nextTaskId);
185
336
  failures.clear(); for (const [key, value] of nextFailures) failures.set(key, value);
186
337
  cancellations.clear(); for (const [key, value] of nextCancellations) cancellations.set(key, value);
187
338
  dispatchEvidence.clear(); for (const [key, value] of nextEvidence) dispatchEvidence.set(key, value);
@@ -227,6 +378,19 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
227
378
  const op = recovery.inspect(operationId), attempt = op?.attempts.at(-1);
228
379
  return !!op && op.taskId === taskId && !op.abandoned && attempt?.attemptId === attemptId && !!attempt.category && !pendingExecutors.has(op.executor) && (attempt.category === 'indeterminate' ? !!attempt.settled && !op.indeterminateGrantUsed : attempt.category === 'operator_cancelled' && !!cancellations.get(attempt.dispatchId) && !cancellations.get(attempt.dispatchId)!.entry.authorized);
229
380
  },
381
+ recordUserAnswer(input: { dispatchId: string; question: string; scope: string[]; prose?: string }): boolean {
382
+ const failure = [...failures.values()].find(entry => entry.failure.dispatchId === input.dispatchId && entry.failure.category === "blocked_on_user");
383
+ if (!failure || !input.question.trim() || userGrants.some(grant => grant.dispatchId === input.dispatchId && !grant.used && !grant.cancelled)) return false;
384
+ userGrants.push({ dispatchId: input.dispatchId, question: input.question.trim(), taskId, scope: [...input.scope], used: false, cancelled: false });
385
+ return true;
386
+ },
387
+ cancelUserAnswer(dispatchId: string): boolean {
388
+ const grant = userGrants.find(item => item.dispatchId === dispatchId && !item.used && !item.cancelled);
389
+ if (!grant) return false;
390
+ grant.cancelled = true;
391
+ return true;
392
+ },
393
+ userAnswerCapabilities() { return { filesystem: false, network: false, cloud: false, secrets: false } as const; },
230
394
  authorize(dispatchId: string): boolean {
231
395
  for (const { entry } of cancellations.values()) {
232
396
  if (entry.failure.dispatchId !== dispatchId || entry.authorized || entry.failure.category !== "operator_cancelled") continue;
@@ -238,7 +402,7 @@ export function createNoProgressGuard(persist?: (type: string, data: unknown) =>
238
402
  }
239
403
  return false;
240
404
  },
241
- adopt(id: string, persistIdentity = true) { /* A live process is never synthesized as completed during reset. */ pendingLineages.clear(); generation = {}; taskId = id; if (persistIdentity) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'task', taskId: id } satisfies GuardHistory }); pending.clear(); pendingExecutors.clear(); /* Preserve failure/fence lineage across task reset. */ },
405
+ adopt(id: string, persistIdentity = true) { /* A live process is never synthesized as completed during reset. */ pendingLineages.clear(); generation = {}; if (persistIdentity) persist?.(RECOVER_ENTRY, { kind: 'guard', event: { type: 'task', taskId: id } satisfies GuardHistory }); taskId = id; taskIdentityPersisted = persistIdentity; pending.clear(); pendingExecutors.clear(); /* Preserve failure/fence lineage across task reset. */ },
242
406
  reset(persistIdentity = true) { this.adopt(randomUUID(), persistIdentity); },
243
407
  };
244
408
  }
@@ -267,7 +431,9 @@ function canonical(value: unknown): string {
267
431
  return JSON.stringify(value);
268
432
  }
269
433
 
270
- /** Wording and scope_mode are intentionally absent: neither can manufacture changed execution conditions. */
434
+ /** Wording and scope_mode are intentionally absent: neither can manufacture changed execution conditions.
435
+ * Tier and tool-catalog revision ARE included: a tier correction (small→feature) or catalog
436
+ * change is a material prerequisite change that must unblock a not_started retry (T1). */
271
437
  export function withNoProgress<P extends DispatchAgentParams | SpawnResearchParams>(
272
438
  d: Pick<DispatchExecutorDeps, "noProgress" | "artifacts"> & Partial<Pick<DispatchExecutorDeps, "budget" | "state" | "getToolCatalogVersion">>,
273
439
  kind: "dispatch" | "research",
@@ -296,32 +462,65 @@ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchPara
296
462
  artifacts: artifactRevision(),
297
463
  structuredContract: research ? { readScope: research.readScope, goalDeclared: !!research.goal, expectedResultDeclared: !!research.expectedResult } : { scope, deliverables: contractIdentity },
298
464
  conditions,
465
+ // Authoritative prerequisite snapshot: tier/catalog changes unblock not_started.
466
+ // Task identity is deliberately excluded so reset cannot bypass cancel/unknown-write fences.
467
+ tier: (d as any).state?.getTaskTier?.() ?? null,
468
+ catalogVersion: (d as any).getToolCatalogVersion?.() ?? null,
299
469
  });
300
- const executorKey = canonical([resolve(cwd), actor]);
470
+ const executorKey = canonicalExecutor(cwd, actor);
471
+ const userAnswer = "agent" in params ? params.task.match(/^USER_ANSWER:\s*(\S+)\s*::\s*(.+)$/m) : null;
472
+ if (userAnswer) d.noProgress.recordUserAnswer({ dispatchId: userAnswer[1], question: userAnswer[2].trim(), scope, prose: params.task });
301
473
  const ticket = d.noProgress.begin(key, fingerprint(), executorKey, scope, worktreeRevision(cwd, []));
302
- if (ticket.allowed && ticket.operationId && !d.noProgress.invocation(ticket.operationId)) d.noProgress.recordInvocation(ticket.operationId, key, { tool: kind === 'dispatch' ? 'dispatch_agent' : 'spawn_research', params: structuredClone(params) });
474
+ // T2: invalid/unpersisted invocation refuses before launch with an exact reason.
475
+ // Concurrency, interrupted append, and restore never produce duplicate execution.
476
+ if (ticket.allowed && ticket.operationId) {
477
+ const invocation = { tool: kind === 'dispatch' ? 'dispatch_agent' : 'spawn_research', params: structuredClone(params) } as NonNullable<GuardHistory['invocation']>;
478
+ if (!validInvocation(invocation)) {
479
+ const invalidFailure: Failure = { dispatchId: randomUUID(), reason: 'invalid_invocation_shape', category: 'invalid_input' };
480
+ d.noProgress.finish(ticket, fingerprint(), invalidFailure);
481
+ return { content: [{ type: "text", text: `Invalid invocation shape: the original contract could not be persisted. Correct the parameters and re-invoke explicitly. No process launched and no effects occurred.` }], details: { status: "invalid_input", reason: "invalid_invocation_shape", recoveryCategory: "invalid_input" as const, exitCode: 1, started: false, notStarted: true, effects: "none" } };
482
+ }
483
+ if (!d.noProgress.invocation(ticket.operationId)) d.noProgress.recordInvocation(ticket.operationId, key, invocation);
484
+ }
303
485
  if (!ticket.allowed) {
304
486
  if (ticket.refusal === "busy") {
305
487
  const recovery = recoveryDecision("busy", { explicitInvocation: true, relevantConditionsChanged: false, executorIdle: false });
306
488
  return { content: [{ type: "text", text: "Busy refusal: the same operation is already in flight. Nothing was queued or retried. Re-invoke explicitly only after the executor is evidenced idle; existing budgets still apply." }], details: { status: "busy", reason: "busy", recoveryCategory: "busy", recovery, exitCode: 1, started: false } };
307
489
  }
308
- const failure = ticket.failure!;
490
+ // Defensive: a reservation failure without a recorded cause (e.g. concurrent
491
+ // start race) stays fail-closed and never synthesizes execution.
492
+ const failure = ticket.failure ?? { dispatchId: randomUUID(), reason: 'reservation_refused', category: 'indeterminate' as const };
309
493
  if (d.budget && d.state) {
310
494
  const b = d.budget, s = d.state;
311
495
  b.ensureTaskTier();
496
+ // T1/F7: refusals are accounted separately from physical launches.
497
+ // A no-progress refusal never spent a child execution, so it must not
498
+ // consume turn/task launch counters. Anti-loop protection stays in the
499
+ // guard (same fingerprint stays refused); budgets still fail closed.
312
500
  s.getTurnReport().refusals++; s.getSessionTotals().refusals++;
313
501
  const block = checkTaskBudget(kind, b.taskCounters(), b.currentTaskBudget(), b.taskActiveElapsedMs(), s.getTaskTier())
314
502
  ?? checkTurnBudget(kind, { dispatches: s.getTurnDispatchCount(), research: s.getTurnResearchCount() }, b.currentBudget(), b.turnBudgetActiveElapsedMs(), s.getTaskTier());
315
503
  if (block) return { content: [{ type: "text", text: block.message }], details: { status: "budget_refused", reason: block.reason, started: false, recoveryCategory: failure.category, exitCode: 1 } };
316
- if (kind === "dispatch") { s.setTurnDispatchCount(s.getTurnDispatchCount() + 1); s.setTaskDispatchCount(s.getTaskDispatchCount() + 1); s.getTurnReport().dispatches.push({ agent: actor, status: "no_progress_refused", elapsed: 0, billed: 0, out: 0 }); }
317
- else { s.setTurnResearchCount(s.getTurnResearchCount() + 1); s.setTaskResearchCount(s.getTaskResearchCount() + 1); s.getTurnReport().research++; }
318
504
  b.updateModeStatus();
319
505
  }
320
506
  const recovery = recoveryDecision(failure.category, { explicitInvocation: true });
321
507
  const operation = d.noProgress.byDispatch(failure.dispatchId);
322
508
  const attempt = operation?.attempts.find(a => a.dispatchId === failure.dispatchId);
323
509
  const rendered = operation && attempt && renderRecoverCommands(d.noProgress, operation.operationId, attempt.attemptId);
324
- const commands = rendered ? `Commands (subject to prerequisites): ${rendered}; legacy: /af-retry ${failure.dispatchId}. ${renderNextInvocation(d.noProgress, operation!.operationId) ? `Original-contract invocation after authorization: ${renderNextInvocation(d.noProgress, operation!.operationId)}.` : 'Original validated invocation unavailable.'} These commands do not start a dispatch.` : '';
510
+ // T6: missing/invalid/abandoned/unknown-process each get their own reason.
511
+ const invocationNote = (() => {
512
+ if (!operation) return 'Original validated invocation unavailable: unknown operation; re-establish the contract before dispatching.';
513
+ const status = (d.noProgress as any).invocationStatus?.(operation.operationId);
514
+ if (!status || status.status === 'available') {
515
+ const next = renderNextInvocation(d.noProgress, operation.operationId);
516
+ return next ? `Original-contract invocation after authorization: ${next}.` : 'Original validated invocation unavailable.';
517
+ }
518
+ if (status.status === 'abandoned') return 'Original invocation abandoned: abandon closed the operation and never satisfies parent work; start a new task for new work.';
519
+ if (status.status === 'unknown_process') return 'Original validated invocation unavailable: pending or unknown process; settle before recovery. Independent inspection is allowed.';
520
+ if (status.status === 'invalid') return 'Original invocation invalid: correct the invocation shape before dispatching.';
521
+ return 'Original validated invocation unavailable: missing contract; re-establish the contract before dispatching. Independent inspection is allowed.';
522
+ })();
523
+ const commands = rendered ? `Commands (subject to prerequisites): ${rendered}; legacy: /af-retry ${failure.dispatchId}. ${invocationNote} These commands do not start a dispatch.` : '';
325
524
  const authorization = failure.category === "operator_cancelled"
326
525
  ? `Fresh one-use authorization is required. Scope mode, model, and prose changes are not authorization. ${commands}`
327
526
  : `${recovery.reason} ${commands}`;
@@ -334,6 +533,9 @@ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchPara
334
533
  const details = result.details as any;
335
534
  const category = recoveryCategoryFromDetails(details);
336
535
  // A busy refusal never started work, so it must not become no-progress history.
536
+ // A runtime-owned not_started refusal DID reach the guard reservation but never
537
+ // launched: record it as not_started (0 launches, 0 indeterminate) so a corrected
538
+ // prerequisite can proceed without reset, grant, or reconcile.
337
539
  if (category && category !== "busy") failure = {
338
540
  dispatchId: details.dispatchId ?? randomUUID(),
339
541
  evidencePath: details.evidencePath ?? details.failurePath ?? details.protocolEvidencePath ?? undefined,
@@ -347,8 +549,10 @@ export function withNoProgress<P extends DispatchAgentParams | SpawnResearchPara
347
549
  throw error;
348
550
  } finally {
349
551
  d.noProgress.finish(ticket, fingerprint(), failure);
350
- if (failure?.category === 'indeterminate' && ticket.operationId && ticket.attemptId && result?.details?.pending !== true && Number.isInteger(result?.details?.exitCode) && result?.details?.dispatchId) {
351
- d.noProgress.settle(ticket.operationId, ticket.attemptId, `runtime-exit:${result.details.dispatchId}:${result.details.exitCode}`);
552
+ // T4: integer exit + dispatchId is not settlement. Missing lifecycle stays unsettled.
553
+ const lifecycle = explicitProcessLifecycle((result?.details as any)?.lifecycle);
554
+ if (failure?.category === 'indeterminate' && ticket.operationId && ticket.attemptId && result?.details?.pending !== true && lifecycle?.launched === true && lifecycle.closeSeen === true) {
555
+ d.noProgress.settle(ticket.operationId, ticket.attemptId, `runtime-lifecycle:${result.details.dispatchId}:launched:${lifecycle.launched}:closeSeen:${lifecycle.closeSeen}`);
352
556
  }
353
557
  const effectsRef = (result?.details as any)?.protocolEffectsEvidenceRef;
354
558
  if (failure?.category === "tool_protocol_error" && typeof effectsRef === "string") {
@@ -0,0 +1,112 @@
1
+ import { buildEvidenceManifest } from "./evidence-manifest.ts";
2
+ import { selectSpecialists } from "./orchestration-route.ts";
3
+ import { recordRoutingObservation } from "./routing-observation.ts";
4
+ import { closeReview } from "./review-closure.ts";
5
+ import { chooseReviewerRerun } from "./rerun-policy.ts";
6
+
7
+ export function activeOrchestrationHandoff(input: {
8
+ agent: string;
9
+ task: string;
10
+ scope: string[];
11
+ revision: string;
12
+ changes: string[];
13
+ exitCode: number;
14
+ command?: string;
15
+ testsExecuted?: number;
16
+ model?: string;
17
+ elapsedMs?: number;
18
+ questions: string[];
19
+ evidenceRefs: string[];
20
+ approvedPlan: boolean;
21
+ risk: "low" | "high";
22
+ scopeBreadth: "narrow" | "wide";
23
+ sharedCode: boolean;
24
+ }) {
25
+ const route = selectSpecialists({
26
+ scopeBreadth: input.scopeBreadth,
27
+ risk: input.risk,
28
+ reversible: true,
29
+ approvedPlan: input.approvedPlan,
30
+ unresolvedForks: input.questions,
31
+ selfDeclaredSmall: /small/i.test(input.task),
32
+ }, { secret: /secret|credential/i.test(input.task), cloud: /\b(cloud|aws)\b/i.test(input.task) });
33
+ const manifest = buildEvidenceManifest({
34
+ revision: input.revision || "unknown",
35
+ scope: input.scope,
36
+ changes: input.changes,
37
+ commands: input.command ? [{ command: input.command, exitCode: input.exitCode }] : [],
38
+ tests: { executed: input.testsExecuted ?? 0, passed: 0, failed: 0 },
39
+ evidenceRefs: input.evidenceRefs,
40
+ openAssertions: input.questions,
41
+ observedRevision: input.revision || "unknown",
42
+ });
43
+ const closure = closeReview({
44
+ revision: input.revision || "unknown",
45
+ scope: input.scope,
46
+ prose: input.agent.includes("review") ? "PASS" : "",
47
+ origin: input.evidenceRefs.length ? "declared" : "missing",
48
+ structuredReturn: input.evidenceRefs.length ? { verdict: "PASS", evidenceRefs: input.evidenceRefs } : undefined,
49
+ });
50
+ const rerun = chooseReviewerRerun({
51
+ impact: input.scopeBreadth === "wide" ? "wide" : "narrow",
52
+ sharedCode: input.sharedCode,
53
+ selector: input.scope[0] ?? "",
54
+ flaky: false,
55
+ policyMandate: false,
56
+ builderPassed: input.exitCode === 0,
57
+ reviewerRan: input.agent.includes("review"),
58
+ });
59
+ const observation = recordRoutingObservation({
60
+ taskClass: route.stages.join("-"),
61
+ model: input.model ?? "unknown",
62
+ wallMs: input.elapsedMs ?? 0,
63
+ retries: 0,
64
+ refusals: 0,
65
+ contractCompliant: closure.status !== "unproven",
66
+ accepted: closure.status === "closed",
67
+ });
68
+ return { route, manifest, closure, rerun, observation, routingChanged: false as const };
69
+ }
70
+
71
+ const REVIEWERS = new Set(["code-reviewer", "plan-reviewer", "security-auditor"]);
72
+
73
+ export function plannerRequiredRefusal(task: string, agent: string, state?: { scope?: string; risk?: string; plan?: { evidenceRef?: string | null } }): string | null {
74
+ if (agent === "planner" || REVIEWERS.has(agent)) return null;
75
+ const secret = /secret|credential/i.test(task);
76
+ const cloud = /\b(cloud|aws)\b/i.test(task);
77
+ const approvedPlan = !!state?.plan?.evidenceRef;
78
+ const highWithoutPlan = state?.risk === "high" && !approvedPlan;
79
+ if (!secret && !cloud && !highWithoutPlan) return null;
80
+ const decision = selectSpecialists({
81
+ scopeBreadth: state?.scope === "wide" ? "wide" : "narrow",
82
+ risk: state?.risk === "high" ? "high" : "low",
83
+ reversible: true,
84
+ approvedPlan,
85
+ unresolvedForks: [],
86
+ selfDeclaredSmall: state?.scope === "small" || /small/i.test(task),
87
+ }, { secret, cloud });
88
+ return decision.stages[0] === "planner" ? decision.reason : null;
89
+ }
90
+
91
+ export function reviewMayClose(input: { revision: string; scope: string[]; output: string; evidenceRef?: string; declared: boolean; wide: boolean }): boolean {
92
+ const rerun = chooseReviewerRerun({
93
+ impact: input.wide ? "wide" : "narrow",
94
+ sharedCode: input.wide,
95
+ selector: input.scope[0] ?? "",
96
+ flaky: false,
97
+ policyMandate: false,
98
+ builderPassed: true,
99
+ reviewerRan: true,
100
+ });
101
+ if (!rerun.accepted) return false;
102
+ if (rerun.mode === "full" && !/full regression|tests_run:\s*full/i.test(input.output)) return false;
103
+ return closeReview({
104
+ revision: input.revision,
105
+ scope: input.scope,
106
+ prose: input.output,
107
+ origin: input.declared ? "declared" : input.evidenceRef ? "extracted" : "missing",
108
+ structuredReturn: /APPROVE/i.test(input.output) ? { verdict: "PASS", evidenceRefs: input.evidenceRef ? [input.evidenceRef] : [] } : undefined,
109
+ evidenceComplete: !!input.evidenceRef,
110
+ evidenceRevision: input.revision,
111
+ }).status === "closed";
112
+ }
@@ -0,0 +1,78 @@
1
+ export type UnknownMetric = "unknown";
2
+
3
+ export interface TimingFields {
4
+ orchestrationMs: number | UnknownMetric;
5
+ modelMs: number | UnknownMetric;
6
+ toolTestMs: number | UnknownMetric;
7
+ waitMs: number | UnknownMetric;
8
+ }
9
+
10
+ export interface TestRunRecord {
11
+ suiteId: string;
12
+ selector: string;
13
+ executed: number;
14
+ passed: number;
15
+ failed: number;
16
+ claimed?: "pass" | "fail";
17
+ result?: "pass" | "fail" | "skipped" | "indeterminate";
18
+ fabricated?: boolean;
19
+ testIds?: string[];
20
+ }
21
+
22
+ export interface SessionBaseline {
23
+ specialistWallMs: number;
24
+ humanWaitExcluded: true;
25
+ timings: TimingFields;
26
+ runs: TestRunRecord[];
27
+ }
28
+
29
+ export interface CoverageReport {
30
+ runs: number;
31
+ executions: number;
32
+ unique: number | UnknownMetric;
33
+ overlap: number | UnknownMetric;
34
+ }
35
+
36
+ /** Observed P2.3 specialist wall time. Splits were not measured and stay unknown. */
37
+ export function p23Baseline(): SessionBaseline {
38
+ return {
39
+ specialistWallMs: 2799,
40
+ humanWaitExcluded: true,
41
+ timings: {
42
+ orchestrationMs: "unknown",
43
+ modelMs: "unknown",
44
+ toolTestMs: "unknown",
45
+ waitMs: "unknown",
46
+ },
47
+ runs: [
48
+ { suiteId: "focused", selector: "adapter", executed: 69, passed: 69, failed: 0, claimed: "pass" },
49
+ { suiteId: "regression", selector: "adapter-regression", executed: 141, passed: 141, failed: 0, claimed: "pass" },
50
+ ],
51
+ };
52
+ }
53
+
54
+ export function uniqueCoverage(runs: TestRunRecord[]): CoverageReport {
55
+ const executions = runs.reduce((sum, run) => sum + run.executed, 0);
56
+ const identified = runs.every(run => Array.isArray(run.testIds) && run.testIds.length === run.executed);
57
+ if (!identified) return { runs: runs.length, executions, unique: "unknown", overlap: "unknown" };
58
+ const seen = new Map<string, number>();
59
+ for (const run of runs) for (const id of run.testIds ?? []) seen.set(id, (seen.get(id) ?? 0) + 1);
60
+ const unique = seen.size;
61
+ const overlap = [...seen.values()].filter(count => count > 1).length;
62
+ return { runs: runs.length, executions, unique, overlap };
63
+ }
64
+
65
+ export function recordTestRun(record: TestRunRecord): TestRunRecord {
66
+ return { ...record, testIds: record.testIds ? [...record.testIds] : undefined };
67
+ }
68
+
69
+ export function acceptTestEvidence(record: TestRunRecord | undefined): { ok: true } | { ok: false; reason: string } {
70
+ if (!record || !record.suiteId || !record.selector || typeof record.executed !== "number") {
71
+ return { ok: false, reason: "missing test-run evidence" };
72
+ }
73
+ if (record.fabricated) return { ok: false, reason: "fabricated test evidence" };
74
+ if (record.result === "skipped" || record.result === "indeterminate") return { ok: false, reason: `${record.result} run is not success` };
75
+ if (record.claimed === "pass" && record.executed === 0) return { ok: false, reason: "zero-test run is not success" };
76
+ if (record.claimed === "pass" && record.passed !== record.executed) return { ok: false, reason: "pass claim does not match executed count" };
77
+ return { ok: true };
78
+ }