@chankov/agent-fleet 2.0.10 → 2.0.11

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 (531) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +26 -8
  2. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
  3. package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  4. package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
  5. package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  6. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
  7. package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
  8. package/.pi/harnesses/agent-hub/README.md +53 -18
  9. package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
  10. package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
  11. package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  12. package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  13. package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
  14. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
  15. package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  17. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  18. package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
  19. package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
  20. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
  21. package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
  22. package/.pi/harnesses/agent-hub/delegate.ts +19 -2
  23. package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  24. package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  25. package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  26. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
  27. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
  28. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
  29. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
  30. package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
  31. package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  32. package/.pi/harnesses/agent-hub/helpers.ts +5 -1
  33. package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
  34. package/.pi/harnesses/agent-hub/index.ts +145 -14
  35. package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
  36. package/.pi/harnesses/agent-hub/package.json +1 -1
  37. package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
  38. package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  39. package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
  40. package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
  41. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
  42. package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  43. package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
  44. package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
  45. package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  46. package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  47. package/.pi/harnesses/agent-hub/spawn.ts +61 -7
  48. package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  49. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  50. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  51. package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  52. package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
  53. package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
  54. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  55. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +176 -26
  56. package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  57. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
  58. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
  59. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
  60. package/.pi/harnesses/agent-hub/types.ts +2 -0
  61. package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  62. package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
  63. package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  64. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
  65. package/.pi/harnesses/coms/package.json +1 -1
  66. package/.pi/harnesses/damage-control-continue/index.ts +9 -0
  67. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  68. package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  69. package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
  70. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  71. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  72. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  73. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  74. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  75. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  76. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  77. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  78. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  79. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  80. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  81. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  82. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  83. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  84. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  85. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  86. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  87. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  88. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  89. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  90. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  91. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  92. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  93. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  94. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  95. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  96. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  97. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  98. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  99. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  100. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  101. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  102. package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  103. package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  104. package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  105. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  106. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  107. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  108. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  109. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  110. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
  111. package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
  112. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  113. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  114. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  115. package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  116. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  117. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  118. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  119. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  120. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  121. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  122. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  123. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  124. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  125. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  126. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  127. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  128. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  129. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  130. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  131. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  132. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  133. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  134. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  135. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  136. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  137. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  138. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  139. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  140. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  141. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  142. package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
  143. package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
  144. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  145. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  146. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  147. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
  148. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  149. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  150. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  151. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  152. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  153. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  154. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  155. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  156. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  157. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  158. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  159. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  160. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  161. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  162. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  163. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  164. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  165. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  166. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  167. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  168. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  169. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  170. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  171. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  172. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  173. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  174. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  175. package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  176. package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
  177. package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
  178. package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
  179. package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
  180. package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
  181. package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
  182. package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
  183. package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
  184. package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
  185. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  186. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  187. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  188. package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  189. package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  190. package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  191. package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  192. package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  193. package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  194. package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
  195. package/.versions/2.0.11/.pi/extensions/package.json +9 -0
  196. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
  197. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  198. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  199. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  200. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  201. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  202. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  203. package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
  204. package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  205. package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  206. package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  207. package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  208. package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  209. package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  210. package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  211. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  212. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
  213. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  214. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
  215. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  216. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  217. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  218. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  219. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  220. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  221. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  222. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  223. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  224. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  225. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  226. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  227. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  228. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  229. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  230. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  231. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
  232. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  233. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  234. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  235. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  236. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  237. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  238. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  239. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  240. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  241. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  242. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  243. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  244. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  245. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  246. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  247. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  248. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  249. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  250. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  251. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  252. package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  253. package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
  254. package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  255. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  256. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  257. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  258. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  259. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
  260. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  261. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
  262. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
  263. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  264. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  265. package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  266. package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  267. package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  268. package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  269. package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  270. package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  271. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
  272. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  276. package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
  277. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  278. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  279. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  280. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  281. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  282. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  283. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  284. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  285. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  286. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  287. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  288. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  289. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  290. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  291. package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
  292. package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  293. package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  294. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  295. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  296. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  297. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  298. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  299. package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  300. package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
  301. package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  302. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  303. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  304. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  305. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  306. package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  307. package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  308. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  309. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  310. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  311. package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  312. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
  313. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  314. package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  315. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
  316. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  317. package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  318. package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  319. package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  320. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  321. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  322. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
  323. package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
  324. package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  325. package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
  326. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  327. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  328. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  329. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  330. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  331. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  332. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  333. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
  334. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  335. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  336. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  337. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  338. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  339. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  340. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  341. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  342. package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
  343. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  344. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  345. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  346. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  347. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  348. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  349. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  350. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  351. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  352. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  353. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  354. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  355. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  356. package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  357. package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  358. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  359. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  360. package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  361. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
  362. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
  363. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  364. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  365. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  366. package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
  367. package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
  368. package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
  369. package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
  370. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
  371. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
  372. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  373. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  374. package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  375. package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
  376. package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
  377. package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  378. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  379. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  380. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
  381. package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
  382. package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  383. package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  384. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  385. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  386. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  387. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  388. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  389. package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  390. package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  391. package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
  392. package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  393. package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
  394. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  395. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  396. package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  397. package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  398. package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  399. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  400. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  401. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  402. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  403. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  404. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  405. package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  406. package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
  407. package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
  408. package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
  409. package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
  410. package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
  411. package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
  412. package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
  413. package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
  414. package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  415. package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  416. package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
  417. package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
  418. package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
  419. package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
  420. package/.versions/2.0.11/.version +1 -0
  421. package/.versions/2.0.11/agents/architect.md +25 -0
  422. package/.versions/2.0.11/agents/bowser.md +28 -0
  423. package/.versions/2.0.11/agents/builder.md +56 -0
  424. package/.versions/2.0.11/agents/code-reviewer.md +210 -0
  425. package/.versions/2.0.11/agents/deep-researcher.md +33 -0
  426. package/.versions/2.0.11/agents/documenter.md +23 -0
  427. package/.versions/2.0.11/agents/orchestrator.md +23 -0
  428. package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
  429. package/.versions/2.0.11/agents/planner.md +106 -0
  430. package/.versions/2.0.11/agents/releaser.md +25 -0
  431. package/.versions/2.0.11/agents/researcher.md +31 -0
  432. package/.versions/2.0.11/agents/security-auditor.md +168 -0
  433. package/.versions/2.0.11/agents/test-engineer.md +154 -0
  434. package/.versions/2.0.11/agents/web-debugger.md +44 -0
  435. package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
  436. package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
  437. package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
  438. package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
  439. package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
  440. package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
  441. package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
  442. package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
  443. package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
  444. package/.versions/2.0.11/docs/getting-started.md +126 -0
  445. package/.versions/2.0.11/docs/npm-install.md +383 -0
  446. package/.versions/2.0.11/docs/pi-extensions.md +449 -0
  447. package/.versions/2.0.11/docs/pi-setup.md +92 -0
  448. package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
  449. package/.versions/2.0.11/install-manifest.json +3020 -0
  450. package/.versions/2.0.11/justfile +247 -0
  451. package/.versions/2.0.11/manifest-meta.json +970 -0
  452. package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
  453. package/.versions/2.0.11/references/communication-contract.md +26 -0
  454. package/.versions/2.0.11/references/definition-of-done.md +67 -0
  455. package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
  456. package/.versions/2.0.11/references/observability-checklist.md +92 -0
  457. package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
  458. package/.versions/2.0.11/references/performance-checklist.md +236 -0
  459. package/.versions/2.0.11/references/prompting-patterns.md +380 -0
  460. package/.versions/2.0.11/references/security-checklist.md +245 -0
  461. package/.versions/2.0.11/references/testing-patterns.md +235 -0
  462. package/.versions/2.0.11/references/workflow-authoring.md +304 -0
  463. package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
  464. package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  465. package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
  466. package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
  467. package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
  468. package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
  469. package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
  470. package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
  471. package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
  472. package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  473. package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
  474. package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  475. package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  476. package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  477. package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
  478. package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
  479. package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
  480. package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  481. package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  482. package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
  483. package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
  484. package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
  485. package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
  486. package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
  487. package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
  488. package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
  489. package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
  490. package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
  491. package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  492. package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
  493. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  494. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  495. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  496. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  497. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  498. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  499. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  500. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  501. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  502. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  503. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  504. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  505. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  506. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  507. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  508. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  509. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  510. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  511. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  512. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  513. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  514. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  515. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  516. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  517. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  518. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  519. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  520. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  521. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  522. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  523. package/CHANGELOG.md +8 -0
  524. package/README.md +1 -0
  525. package/bin/catalog/harness-runtime-closure.json +29 -0
  526. package/bin/cli.js +15 -4
  527. package/bin/lib/doctor.js +83 -1
  528. package/docs/ARCHITECTURE.md +181 -2
  529. package/docs/workflows.md +8 -2
  530. package/install-manifest.json +31 -2
  531. package/package.json +2 -2
@@ -12,11 +12,11 @@ import { Run, type FinishResult } from "./workflows/lib/run.ts";
12
12
  import { buildTestWorkflow, buildTestWorkflowPreflight } from "./workflows/wf-build-test.ts";
13
13
  import { documentWorkflow, documentWorkflowPreflight } from "./workflows/wf-document.ts";
14
14
  import { qualityWorkflow, qualityWorkflowPreflight } from "./workflows/wf-quality.ts";
15
- import { scoutWorkflow, scoutWorkflowPreflight } from "./workflows/wf-scout.ts";
15
+ import { scoutWorkflow, scoutWorkflowPreflight, type ScoutWorkflowDeps } from "./workflows/wf-scout.ts";
16
16
  import { pollWorkflow, pollWorkflowPreflight, pollWorkflowValidate } from "./workflows/wf-poll.ts";
17
17
  import { debateWorkflow, debateWorkflowPreflight, debateWorkflowValidate } from "./workflows/wf-debate.ts";
18
18
 
19
- export type Workflow = (run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }) => Promise<FinishResult>;
19
+ export type Workflow = (run: Run, input: { args: string[]; dryRun: boolean; cwd: string; panel?: string; rounds?: number; apply?: boolean }, deps?: any) => Promise<FinishResult>;
20
20
  export interface WorkflowDefinition {
21
21
  run: Workflow;
22
22
  validate?: (command: FlowCommand, cwd: string) => void;
@@ -64,20 +64,31 @@ export async function resolveWorkflow(name: string, workflowsDir = resolve(dirna
64
64
  return { run: run as Workflow, ...(typeof preflight === "function" ? { preflight: preflight as (cwd: string) => void } : {}) };
65
65
  }
66
66
 
67
- export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string } = {}): Promise<FinishResult> {
67
+ export interface HubScoutExecution {
68
+ /** Hub-only no-branch mode. CLI callers omit this and retain legacy branch semantics. */
69
+ noBranch: true;
70
+ traceDirectory: string;
71
+ signal?: AbortSignal;
72
+ scoutAgent?: ScoutWorkflowDeps["agent"];
73
+ }
74
+
75
+ export async function executeFlow(command: FlowCommand, options: { cwd?: string; command?: string[]; workflowsDir?: string; hubScout?: HubScoutExecution } = {}): Promise<FinishResult> {
68
76
  const cwd = options.cwd ?? process.cwd();
77
+ if (options.hubScout && command.name !== "scout") throw Object.assign(new Error("Hub no-branch execution currently permits only the read-only scout flow"), { exitCode: 2 });
69
78
  const workflow = await resolveWorkflow(command.name, options.workflowsDir);
70
79
  if (!workflow) throw Object.assign(new Error(`Unknown flow: ${command.name}`), { exitCode: 2 });
71
80
  workflow.validate?.(command, cwd);
72
81
  loadEnv(cwd);
73
- // All refusal checks precede branch creation and the FlowTrace constructor.
74
- requireCleanTree(cwd, command.allowDirty);
82
+ // CLI keeps its clean-tree + branch defaults. Hub scout runs only in a detached
83
+ // isolated snapshot and never creates or annotates a branch.
84
+ if (!options.hubScout) requireCleanTree(cwd, command.allowDirty);
75
85
  workflow.preflight?.(cwd, command);
76
86
  const runId = command.runId ?? makeRunId();
77
87
  const repositoryBaseline = snapshot(cwd);
78
- const branch = createFlowBranch(command.name, runId, cwd);
79
- const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline });
88
+ const branch = options.hubScout ? undefined : createFlowBranch(command.name, runId, cwd);
89
+ const run = new Run({ cwd, runId, command: options.command ?? process.argv, repositoryBaseline, traceDirectory: options.hubScout?.traceDirectory });
80
90
  const persistResult = (result: FinishResult) => {
91
+ if (!branch) return;
81
92
  try { recordFlowResult(branch, result.status, cwd); }
82
93
  catch (error) { console.error(`Warning: flow result metadata was not recorded: ${error instanceof Error ? error.message : String(error)}`); }
83
94
  };
@@ -86,10 +97,16 @@ export async function executeFlow(command: FlowCommand, options: { cwd?: string;
86
97
  if (interruption) return;
87
98
  interruption = run.interrupt(signal);
88
99
  };
100
+ const onAbort = () => { if (!interruption) interruption = run.abort("cancelled by Hub owner", 130); };
89
101
  process.once("SIGINT", onSignal);
90
102
  process.once("SIGTERM", onSignal);
103
+ options.hubScout?.signal?.addEventListener("abort", onAbort, { once: true });
91
104
  try {
92
- const result = await workflow.run(run, { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply });
105
+ if (options.hubScout?.signal?.aborted) onAbort();
106
+ const input = { args: command.args, dryRun: command.dryRun, cwd, panel: command.panel, rounds: command.rounds, apply: command.apply };
107
+ const result = options.hubScout
108
+ ? await workflow.run(run, input, { ...(options.hubScout.scoutAgent ? { agent: options.hubScout.scoutAgent } : {}), dataReadRoot: cwd })
109
+ : await workflow.run(run, input);
93
110
  const finalResult = interruption ?? result;
94
111
  persistResult(finalResult);
95
112
  console.error(finalResult.banner);
@@ -108,6 +125,7 @@ export async function executeFlow(command: FlowCommand, options: { cwd?: string;
108
125
  } finally {
109
126
  process.removeListener("SIGINT", onSignal);
110
127
  process.removeListener("SIGTERM", onSignal);
128
+ options.hubScout?.signal?.removeEventListener("abort", onAbort);
111
129
  }
112
130
  }
113
131
 
@@ -1,12 +1,17 @@
1
1
  import { profileFallback } from './model-profile.ts';
2
2
  import type { ChildProcess } from "node:child_process";
3
- import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
3
+ import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
4
+ import { homedir } from "node:os";
4
5
  import { resolve } from "node:path";
6
+ import { fileURLToPath } from "node:url";
7
+ import { SCOUT_DATA_ROOT_ENV } from "./scout-data-boundary.ts";
5
8
 
6
9
  interface SpawnPiAgentOptions {
7
10
  model: string; tools: string; thinking: string; systemPrompt?: string; noSkills?: boolean; noContextFiles?: boolean;
8
11
  sessionFile: string; resume?: boolean; prompt: string; cwd?: string; extensions?: string[]; detached?: boolean;
9
12
  signal?: AbortSignal; toolWatchdog?: { timeoutMs: number | null }; turnDeadlineMs?: number | null;
13
+ env?: Record<string, string>;
14
+ writeIsolation?: { enabled: true; cwd: string; runtimePaths: string[] };
10
15
  }
11
16
  interface SpawnPiAgentResult { output: string; exitCode: number | null; assistantError?: string; spawnError?: string; stderr?: string }
12
17
  interface SpawnCallbacks { onProcess?(process: ChildProcess): void; onUsage?(usage: { input?: number; output?: number; cacheRead?: number; cacheWrite?: number }): void }
@@ -37,6 +42,8 @@ export interface AgentPhaseOptions<T = unknown> {
37
42
  toolWatchdogMs?: number; turnDeadlineMs?: number; rulesPaths?: string[]; docsPaths?: string[];
38
43
  gates?: Gate<T>[]; gateRetries?: number; protectedGlobs?: string[]; permissionPolicy?: PermissionPolicy;
39
44
  model?: string; thinking?: string; sessionTag?: string;
45
+ /** Hub scout only: confine OS writes and declared filesystem-tool data reads to this snapshot. */
46
+ dataReadRoot?: string;
40
47
  }
41
48
 
42
49
  export function modelTag(model: string): string {
@@ -95,17 +102,54 @@ export async function runAgentPhase<T = unknown>(options: AgentPhaseOptions<T>):
95
102
  options.run.trace.write("log", { phase: options.persona.name, message: `session recycled before spawn — ${overflow.message}` });
96
103
  }
97
104
  let measuredTokens = meta.contextTokens;
98
- const result = await spawnAgent({
99
- model, tools: options.persona.tools, thinking,
100
- systemPrompt: replacement, noSkills: true, noContextFiles: true, sessionFile, resume, prompt, cwd,
101
- extensions: [".pi/harnesses/damage-control-continue/index.ts"], detached: true, signal: options.run.signal,
102
- toolWatchdog: { timeoutMs: options.toolWatchdogMs ?? 120_000 }, turnDeadlineMs: options.turnDeadlineMs ?? 1_200_000,
103
- }, profileFallback(options.persona.fallbackModel), {
104
- onProcess: process => options.run.registerProcess(process, options.persona.name),
105
- onUsage: usage => {
106
- measuredTokens = Math.max(measuredTokens, Number(usage.input ?? 0) + Number(usage.output ?? 0) + Number((usage as any).cacheRead ?? 0) + Number((usage as any).cacheWrite ?? 0));
107
- },
108
- }, { midRun: !/(^|,)(write|edit)(,|$)/.test(options.persona.tools) });
105
+ const scoutBoundary = options.dataReadRoot ? fileURLToPath(new URL("./scout-data-boundary.ts", import.meta.url)) : null;
106
+ // Pi needs writable trust/auth locks even during read-only reconnaissance.
107
+ // Copy only runtime configuration, never the user's extensions or sessions.
108
+ const runtime = options.dataReadRoot ? mkdtempSync(resolve(directory, "pi-runtime-")) : null;
109
+ let result: SpawnPiAgentResult;
110
+ try {
111
+ if (runtime) {
112
+ // Match Pi's documented override without requiring its SDK in packaged CLI installs.
113
+ const configured = process.env.PI_CODING_AGENT_DIR || resolve(homedir(), ".pi", "agent");
114
+ const source = configured === "~" ? homedir() : configured.startsWith("~/") ? resolve(homedir(), configured.slice(2)) : resolve(configured);
115
+ for (const name of ["auth.json", "models.json", "settings.json", "trust.json"]) {
116
+ try {
117
+ let contents = readFileSync(resolve(source, name), "utf8");
118
+ if (name === "settings.json") {
119
+ // --no-extensions does not stop Pi resolving/installing packages.
120
+ // Managed scout loads only the explicitly supplied Fleet extensions.
121
+ const settings = JSON.parse(contents);
122
+ for (const key of ["packages", "extensions", "skills", "prompts", "themes"]) settings[key] = [];
123
+ contents = JSON.stringify(settings);
124
+ }
125
+ writeFileSync(resolve(runtime, name), contents, { mode: 0o600, flag: "wx" });
126
+ } catch (error) {
127
+ if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
128
+ }
129
+ }
130
+ mkdirSync(resolve(runtime, "tmp"), { mode: 0o700 });
131
+ }
132
+ result = await spawnAgent({
133
+ model, tools: options.persona.tools, thinking,
134
+ systemPrompt: replacement, noSkills: true, noContextFiles: true, sessionFile, resume, prompt, cwd,
135
+ extensions: scoutBoundary
136
+ ? [fileURLToPath(new URL("../../../../../.pi/harnesses/damage-control-continue/index.ts", import.meta.url)), scoutBoundary]
137
+ : [".pi/harnesses/damage-control-continue/index.ts"], detached: true, signal: options.run.signal,
138
+ ...(options.dataReadRoot ? {
139
+ env: { [SCOUT_DATA_ROOT_ENV]: resolve(options.dataReadRoot), PI_CODING_AGENT_DIR: runtime!, TMPDIR: resolve(runtime!, "tmp") },
140
+ writeIsolation: { enabled: true as const, cwd, runtimePaths: [directory] },
141
+ } : {}),
142
+ toolWatchdog: { timeoutMs: options.toolWatchdogMs ?? 120_000 }, turnDeadlineMs: options.turnDeadlineMs ?? 1_200_000,
143
+ }, profileFallback(options.persona.fallbackModel), {
144
+ onProcess: process => options.run.registerProcess(process, options.persona.name),
145
+ onUsage: usage => {
146
+ measuredTokens = Math.max(measuredTokens, Number(usage.input ?? 0) + Number(usage.output ?? 0) + Number((usage as any).cacheRead ?? 0) + Number((usage as any).cacheWrite ?? 0));
147
+ },
148
+ }, { midRun: !/(^|,)(write|edit)(,|$)/.test(options.persona.tools) });
149
+ } finally {
150
+ // Includes provider failure, cancellation, and setup/spawn exceptions.
151
+ if (runtime) rmSync(runtime, { recursive: true, force: true });
152
+ }
109
153
  meta = { contextTokens: measuredTokens };
110
154
  writeFileSync(metaFile, JSON.stringify(meta), "utf8");
111
155
  const after = snapshot(cwd);
@@ -0,0 +1,125 @@
1
+ import { createHash } from "node:crypto";
2
+ import { execFileSync } from "node:child_process";
3
+ import { chmodSync, closeSync, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, rmSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
4
+ import { constants } from "node:fs";
5
+ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
6
+
7
+ export const ISOLATED_SNAPSHOT_SCHEMA = "agent-fleet.flow-snapshot/v1" as const;
8
+ export interface SnapshotEntry { path: string; sha256: string | null; size: number; mode: number; state: "file" | "deleted" }
9
+ export interface IsolatedSnapshotManifest {
10
+ schema: typeof ISOLATED_SNAPSHOT_SCHEMA; sourceRoot: string; sourceRevision: string; sourceStateHash: string;
11
+ createdAt: string; entries: SnapshotEntry[]; excluded: string[]; workspace: string;
12
+ }
13
+
14
+ function git(cwd: string, args: string[]): string { return execFileSync("git", args, { cwd, encoding: "utf8", maxBuffer: 64 * 1024 * 1024 }); }
15
+ function safeRelative(path: string): string {
16
+ const value = path.replaceAll("\\", "/").replace(/^\.\//, "");
17
+ if (!value || isAbsolute(value) || value.split("/").includes("..") || value.includes("\0")) throw new Error(`Unsafe snapshot path: ${JSON.stringify(path)}`);
18
+ return value;
19
+ }
20
+ function sensitive(path: string): boolean {
21
+ const parts = path.toLowerCase().split("/"); const base = parts.at(-1) ?? "";
22
+ return parts.includes("agent-sessions") || parts.includes("flow-sessions") || /^\.env(?:\.|$)/.test(base) || /^(?:auth|credentials?|secrets?)\.json$/.test(base);
23
+ }
24
+ function assertInside(root: string, path: string, label: string): void {
25
+ const fromRoot = relative(root, path);
26
+ if (fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) throw new Error(`${label} escapes owned root`);
27
+ }
28
+ function pathExists(path: string): boolean { try { lstatSync(path); return true; } catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return false; throw error; } }
29
+ function assertPlainParents(root: string, relativePath: string): void {
30
+ let current = root;
31
+ for (const part of relativePath.split("/").slice(0, -1)) {
32
+ current = join(current, part);
33
+ assertInside(root, current, `Snapshot path ${relativePath}`);
34
+ if (pathExists(current) && lstatSync(current).isSymbolicLink()) throw new Error(`Snapshot path traverses symlink: ${relativePath}`);
35
+ }
36
+ }
37
+ function stableBytes(root: string, path: string): { data: Buffer; mode: number } {
38
+ const full = resolve(root, path);
39
+ assertInside(root, full, `Snapshot source ${path}`);
40
+ assertPlainParents(root, path);
41
+ let fd: number | undefined;
42
+ try {
43
+ fd = openSync(full, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
44
+ const before = fstatSync(fd);
45
+ if (!before.isFile()) throw new Error(`Snapshot source must be a plain file: ${path}`);
46
+ const data = readFileSync(fd);
47
+ const after = fstatSync(fd);
48
+ if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeMs !== after.mtimeMs) throw new Error(`Snapshot source changed while read: ${path}`);
49
+ return { data, mode: before.mode & 0o777 };
50
+ } catch (error) {
51
+ if ((error as NodeJS.ErrnoException).code === "ELOOP") throw new Error(`Snapshot source must be a plain file: ${path}`);
52
+ throw error;
53
+ } finally { if (fd !== undefined) closeSync(fd); }
54
+ }
55
+ function inspect(root: string, path: string): SnapshotEntry {
56
+ const full = resolve(root, path);
57
+ assertInside(root, full, `Snapshot source ${path}`);
58
+ assertPlainParents(root, path);
59
+ if (!pathExists(full)) return { path, sha256: null, size: 0, mode: 0, state: "deleted" };
60
+ const { data, mode } = stableBytes(root, path);
61
+ return { path, sha256: createHash("sha256").update(data).digest("hex"), size: data.length, mode, state: "file" };
62
+ }
63
+ function stateHash(entries: SnapshotEntry[]): string { return createHash("sha256").update(JSON.stringify(entries)).digest("hex"); }
64
+ function listedPaths(root: string): { included: string[]; excluded: string[] } {
65
+ const raw = git(root, ["ls-files", "-z", "--cached", "--others", "--exclude-standard"]);
66
+ const all = raw.split("\0").filter(Boolean).map(safeRelative).sort();
67
+ return { included: all.filter(path => !sensitive(path)), excluded: all.filter(sensitive) };
68
+ }
69
+ function removeOwnedLeaf(root: string, path: string): void {
70
+ const destination = resolve(root, path);
71
+ assertInside(root, destination, `Snapshot destination ${path}`);
72
+ assertPlainParents(root, path);
73
+ if (!pathExists(destination)) return;
74
+ const value = lstatSync(destination);
75
+ if (value.isDirectory() && !value.isSymbolicLink()) throw new Error(`Snapshot destination unexpectedly became a directory: ${path}`);
76
+ unlinkSync(destination); // unlink the leaf itself; never recurse through or follow its target
77
+ }
78
+ function prepareOwnedParents(root: string, path: string): void {
79
+ assertPlainParents(root, path);
80
+ mkdirSync(dirname(resolve(root, path)), { recursive: true, mode: 0o700 });
81
+ assertPlainParents(root, path);
82
+ }
83
+ function writeOwnedFile(root: string, entry: SnapshotEntry, data: Buffer): void {
84
+ const destination = resolve(root, entry.path);
85
+ assertInside(root, destination, `Snapshot destination ${entry.path}`);
86
+ prepareOwnedParents(root, entry.path);
87
+ removeOwnedLeaf(root, entry.path);
88
+ assertPlainParents(root, entry.path);
89
+ let fd: number | undefined;
90
+ try {
91
+ fd = openSync(destination, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), entry.mode);
92
+ writeSync(fd, data);
93
+ } finally { if (fd !== undefined) closeSync(fd); }
94
+ chmodSync(destination, entry.mode);
95
+ }
96
+
97
+ /** Create a detached local clone plus a stable overlay of the current working tree. Never mutates sourceRoot. */
98
+ export function createIsolatedWorkingTreeSnapshot(sourceRoot: string, workspace: string, manifestPath: string): IsolatedSnapshotManifest {
99
+ const root = resolve(sourceRoot), target = resolve(workspace);
100
+ if (target === root || !relative(root, target).startsWith("..")) throw new Error("Snapshot destination must be outside the source tree");
101
+ if (pathExists(target)) throw new Error("Snapshot destination must be newly owned and absent");
102
+ const sourceRevision = git(root, ["rev-parse", "HEAD"]).trim();
103
+ const { included, excluded } = listedPaths(root);
104
+ const first = included.map(path => inspect(root, path));
105
+ mkdirSync(dirname(target), { recursive: true, mode: 0o700 });
106
+ execFileSync("git", ["clone", "--quiet", "--no-hardlinks", "--no-checkout", root, target]);
107
+ execFileSync("git", ["checkout", "--quiet", "--detach", sourceRevision], { cwd: target });
108
+ for (const path of excluded) removeOwnedLeaf(target, path);
109
+ for (const entry of first) {
110
+ if (entry.state === "deleted") removeOwnedLeaf(target, entry.path);
111
+ else {
112
+ const { data } = stableBytes(root, entry.path);
113
+ const currentHash = createHash("sha256").update(data).digest("hex");
114
+ if (currentHash !== entry.sha256 || data.length !== entry.size) throw new Error(`Snapshot source changed before copy: ${entry.path}`);
115
+ writeOwnedFile(target, entry, data);
116
+ const copied = inspect(target, entry.path);
117
+ if (copied.sha256 !== entry.sha256 || copied.size !== entry.size) throw new Error(`Snapshot copy did not match stable source: ${entry.path}`);
118
+ }
119
+ }
120
+ const second = included.map(path => inspect(root, path));
121
+ if (stateHash(first) !== stateHash(second)) { rmSync(target, { recursive: true, force: true }); throw new Error("Source working tree changed while isolated snapshot was created"); }
122
+ const manifest: IsolatedSnapshotManifest = { schema: ISOLATED_SNAPSHOT_SCHEMA, sourceRoot: root, sourceRevision, sourceStateHash: stateHash(second), createdAt: new Date().toISOString(), entries: second, excluded, workspace: target };
123
+ mkdirSync(dirname(manifestPath), { recursive: true, mode: 0o700 }); writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o400 });
124
+ return manifest;
125
+ }
@@ -37,8 +37,8 @@ export class Run {
37
37
  private readonly cancellation = new AbortController();
38
38
  readonly signal = this.cancellation.signal;
39
39
 
40
- constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; repositoryBaseline?: PermissionSnapshot } = {}) {
41
- this.trace = options.trace ?? new FlowTrace(options);
40
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; trace?: FlowTrace; traceDirectory?: string; repositoryBaseline?: PermissionSnapshot } = {}) {
41
+ this.trace = options.trace ?? new FlowTrace({ ...options, directory: options.traceDirectory });
42
42
  this.command = options.command ?? [];
43
43
  this.repositoryBaseline = options.repositoryBaseline;
44
44
  }
@@ -0,0 +1,55 @@
1
+ import { existsSync, lstatSync, realpathSync } from "node:fs";
2
+ import { isAbsolute, relative, resolve, sep } from "node:path";
3
+
4
+ export const SCOUT_DATA_ROOT_ENV = "AGENT_FLEET_SCOUT_DATA_ROOT";
5
+ const FILESYSTEM_TOOLS = new Set(["read", "grep", "find", "ls"]);
6
+
7
+ function hasTraversal(value: string): boolean {
8
+ return value.replaceAll("\\", "/").split("/").includes("..");
9
+ }
10
+
11
+ function inside(root: string, candidate: string): boolean {
12
+ const fromRoot = relative(root, candidate);
13
+ return fromRoot === "" || (!isAbsolute(fromRoot) && fromRoot !== ".." && !fromRoot.startsWith(`..${sep}`));
14
+ }
15
+
16
+ /** Validate model-declared filesystem data paths without restricting runtime/library reads. */
17
+ export function validateScoutDataPath(rootValue: string, cwdValue: string, inputValue: unknown): string | null {
18
+ if (typeof inputValue !== "string" || inputValue.includes("\0")) return "Scout filesystem path must be a plain string.";
19
+ if (hasTraversal(inputValue)) return "Scout filesystem traversal is denied.";
20
+ const root = realpathSync(resolve(rootValue));
21
+ // Canonicalize cwd too: Darwin tmpdir aliases (/var vs /private/var) would
22
+ // otherwise make every in-snapshot read look like an escape.
23
+ const cwd = realpathSync(resolve(cwdValue));
24
+ const candidate = resolve(cwd, inputValue || ".");
25
+ if (!inside(root, candidate)) return "Scout filesystem reads are limited to the isolated snapshot.";
26
+ let current = root;
27
+ const fromRoot = relative(root, candidate);
28
+ for (const part of fromRoot ? fromRoot.split(sep) : []) {
29
+ current = resolve(current, part);
30
+ if (!existsSync(current)) break;
31
+ if (lstatSync(current).isSymbolicLink()) return "Scout filesystem symlink traversal is denied.";
32
+ }
33
+ if (existsSync(candidate) && !inside(root, realpathSync(candidate))) return "Scout filesystem symlink escape is denied.";
34
+ return null;
35
+ }
36
+
37
+ function validatePattern(value: unknown): string | null {
38
+ if (value === undefined) return null;
39
+ if (typeof value !== "string" || value.includes("\0") || isAbsolute(value) || hasTraversal(value)) return "Scout filesystem pattern traversal is denied.";
40
+ return null;
41
+ }
42
+
43
+ export default function scoutDataBoundary(pi: { on(name: "tool_call", handler: (event: { toolName?: string; input: unknown }, ctx: { cwd: string }) => unknown): void }): void {
44
+ pi.on("tool_call", (event, ctx) => {
45
+ const tool = String(event.toolName ?? "").toLowerCase();
46
+ if (!FILESYSTEM_TOOLS.has(tool)) return;
47
+ const root = process.env[SCOUT_DATA_ROOT_ENV];
48
+ if (!root) return { block: true, reason: "Scout filesystem boundary is unavailable." };
49
+ const input = event.input as Record<string, unknown>;
50
+ const reason = validateScoutDataPath(root, ctx.cwd, tool === "read" ? input.path : (input.path ?? "."))
51
+ ?? (tool === "grep" ? validatePattern(input.glob) : null)
52
+ ?? (tool === "find" ? validatePattern(input.pattern) : null);
53
+ return reason ? { block: true, reason } : { block: false };
54
+ });
55
+ }
@@ -12,10 +12,10 @@ export class FlowTrace {
12
12
  readonly file: string;
13
13
  private ended = false;
14
14
 
15
- constructor(options: { cwd?: string; runId?: string; command?: string[]; pid?: number } = {}) {
15
+ constructor(options: { cwd?: string; runId?: string; command?: string[]; pid?: number; directory?: string } = {}) {
16
16
  this.runId = options.runId ?? makeRunId();
17
17
  this.cwd = resolve(options.cwd ?? process.cwd());
18
- this.directory = resolve(this.cwd, ".pi", "flow-sessions", this.runId);
18
+ this.directory = options.directory ? resolve(options.directory) : resolve(this.cwd, ".pi", "flow-sessions", this.runId);
19
19
  this.file = resolve(this.directory, "trace.jsonl");
20
20
  mkdirSync(this.directory, { recursive: true });
21
21
  this.write("run_start", { pid: options.pid ?? process.pid, command: options.command ?? process.argv });
@@ -8,6 +8,8 @@ export const SCOUT_PERMISSION_POLICY: PermissionPolicy = { writes: [] };
8
8
  export interface ScoutWorkflowDeps {
9
9
  agent?: (options: Parameters<typeof runAgentPhase<ScoutReport>>[0]) => Promise<ScoutReport>;
10
10
  persona?: PersonaDefinition;
11
+ /** Present only for the Hub adapter's owned isolated snapshot. */
12
+ dataReadRoot?: string;
11
13
  }
12
14
 
13
15
  export function scoutWorkflowPreflight(cwd: string): void {
@@ -31,7 +33,7 @@ export async function scoutWorkflow(run: Run, input: { args: string[]; dryRun: b
31
33
  if (!parsed.ok) throw new Error(parsed.errors.join("; "));
32
34
  return parsed.value!;
33
35
  }
34
- return agent({ run, persona, task: request, envelope: "scout", cwd: input.cwd, permissionPolicy: SCOUT_PERMISSION_POLICY });
36
+ return agent({ run, persona, task: request, envelope: "scout", cwd: input.cwd, permissionPolicy: SCOUT_PERMISSION_POLICY, ...(deps.dataReadRoot ? { dataReadRoot: deps.dataReadRoot } : {}) });
35
37
  });
36
38
  run.trace.write("log", { phase: "scout", message: report.summary, findings: report.findings });
37
39
  return run.finish({ accepted: true });
@@ -1181,21 +1181,56 @@ tool results; `artifacts/...` is a session-relative handoff alias, not a read-to
1181
1181
 
1182
1182
  ### No-progress stops
1183
1183
 
1184
- The first unchanged retry after a failed dispatch/research operation is refused across
1185
- turns. Identity uses actor, scope, supplied artifact contents and worktree content,
1186
- not task wording; generated runtime files are not progress. Budget renewal preserves
1187
- the guard. New input content/scope or a genuine new task can permit work. For research
1188
- without scope/artifacts, the guard conservatively treats the repository as its scope.
1189
-
1190
- A human may type `/af-retry <failed-dispatchId>` to authorize exactly one retry of
1191
- that failure. The command is audited, does not dispatch or renew budget, and stale
1192
- IDs/prose do not authorize. Same-input concurrent operations are also refused.
1193
-
1194
- The first unchanged refusal leaves the parent turn running so corrected inputs can
1195
- be supplied; a second unchanged refusal stops the turn. Successful-but-unverified
1196
- execution is **not** a no-progress failure; actual execution failure or failed
1197
- deliverable readback is. This distinction prevents acceptance policy from blocking
1198
- normal successful follow-up work.
1184
+ Unchanged failed dispatch/research retries are refused across turns using normalized
1185
+ actor, structured scope, input artifacts, actual execution conditions and worktree
1186
+ state, not task wording or scope_mode. Research scope is advisory, not isolation.
1187
+
1188
+ Operator cancellation fences the **agent identity**, including disjoint scopes,
1189
+ model/prose changes and dispatch/research inputs. Other agents' already-running work
1190
+ is not cancelled. A human `/af-retry <cancelled-dispatchId>` supplies one-use
1191
+ explicit authorization; it never dispatches or renews budget. Stale IDs cannot grant
1192
+ permission. Other failure categories cannot be authorized with this command.
1193
+
1194
+ Non-busy recovery refusals spend existing turn/task operation allowances. Exhaustion
1195
+ returns budget_refused; no new limit, parent abort, retry, wait or queue is added.
1196
+ Busy operations that never started spend no allowance. Turn reports include charged
1197
+ refusals as zero-time/zero-token no_progress_refused rows (research in its count);
1198
+ refusal totals include even uncharged budget refusals. Session execution totals
1199
+ still count real dispatch attempts rather than guard refusals.
1200
+
1201
+ The shared recovery contract is fail-closed. Protocol errors require changed
1202
+ conditions plus a trusted prior-effects inspection. The internal task-generation-bound
1203
+ establishEffects port accepts a retained inspection reference; it is not a model
1204
+ parameter or a promise that T3 exists. No T3 producer is installed yet. Unknown-tool
1205
+ recovery likewise has no trusted catalog-change producer in this slice.
1206
+
1207
+ ### Runtime verification contract
1208
+
1209
+ set_assertions.test_command declares an exact bash verification command for a test
1210
+ or code-grep requirement. It does not execute the command. For code-grep, the command
1211
+ must exit nonzero when the declared presence/absence condition fails. Native children
1212
+ run it through the existing approved bash path after edits. The child-loaded
1213
+ runtime-test-check observer preserves Pi's configured shell/prefix, execution context,
1214
+ renderers and tool_result error flag; the parent retains command, actual exit and
1215
+ before/after revisions, binding source/text/reference/critical conditions to task ID.
1216
+ Compilation only checks the minimal change requirement, never semantic assertions.
1217
+
1218
+ manual/runtime-ui requirements are explicitly unsupported by this producer. A test
1219
+ or code-grep without a command/check remains missing/unverified; a model's proven
1220
+ stamp is not runtime proof. Fresh bound runtime checks supersede old claimed ledger
1221
+ stamps; stale runtime checks do not. Runtime refs and claimedEvidenceRefs are separate.
1222
+
1223
+ agent-fleet.runtime-result/v1 reports orthogonal execution, changes, verification,
1224
+ acceptance and compatibility dimensions. Acceptance requires completed execution,
1225
+ current task, certain changed state, and all requirements/checks passing with current
1226
+ revision and retained runtime evidence. Missing/failed/stale/unsupported checks,
1227
+ unchanged/missing deliverables and uncertain attribution never accept, at any tier.
1228
+ needs_verification means unaccepted, not nearly done.
1229
+
1230
+ **Semantic limitation (operator accepted):** specialist-authored tests may pass the
1231
+ runtime gate. Runtime proves execution/state, NOT the adequacy of those tests or
1232
+ code-grep predicates. Separate code review remains required; accepted is not human
1233
+ Checkpoint A approval. No live model runs or T3/T7 implementation are included.
1199
1234
 
1200
1235
  ### Explicit delivery contract
1201
1236
 
@@ -1205,9 +1240,9 @@ records size/hash/preview and whether it changed, retains the inspected content,
1205
1240
  saves `details.assessmentPath`. Missing files, directories and unsafe symlink paths
1206
1241
  do not pass readback. An existing unchanged file is not attributed to this run.
1207
1242
 
1208
- Exit 0 returns `executionStatus: completed`, **not** acceptance. Tool status is
1209
- `completed_unverified` or `verification_failed`; `accepted: false` and the assertion
1210
- ledger keep semantic verification in the operator's hands. Every delivered return is
1243
+ Exit 0 returns `executionStatus: completed`, **not** acceptance. Without qualifying runtime checks, tool status is
1244
+ `completed_unverified` or `verification_failed` and `accepted: false`. Only the
1245
+ runtime verification contract above can produce `accepted: true`. Every delivered return is
1211
1246
  saved even without assertion IDs. Pending peer delivery remains pending.
1212
1247
 
1213
1248
  Scope roots are checked before budget confirmation/counters. Missing roots are not
@@ -60,3 +60,140 @@ export function readBackDeliverables(contract: DeliverableContract, roots: Roots
60
60
  } catch (error) { return { path: file.path, status: "unreadable", reason: String(error) }; }
61
61
  });
62
62
  }
63
+
64
+ export type ExecutionStatus = "completed" | "failed" | "pending";
65
+ export type ChangeStatus = "changed" | "unchanged" | "unknown";
66
+ export type VerificationStatus = "passed" | "failed" | "missing" | "stale" | "unsupported";
67
+ export type RequirementStatus = VerificationStatus;
68
+
69
+ export interface AcceptanceRequirement {
70
+ id: string;
71
+ tag: string;
72
+ text: string;
73
+ source: string;
74
+ reference?: string;
75
+ criticalConditions?: string[];
76
+ testCommand?: string;
77
+ status?: "open" | "proven" | "unproven" | "failed";
78
+ evidenceTaskId?: string;
79
+ evidenceRevision?: string;
80
+ evidenceRefs?: string[];
81
+ }
82
+
83
+ export interface VerificationCheckInput {
84
+ kind?: "test" | "code-grep" | "compilation";
85
+ taskId?: string;
86
+ coverage?: Array<{ id: string; source: string; text: string; reference?: string; criticalConditions: string[] }>;
87
+ producer: "runtime" | "specialist";
88
+ command: string[];
89
+ exitCode: number | null;
90
+ inspectedRevision: string;
91
+ evidenceRef: string;
92
+ requirementIds?: string[];
93
+ }
94
+
95
+ export interface RuntimeResultInput {
96
+ task: { id: string; current: boolean; beforeRevision: string; afterRevision: string };
97
+ execution: { status: ExecutionStatus; exitCode: number | null; dispatchId: string | null };
98
+ changes: { status: ChangeStatus; paths: string[]; attribution: "certain" | "uncertain" | "not_observed" };
99
+ requirements: AcceptanceRequirement[];
100
+ deliverables: DeliverableReadback[];
101
+ checks: VerificationCheckInput[];
102
+ evidenceRefs?: string[];
103
+ }
104
+
105
+ export function minimalChangeRequirement(): AcceptanceRequirement {
106
+ return {
107
+ id: "AF-MIN-CHANGE",
108
+ tag: "test",
109
+ text: "Inspect the actual changed state and run an applicable verification command against it.",
110
+ source: "runtime:minimal-change-contract",
111
+ reference: "T2a",
112
+ criticalConditions: ["command, exit code, inspected revision, and evidence reference are runtime-recorded"],
113
+ status: "open",
114
+ };
115
+ }
116
+
117
+ export function mapCompatibilityStatus(input: {
118
+ execution: ExecutionStatus;
119
+ verification: VerificationStatus;
120
+ accepted: boolean;
121
+ deliverableFailed: boolean;
122
+ }): { hubAcceptanceStatus: "not_available" | "deliverable_failed" | "needs_verification" | "accepted"; flowStatus: "accepted" | "rejected" } {
123
+ if (input.execution !== "completed") return { hubAcceptanceStatus: "not_available", flowStatus: "rejected" };
124
+ if (input.deliverableFailed) return { hubAcceptanceStatus: "deliverable_failed", flowStatus: "rejected" };
125
+ if (input.accepted && input.verification === "passed") return { hubAcceptanceStatus: "accepted", flowStatus: "accepted" };
126
+ return { hubAcceptanceStatus: "needs_verification", flowStatus: "rejected" };
127
+ }
128
+
129
+ const unique = (values: Array<string | undefined>) => [...new Set(values.map(value => String(value || "").trim()).filter(Boolean))];
130
+
131
+ export function buildRuntimeResult(input: RuntimeResultInput) {
132
+ const checks = input.checks.map(check => {
133
+ let status: VerificationStatus = "unsupported";
134
+ if (check.producer === "runtime" && !!check.taskId && check.command.length > 0 && Number.isInteger(check.exitCode) && check.evidenceRef) {
135
+ status = check.taskId === input.task.id && check.inspectedRevision === input.task.afterRevision ? (check.exitCode === 0 ? "passed" : "failed") : "stale";
136
+ }
137
+ return { ...check, command: [...check.command], requirementIds: [...(check.requirementIds ?? [])], status };
138
+ });
139
+ const requirements = input.requirements.map(requirement => {
140
+ const matching = checks.filter(check => check.requirementIds.includes(requirement.id) && (requirement.id === "AF-MIN-CHANGE" || (["test", "code-grep"].includes(requirement.tag) && check.kind === requirement.tag && check.taskId === input.task.id && check.command.length === 1 && check.command[0] === requirement.testCommand && check.coverage?.some(binding => binding.id === requirement.id && binding.source === requirement.source && binding.text === requirement.text && binding.reference === requirement.reference && JSON.stringify(binding.criticalConditions) === JSON.stringify(requirement.criticalConditions ?? [])))));
141
+ let status: RequirementStatus;
142
+ if (requirement.id !== "AF-MIN-CHANGE" && !["test", "code-grep"].includes(requirement.tag)) status = "unsupported";
143
+ else if (matching.some(check => check.status === "failed")) status = "failed";
144
+ else if (matching.some(check => check.status === "stale")) status = "stale";
145
+ else if (matching.some(check => check.status === "passed")) status = "passed";
146
+ else if (requirement.evidenceTaskId && requirement.evidenceTaskId !== input.task.id) status = "stale";
147
+ else if (requirement.evidenceRevision && requirement.evidenceRevision !== input.task.afterRevision) status = "stale";
148
+ else if (requirement.status === "failed") status = "failed";
149
+ else if (requirement.status === "proven") status = "unsupported";
150
+ else status = "missing";
151
+ return {
152
+ id: requirement.id,
153
+ tag: requirement.tag,
154
+ text: requirement.text,
155
+ source: requirement.source,
156
+ ...(requirement.reference ? { reference: requirement.reference } : {}),
157
+ criticalConditions: [...(requirement.criticalConditions ?? [])],
158
+ ...(requirement.testCommand ? { testCommand: requirement.testCommand } : {}),
159
+ taskId: input.task.id,
160
+ revision: input.task.afterRevision,
161
+ status,
162
+ claimedEvidenceRefs: unique(requirement.evidenceRefs ?? []),
163
+ evidenceRefs: unique(matching.filter(check => check.producer === "runtime").map(check => check.evidenceRef)),
164
+ };
165
+ });
166
+ const deliverableFailed = input.deliverables.some(deliverable => deliverable.status !== "read" || deliverable.changed !== true);
167
+ let verification: VerificationStatus;
168
+ if (input.execution.status !== "completed") verification = "unsupported";
169
+ else if (!input.task.current || requirements.some(requirement => requirement.status === "stale") || checks.some(check => check.status === "stale")) verification = "stale";
170
+ else if (deliverableFailed) verification = "failed";
171
+ else if (input.changes.attribution === "uncertain" || input.changes.status === "unknown") verification = "unsupported";
172
+ else if (requirements.some(requirement => requirement.status === "failed") || checks.some(check => check.status === "failed")) verification = "failed";
173
+ else if (requirements.some(requirement => requirement.status === "unsupported") || checks.some(check => check.status === "unsupported")) verification = "unsupported";
174
+ else if (input.changes.status !== "changed" || requirements.length === 0 || requirements.some(requirement => requirement.status === "missing") || checks.length === 0) verification = "missing";
175
+ else verification = "passed";
176
+ const accepted = input.execution.status === "completed" && input.task.current && input.changes.status === "changed" && input.changes.attribution === "certain" && verification === "passed" && requirements.every(requirement => requirement.status === "passed");
177
+ const compatibility = mapCompatibilityStatus({ execution: input.execution.status, verification, accepted, deliverableFailed });
178
+ const evidenceRefs = unique([
179
+ ...(input.evidenceRefs ?? []),
180
+ ...input.deliverables.map(deliverable => deliverable.retainedPath),
181
+ ...checks.filter(check => check.producer === "runtime").map(check => check.evidenceRef),
182
+ ...requirements.flatMap(requirement => requirement.evidenceRefs),
183
+ ]);
184
+ const reasons: string[] = [];
185
+ if (input.execution.status !== "completed") reasons.push(`execution_${input.execution.status}`);
186
+ if (!input.task.current) reasons.push("stale_task");
187
+ if (input.changes.status !== "changed") reasons.push(`changes_${input.changes.status}`);
188
+ if (input.changes.attribution !== "certain") reasons.push("change_attribution_uncertain");
189
+ if (verification !== "passed") reasons.push(`verification_${verification}`);
190
+ return {
191
+ schema: "agent-fleet.runtime-result/v1" as const,
192
+ task: { id: input.task.id, current: input.task.current, revision: { before: input.task.beforeRevision, after: input.task.afterRevision } },
193
+ execution: { ...input.execution },
194
+ changes: { ...input.changes, paths: [...input.changes.paths] },
195
+ verification: { status: verification, requirements, checks, evidenceRefs, claimedEvidenceRefs: unique(requirements.flatMap(requirement => requirement.claimedEvidenceRefs)) },
196
+ acceptance: { status: accepted ? "accepted" as const : "not_accepted" as const, accepted, reasons },
197
+ compatibility,
198
+ };
199
+ }