@chankov/agent-fleet 2.0.14 → 2.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (617) hide show
  1. package/.pi/agent-fleet/scripts/fleet.ts +2 -1
  2. package/.pi/extensions/compact-and-continue/README.md +2 -2
  3. package/.pi/harnesses/agent-hub/README.md +89 -10
  4. package/.pi/harnesses/agent-hub/budget-recovery.ts +2 -2
  5. package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
  6. package/.pi/harnesses/agent-hub/commands/recover.ts +13 -4
  7. package/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  8. package/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  9. package/.pi/harnesses/agent-hub/context/budgets.ts +9 -7
  10. package/.pi/harnesses/agent-hub/deterministic-fs.ts +51 -12
  11. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +4 -0
  12. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +14 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +3 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native.ts +9 -1
  15. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +2 -1
  16. package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +2 -0
  17. package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +23 -5
  18. package/.pi/harnesses/agent-hub/docs-lane.js +2 -1
  19. package/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  20. package/.pi/harnesses/agent-hub/filesystem-tool.ts +75 -11
  21. package/.pi/harnesses/agent-hub/index.ts +246 -19
  22. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +13 -5
  23. package/.pi/harnesses/agent-hub/no-progress.ts +232 -28
  24. package/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  25. package/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  26. package/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  27. package/.pi/harnesses/agent-hub/package.json +1 -1
  28. package/.pi/harnesses/agent-hub/policy/work-mode.ts +14 -5
  29. package/.pi/harnesses/agent-hub/process-obligations.ts +116 -15
  30. package/.pi/harnesses/agent-hub/prompts/fragments.ts +9 -11
  31. package/.pi/harnesses/agent-hub/recover-policy.ts +18 -1
  32. package/.pi/harnesses/agent-hub/recover-state.ts +1 -1
  33. package/.pi/harnesses/agent-hub/recovery-contract.ts +70 -0
  34. package/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  35. package/.pi/harnesses/agent-hub/research/runtime.ts +2 -0
  36. package/.pi/harnesses/agent-hub/research/spawn-run.ts +15 -6
  37. package/.pi/harnesses/agent-hub/return-contract.js +27 -5
  38. package/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  39. package/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  40. package/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  41. package/.pi/harnesses/agent-hub/run-budget.js +12 -0
  42. package/.pi/harnesses/agent-hub/scope-gate.js +23 -2
  43. package/.pi/harnesses/agent-hub/session-audit.ts +94 -8
  44. package/.pi/harnesses/agent-hub/spawn.ts +10 -2
  45. package/.pi/harnesses/agent-hub/system1-activity.ts +116 -1
  46. package/.pi/harnesses/agent-hub/system1-communication-store.ts +47 -13
  47. package/.pi/harnesses/agent-hub/system1-report.ts +50 -0
  48. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -2
  49. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  50. package/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
  51. package/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
  52. package/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  53. package/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  54. package/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  55. package/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  56. package/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  57. package/.pi/harnesses/agent-hub/tools/action-executors.ts +33 -10
  58. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  59. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +86 -26
  60. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +9 -0
  61. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +9 -6
  62. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +6 -2
  63. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  64. package/.pi/harnesses/agent-hub/work-mode.ts +13 -8
  65. package/.pi/harnesses/coms/package.json +1 -1
  66. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  67. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +6 -1
  68. package/.pi/harnesses/lib/fleet-dashboard-view.ts +29 -4
  69. package/.pi/harnesses/lib/fleet-read-model.ts +73 -0
  70. package/.pi/harnesses/lib/system1/demo.ts +2 -4
  71. package/.pi/harnesses/lib/system1/selection.js +11 -0
  72. package/.pi/prompts/af-build.md +9 -6
  73. package/.versions/2.0.15/.pi/agent-fleet/hermes/README.md +347 -0
  74. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  75. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  76. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  77. package/.versions/2.0.15/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  78. package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  79. package/.versions/2.0.15/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  80. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  81. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  82. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  83. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  84. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  85. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  86. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  87. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  88. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  89. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  90. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  91. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  92. package/.versions/2.0.15/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  93. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  94. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  95. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  96. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  97. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  98. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  99. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  100. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  101. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  102. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  103. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  104. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  105. package/.versions/2.0.15/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  106. package/.versions/2.0.15/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  107. package/.versions/2.0.15/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  108. package/.versions/2.0.15/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  109. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  110. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  111. package/.versions/2.0.15/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  112. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  113. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  114. package/.versions/2.0.15/.pi/agent-fleet/scripts/fleet.ts +217 -0
  115. package/.versions/2.0.15/.pi/agent-fleet/scripts/flow.ts +157 -0
  116. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  117. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  118. package/.versions/2.0.15/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  119. package/.versions/2.0.15/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  120. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  121. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  122. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  123. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  124. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  125. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  126. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  127. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  128. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  129. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  130. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  131. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  132. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  133. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  134. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  135. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  136. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  137. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  138. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  139. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  140. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  141. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  142. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  143. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  144. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  145. package/.versions/2.0.15/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  146. package/.versions/2.0.15/.pi/agent-fleet/scripts/package-lock.json +35 -0
  147. package/.versions/2.0.15/.pi/agent-fleet/scripts/package.json +9 -0
  148. package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  149. package/.versions/2.0.15/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  150. package/.versions/2.0.15/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  151. package/.versions/2.0.15/.pi/agent-fleet/scripts/team-up.ts +378 -0
  152. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  153. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  154. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  155. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  156. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  157. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  158. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  159. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  160. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  161. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  162. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  163. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  164. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  165. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  166. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  167. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  168. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  169. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  170. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  171. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  172. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  173. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  174. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  175. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  176. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  177. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  178. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  179. package/.versions/2.0.15/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  180. package/.versions/2.0.15/.pi/agents/dispatch-policy.yaml +32 -0
  181. package/.versions/2.0.15/.pi/agents/model-profiles.yaml +134 -0
  182. package/.versions/2.0.15/.pi/agents/peers.yaml +147 -0
  183. package/.versions/2.0.15/.pi/agents/teams.yaml +41 -0
  184. package/.versions/2.0.15/.pi/agents/voices.yaml +13 -0
  185. package/.versions/2.0.15/.pi/damage-control-rules.yaml +297 -0
  186. package/.versions/2.0.15/.pi/extensions/btw/README.md +120 -0
  187. package/.versions/2.0.15/.pi/extensions/btw/index.ts +914 -0
  188. package/.versions/2.0.15/.pi/extensions/btw/package.json +6 -0
  189. package/.versions/2.0.15/.pi/extensions/btw/state.js +179 -0
  190. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  191. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  192. package/.versions/2.0.15/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  193. package/.versions/2.0.15/.pi/extensions/compact-and-continue/README.md +42 -0
  194. package/.versions/2.0.15/.pi/extensions/compact-and-continue/index.ts +120 -0
  195. package/.versions/2.0.15/.pi/extensions/compact-and-continue/package.json +6 -0
  196. package/.versions/2.0.15/.pi/extensions/mcp-bridge/README.md +46 -0
  197. package/.versions/2.0.15/.pi/extensions/mcp-bridge/index.ts +206 -0
  198. package/.versions/2.0.15/.pi/extensions/mcp-bridge/package.json +6 -0
  199. package/.versions/2.0.15/.pi/extensions/package-lock.json +1175 -0
  200. package/.versions/2.0.15/.pi/extensions/package.json +9 -0
  201. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/README.md +224 -0
  202. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/config.ts +198 -0
  203. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  204. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/index.ts +248 -0
  205. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/package.json +6 -0
  206. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  207. package/.versions/2.0.15/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  208. package/.versions/2.0.15/.pi/harnesses/agent-hub/README.md +1448 -0
  209. package/.versions/2.0.15/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  210. package/.versions/2.0.15/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  211. package/.versions/2.0.15/.pi/harnesses/agent-hub/artifacts.js +146 -0
  212. package/.versions/2.0.15/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  213. package/.versions/2.0.15/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  214. package/.versions/2.0.15/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  215. package/.versions/2.0.15/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  216. package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  217. package/.versions/2.0.15/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  218. package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  219. package/.versions/2.0.15/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  220. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  221. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  222. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  223. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  224. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  225. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  226. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  227. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  228. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  229. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  230. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  231. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  232. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  233. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  234. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  235. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  236. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  237. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  238. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  239. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  240. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  241. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  242. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  243. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  244. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  245. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  246. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  247. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  248. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  249. package/.versions/2.0.15/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  250. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  251. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  252. package/.versions/2.0.15/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  253. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  254. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  255. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  256. package/.versions/2.0.15/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  257. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  258. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  259. package/.versions/2.0.15/.pi/harnesses/agent-hub/context-window.js +108 -0
  260. package/.versions/2.0.15/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  261. package/.versions/2.0.15/.pi/harnesses/agent-hub/delegate.ts +467 -0
  262. package/.versions/2.0.15/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
  263. package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  264. package/.versions/2.0.15/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  265. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  266. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  267. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  268. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
  269. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  270. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
  271. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  272. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  273. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  274. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +76 -0
  275. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  276. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  277. package/.versions/2.0.15/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  278. package/.versions/2.0.15/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  279. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  280. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  281. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  282. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  283. package/.versions/2.0.15/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  284. package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  285. package/.versions/2.0.15/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  286. package/.versions/2.0.15/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  287. package/.versions/2.0.15/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  288. package/.versions/2.0.15/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
  289. package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/registration-surface.json +64 -0
  290. package/.versions/2.0.15/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  291. package/.versions/2.0.15/.pi/harnesses/agent-hub/footer.ts +30 -0
  292. package/.versions/2.0.15/.pi/harnesses/agent-hub/helpers.ts +270 -0
  293. package/.versions/2.0.15/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  294. package/.versions/2.0.15/.pi/harnesses/agent-hub/index.ts +2597 -0
  295. package/.versions/2.0.15/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  296. package/.versions/2.0.15/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  297. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  298. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  299. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  300. package/.versions/2.0.15/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  301. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  302. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  303. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  304. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  305. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  306. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  307. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  308. package/.versions/2.0.15/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  309. package/.versions/2.0.15/.pi/harnesses/agent-hub/no-progress.ts +563 -0
  310. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  311. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  312. package/.versions/2.0.15/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  313. package/.versions/2.0.15/.pi/harnesses/agent-hub/package.json +7 -0
  314. package/.versions/2.0.15/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  315. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  316. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  317. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  318. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  319. package/.versions/2.0.15/.pi/harnesses/agent-hub/policy/work-mode.ts +135 -0
  320. package/.versions/2.0.15/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  321. package/.versions/2.0.15/.pi/harnesses/agent-hub/presentation.ts +48 -0
  322. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  323. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  324. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  325. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  326. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  327. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  328. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  329. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  330. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  331. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  332. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  333. package/.versions/2.0.15/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  334. package/.versions/2.0.15/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  335. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  336. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/fragments.ts +116 -0
  337. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  338. package/.versions/2.0.15/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  339. package/.versions/2.0.15/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  340. package/.versions/2.0.15/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  341. package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  342. package/.versions/2.0.15/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  343. package/.versions/2.0.15/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  344. package/.versions/2.0.15/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  345. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  346. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
  347. package/.versions/2.0.15/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
  348. package/.versions/2.0.15/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  349. package/.versions/2.0.15/.pi/harnesses/agent-hub/return-contract.js +349 -0
  350. package/.versions/2.0.15/.pi/harnesses/agent-hub/return-extract.js +77 -0
  351. package/.versions/2.0.15/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  352. package/.versions/2.0.15/.pi/harnesses/agent-hub/review-findings.js +104 -0
  353. package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  354. package/.versions/2.0.15/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  355. package/.versions/2.0.15/.pi/harnesses/agent-hub/run-budget.js +554 -0
  356. package/.versions/2.0.15/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  357. package/.versions/2.0.15/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  358. package/.versions/2.0.15/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  359. package/.versions/2.0.15/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  360. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  361. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-health.js +110 -0
  362. package/.versions/2.0.15/.pi/harnesses/agent-hub/session-start.ts +42 -0
  363. package/.versions/2.0.15/.pi/harnesses/agent-hub/spawn.ts +534 -0
  364. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  365. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-communication-store.ts +129 -0
  366. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  367. package/.versions/2.0.15/.pi/harnesses/agent-hub/system1-runtime.ts +280 -0
  368. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  369. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  370. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-config.ts +37 -0
  371. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-contract.ts +19 -0
  372. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  373. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-live-stage-closure.user-run.mjs +336 -0
  374. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  375. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  376. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  377. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  378. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  379. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs +157 -0
  380. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  381. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  382. package/.versions/2.0.15/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  383. package/.versions/2.0.15/.pi/harnesses/agent-hub/timeline.ts +72 -0
  384. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  385. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  386. package/.versions/2.0.15/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  387. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
  388. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  389. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  390. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  391. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
  392. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  393. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  394. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  395. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  396. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  397. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  398. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  399. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  400. package/.versions/2.0.15/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  401. package/.versions/2.0.15/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  402. package/.versions/2.0.15/.pi/harnesses/agent-hub/types.ts +66 -0
  403. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  404. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  405. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  406. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  407. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  408. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  409. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  410. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  411. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  412. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  413. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  414. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  415. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  416. package/.versions/2.0.15/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  417. package/.versions/2.0.15/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  418. package/.versions/2.0.15/.pi/harnesses/agent-hub/version.ts +42 -0
  419. package/.versions/2.0.15/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  420. package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  421. package/.versions/2.0.15/.pi/harnesses/agent-hub/work-mode.ts +179 -0
  422. package/.versions/2.0.15/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  423. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/README.md +59 -0
  424. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/index.ts +558 -0
  425. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  426. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  427. package/.versions/2.0.15/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  428. package/.versions/2.0.15/.pi/harnesses/coms/README.md +100 -0
  429. package/.versions/2.0.15/.pi/harnesses/coms/index.ts +282 -0
  430. package/.versions/2.0.15/.pi/harnesses/coms/package.json +7 -0
  431. package/.versions/2.0.15/.pi/harnesses/coms/version.ts +42 -0
  432. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/README.md +135 -0
  433. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/index.ts +550 -0
  434. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/package.json +7 -0
  435. package/.versions/2.0.15/.pi/harnesses/damage-control-continue/version.ts +42 -0
  436. package/.versions/2.0.15/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  437. package/.versions/2.0.15/.pi/harnesses/lib/coms-core-io.ts +385 -0
  438. package/.versions/2.0.15/.pi/harnesses/lib/coms-core.ts +577 -0
  439. package/.versions/2.0.15/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  440. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  441. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  442. package/.versions/2.0.15/.pi/harnesses/lib/context-budget-view.ts +107 -0
  443. package/.versions/2.0.15/.pi/harnesses/lib/context-budget.ts +114 -0
  444. package/.versions/2.0.15/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  445. package/.versions/2.0.15/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  446. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  447. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  448. package/.versions/2.0.15/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  449. package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  450. package/.versions/2.0.15/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  451. package/.versions/2.0.15/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  452. package/.versions/2.0.15/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  453. package/.versions/2.0.15/.pi/harnesses/lib/fleet-panel.ts +34 -0
  454. package/.versions/2.0.15/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  455. package/.versions/2.0.15/.pi/harnesses/lib/fleet-selection.ts +24 -0
  456. package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  457. package/.versions/2.0.15/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  458. package/.versions/2.0.15/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  459. package/.versions/2.0.15/.pi/harnesses/lib/herdr-client.ts +472 -0
  460. package/.versions/2.0.15/.pi/harnesses/lib/herdr-presence.ts +399 -0
  461. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  462. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  463. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  464. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  465. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  466. package/.versions/2.0.15/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  467. package/.versions/2.0.15/.pi/harnesses/lib/spawned-peers.js +191 -0
  468. package/.versions/2.0.15/.pi/harnesses/lib/system1/config.js +61 -0
  469. package/.versions/2.0.15/.pi/harnesses/lib/system1/contracts.ts +152 -0
  470. package/.versions/2.0.15/.pi/harnesses/lib/system1/demo.ts +104 -0
  471. package/.versions/2.0.15/.pi/harnesses/lib/system1/jev.ts +503 -0
  472. package/.versions/2.0.15/.pi/harnesses/lib/system1/selection.js +11 -0
  473. package/.versions/2.0.15/.pi/harnesses/lib/system1/service.ts +245 -0
  474. package/.versions/2.0.15/.pi/harnesses/lib/update-check.ts +222 -0
  475. package/.versions/2.0.15/.pi/harnesses/package-lock.json +2039 -0
  476. package/.versions/2.0.15/.pi/harnesses/package.json +10 -0
  477. package/.versions/2.0.15/.pi/prompts/af-build.md +27 -0
  478. package/.versions/2.0.15/.pi/prompts/af-code-simplify.md +22 -0
  479. package/.versions/2.0.15/.pi/prompts/af-constraints.md +31 -0
  480. package/.versions/2.0.15/.pi/prompts/af-plan.md +17 -0
  481. package/.versions/2.0.15/.pi/prompts/af-review.md +16 -0
  482. package/.versions/2.0.15/.pi/prompts/af-set-hermes-telegram.md +15 -0
  483. package/.versions/2.0.15/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  484. package/.versions/2.0.15/.pi/prompts/af-setup-rules.md +20 -0
  485. package/.versions/2.0.15/.pi/prompts/af-ship.md +17 -0
  486. package/.versions/2.0.15/.pi/prompts/af-spec.md +15 -0
  487. package/.versions/2.0.15/.pi/prompts/af-test.md +19 -0
  488. package/.versions/2.0.15/.pi/skills/bowser/SKILL.md +145 -0
  489. package/.versions/2.0.15/.version +1 -0
  490. package/.versions/2.0.15/agents/architect.md +24 -0
  491. package/.versions/2.0.15/agents/bowser.md +28 -0
  492. package/.versions/2.0.15/agents/builder.md +55 -0
  493. package/.versions/2.0.15/agents/code-reviewer.md +209 -0
  494. package/.versions/2.0.15/agents/deep-researcher.md +32 -0
  495. package/.versions/2.0.15/agents/documenter.md +22 -0
  496. package/.versions/2.0.15/agents/orchestrator.md +22 -0
  497. package/.versions/2.0.15/agents/plan-reviewer.md +83 -0
  498. package/.versions/2.0.15/agents/planner.md +105 -0
  499. package/.versions/2.0.15/agents/releaser.md +24 -0
  500. package/.versions/2.0.15/agents/researcher.md +30 -0
  501. package/.versions/2.0.15/agents/security-auditor.md +167 -0
  502. package/.versions/2.0.15/agents/test-engineer.md +153 -0
  503. package/.versions/2.0.15/agents/web-debugger.md +44 -0
  504. package/.versions/2.0.15/agents/web-performance-auditor.md +194 -0
  505. package/.versions/2.0.15/bin/catalog/harness-runtime-closure.json +73 -0
  506. package/.versions/2.0.15/codex/fleet-session-client/SKILL.md +34 -0
  507. package/.versions/2.0.15/codex/fleet-session-client.zip +0 -0
  508. package/.versions/2.0.15/docs/ARCHITECTURE.md +829 -0
  509. package/.versions/2.0.15/docs/agent-fleet-setup.md +1090 -0
  510. package/.versions/2.0.15/docs/claude-code-coms-bridge.md +134 -0
  511. package/.versions/2.0.15/docs/codex-session-bridge.md +219 -0
  512. package/.versions/2.0.15/docs/coms-hermes-bridge.md +188 -0
  513. package/.versions/2.0.15/docs/getting-started.md +126 -0
  514. package/.versions/2.0.15/docs/npm-install.md +525 -0
  515. package/.versions/2.0.15/docs/pi-extensions.md +454 -0
  516. package/.versions/2.0.15/docs/pi-setup.md +92 -0
  517. package/.versions/2.0.15/docs/skill-anatomy.md +150 -0
  518. package/.versions/2.0.15/install-manifest.json +3193 -0
  519. package/.versions/2.0.15/justfile +247 -0
  520. package/.versions/2.0.15/manifest-meta.json +1071 -0
  521. package/.versions/2.0.15/references/accessibility-checklist.md +160 -0
  522. package/.versions/2.0.15/references/communication-contract.md +26 -0
  523. package/.versions/2.0.15/references/definition-of-done.md +67 -0
  524. package/.versions/2.0.15/references/fleet-coordination-patterns.md +171 -0
  525. package/.versions/2.0.15/references/observability-checklist.md +92 -0
  526. package/.versions/2.0.15/references/orchestration-patterns.md +370 -0
  527. package/.versions/2.0.15/references/performance-checklist.md +236 -0
  528. package/.versions/2.0.15/references/prompting-patterns.md +380 -0
  529. package/.versions/2.0.15/references/security-checklist.md +245 -0
  530. package/.versions/2.0.15/references/testing-patterns.md +235 -0
  531. package/.versions/2.0.15/references/workflow-authoring.md +304 -0
  532. package/.versions/2.0.15/skills/_internal/grilling.md +59 -0
  533. package/.versions/2.0.15/skills/browser-testing-with-devtools/SKILL.md +351 -0
  534. package/.versions/2.0.15/skills/code-review-and-quality/SKILL.md +396 -0
  535. package/.versions/2.0.15/skills/compound-learning/SKILL.md +137 -0
  536. package/.versions/2.0.15/skills/constraint-driven-development/SKILL.md +338 -0
  537. package/.versions/2.0.15/skills/constraint-driven-development/references/floor-guard.md +99 -0
  538. package/.versions/2.0.15/skills/context-engineering/SKILL.md +341 -0
  539. package/.versions/2.0.15/skills/deprecation-and-migration/SKILL.md +247 -0
  540. package/.versions/2.0.15/skills/designing-agents/SKILL.md +394 -0
  541. package/.versions/2.0.15/skills/designing-agents/pi-harness-authoring.md +222 -0
  542. package/.versions/2.0.15/skills/drafting-workflows/SKILL.md +143 -0
  543. package/.versions/2.0.15/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  544. package/.versions/2.0.15/skills/frontend-ui-engineering/SKILL.md +328 -0
  545. package/.versions/2.0.15/skills/git-workflow-and-versioning/SKILL.md +316 -0
  546. package/.versions/2.0.15/skills/idea-refine/SKILL.md +182 -0
  547. package/.versions/2.0.15/skills/idea-refine/examples.md +238 -0
  548. package/.versions/2.0.15/skills/idea-refine/frameworks.md +99 -0
  549. package/.versions/2.0.15/skills/idea-refine/refinement-criteria.md +113 -0
  550. package/.versions/2.0.15/skills/idea-refine/scripts/idea-refine.sh +15 -0
  551. package/.versions/2.0.15/skills/incremental-implementation/SKILL.md +353 -0
  552. package/.versions/2.0.15/skills/interview-me/SKILL.md +226 -0
  553. package/.versions/2.0.15/skills/orchestration-verification/SKILL.md +182 -0
  554. package/.versions/2.0.15/skills/peer-coms/SKILL.md +90 -0
  555. package/.versions/2.0.15/skills/performance-optimization/SKILL.md +496 -0
  556. package/.versions/2.0.15/skills/planning-and-task-breakdown/SKILL.md +318 -0
  557. package/.versions/2.0.15/skills/repository-ai-setup/SKILL.md +117 -0
  558. package/.versions/2.0.15/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  559. package/.versions/2.0.15/skills/repository-ai-setup/references/apply-contract.md +74 -0
  560. package/.versions/2.0.15/skills/repository-ai-setup/references/provenance-template.md +16 -0
  561. package/.versions/2.0.15/skills/repository-ai-setup/references/setup-flow.md +108 -0
  562. package/.versions/2.0.15/skills/repository-ai-setup/references/verify-setup.md +20 -0
  563. package/.versions/2.0.15/skills/security-and-hardening/SKILL.md +524 -0
  564. package/.versions/2.0.15/skills/spec-driven-development/SKILL.md +295 -0
  565. package/.versions/2.0.15/skills/using-agent-skills/SKILL.md +198 -0
  566. package/.versions/2.0.15/vendor/agent-skills-upstream/LICENSE +21 -0
  567. package/.versions/2.0.15/vendor/agent-skills-upstream/README.md +430 -0
  568. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  569. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  570. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  571. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  572. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  573. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  574. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  575. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  576. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  577. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  578. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  579. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  580. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  581. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  582. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  583. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  584. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  585. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  586. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  587. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  588. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  589. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  590. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  591. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  592. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  593. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  594. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  595. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  596. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  597. package/.versions/2.0.15/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  598. package/CHANGELOG.md +6 -0
  599. package/README.md +1 -1
  600. package/agents/builder.md +2 -2
  601. package/bin/cli.js +16 -2
  602. package/bin/lib/apply.js +5 -0
  603. package/bin/lib/doctor.js +85 -12
  604. package/bin/lib/reconcile.js +9 -1
  605. package/bin/lib/state.js +1 -0
  606. package/bin/lib/task-triage-setup.js +76 -0
  607. package/bin/lib/transaction.js +4 -0
  608. package/docs/ARCHITECTURE.md +99 -24
  609. package/docs/agent-fleet-setup.md +179 -6
  610. package/docs/npm-install.md +64 -15
  611. package/docs/pi-extensions.md +1 -1
  612. package/install-manifest.json +13 -3
  613. package/manifest-meta.json +6 -0
  614. package/package.json +9 -2
  615. package/skills/incremental-implementation/SKILL.md +64 -13
  616. package/skills/planning-and-task-breakdown/SKILL.md +43 -14
  617. package/skills/using-agent-skills/SKILL.md +2 -2
@@ -0,0 +1,156 @@
1
+ // Offline-safe fixture preflight for the opt-in, user-run independent review.
2
+ import { createHash } from "node:crypto";
3
+ import { lstatSync, readFileSync, realpathSync } from "node:fs";
4
+ import { basename, isAbsolute, join, relative } from "node:path";
5
+ import { reviewClosureUnmet } from "./task-triage-review-contract.mjs";
6
+
7
+ // Executed as a fresh Pi extension in the isolated reviewer-only workspace.
8
+ // Tier declaration is preparation, not authorization: the Hub still applies its
9
+ // own classification, process and budget gates, and no other tool can run here.
10
+ export const reviewGateSource = `let used = false;
11
+ export default function (pi) {
12
+ pi.on("tool_call", (event, ctx) => {
13
+ if (event.toolName === "set_task_tier") {
14
+ const input = event.input;
15
+ if (!used && input && (input.tier === "trivial" || input.tier === "small") &&
16
+ (input.scope === undefined || input.scope === "read-only" || input.scope === "small") &&
17
+ (input.risk === undefined || ["unknown", "low", "high"].includes(input.risk)) &&
18
+ (input.new_task === undefined || input.new_task === false)) return;
19
+ ctx.abort(); return { block: true, reason: "Reviewer-only tier preparation refused: no new task or post-dispatch reclassification." };
20
+ }
21
+ if (event.toolName === "set_assertions") {
22
+ // Assertion declaration is preparation, not proof or authorization. The Hub
23
+ // validates it; this fixture gate only prevents it after the sole review.
24
+ if (!used) return;
25
+ ctx.abort(); return { block: true, reason: "Reviewer-only assertions refused after dispatch." };
26
+ }
27
+ if (event.toolName === "dispatch_agent") {
28
+ const input = event.input;
29
+ const allowed = !used && input?.agent === "code-reviewer" && input?.backend === "native" &&
30
+ JSON.stringify(input?.scope) === '["README-SYNTH.md"]' &&
31
+ (input?.artifacts === undefined || (Array.isArray(input.artifacts) && input.artifacts.length === 0));
32
+ if (allowed) { used = true; return; }
33
+ ctx.abort(); return { block: true, reason: "Independent review only: one exact native reviewer; no other dispatch." };
34
+ }
35
+ ctx.abort(); return { block: true, reason: "Only tier/assertion preparation and the independent reviewer dispatch are authorized." };
36
+ });
37
+ }
38
+ `;
39
+
40
+ const sha = bytes => createHash("sha256").update(bytes).digest("hex");
41
+ const must = (condition, message) => { if (!condition) throw new Error(message); };
42
+ export function reviewFixture(from) {
43
+ must(isAbsolute(from) && /^t4-live-stage-closure-[\w-]+$/.test(basename(from)), "--from must name an absolute retained T4 live-stage fixture");
44
+ must(realpathSync(from) === from && lstatSync(from).isDirectory(), "fixture directory must be real, not a link");
45
+ const file = (path) => {
46
+ must(isAbsolute(path) && (path === from || relative(from, path).startsWith("..") === false && !isAbsolute(relative(from, path))), `out-of-fixture evidence: ${path}`);
47
+ const parts = relative(from, path).split(/[\\/]/);
48
+ let cursor = from;
49
+ for (const part of parts) {
50
+ cursor = join(cursor, part);
51
+ must(!lstatSync(cursor).isSymbolicLink(), `linked fixture evidence refused: ${cursor}`);
52
+ }
53
+ must(lstatSync(path).isFile(), `missing fixture evidence file: ${path}`);
54
+ return path;
55
+ };
56
+ const json = path => JSON.parse(readFileSync(file(path), "utf8"));
57
+ const resultPath = file(join(from, "result.json"));
58
+ const result = json(resultPath);
59
+ must(result.fixture === from && result.worktree === join(from, "worktree") && result.model === "openai-codex/gpt-6-luna", "result fixture/model mismatch");
60
+ must(Array.isArray(result.stages) && result.stages.length === 3 &&
61
+ result.stages.map(s => s.role).join(",") === "planner,builder,code-reviewer" &&
62
+ result.stages.map(s => s.stage).join(",") === "plan,build,review", "not the retained three-stage fixture");
63
+ must(result.stages.every(s => s.modelEvidence?.fallback === null && s.modelEvidence?.status === "observed" &&
64
+ s.modelEvidence.identities?.length && s.modelEvidence.identities.every(m => `${m.provider}/${m.model}` === result.model)), "original stage model evidence incomplete");
65
+ must(typeof result.error === "string" && result.error.startsWith("review closure unmet: parsed A1 evidence missing references:") &&
66
+ result.error.includes("parsed A1 evidence missing exact declared command") &&
67
+ result.error.includes("parsed A1 evidence missing exit code") &&
68
+ result.error.includes("parsed A1 evidence missing inspected revision"), "not the retained abbreviated-A1 reviewer fixture");
69
+ must(result.after?.exactExpectedBytes === true && result.after?.unchangedFixture === true &&
70
+ result.afterReview?.unchangedFixture === true && result.afterReview?.nonRuntimeStatus === " M README-SYNTH.md" &&
71
+ result.stages[2].process?.accepted === true && result.stages[2].process?.currentStage === "complete" &&
72
+ result.stages[2].process?.obligations?.review?.status === "satisfied", "original process or README scope not complete");
73
+ const [plan, build, review] = result.stages;
74
+ const session = join(from, "worktree/.pi/agent-sessions/sessions");
75
+ // Derive the original session from the retained planner result path, then constrain every stage to it.
76
+ const base = join(plan.resultPath, "../../..");
77
+ must(relative(session, base) && !relative(session, base).includes("/") && !relative(session, base).startsWith(".."), "invalid original session");
78
+ const expectedStage = (s, role) => {
79
+ must(/^[0-9a-f-]{36}$/.test(s.id) && s.resultPath === join(base, "dispatches", s.id, "result.json") &&
80
+ s.returnPath === join(base, "artifacts/returns", `${role}-${s.id}.md`) &&
81
+ s.acceptancePath === join(base, "artifacts/evidence", `${role}-acceptance-${s.id}.md`), `invalid ${role} stage paths`);
82
+ return [s.resultPath, s.returnPath, s.acceptancePath];
83
+ };
84
+ const paths = [resultPath, ...expectedStage(plan, "planner"), ...expectedStage(build, "builder"), ...expectedStage(review, "code-reviewer")];
85
+ const before = join(from, "evidence/README-before.md"), after = join(from, "evidence/README-after.md");
86
+ const afterDiff = join(from, "evidence/README-before-after.git-diff.patch");
87
+ const manifest = result.baseline?.manifest, baselineBytes = result.baseline?.filesPath;
88
+ must(manifest === join(from, "evidence/baseline-fixture-sha256.json") && baselineBytes === join(from, "evidence/baseline-fixture-bytes.json") &&
89
+ result.baseline?.bytes === before && result.after?.path === after && result.after?.diffPath === afterDiff, "baseline/after paths inconsistent");
90
+ paths.push(before, after, afterDiff, result.baseline.diff, result.baseline.statusPath, manifest, baselineBytes,
91
+ result.after.statusPath, result.afterReview.statusPath, join(from, "worktree/README-SYNTH.md"), join(base, "artifacts/plans/synthetic-readme-fix.md"));
92
+ const acceptance = json(build.acceptancePath), check = acceptance.verification?.checks?.[0];
93
+ must(acceptance.task?.id && acceptance.task?.revision?.after && acceptance.task.revision.after === check?.inspectedRevision &&
94
+ check?.taskId === acceptance.task.id && check?.exitCode === 0 && check?.command?.length === 1 &&
95
+ check.command[0] === result.declaredCheck && acceptance.execution?.dispatchId === build.id &&
96
+ acceptance.process?.obligations?.acceptance?.status === "satisfied" &&
97
+ ["A1", "AF-MIN-CHANGE"].every(id => acceptance.verification.requirements.some(r => r.id === id && r.status === "passed" && r.taskId === acceptance.task.id && r.revision === check.inspectedRevision)), "builder task/revision/check evidence mismatch");
98
+ must(typeof check.evidenceRef === "string" && check.evidenceRef.startsWith(join(base, "artifacts/evidence/builder-test-check-")), "check path outside original session");
99
+ paths.push(check.evidenceRef);
100
+ const checkRecord = json(check.evidenceRef), buildResult = json(build.resultPath);
101
+ const priorReview = json(review.acceptancePath), priorResult = json(review.resultPath);
102
+ must(priorReview.task?.id === acceptance.task.id && priorReview.task?.revision?.after === check.inspectedRevision &&
103
+ priorResult.output?.split(/\r?\n/, 1)[0] === "VERDICT: APPROVE" &&
104
+ priorReview.structuredReturn?.assertions_proven?.some(item => item.id === "A1") &&
105
+ priorReview.process?.accepted === true, "original reviewer task/revision/verdict mismatch");
106
+ must(checkRecord.declaration?.taskId === acceptance.task.id && checkRecord.declaration?.dispatchId === build.id &&
107
+ checkRecord.observation?.command === result.declaredCheck && checkRecord.observation?.exitCode === 0 &&
108
+ checkRecord.observation?.afterRevision === check.inspectedRevision &&
109
+ buildResult.evidencePath === build.resultPath && buildResult.exitCode === 0, "builder check/result inconsistency");
110
+ const hashes = json(manifest), originals = json(baselineBytes);
111
+ const expectedKeys = ["README-SYNTH.md", "probe-hooks.ts", "stage-boundary.mjs", "skills/orchestration-verification/SKILL.md", ".pi/agents/teams.yaml", ".pi/agents/personas/planner.md", ".pi/agents/personas/builder.md", ".pi/agents/personas/code-reviewer.md"];
112
+ must(Object.keys(hashes).sort().join() === expectedKeys.sort().join() && Object.keys(originals).sort().join() === expectedKeys.join(), "baseline fixture manifest coverage mismatch");
113
+ for (const key of expectedKeys) {
114
+ must(typeof hashes[key] === "string" && sha(Buffer.from(originals[key])) === hashes[key], `recorded baseline bytes mismatch: ${key}`);
115
+ if (key !== "README-SYNTH.md") must(sha(readFileSync(file(join(from, "worktree", key)))) === hashes[key], `fixture changed: ${key}`);
116
+ }
117
+ const initial = readFileSync(file(before));
118
+ must(sha(initial) === hashes["README-SYNTH.md"] && initial.equals(Buffer.from(originals["README-SYNTH.md"])), "baseline README mismatch");
119
+ const expected = Buffer.from(initial.toString("utf8").replace("wdiget renders", "widget renders"));
120
+ must(initial.toString("utf8").includes("wdiget renders") && !expected.equals(initial) &&
121
+ readFileSync(file(after)).equals(expected) && readFileSync(file(join(from, "worktree/README-SYNTH.md"))).equals(expected), "actual README bytes/scope mismatch");
122
+ const readback = acceptance.readback?.[0];
123
+ must(acceptance.readback.length === 1 && readback.path === join(from, "worktree/README-SYNTH.md") &&
124
+ readback.status === "read" && readback.changed === true && readback.sha256 === sha(expected) &&
125
+ readback.bytes === expected.length && acceptance.scopeRoots?.length === 1 &&
126
+ acceptance.scopeRoots[0].scope === "README-SYNTH.md" && acceptance.scopeRoots[0].exists === true &&
127
+ readback.retainedPath === join(base, "dispatches", build.id, "deliverables/0") &&
128
+ readFileSync(file(readback.retainedPath)).equals(expected), "builder README scope/readback mismatch");
129
+ paths.push(readback.retainedPath);
130
+ must(readFileSync(file(afterDiff), "utf8").includes("-The wdiget renders a greeting.\n+The widget renders a greeting."), "before/after diff missing typo");
131
+ must(readFileSync(file(result.baseline.statusPath), "utf8") === "" &&
132
+ readFileSync(file(result.after.statusPath), "utf8") === result.after.gitStatus &&
133
+ readFileSync(file(result.afterReview.statusPath), "utf8") === result.afterReview.gitStatus, "recorded status mismatch");
134
+ // Only artifacts owned by the exact original Hub session are excluded from
135
+ // source scope. Reject unrelated untracked paths, including other sessions.
136
+ const sessionId = basename(base);
137
+ const ownedPrefix = `?? .pi/agent-sessions/sessions/${sessionId}/`;
138
+ const checkedStatus = status => status.split("\n").filter(Boolean).filter(line => !line.startsWith(ownedPrefix)).join("\n");
139
+ must(checkedStatus(result.after.gitStatus) === " M README-SYNTH.md" &&
140
+ checkedStatus(result.afterReview.gitStatus) === " M README-SYNTH.md" &&
141
+ result.after.nonRuntimeStatus === " M README-SYNTH.md" &&
142
+ result.afterReview.nonRuntimeStatus === " M README-SYNTH.md", "unrelated source or session changes in recorded status");
143
+ const unique = [...new Set(paths)];
144
+ // Only the eight fixture-file hashes above were recorded at creation; all other hashes are a first-time snapshot NOW.
145
+ const snapshot = Object.fromEntries(unique.map(path => [file(path), sha(readFileSync(path))]));
146
+ const verify = () => { for (const [path, hash] of Object.entries(snapshot)) must(sha(readFileSync(file(path))) === hash, `fixture evidence changed since first-time snapshot: ${path}`); };
147
+ return { result, plan, build, review, before, after, afterDiff, acceptancePath: build.acceptancePath,
148
+ checkPath: check.evidenceRef, check: result.declaredCheck, exitCode: 0, inspectedRevision: check.inspectedRevision,
149
+ requiredPaths: [plan.returnPath, before, after, afterDiff, build.acceptancePath, check.evidenceRef], snapshot, recordedBaseline: hashes, verify };
150
+ }
151
+
152
+ // The original process is independently complete; new session acceptance never rewrites it.
153
+ export function independentReviewUnmet(fixture, output, parsed) {
154
+ return reviewClosureUnmet({ process: fixture.review.process, verdict: output.split(/\r?\n/, 1)[0], parsed,
155
+ requiredPaths: fixture.requiredPaths, check: fixture.check, exitCode: fixture.exitCode, inspectedRevision: fixture.inspectedRevision });
156
+ }
@@ -0,0 +1,112 @@
1
+ // Offline-safe, bounded diagnostic projection: never retain RPC payloads or UI decision values.
2
+ const MAX_STDERR = 8192, MAX_EVENTS = 80;
3
+ export const BENIGN_UI_METHODS = new Set(["notify", "setStatus", "setWidget", "setTitle", "set_editor_text"]);
4
+
5
+ export function redactDiagnostic(text) {
6
+ return String(text)
7
+ .replace(/\x1b\[[0-9;]*m/g, "")
8
+ .replace(/https?:\/\/[^\s]+/gi, "[redacted-url]")
9
+ .replace(/\b(?:Bearer|Basic)\s+[^\s]+/gi, "[redacted-auth]")
10
+ .replace(/\b[A-Za-z0-9_-]*(?:api[_-]?key|token|secret|password|authorization|credential|cookie)[A-Za-z0-9_-]*["']?\s*[:=]\s*(?:"[^"\r\n]*(?:"|$)|'[^'\r\n]*(?:'|$)|[^\s,;"'}]+)/gi, "[redacted-secret]")
11
+ .replace(/\b(?:sk|ghp|github_pat|AIza)[-_][A-Za-z0-9_-]{8,}\b/g, "[redacted-token]")
12
+ .replace(/\b[A-Za-z0-9_+/=-]{40,}\b/g, "[redacted-long-value]");
13
+ }
14
+
15
+ export function createReviewDiagnostics(outcome, save) {
16
+ const diagnostics = outcome.diagnostics = { stderr: "", stderrTruncated: false, rpc: [], kills: [], spawnError: null, exit: null, firstFailure: null };
17
+ let stderr = "", pendingLine = "", oversizedLine = false;
18
+ const persist = () => save();
19
+ const retainLine = line => {
20
+ const safe = redactDiagnostic(line);
21
+ if (Buffer.byteLength(safe) > MAX_STDERR) {
22
+ diagnostics.stderrTruncated = true;
23
+ return;
24
+ }
25
+ stderr += safe;
26
+ while (Buffer.byteLength(stderr) > MAX_STDERR) {
27
+ stderr = stderr.slice(stderr.indexOf("\n") + 1);
28
+ diagnostics.stderrTruncated = true;
29
+ }
30
+ };
31
+ const failure = reason => {
32
+ if (!diagnostics.firstFailure) diagnostics.firstFailure = { reason: redactDiagnostic(reason), at: new Date().toISOString() };
33
+ persist();
34
+ };
35
+ const safe = value => typeof value === "string" ? redactDiagnostic(value).slice(0, 240) : undefined;
36
+ const rpc = ev => {
37
+ const item = { at: new Date().toISOString(), type: ev.type };
38
+ if (ev.type === "extension_ui_request") {
39
+ item.method = [...BENIGN_UI_METHODS, "select", "confirm", "input", "editor"].includes(ev.method) ? ev.method : "unknown";
40
+ } else if (ev.type === "message_end" || ev.type === "tool_execution_start" || ev.type === "tool_execution_end") {
41
+ const message = ev.message, result = ev.result ?? (message?.role === "toolResult" ? message : undefined);
42
+ const details = result?.details;
43
+ item.role = safe(message?.role ?? ev.role);
44
+ item.provider = safe(message?.role === "assistant" ? message.provider : undefined);
45
+ item.model = safe(message?.role === "assistant" ? message.model : undefined);
46
+ item.toolCallId = safe(ev.toolCallId ?? result?.toolCallId);
47
+ item.toolName = safe(ev.toolName ?? result?.toolName);
48
+ if (typeof result?.isError === "boolean" || typeof ev.isError === "boolean")
49
+ item.isError = result?.isError === true || ev.isError === true;
50
+ item.status = safe(result?.status ?? details?.status ?? ev.status);
51
+ // Tool payloads are not evidence: retain only a bounded sanitized error/refusal reason.
52
+ const text = result?.content;
53
+ const resultText = typeof text === "string" ? text : Array.isArray(text) ? text.find(part => typeof part?.text === "string")?.text : undefined;
54
+ const reason = result?.reason ?? details?.reason ?? ev.reason ??
55
+ ((item.isError || /\b(?:refus(?:ed|al)|denied|blocked|not authorized)\b/i.test(resultText ?? "")) ? resultText : undefined);
56
+ item.reason = safe(reason);
57
+ } else if (ev.type === "response") {
58
+ item.command = ev.command === "prompt" ? "prompt" : "other";
59
+ item.success = ev.success === true;
60
+ if (ev.success === false && ev.error) item.error = redactDiagnostic(ev.error).slice(0, 240);
61
+ } else if (ev.type === "error") {
62
+ item.error = redactDiagnostic(ev.error ?? "RPC error").slice(0, 240);
63
+ }
64
+ diagnostics.rpc.push(item);
65
+ if (diagnostics.rpc.length > MAX_EVENTS) diagnostics.rpc.shift();
66
+ persist();
67
+ };
68
+ return {
69
+ failure, rpc,
70
+ stderr(chunk) {
71
+ const text = String(chunk);
72
+ let start = 0, end;
73
+ while ((end = text.indexOf("\n", start)) !== -1) {
74
+ if (!oversizedLine && end + 1 - start <= MAX_STDERR) {
75
+ const part = text.slice(start, end + 1);
76
+ if (Buffer.byteLength(pendingLine) + Buffer.byteLength(part) <= MAX_STDERR)
77
+ retainLine(pendingLine + part);
78
+ else diagnostics.stderrTruncated = true;
79
+ } else diagnostics.stderrTruncated = true;
80
+ pendingLine = "";
81
+ oversizedLine = false;
82
+ start = end + 1;
83
+ }
84
+ if (start < text.length && !oversizedLine) {
85
+ if (text.length - start <= MAX_STDERR) {
86
+ const part = text.slice(start);
87
+ if (Buffer.byteLength(pendingLine) + Buffer.byteLength(part) <= MAX_STDERR) pendingLine += part;
88
+ else oversizedLine = true;
89
+ } else oversizedLine = true;
90
+ if (oversizedLine) {
91
+ pendingLine = "";
92
+ diagnostics.stderrTruncated = true;
93
+ }
94
+ }
95
+ // Never persist an incomplete line: its key or value may be split across chunks.
96
+ },
97
+ flushStderr() {
98
+ if (pendingLine || oversizedLine) diagnostics.stderrTruncated = true;
99
+ pendingLine = "";
100
+ oversizedLine = false;
101
+ diagnostics.stderr = stderr;
102
+ persist();
103
+ },
104
+ spawnError(error) { diagnostics.spawnError = { at: new Date().toISOString(), code: error.code ?? null, message: redactDiagnostic(error.message).slice(0, 240) }; failure(`Pi spawn error: ${error.message}`); },
105
+ exit(code, signal) { diagnostics.exit = { at: new Date().toISOString(), code, signal }; persist(); },
106
+ kill(reason, signal, send) {
107
+ diagnostics.kills.push({ at: new Date().toISOString(), reason, signal });
108
+ failure(reason); // Record intent durably before sending a signal.
109
+ send();
110
+ },
111
+ };
112
+ }
@@ -0,0 +1,157 @@
1
+ // USER RUN ONLY: node .pi/harnesses/agent-hub/task-triage-reviewer-only.user-run.mjs --live --from /tmp/t4-live-stage-closure-...
2
+ // Real provider spend. Never imported by offline tests/npm; no original fixture writes.
3
+ import { spawn } from "node:child_process";
4
+ import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { join } from "node:path";
7
+ import { fileURLToPath } from "node:url";
8
+ import { reviewFixture, independentReviewUnmet, reviewGateSource } from "./task-triage-reviewer-only-contract.mjs";
9
+ import { reviewReturnTemplate } from "./task-triage-review-contract.mjs";
10
+ import { BENIGN_UI_METHODS, createReviewDiagnostics } from "./task-triage-reviewer-only-diagnostics.mjs";
11
+
12
+ if (process.argv.length !== 5 || process.argv[2] !== "--live" || process.argv[3] !== "--from") {
13
+ console.error("LIVE MODEL SPEND: supply --live --from <absolute retained fixture>; no offline/automatic mode.");
14
+ process.exitCode = 2;
15
+ } else {
16
+ await run(process.argv[4]);
17
+ }
18
+
19
+ async function run(from) {
20
+ let fixture;
21
+ try { fixture = reviewFixture(from); fixture.verify(); }
22
+ catch (e) { console.error(`Pre-spend fixture refusal: ${e.message}`); process.exitCode = 2; return; }
23
+ const root = fileURLToPath(new URL("../../../", import.meta.url));
24
+ const dir = mkdtempSync(join(tmpdir(), "t4-independent-review-"));
25
+ const workspace = join(dir, "worktree"), evidence = join(dir, "evidence");
26
+ mkdirSync(join(workspace, ".pi/agents/personas"), { recursive: true });
27
+ mkdirSync(join(workspace, "skills/orchestration-verification"), { recursive: true });
28
+ mkdirSync(evidence);
29
+ // The original result and all original evidence remain read-only inputs; only this fresh directory receives writes.
30
+ cpSync(join(root, "skills/orchestration-verification/SKILL.md"), join(workspace, "skills/orchestration-verification/SKILL.md"));
31
+ cpSync(fixture.after, join(workspace, "README-SYNTH.md")); // isolated scope root, not original evidence
32
+ writeFileSync(join(workspace, ".pi/agents/teams.yaml"), "review-only:\n - code-reviewer\n");
33
+ writeFileSync(join(workspace, ".pi/agents/personas/code-reviewer.md"), `---\nname: code-reviewer\ndescription: Independent synthetic fixture reviewer\ntools: read,grep,find,ls\nmodel: openai-codex/gpt-6-luna\ndelegate_depth: 0\n---\nReview only the retained synthetic evidence named in the dispatch. Do not run commands, edit, write, delegate or read credentials. First line must be exactly VERDICT: APPROVE or VERDICT: REJECT.\n`);
34
+ // A tool_call gate reserves the ONLY permitted child before execution, with no planner/builder/delegates.
35
+ writeFileSync(join(workspace, "review-gate.ts"), reviewGateSource);
36
+ const outputPath = join(dir, "review-result.json");
37
+ const outcome = { originalFixture: from, outputPath, originalProcessComplete: fixture.review.process.accepted === true &&
38
+ fixture.review.process.currentStage === "complete" && fixture.review.process.obligations.review.status === "satisfied",
39
+ independentReviewerContractAccepted: false,
40
+ hashProvenance: "recordedBaseline covers only original fixture files; snapshot is first-time capture for all other retained records", recordedBaseline: fixture.recordedBaseline,
41
+ firstTimeSnapshot: fixture.snapshot, error: null };
42
+ const save = () => { writeFileSync(`${outputPath}.tmp`, JSON.stringify(outcome, null, 2), { mode: 0o600 }); renameSync(`${outputPath}.tmp`, outputPath); };
43
+ const diagnostic = createReviewDiagnostics(outcome, save);
44
+ save();
45
+ const env = { ...process.env, TMPDIR: join(dir, "runtime-tmp"), NODE_COMPILE_CACHE: join(dir, "node-compile-cache") };
46
+ mkdirSync(env.TMPDIR); mkdirSync(env.NODE_COMPILE_CACHE);
47
+ delete env.PI_OFFLINE; delete env.TYPESAFE_API_KEY; delete env.AGENT_HUB_TASK_TRIAGE_FAKE; delete env.AGENT_HUB_TASK_TRIAGE_FAKE_RECORD;
48
+ if (env.NODE_OPTIONS?.includes("system1-no-network")) delete env.NODE_OPTIONS;
49
+ let child;
50
+ try {
51
+ // Verify again immediately before real spend; no Pi process exists on validation failure.
52
+ fixture.verify();
53
+ child = spawn(join(root, "node_modules/.bin/pi"), ["--mode", "rpc", "--no-session", "--no-extensions",
54
+ "-e", join(root, ".pi/harnesses/damage-control-continue/index.ts"),
55
+ "-e", join(root, ".pi/harnesses/ask-user-remote/index.ts"),
56
+ "-e", join(root, ".pi/harnesses/agent-hub/index.ts"), "-e", join(workspace, "review-gate.ts"),
57
+ "--solo", "--work-mode", "orchestrator", "--agent-team", "review-only", "--model", "openai-codex/gpt-6-luna"],
58
+ { cwd: workspace, env, detached: true, stdio: ["pipe", "pipe", "pipe"] });
59
+ let buffer = "", turns = 0, ended = false, reply, failPendingPrompt;
60
+ const models = [], callbacks = new Map(), waiters = new Set();
61
+ const kill = (signal, reason) => diagnostic.kill(reason, signal, () => {
62
+ if (child.pid && !ended) { try { process.kill(-child.pid, signal); } catch (e) { if (e.code !== "ESRCH") throw e; } }
63
+ });
64
+ child.once("error", e => { diagnostic.spawnError(e); ended = true; failPendingPrompt?.(); for (const wake of waiters) wake(); });
65
+ child.once("close", (code, signal) => { ended = true; outcome.shutdown = { code, signal }; diagnostic.exit(code, signal); failPendingPrompt?.(); for (const wake of waiters) wake(); });
66
+ child.stdin.on("error", e => { diagnostic.failure(`Pi stdin error: ${e.message}`); failPendingPrompt?.(); });
67
+ child.stderr.on("data", chunk => diagnostic.stderr(chunk));
68
+ child.stderr.once("end", () => diagnostic.flushStderr());
69
+ child.stdout.on("data", chunk => {
70
+ buffer += String(chunk);
71
+ for (let nl; (nl = buffer.indexOf("\n")) >= 0;) {
72
+ const line = buffer.slice(0, nl); buffer = buffer.slice(nl + 1);
73
+ let ev; try { ev = JSON.parse(line); } catch { continue; }
74
+ if (["agent_start", "agent_end", "message_end", "tool_execution_start", "tool_execution_end", "response", "error", "extension_ui_request"].includes(ev.type)) diagnostic.rpc(ev);
75
+ if (ev.type === "agent_end") { turns++; for (const wake of waiters) wake(); }
76
+ if (ev.type === "message_end" && ev.message?.role === "assistant") models.push({ provider: ev.message.provider, model: ev.message.model, output: ev.message.usage?.output });
77
+ if (ev.type === "response" && callbacks.has(ev.id)) { callbacks.get(ev.id)(ev); callbacks.delete(ev.id); }
78
+ if (ev.type === "extension_ui_request" && !BENIGN_UI_METHODS.has(ev.method))
79
+ kill("SIGTERM", `unexpected human decision (${["select", "confirm", "input", "editor"].includes(ev.method) ? ev.method : "unknown"}); no budget extension authorized`);
80
+ if (ev.type === "error") diagnostic.failure(`Pi RPC error: ${ev.error ?? "unknown"}`);
81
+ }
82
+ });
83
+ const prompt = async message => {
84
+ const prior = turns, id = `independent-${prior}`;
85
+ reply = await new Promise((resolve, reject) => {
86
+ const finish = (error, ev) => { clearTimeout(timer); callbacks.delete(id); failPendingPrompt = undefined; error ? reject(error) : resolve(ev); };
87
+ const timer = setTimeout(() => { kill("SIGTERM", "Pi RPC timeout"); finish(new Error("Pi RPC timeout")); }, 600_000);
88
+ failPendingPrompt = () => finish(new Error(outcome.diagnostics.firstFailure?.reason ?? "Pi exited before RPC prompt response"));
89
+ callbacks.set(id, ev => finish(null, ev));
90
+ child.stdin.write(JSON.stringify({ id, type: "prompt", message }) + "\n");
91
+ });
92
+ if (!reply.success) { diagnostic.failure(`Pi prompt failed: ${reply.error ?? "unknown"}`); throw new Error("Pi prompt failed"); }
93
+ if (turns <= prior) await new Promise((resolve, reject) => {
94
+ const timer = setTimeout(() => { waiters.delete(wake); kill("SIGTERM", "Pi agent_end timeout"); reject(new Error("Pi agent_end timeout")); }, 600_000);
95
+ const wake = () => { if (turns <= prior && !ended) return; clearTimeout(timer); waiters.delete(wake); ended && turns <= prior ? reject(new Error(outcome.diagnostics.firstFailure?.reason ?? "Pi exited before agent_end")) : resolve(); };
96
+ waiters.add(wake); wake();
97
+ });
98
+ if (outcome.diagnostics.firstFailure) throw new Error(outcome.diagnostics.firstFailure.reason);
99
+ };
100
+ const template = reviewReturnTemplate({ planReturnPath: fixture.plan.returnPath, before: fixture.before, after: fixture.after,
101
+ afterDiff: fixture.afterDiff, acceptancePath: fixture.acceptancePath, checkPath: fixture.checkPath,
102
+ check: fixture.check, exitCode: fixture.exitCode, inspectedRevision: fixture.inspectedRevision });
103
+ await prompt(`Independent synthetic reviewer-contract continuation, not a replay of original process. Dispatch EXACTLY ONE native code-reviewer, pinned openai-codex/gpt-6-luna, backend native, scope ["README-SYNTH.md"], artifacts [] (EMPTY: the cited files are read-only paths in the task, NOT dispatch input artifacts), review_reason "human authorized independent reviewer-only continuation". No planner, builder, helpers or further children. Reviewer must read these ORIGINAL actual absolute evidence inputs: planner return ${fixture.plan.returnPath}, actual plan ${join(fixture.plan.returnPath, "../../plans/synthetic-readme-fix.md")}, README ${join(from, "worktree/README-SYNTH.md")}, before ${fixture.before}, after ${fixture.after}, original baseline diff ${fixture.result.baseline.diff}, before/after diff ${fixture.afterDiff}, baseline status ${fixture.result.baseline.statusPath}, original recorded fixture hashes ${fixture.result.baseline.manifest}, baseline bytes ${fixture.result.baseline.filesPath}, after status ${fixture.result.after.statusPath}, after-review status ${fixture.result.afterReview.statusPath}. Scope accounting: the preflight independently checks both complete recorded status files and refuses any entry outside the changed README or untracked artifacts under the EXACT original Hub session .pi/agent-sessions/sessions/${fixture.plan.resultPath.split('/dispatches/')[0].split('/').at(-1)}/; those session artifacts are generated evidence, not declared README source edits. Verify this distinction yourself from the status paths, baseline manifest and artifact paths; REJECT if any unrelated source edit or foreign-session entry exists. Builder acceptance ${fixture.acceptancePath}, builder check ${fixture.checkPath}, builder result ${fixture.build.resultPath}, original reviewer return ${fixture.review.returnPath}, original reviewer acceptance ${fixture.review.acceptancePath}. Examine plan, exact change and README scope, diff, builder A1/AF-MIN-CHANGE check and revision/readback. Earlier reviewer returns conflict: one abbreviated A1; another rejected by comparing the BEFORE SHA-256 to the digest required for the AFTER bytes. Read the synthetic-only adjudication note at ${join(root, ".pi/agent-sessions/sessions/52b6c78b-3f03-4417-9493-bb877381f8bb/artifacts/c2-reviewer-hash-adjudication.md")} as a contested finding, not proof: independently read the cited BEFORE and AFTER bytes and declared command, verify whether the exact one-token replacement yields the declared AFTER digest, and REJECT if it does not or other evidence is insufficient. Do not reuse either prior verdict as authority. Do NOT execute or propose repeating the verification command: readonly review of recorded execution. Start final reviewer return with canonical first-line VERDICT: APPROVE or VERDICT: REJECT; reject freely if unsupported. Structured keys changed_files, assertions_proven, assertions_unproven, assertions_failed, tests_run, open_risks, requires_user_decision. The reviewer return must place exactly one A1 bullet DIRECTLY UNDER assertions_proven: as '- A1: <your independently verified finding> — evidence: <six JSON-quoted source paths; declared command JSON-quoted; exit code; inspected revision JSON-quoted; your observation>'. Do not put A1 in bracket shorthand 'assertions_proven: [A1 — ...]' or put '- A1 — evidence:' after the structured keys: those are not parsed A1 evidence and will be rejected. The command must be cited, NOT run. Choose VERDICT: REJECT and assertions_unproven if the sources do not support approval. Following is an INSTRUCTIONAL TEMPLATE, NOT evidence; do not copy unverified findings, and never auto-fill missing evidence.\n${template}\nNo new reviewer file is expected from you: Hub retains actual return. Report what you observed, do not assert this changes original process state.`);
104
+ fixture.verify();
105
+ const sessions = join(workspace, ".pi/agent-sessions/sessions");
106
+ const ids = existsSync(sessions) ? readdirSync(sessions) : [];
107
+ if (ids.length !== 1) throw new Error(`expected one fresh session; found ${ids.length}`);
108
+ const base = join(sessions, ids[0]), dispatches = join(base, "dispatches");
109
+ const started = existsSync(dispatches) ? readdirSync(dispatches).filter(id => existsSync(join(dispatches, id, "request.json"))) : [];
110
+ if (started.length !== 1) throw new Error(`only one reviewer may start; observed ${started.length} dispatches`);
111
+ const id = started[0], request = JSON.parse(readFileSync(join(dispatches, id, "request.json"), "utf8"));
112
+ if (request.agent !== "code-reviewer" || request.backendRequested !== "native" ||
113
+ JSON.stringify(request.scope) !== '["README-SYNTH.md"]') throw new Error("non-reviewer/native/scope child started");
114
+ const result = JSON.parse(readFileSync(join(dispatches, id, "result.json"), "utf8"));
115
+ const acceptancePath = join(base, "artifacts/evidence", `code-reviewer-acceptance-${id}.md`);
116
+ const returnPath = join(base, "artifacts/returns", `code-reviewer-${id}.md`);
117
+ const acceptance = JSON.parse(readFileSync(acceptancePath, "utf8"));
118
+ const identities = readFileSync(join(dispatches, id, "session.json"), "utf8").split("\n").filter(Boolean).map(line => JSON.parse(line))
119
+ .filter(row => row.type === "message" && row.message?.role === "assistant").map(row => `${row.message.provider}/${row.message.model}`);
120
+ if (result.exitCode !== 0 || !(result.billed > 0) || result.diagnostics?.modelFallback !== null ||
121
+ !identities.length || identities.some(identity => identity !== "openai-codex/gpt-6-luna") ||
122
+ !models.length || models.some(m => `${m.provider}/${m.model}` !== "openai-codex/gpt-6-luna") ||
123
+ result.evidencePath !== join(dispatches, id, "result.json") ||
124
+ !existsSync(returnPath) || result.toolEvents?.some(e => !["read", "grep", "find", "ls"].includes(e.toolName)))
125
+ throw new Error("reviewer execution/model/readonly evidence not proven");
126
+ const unmet = independentReviewUnmet(fixture, result.output, acceptance.structuredReturn);
127
+ outcome.reviewer = { id, resultPath: result.evidencePath, acceptancePath, returnPath, billed: result.billed, identities, parentModels: models,
128
+ verdict: result.output.split(/\r?\n/, 1)[0], contractUnmet: unmet };
129
+ outcome.independentReviewerContractAccepted = unmet.length === 0;
130
+ if (unmet.length) throw new Error(`independent reviewer closure unmet: ${unmet.join("; ")}; new output: ${outputPath}`);
131
+ } catch (e) { diagnostic.failure(String(e.message ?? e)); outcome.error = outcome.diagnostics.firstFailure.reason; process.exitCode = 1; }
132
+ finally {
133
+ if (child) {
134
+ child.stdin.end();
135
+ await new Promise(resolve => {
136
+ if (outcome.shutdown) return resolve();
137
+ const done = () => { clearTimeout(grace); clearTimeout(bound); resolve(); };
138
+ child.once("close", done);
139
+ const grace = setTimeout(() => { killShutdown("SIGTERM", "shutdown grace elapsed"); }, 2000);
140
+ const bound = setTimeout(() => { killShutdown("SIGKILL", "shutdown bound elapsed"); resolve(); }, 8000);
141
+ function killShutdown(signal, reason) { diagnostic.kill(reason, signal, () => {
142
+ try { process.kill(-child.pid, signal); } catch { /* already closed */ }
143
+ }); }
144
+ });
145
+ }
146
+ if (child && (outcome.shutdown?.code !== 0 || outcome.shutdown?.signal)) {
147
+ diagnostic.failure(`fresh Pi session did not exit cleanly: ${JSON.stringify(outcome.shutdown)}`);
148
+ outcome.error = outcome.diagnostics.firstFailure.reason;
149
+ outcome.independentReviewerContractAccepted = false; process.exitCode = 1;
150
+ }
151
+ try { fixture.verify(); } catch (e) { diagnostic.failure(`original evidence changed: ${e.message}`); outcome.error = outcome.diagnostics.firstFailure.reason; outcome.independentReviewerContractAccepted = false; process.exitCode = 1; }
152
+ diagnostic.flushStderr();
153
+ save();
154
+ console.log(JSON.stringify({ originalProcessComplete: outcome.originalProcessComplete, independentReviewerContractAccepted: outcome.independentReviewerContractAccepted,
155
+ output: outputPath, error: outcome.error, reviewer: outcome.reviewer }));
156
+ }
157
+ }
@@ -0,0 +1,125 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import type { System1Result, System1Service } from "../lib/system1/contracts.ts";
3
+ import type { TaskTriageActivity } from "./system1-activity.ts";
4
+ import { TASK_TRIAGE_LIMITS, TASK_TRIAGE_QUESTIONS, TASK_TRIAGE_QUESTION_VERSION, type TaskTriageAssessment } from "./task-triage-contract.ts";
5
+ import { buildTaskTriageState } from "./task-triage-state.ts";
6
+ import { assessTaskTriage } from "./task-triage-policy.ts";
7
+
8
+ export const TASK_TRIAGE_RUNTIME_ENTRY = "agent-hub-task-triage-runtime/v1";
9
+
10
+ /** An unavailable or invalid assessment is not an evaluation that can fence baseline work. */
11
+ export function evaluatedTaskTriageInputChanged(current: { revision: string; assessment: TaskTriageAssessment } | null, text: string): boolean {
12
+ return !!current && (current.assessment.status === "applied" || current.assessment.status === "no_additions")
13
+ && current.revision !== createHash("sha256").update(text).digest("hex");
14
+ }
15
+ interface Snapshot { schema: typeof TASK_TRIAGE_RUNTIME_ENTRY; calls: number; fingerprints: string[]; assessments?: Record<string, TaskTriageAssessment>; }
16
+ type TaskTriageCurrent = { fingerprint: string; taskId: string; assessment: TaskTriageAssessment; evaluationId: string; revision: string };
17
+ export function restoreTaskTriageCounter(entries: readonly unknown[]): Snapshot | null {
18
+ for (let i = entries.length - 1; i >= 0; i--) {
19
+ const row = entries[i] as any;
20
+ if ((row?.customType ?? row?.type) !== TASK_TRIAGE_RUNTIME_ENTRY) continue;
21
+ const s = row.data as Snapshot;
22
+ return s?.schema === TASK_TRIAGE_RUNTIME_ENTRY && Number.isSafeInteger(s.calls) && s.calls >= 0 && s.calls <= TASK_TRIAGE_LIMITS.maxCallsPerSession && Array.isArray(s.fingerprints) && s.fingerprints.length <= TASK_TRIAGE_LIMITS.maxCallsPerSession && s.fingerprints.every(x => typeof x === "string" && /^[a-f0-9]{64}$/.test(x)) && (!s.assessments || (typeof s.assessments === "object" && !Array.isArray(s.assessments) && Object.entries(s.assessments).every(([key, value]) => s.fingerprints.includes(key) && value && ["applied", "no_additions", "unavailable", "skipped", "stale"].includes((value as TaskTriageAssessment).status) && Array.isArray((value as TaskTriageAssessment).reasons)) && Buffer.byteLength(JSON.stringify(s.assessments)) <= 64 * 1024)) ? s : null;
23
+ }
24
+ return entries.some((row: any) => row?.type === "message" && row?.message?.role === "user") ? null : { schema: TASK_TRIAGE_RUNTIME_ENTRY, calls: 0, fingerprints: [] };
25
+ }
26
+ export function createTaskTriageRuntime(options: { service?: System1Service; serviceUnavailableReason?: string; root: string; persist(snapshot: Snapshot): void; restored?: Snapshot | null; observer?: Pick<TaskTriageActivity, "evaluationStarted" | "evaluationFinished"> }) {
27
+ let snapshot: Snapshot | null = options.restored === undefined ? restoreTaskTriageCounter([]) : options.restored;
28
+ let pending: { text: string; revision: string } | null = null;
29
+ let scope: string | null = null;
30
+ let current: TaskTriageCurrent | null = null;
31
+ let controller: AbortController | null = null;
32
+ let flight: { fingerprint: string; taskId: string; generation: number; promise: Promise<TaskTriageCurrent | null> } | null = null;
33
+ let epoch = 0;
34
+ let cancelObservation: (() => void) | null = null;
35
+ const stop = () => { epoch++; controller?.abort(); controller = null; flight = null; cancelObservation?.(); cancelObservation = null; };
36
+ return {
37
+ get status() { return current?.assessment ?? { status: !snapshot || !options.service ? "unavailable" : "skipped", reasons: [], detail: !snapshot ? "counter_restore_ambiguous" : !options.service ? `shared_service_${options.serviceUnavailableReason ?? "unavailable"}` : "no_user_input" } as TaskTriageAssessment; },
38
+ get current() { return current; },
39
+ get inputRevision() { return pending?.revision; },
40
+ get calls() { return snapshot?.calls ?? null; },
41
+ input(text: string, source: string) {
42
+ if (source === "extension" || !text.trim()) return;
43
+ const revision = createHash("sha256").update(text).digest("hex");
44
+ if (pending?.revision === revision) return;
45
+ stop(); pending = { text, revision }; current = null;
46
+ },
47
+ restore(entries: readonly unknown[]) { stop(); pending = null; current = null; scope = null; snapshot = restoreTaskTriageCounter(entries); },
48
+ dispose: stop,
49
+ adopt(taskId: string) { if (current) current = { ...current, taskId }; return current; },
50
+ /** Reuse the already evaluated input; otherwise wait for the newest pending revision. */
51
+ async bindInput(taskId: string) { return current ?? await this.evaluate(taskId); },
52
+ scope(value: string) { if (scope === value) return false; scope = value; stop(); current = null; return true; },
53
+ invalidate() { stop(); current = null; },
54
+ async evaluate(taskId: string): Promise<TaskTriageCurrent | null> {
55
+ if (!pending || !taskId) return current;
56
+ const input = pending, generation = epoch;
57
+ const built = buildTaskTriageState({ task: input.text, constraints: scope ? [`Declared process scope: ${scope}`] : [] }, options.root);
58
+ const fingerprint = built.ok ? built.fingerprint : input.revision + (scope ?? "");
59
+ if (current?.fingerprint === fingerprint && current.taskId === taskId) return current;
60
+ if (flight?.fingerprint === fingerprint && flight.taskId === taskId && flight.generation === generation) return flight.promise;
61
+ const evaluationId = randomUUID(), identity = { taskId, evaluationId, inputRevision: input.revision };
62
+ let observed = false, observationClosed = false, providerResult: System1Result | undefined;
63
+ const beginObservation = (logicalCall: boolean) => {
64
+ if (observed) return;
65
+ observed = true;
66
+ try { options.observer?.evaluationStarted({ ...identity }, logicalCall); } catch { /* optional observer never owns policy */ }
67
+ };
68
+ const finishObservation = (assessment: TaskTriageAssessment) => {
69
+ if (observationClosed) return;
70
+ observationClosed = true;
71
+ // Only validated metadata, not task/state, raw bodies or mutable policy objects.
72
+ const result: System1Result | undefined = providerResult?.status === "ok"
73
+ ? { status: "ok", evaluation: { answers: [], metadata: { provider: providerResult.evaluation.metadata.provider,
74
+ requestedModel: providerResult.evaluation.metadata.requestedModel, returnedModel: providerResult.evaluation.metadata.returnedModel,
75
+ questionSetVersion: providerResult.evaluation.metadata.questionSetVersion, latencyMs: providerResult.evaluation.metadata.latencyMs,
76
+ attempts: providerResult.evaluation.metadata.attempts, usage: providerResult.evaluation.metadata.usage ? { inputTokens: providerResult.evaluation.metadata.usage.inputTokens, outputTokens: providerResult.evaluation.metadata.usage.outputTokens } : undefined } } }
77
+ : providerResult ? { status: providerResult.status,
78
+ ...("reason" in providerResult ? { reason: providerResult.reason } : {}),
79
+ ...("missingCapabilities" in providerResult ? { missingCapabilities: [...providerResult.missingCapabilities] } : {}) } as System1Result : undefined;
80
+ try { options.observer?.evaluationFinished({ ...identity }, structuredClone({ assessment, result })); } catch { /* observational only */ }
81
+ };
82
+ const record = (assessment: TaskTriageAssessment) => {
83
+ beginObservation(false); finishObservation(assessment);
84
+ if (epoch !== generation || pending?.revision !== input.revision) return null;
85
+ current = { fingerprint, taskId, assessment, evaluationId, revision: input.revision };
86
+ return current;
87
+ };
88
+ if (!built.ok) return record({ status: built.reason, reasons: [] });
89
+ const service = options.service;
90
+ if (!service) return record({ status: "unavailable", reasons: [], detail: `shared_service_${options.serviceUnavailableReason ?? "unavailable"}` });
91
+ if (!snapshot) return record({ status: "unavailable", reasons: [], detail: "counter_restore_ambiguous" });
92
+ if (snapshot.fingerprints.includes(fingerprint)) return record(snapshot.assessments?.[fingerprint] ?? { status: "stale", reasons: [], detail: "reserved_result_unavailable" });
93
+ if (snapshot.calls >= TASK_TRIAGE_LIMITS.maxCallsPerSession) return record({ status: "skipped", reasons: [], detail: "session_call_cap" });
94
+ // Reserve durably before the physical request; a failed write never permits inference.
95
+ const next: Snapshot = { schema: TASK_TRIAGE_RUNTIME_ENTRY, calls: snapshot.calls + 1, fingerprints: [...snapshot.fingerprints, fingerprint], assessments: snapshot.assessments };
96
+ try { options.persist(next); snapshot = next; } catch { return record({ status: "unavailable", reasons: [], detail: "counter_persistence_failed" }); }
97
+ beginObservation(true);
98
+ const cancel = () => finishObservation({ status: "cancelled", reasons: [], detail: "cancelled" });
99
+ cancelObservation = cancel;
100
+ controller = new AbortController();
101
+ const call = controller;
102
+ const timeout = setTimeout(() => call.abort(), TASK_TRIAGE_LIMITS.timeoutMs);
103
+ const work: Promise<TaskTriageCurrent | null> = (async () => {
104
+ try {
105
+ const result = await Promise.race([
106
+ service.evaluate({ state: built.state, questions: TASK_TRIAGE_QUESTIONS, questionSetVersion: TASK_TRIAGE_QUESTION_VERSION, timeoutMs: TASK_TRIAGE_LIMITS.timeoutMs, signal: call.signal }),
107
+ new Promise<never>((_, reject) => call.signal.addEventListener("abort", () => reject(new Error("deadline")), { once: true })),
108
+ ]);
109
+ providerResult = result;
110
+ const assessment = assessTaskTriage(result);
111
+ if (epoch !== generation || pending?.revision !== input.revision) return null;
112
+ // A result is reusable only after its bounded projection is durably appended.
113
+ const cached: Snapshot = { ...snapshot!, assessments: { ...snapshot!.assessments, [fingerprint]: assessment } };
114
+ try { options.persist(cached); snapshot = cached; }
115
+ catch { return record({ status: "unavailable", reasons: [], detail: "result_persistence_failed" }); }
116
+ return record(assessment);
117
+ } catch { return record({ status: call.signal.aborted ? "unavailable" : "unavailable", reasons: [], detail: call.signal.aborted ? "deadline_or_cancelled" : "provider_failure" }); }
118
+ finally { clearTimeout(timeout); if (controller === call) controller = null; if (cancelObservation === cancel) cancelObservation = null; }
119
+ })();
120
+ flight = { fingerprint, taskId, generation, promise: work };
121
+ try { return await work; }
122
+ finally { if (flight?.promise === work) flight = null; }
123
+ },
124
+ };
125
+ }
@@ -0,0 +1,21 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+
3
+ /** A stage producer under action confirmation may inspect and return evidence text.
4
+ * The Hub persists its output as the plan/review artifact; no unbound child
5
+ * shell or file write can stand in for an exact action-bound human grant.
6
+ */
7
+ export function stageProducerTools(declared: string): string {
8
+ return declared.split(",").map(tool => tool.trim()).filter(tool => ["read", "grep", "find", "ls"].includes(tool)).join(",");
9
+ }
10
+
11
+ export function stageProducerToolGate(tool: string): string | null {
12
+ return ["read", "grep", "find", "ls"].includes(tool)
13
+ ? null : "Unbound stage producer effect refused; use the Hub's exact action confirmation for effects.";
14
+ }
15
+
16
+ export default function stageGuard(pi: ExtensionAPI): void {
17
+ pi.on("tool_call", event => {
18
+ const reason = stageProducerToolGate(String(event.toolName));
19
+ if (reason) return { block: true, reason };
20
+ });
21
+ }