@chankov/agent-fleet 2.0.17 → 2.0.18

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 (662) hide show
  1. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +75 -49
  2. package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +18 -20
  3. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +3 -1
  4. package/.pi/agents/model-profiles.yaml +5 -5
  5. package/.pi/agents/peers.yaml +3 -3
  6. package/.pi/agents/voices.yaml +1 -1
  7. package/.pi/harnesses/agent-hub/README.md +35 -8
  8. package/.pi/harnesses/agent-hub/agentic-sources.ts +29 -5
  9. package/.pi/harnesses/agent-hub/config/overrides.ts +13 -3
  10. package/.pi/harnesses/agent-hub/delegate.ts +16 -5
  11. package/.pi/harnesses/agent-hub/deterministic-fs.ts +7 -4
  12. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +13 -2
  13. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +7 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
  16. package/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  17. package/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  18. package/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  19. package/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  20. package/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  21. package/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  22. package/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  23. package/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  24. package/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  25. package/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  26. package/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  27. package/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  28. package/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  29. package/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  30. package/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  31. package/.pi/harnesses/agent-hub/filesystem-tool.ts +74 -26
  32. package/.pi/harnesses/agent-hub/index.ts +23 -5
  33. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +3 -2
  34. package/.pi/harnesses/agent-hub/no-progress.ts +45 -15
  35. package/.pi/harnesses/agent-hub/package.json +1 -1
  36. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  37. package/.pi/harnesses/agent-hub/proactive-config.ts +8 -3
  38. package/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
  39. package/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
  40. package/.pi/harnesses/agent-hub/proactive-local.ts +25 -7
  41. package/.pi/harnesses/agent-hub/proactive-observer.ts +2 -1
  42. package/.pi/harnesses/agent-hub/proactive-rules.ts +39 -11
  43. package/.pi/harnesses/agent-hub/proactive-runtime.ts +8 -6
  44. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +32 -2
  45. package/.pi/harnesses/agent-hub/proactive-types.ts +5 -1
  46. package/.pi/harnesses/agent-hub/prompts/fragments.ts +21 -49
  47. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +2 -1
  48. package/.pi/harnesses/agent-hub/research/runtime.ts +7 -3
  49. package/.pi/harnesses/agent-hub/research/spawn-run.ts +17 -6
  50. package/.pi/harnesses/agent-hub/spawn.ts +38 -9
  51. package/.pi/harnesses/agent-hub/system1-communication-store.ts +39 -0
  52. package/.pi/harnesses/agent-hub/tools/action-executors.ts +6 -1
  53. package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  54. package/.pi/harnesses/agent-hub/tools/ask-system1.ts +1 -1
  55. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +4 -4
  56. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +4 -2
  57. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +3 -3
  58. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +3 -1
  59. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  60. package/.pi/harnesses/agent-hub/work-mode.ts +3 -0
  61. package/.pi/harnesses/coms/package.json +1 -1
  62. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  63. package/.pi/harnesses/lib/context-budget-child-prompt.ts +3 -2
  64. package/.pi/harnesses/lib/deterministic-handle-path.ts +2 -0
  65. package/.pi/harnesses/lib/policy-roots.ts +142 -0
  66. package/.pi/harnesses/lib/system1/config-agentic.js +2 -1
  67. package/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  68. package/.pi/harnesses/lib/system1/config-proactive.js +13 -2
  69. package/.pi/harnesses/lib/system1/config-v2.js +8 -5
  70. package/.versions/2.0.18/.pi/agent-fleet/hermes/README.md +347 -0
  71. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  72. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  73. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  74. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  75. package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  76. package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  77. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  78. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  79. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  80. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  81. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  82. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  83. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  84. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  85. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  86. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  87. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  88. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  89. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  90. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  91. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  92. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  93. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  94. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  95. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  96. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  97. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  98. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  99. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  100. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  101. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  102. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  103. package/.versions/2.0.18/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  104. package/.versions/2.0.18/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  105. package/.versions/2.0.18/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  106. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  107. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  108. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  109. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  110. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  111. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet.ts +217 -0
  112. package/.versions/2.0.18/.pi/agent-fleet/scripts/flow.ts +157 -0
  113. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  114. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  115. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  116. package/.versions/2.0.18/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  117. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  118. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  119. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  120. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  121. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  122. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  123. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  124. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  125. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  126. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  127. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  128. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  129. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  130. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  131. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  132. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  133. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  134. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  135. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  136. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  137. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  138. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  139. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  140. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  141. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  142. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  143. package/.versions/2.0.18/.pi/agent-fleet/scripts/package-lock.json +35 -0
  144. package/.versions/2.0.18/.pi/agent-fleet/scripts/package.json +9 -0
  145. package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  146. package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  147. package/.versions/2.0.18/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  148. package/.versions/2.0.18/.pi/agent-fleet/scripts/team-up.ts +378 -0
  149. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  150. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  151. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  152. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  153. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  154. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  155. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  156. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  157. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  158. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  159. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  160. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  161. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  162. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  163. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  164. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  165. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  166. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  167. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  168. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  169. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  170. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  171. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  172. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  173. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  174. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  175. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  176. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  177. package/.versions/2.0.18/.pi/agents/dispatch-policy.yaml +32 -0
  178. package/.versions/2.0.18/.pi/agents/model-profiles.yaml +134 -0
  179. package/.versions/2.0.18/.pi/agents/peers.yaml +147 -0
  180. package/.versions/2.0.18/.pi/agents/teams.yaml +41 -0
  181. package/.versions/2.0.18/.pi/agents/voices.yaml +13 -0
  182. package/.versions/2.0.18/.pi/damage-control-rules.yaml +297 -0
  183. package/.versions/2.0.18/.pi/extensions/btw/README.md +120 -0
  184. package/.versions/2.0.18/.pi/extensions/btw/index.ts +914 -0
  185. package/.versions/2.0.18/.pi/extensions/btw/package.json +6 -0
  186. package/.versions/2.0.18/.pi/extensions/btw/state.js +179 -0
  187. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  188. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  189. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  190. package/.versions/2.0.18/.pi/extensions/compact-and-continue/README.md +42 -0
  191. package/.versions/2.0.18/.pi/extensions/compact-and-continue/index.ts +120 -0
  192. package/.versions/2.0.18/.pi/extensions/compact-and-continue/package.json +6 -0
  193. package/.versions/2.0.18/.pi/extensions/mcp-bridge/README.md +46 -0
  194. package/.versions/2.0.18/.pi/extensions/mcp-bridge/index.ts +206 -0
  195. package/.versions/2.0.18/.pi/extensions/mcp-bridge/package.json +6 -0
  196. package/.versions/2.0.18/.pi/extensions/package-lock.json +1175 -0
  197. package/.versions/2.0.18/.pi/extensions/package.json +9 -0
  198. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/README.md +224 -0
  199. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/config.ts +198 -0
  200. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  201. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/index.ts +248 -0
  202. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/package.json +6 -0
  203. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  204. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  205. package/.versions/2.0.18/.pi/harnesses/agent-hub/README.md +1483 -0
  206. package/.versions/2.0.18/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  207. package/.versions/2.0.18/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  208. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  209. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  210. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  211. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  212. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  213. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  214. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  215. package/.versions/2.0.18/.pi/harnesses/agent-hub/artifacts.js +146 -0
  216. package/.versions/2.0.18/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  217. package/.versions/2.0.18/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  218. package/.versions/2.0.18/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  219. package/.versions/2.0.18/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  220. package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  221. package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  222. package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  223. package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  224. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  225. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  226. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  227. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  228. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  229. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  230. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  231. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  232. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  233. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  234. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  235. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  236. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  237. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  238. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  239. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  240. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  241. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  242. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  243. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  244. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  245. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  246. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  247. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  248. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  249. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  250. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  251. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  252. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  253. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  254. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  255. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  256. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  257. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  258. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  259. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  260. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  261. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  262. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  263. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-window.js +108 -0
  264. package/.versions/2.0.18/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  265. package/.versions/2.0.18/.pi/harnesses/agent-hub/delegate.ts +478 -0
  266. package/.versions/2.0.18/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
  267. package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  268. package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  269. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  270. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  271. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  272. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
  273. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
  274. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
  275. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  276. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  277. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  278. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  279. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  280. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  281. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  282. package/.versions/2.0.18/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  283. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  284. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  285. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  286. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  287. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  288. package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  289. package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  290. package/.versions/2.0.18/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  291. package/.versions/2.0.18/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  292. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  293. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  294. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  295. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  296. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  297. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  298. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  299. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  300. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  301. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  302. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
  303. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  304. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  305. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  306. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  307. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  308. package/.versions/2.0.18/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
  309. package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
  310. package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  311. package/.versions/2.0.18/.pi/harnesses/agent-hub/footer.ts +30 -0
  312. package/.versions/2.0.18/.pi/harnesses/agent-hub/helpers.ts +270 -0
  313. package/.versions/2.0.18/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  314. package/.versions/2.0.18/.pi/harnesses/agent-hub/index.ts +2625 -0
  315. package/.versions/2.0.18/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  316. package/.versions/2.0.18/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  317. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  318. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  319. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  320. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  321. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  322. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  323. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  324. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  325. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  326. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  327. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  328. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  329. package/.versions/2.0.18/.pi/harnesses/agent-hub/no-progress.ts +593 -0
  330. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  331. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  332. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  333. package/.versions/2.0.18/.pi/harnesses/agent-hub/package.json +7 -0
  334. package/.versions/2.0.18/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  335. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  336. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  337. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  338. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  339. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
  340. package/.versions/2.0.18/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  341. package/.versions/2.0.18/.pi/harnesses/agent-hub/presentation.ts +48 -0
  342. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  343. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  344. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
  345. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
  346. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  347. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  348. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  349. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  350. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  351. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  352. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  353. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  354. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot.ts +258 -0
  355. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  356. package/.versions/2.0.18/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  357. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
  358. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
  359. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  360. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  361. package/.versions/2.0.18/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  362. package/.versions/2.0.18/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  363. package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  364. package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  365. package/.versions/2.0.18/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  366. package/.versions/2.0.18/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  367. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  368. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
  369. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
  370. package/.versions/2.0.18/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  371. package/.versions/2.0.18/.pi/harnesses/agent-hub/return-contract.js +349 -0
  372. package/.versions/2.0.18/.pi/harnesses/agent-hub/return-extract.js +77 -0
  373. package/.versions/2.0.18/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  374. package/.versions/2.0.18/.pi/harnesses/agent-hub/review-findings.js +104 -0
  375. package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  376. package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  377. package/.versions/2.0.18/.pi/harnesses/agent-hub/run-budget.js +554 -0
  378. package/.versions/2.0.18/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  379. package/.versions/2.0.18/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  380. package/.versions/2.0.18/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  381. package/.versions/2.0.18/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  382. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  383. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-health.js +110 -0
  384. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-start.ts +42 -0
  385. package/.versions/2.0.18/.pi/harnesses/agent-hub/spawn.ts +563 -0
  386. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  387. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
  388. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  389. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  390. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  391. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  392. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  393. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  394. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  395. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  396. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  397. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  398. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  399. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  400. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  401. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  402. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  403. package/.versions/2.0.18/.pi/harnesses/agent-hub/timeline.ts +72 -0
  404. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  405. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  406. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  407. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
  408. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  409. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  410. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  411. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  412. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  413. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
  414. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  415. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  416. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  417. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  418. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  419. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  420. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  421. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  422. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  423. package/.versions/2.0.18/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  424. package/.versions/2.0.18/.pi/harnesses/agent-hub/types.ts +66 -0
  425. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  426. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  427. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  428. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  429. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  430. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  431. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  432. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  433. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  434. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  435. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  436. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  437. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  438. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  439. package/.versions/2.0.18/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  440. package/.versions/2.0.18/.pi/harnesses/agent-hub/version.ts +42 -0
  441. package/.versions/2.0.18/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  442. package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  443. package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode.ts +187 -0
  444. package/.versions/2.0.18/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  445. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/README.md +59 -0
  446. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/index.ts +558 -0
  447. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  448. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  449. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  450. package/.versions/2.0.18/.pi/harnesses/coms/README.md +100 -0
  451. package/.versions/2.0.18/.pi/harnesses/coms/index.ts +282 -0
  452. package/.versions/2.0.18/.pi/harnesses/coms/package.json +7 -0
  453. package/.versions/2.0.18/.pi/harnesses/coms/version.ts +42 -0
  454. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/README.md +135 -0
  455. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/index.ts +533 -0
  456. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/package.json +7 -0
  457. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/version.ts +42 -0
  458. package/.versions/2.0.18/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  459. package/.versions/2.0.18/.pi/harnesses/lib/coms-core-io.ts +385 -0
  460. package/.versions/2.0.18/.pi/harnesses/lib/coms-core.ts +577 -0
  461. package/.versions/2.0.18/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  462. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
  463. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  464. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-view.ts +107 -0
  465. package/.versions/2.0.18/.pi/harnesses/lib/context-budget.ts +114 -0
  466. package/.versions/2.0.18/.pi/harnesses/lib/damage-control-shared.ts +226 -0
  467. package/.versions/2.0.18/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  468. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  469. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  470. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  471. package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  472. package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  473. package/.versions/2.0.18/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  474. package/.versions/2.0.18/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  475. package/.versions/2.0.18/.pi/harnesses/lib/fleet-panel.ts +34 -0
  476. package/.versions/2.0.18/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  477. package/.versions/2.0.18/.pi/harnesses/lib/fleet-selection.ts +24 -0
  478. package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  479. package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  480. package/.versions/2.0.18/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  481. package/.versions/2.0.18/.pi/harnesses/lib/herdr-client.ts +472 -0
  482. package/.versions/2.0.18/.pi/harnesses/lib/herdr-presence.ts +399 -0
  483. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  484. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  485. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  486. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  487. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  488. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  489. package/.versions/2.0.18/.pi/harnesses/lib/policy-roots.ts +142 -0
  490. package/.versions/2.0.18/.pi/harnesses/lib/safe-source-read.js +29 -0
  491. package/.versions/2.0.18/.pi/harnesses/lib/spawned-peers.js +191 -0
  492. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  493. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  494. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-json.js +37 -0
  495. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-loader.js +44 -0
  496. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  497. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-triage.js +42 -0
  498. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-v2.js +106 -0
  499. package/.versions/2.0.18/.pi/harnesses/lib/system1/config.js +50 -0
  500. package/.versions/2.0.18/.pi/harnesses/lib/system1/contracts.ts +154 -0
  501. package/.versions/2.0.18/.pi/harnesses/lib/system1/demo.ts +95 -0
  502. package/.versions/2.0.18/.pi/harnesses/lib/system1/jev.ts +503 -0
  503. package/.versions/2.0.18/.pi/harnesses/lib/system1/selection.js +11 -0
  504. package/.versions/2.0.18/.pi/harnesses/lib/system1/service.ts +245 -0
  505. package/.versions/2.0.18/.pi/harnesses/lib/update-check.ts +222 -0
  506. package/.versions/2.0.18/.pi/harnesses/package-lock.json +2039 -0
  507. package/.versions/2.0.18/.pi/harnesses/package.json +10 -0
  508. package/.versions/2.0.18/.pi/prompts/af-build.md +27 -0
  509. package/.versions/2.0.18/.pi/prompts/af-code-simplify.md +22 -0
  510. package/.versions/2.0.18/.pi/prompts/af-constraints.md +31 -0
  511. package/.versions/2.0.18/.pi/prompts/af-plan.md +17 -0
  512. package/.versions/2.0.18/.pi/prompts/af-review.md +16 -0
  513. package/.versions/2.0.18/.pi/prompts/af-set-hermes-telegram.md +15 -0
  514. package/.versions/2.0.18/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  515. package/.versions/2.0.18/.pi/prompts/af-setup-rules.md +20 -0
  516. package/.versions/2.0.18/.pi/prompts/af-ship.md +17 -0
  517. package/.versions/2.0.18/.pi/prompts/af-spec.md +15 -0
  518. package/.versions/2.0.18/.pi/prompts/af-test.md +19 -0
  519. package/.versions/2.0.18/.pi/skills/bowser/SKILL.md +145 -0
  520. package/.versions/2.0.18/.version +1 -0
  521. package/.versions/2.0.18/agents/architect.md +24 -0
  522. package/.versions/2.0.18/agents/bowser.md +28 -0
  523. package/.versions/2.0.18/agents/builder.md +55 -0
  524. package/.versions/2.0.18/agents/code-reviewer.md +209 -0
  525. package/.versions/2.0.18/agents/deep-researcher.md +32 -0
  526. package/.versions/2.0.18/agents/documenter.md +22 -0
  527. package/.versions/2.0.18/agents/orchestrator.md +22 -0
  528. package/.versions/2.0.18/agents/plan-reviewer.md +83 -0
  529. package/.versions/2.0.18/agents/planner.md +105 -0
  530. package/.versions/2.0.18/agents/releaser.md +24 -0
  531. package/.versions/2.0.18/agents/researcher.md +30 -0
  532. package/.versions/2.0.18/agents/security-auditor.md +167 -0
  533. package/.versions/2.0.18/agents/test-engineer.md +153 -0
  534. package/.versions/2.0.18/agents/web-debugger.md +44 -0
  535. package/.versions/2.0.18/agents/web-performance-auditor.md +194 -0
  536. package/.versions/2.0.18/bin/catalog/harness-runtime-closure.json +73 -0
  537. package/.versions/2.0.18/codex/fleet-session-client/SKILL.md +34 -0
  538. package/.versions/2.0.18/codex/fleet-session-client.zip +0 -0
  539. package/.versions/2.0.18/docs/ARCHITECTURE.md +874 -0
  540. package/.versions/2.0.18/docs/agent-fleet-setup.md +1101 -0
  541. package/.versions/2.0.18/docs/claude-code-coms-bridge.md +147 -0
  542. package/.versions/2.0.18/docs/codex-session-bridge.md +219 -0
  543. package/.versions/2.0.18/docs/coms-hermes-bridge.md +188 -0
  544. package/.versions/2.0.18/docs/getting-started.md +126 -0
  545. package/.versions/2.0.18/docs/npm-install.md +535 -0
  546. package/.versions/2.0.18/docs/pi-extensions.md +454 -0
  547. package/.versions/2.0.18/docs/pi-setup.md +92 -0
  548. package/.versions/2.0.18/docs/skill-anatomy.md +150 -0
  549. package/.versions/2.0.18/install-manifest.json +3193 -0
  550. package/.versions/2.0.18/justfile +247 -0
  551. package/.versions/2.0.18/manifest-meta.json +1071 -0
  552. package/.versions/2.0.18/references/accessibility-checklist.md +160 -0
  553. package/.versions/2.0.18/references/communication-contract.md +26 -0
  554. package/.versions/2.0.18/references/definition-of-done.md +67 -0
  555. package/.versions/2.0.18/references/fleet-coordination-patterns.md +171 -0
  556. package/.versions/2.0.18/references/observability-checklist.md +92 -0
  557. package/.versions/2.0.18/references/orchestration-patterns.md +370 -0
  558. package/.versions/2.0.18/references/performance-checklist.md +236 -0
  559. package/.versions/2.0.18/references/prompting-patterns.md +380 -0
  560. package/.versions/2.0.18/references/security-checklist.md +245 -0
  561. package/.versions/2.0.18/references/testing-patterns.md +235 -0
  562. package/.versions/2.0.18/references/workflow-authoring.md +304 -0
  563. package/.versions/2.0.18/skills/_internal/grilling.md +59 -0
  564. package/.versions/2.0.18/skills/browser-testing-with-devtools/SKILL.md +351 -0
  565. package/.versions/2.0.18/skills/code-review-and-quality/SKILL.md +396 -0
  566. package/.versions/2.0.18/skills/compound-learning/SKILL.md +137 -0
  567. package/.versions/2.0.18/skills/constraint-driven-development/SKILL.md +338 -0
  568. package/.versions/2.0.18/skills/constraint-driven-development/references/floor-guard.md +99 -0
  569. package/.versions/2.0.18/skills/context-engineering/SKILL.md +341 -0
  570. package/.versions/2.0.18/skills/deprecation-and-migration/SKILL.md +247 -0
  571. package/.versions/2.0.18/skills/designing-agents/SKILL.md +394 -0
  572. package/.versions/2.0.18/skills/designing-agents/pi-harness-authoring.md +222 -0
  573. package/.versions/2.0.18/skills/drafting-workflows/SKILL.md +143 -0
  574. package/.versions/2.0.18/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  575. package/.versions/2.0.18/skills/frontend-ui-engineering/SKILL.md +328 -0
  576. package/.versions/2.0.18/skills/git-workflow-and-versioning/SKILL.md +316 -0
  577. package/.versions/2.0.18/skills/idea-refine/SKILL.md +182 -0
  578. package/.versions/2.0.18/skills/idea-refine/examples.md +238 -0
  579. package/.versions/2.0.18/skills/idea-refine/frameworks.md +99 -0
  580. package/.versions/2.0.18/skills/idea-refine/refinement-criteria.md +113 -0
  581. package/.versions/2.0.18/skills/idea-refine/scripts/idea-refine.sh +15 -0
  582. package/.versions/2.0.18/skills/incremental-implementation/SKILL.md +353 -0
  583. package/.versions/2.0.18/skills/interview-me/SKILL.md +226 -0
  584. package/.versions/2.0.18/skills/orchestration-verification/SKILL.md +182 -0
  585. package/.versions/2.0.18/skills/peer-coms/SKILL.md +90 -0
  586. package/.versions/2.0.18/skills/performance-optimization/SKILL.md +496 -0
  587. package/.versions/2.0.18/skills/planning-and-task-breakdown/SKILL.md +318 -0
  588. package/.versions/2.0.18/skills/repository-ai-setup/SKILL.md +135 -0
  589. package/.versions/2.0.18/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  590. package/.versions/2.0.18/skills/repository-ai-setup/references/apply-contract.md +74 -0
  591. package/.versions/2.0.18/skills/repository-ai-setup/references/provenance-template.md +16 -0
  592. package/.versions/2.0.18/skills/repository-ai-setup/references/setup-flow.md +108 -0
  593. package/.versions/2.0.18/skills/repository-ai-setup/references/verify-setup.md +20 -0
  594. package/.versions/2.0.18/skills/repository-ai-setup.zip +0 -0
  595. package/.versions/2.0.18/skills/security-and-hardening/SKILL.md +524 -0
  596. package/.versions/2.0.18/skills/spec-driven-development/SKILL.md +295 -0
  597. package/.versions/2.0.18/skills/using-agent-skills/SKILL.md +198 -0
  598. package/.versions/2.0.18/vendor/agent-skills-upstream/LICENSE +21 -0
  599. package/.versions/2.0.18/vendor/agent-skills-upstream/README.md +430 -0
  600. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  601. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  602. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  603. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  604. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  605. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  606. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  607. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  608. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  609. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  610. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  611. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  612. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  613. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  614. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  615. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  616. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  617. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  618. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  619. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  620. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  621. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  622. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  623. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  624. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  625. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  626. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  627. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  628. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  629. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  630. package/CHANGELOG.md +6 -0
  631. package/README.md +2 -2
  632. package/agents/architect.md +2 -2
  633. package/agents/bowser.md +1 -1
  634. package/agents/builder.md +5 -5
  635. package/agents/code-reviewer.md +2 -2
  636. package/agents/deep-researcher.md +2 -2
  637. package/agents/documenter.md +3 -3
  638. package/agents/orchestrator.md +2 -2
  639. package/agents/plan-reviewer.md +2 -2
  640. package/agents/planner.md +4 -4
  641. package/agents/releaser.md +2 -2
  642. package/agents/researcher.md +2 -2
  643. package/agents/security-auditor.md +2 -2
  644. package/agents/test-engineer.md +4 -4
  645. package/agents/web-debugger.md +2 -2
  646. package/agents/web-performance-auditor.md +2 -2
  647. package/bin/cli.js +2 -2
  648. package/bin/lib/external-content.js +33 -0
  649. package/bin/lib/project-provenance.js +19 -13
  650. package/bin/lib/transaction.js +32 -1
  651. package/docs/ARCHITECTURE.md +42 -2
  652. package/docs/agent-fleet-setup.md +4 -4
  653. package/docs/claude-code-coms-bridge.md +17 -4
  654. package/docs/external-project-ai-content.md +48 -0
  655. package/docs/npm-install.md +5 -0
  656. package/docs/system1-agentic.md +27 -0
  657. package/docs/system1-config.md +23 -1
  658. package/docs/system1-file-discovery.md +220 -0
  659. package/install-manifest.json +1 -1
  660. package/package.json +15 -6
  661. package/skills/repository-ai-setup/SKILL.md +18 -0
  662. package/skills/repository-ai-setup.zip +0 -0
@@ -2,6 +2,7 @@
2
2
  import { chmodSync, closeSync, constants, cpSync, existsSync, fchmodSync, fstatSync, fsyncSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, symlinkSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
3
3
  import { createHash, randomUUID } from "node:crypto";
4
4
  import { dirname, join } from "node:path";
5
+ import { externalContentTarget, validateContentDestination } from "./external-content.js";
5
6
  import { STATE_REL_PATH, LEGACY_RECORD_REL_PATH } from "./state.js";
6
7
  import { acquireWorkspaceLock, assertSafeWorkspaceTarget, ownedRelativePath } from "./workspace-safety.js";
7
8
 
@@ -108,6 +109,14 @@ function validateJournal(workspace, value) {
108
109
  if (!value.backup.startsWith(`${RECOVERY_REL_PATH}/`) && value.backup !== RECOVERY_REL_PATH) throw new Error("transaction backup is not installer-owned");
109
110
  for (const rel of value.paths) assertSafeWorkspaceTarget(workspace, rel);
110
111
  assertSafeWorkspaceTarget(workspace, value.backup, { allowLeafSymlink: false });
112
+ if (value.external !== undefined) {
113
+ if (!Array.isArray(value.external) || value.external.length > 128) throw new Error("invalid external recovery targets");
114
+ for (const item of value.external) {
115
+ externalContentTarget(workspace,item.destination,item.path);
116
+ if (!/^external\/\d+$/.test(item.backup) || ![true,false].includes(item.present)) throw new Error("invalid external backup");
117
+ assertSafeWorkspaceTarget(workspace,join(value.backup,item.backup),{allowLeafSymlink:false});
118
+ }
119
+ }
111
120
  return value;
112
121
  }
113
122
  function backupTouchedPaths(workspace, paths, protectedBackup = false) {
@@ -139,10 +148,22 @@ function backupTouchedPaths(workspace, paths, protectedBackup = false) {
139
148
  }
140
149
  function restoreTouchedPaths(workspace, journal) {
141
150
  // Validate the complete recovery source before removing any current target.
151
+ for (const item of journal.external ?? []) {
152
+ externalContentTarget(workspace,item.destination,item.path);
153
+ if (item.present) {
154
+ const backup=assertSafeWorkspaceTarget(workspace,join(journal.backup,item.backup),{allowLeafSymlink:false});
155
+ if (!pathExists(backup) || !lstatSync(backup).isFile()) throw new Error("external recovery backup missing or unsafe");
156
+ }
157
+ }
142
158
  for (const rel of journal.present) {
143
159
  const source = assertSafeWorkspaceTarget(workspace, join(journal.backup, rel), { allowLeafSymlink: !journal.originalModes });
144
160
  if (!pathExists(source) || (journal.originalModes && !lstatSync(source).isFile())) throw Object.assign(new Error(`transaction backup is missing or invalid for ${rel}; journal preserved for diagnosis`), { unrecoverable: true });
145
161
  }
162
+ for (const item of journal.external ?? []) {
163
+ const target=externalContentTarget(workspace,item.destination,item.path);
164
+ if (item.present) { mkdirSync(dirname(target),{recursive:true}); copySnapshot(join(workspace,journal.backup,item.backup),target); }
165
+ else rmSync(target,{force:true});
166
+ }
146
167
  for (const rel of journal.paths) {
147
168
  const path = assertSafeWorkspaceTarget(workspace, rel);
148
169
  if (pathExists(path) && lstatSync(path).isSymbolicLink()) unlinkSync(path);
@@ -192,11 +213,21 @@ export function runTransaction({ workspace, plan, manifest, validate = () => {},
192
213
  const lock = lockHeld ? null : acquireWorkspaceLock(workspace, plan?.verb ?? "transaction");
193
214
  let journal;
194
215
  try {
216
+ validate(); // Recheck reviewed bytes after acquiring the local lifecycle lock.
217
+ for (const item of plan?.externalContent ?? []) externalContentTarget(workspace,item.destination,item.path);
195
218
  assertPlanFingerprints(plan ?? { workspace }, manifest);
196
219
  const paths = plan ? touchedPaths(plan, manifest) : [];
197
220
  const saved = backupTouchedPaths(workspace, paths, Boolean(plan?.preserveBackup));
198
221
  if (plan) plan.backup = saved.backup;
199
- journal = { schemaVersion: 3, phase: "prepared", backup: saved.backup, paths, present: saved.present, ...(plan?.preserveBackup ? { preserveBackup: true, originalModes: Object.fromEntries(saved.present.map(rel => [rel, lstatSync(join(workspace, rel)).mode & 0o777])) } : {}) };
222
+ const external=[];
223
+ for (const [index,item] of (plan?.externalContent ?? []).entries()) {
224
+ const destination=validateContentDestination(workspace,item.destination);
225
+ const target=externalContentTarget(workspace,destination,item.path), backup=`external/${index}`, present=pathExists(target);
226
+ if (present) { const savedPath=join(workspace,saved.backup,backup);mkdirSync(dirname(savedPath),{recursive:true,mode:0o700});copySnapshot(target,savedPath);fsyncPath(savedPath);fsyncPath(dirname(savedPath)); }
227
+ external.push({destination,path:item.path,backup,present});
228
+ }
229
+ if (external.length) fsyncPath(join(workspace,saved.backup));
230
+ journal = { ...(external.length ? {external} : {}), schemaVersion: 3, phase: "prepared", backup: saved.backup, paths, present: saved.present, ...(plan?.preserveBackup ? { preserveBackup: true, originalModes: Object.fromEntries(saved.present.map(rel => [rel, lstatSync(join(workspace, rel)).mode & 0o777])) } : {}) };
200
231
  mkdirSync(dirname(journalPath(workspace)), { recursive: true }); durableJson(journalPath(workspace), journal);
201
232
  if (failAt === "after-journal") throw new Error("injected transaction interruption");
202
233
  journal.phase = "applying"; durableJson(journalPath(workspace), journal);
@@ -21,9 +21,10 @@ this page describes the current architecture.
21
21
  | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `.pi/agent-fleet/scripts/lib/`) — see [Hermes artifacts](../.pi/agent-fleet/hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
22
22
  | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `.pi/agent-fleet/scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
23
23
  | **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake | `.pi/agent-fleet/scripts/fleet-codex-client.ts`, `.pi/agent-fleet/scripts/lib/fleet-codex-*`, opt-in feature `chatgpt-client` — see [codex-session-bridge.md](codex-session-bridge.md) |
24
- | **System 1 foundation** | Experimental shared structured-judgment service; TypeSafe Jev only, with independent watchdog/dispatch/proactive/task-triage consumer opt-ins | `.pi/harnesses/lib/system1/`, feature `system1`, human-owned `.ai/system1.json` |
24
+ | **System 1 foundation** | Experimental shared structured-judgment service; TypeSafe Jev only, with independent watchdog/dispatch/proactive/task-triage/agenticAsk/fileDiscovery consumer opt-ins | `.pi/harnesses/lib/system1/`, feature `system1`, human-owned `.ai/system1.json` |
25
25
  | **System 1 dispatch advice / communication** | Optional off-by-default `dispatch_triage` tool; shared-service memory-only Fleet `1` viewer, independently opt-in; live calibration not yet accepted | `.pi/harnesses/agent-hub/dispatch-triage-*.ts`, `system1-communication-store.ts`, `ui/system1-communication.ts` — [guide](system1-dispatch-triage.md) |
26
26
  | **System 1 task triage** | Active uncalibrated opt-in: uncertain predicates add process obligations, never spend/permission authority; session Fleet/audit metadata | `.pi/harnesses/agent-hub/task-triage-*.ts`, human-owned `consumers.taskTriage` in `.ai/system1.json` — [config/recovery](agent-fleet-setup.md#task-triage-active-experimental-off-by-default) |
27
+ | **System 1 file discovery (D9)** | Off-by-default automatic full-list file ranking; parent scheduler/cache/durable budget, guarded source export, private UDS broker and per-physical-attempt native/descendant identities; no permission or acceptance authority | `.pi/harnesses/agent-hub/file-discovery/`, `tools/ask-system1-files.ts` — [scope/status/full-list and activation](system1-file-discovery.md) |
27
28
  | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
28
29
  | **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
29
30
 
@@ -152,6 +153,29 @@ hub (operator by default; orchestrator when selected)
152
153
 
153
154
  Composition rule: **the hub (or a slash command) orchestrates; personas do not invoke other personas as peers.** Specialists may only fan out to their configured **sub-agents**. Research helpers write findings to disk; the hub resumes specialists with paths, not raw dumps.
154
155
 
156
+ ### Automatic file discovery
157
+
158
+ The independently consented v2 `consumers.fileDiscovery` consumer intercepts eligible
159
+ parent inventory/find/ls/grep results and native research/worker/registered descendant
160
+ discoveries before the next model step. Pre-spawn context is prepared after launch
161
+ gates and rechecked after awaits. One parent runtime owns bounded scheduling,
162
+ durable logical reservations, full-question/current-permission cache identity and
163
+ individual waiter cancellation. The parent reads guarded files; native attempts
164
+ receive private, revocable broker assignments, never the provider key. Sandbox,
165
+ tool/depth/tree caps, task authority and mandatory policy remain unchanged.
166
+
167
+ All display-permitted candidates retain ranked or explicit unscored rows; >255 is
168
+ not a semantic limit. Managed per-page artifacts preserve total/offset/next/hash and
169
+ normal orchestrator self-read limits. Discovery/evaluation coverage and complete,
170
+ partial, unavailable, cancelled and skipped differ. Exact read/grep evidence is
171
+ not replaced. Fleet communication capture is opt-in and memory-only: D9 includes
172
+ only hashed owner/attempt, trigger, counts/coverage/elapsed and actual-or-unknown
173
+ usage, never source bodies, raw queries, arbitrary paths or tokens. Configuration
174
+ changes require a new session. Offline production lifecycle/package tests prove
175
+ mechanics, not semantic accuracy or final live activation. See the [D9 guide](system1-file-discovery.md)
176
+ for exact triggers, unsupported surfaces, residual limitations and unpublished
177
+ source/local-tarball commands.
178
+
155
179
  ### Research search supervision
156
180
 
157
181
  The shared `spawnPiAgent` seam supervises every `read`/`grep`/`find`/`ls` call from native
@@ -290,6 +314,15 @@ retrieval handle. With `bounded-output` off, legacy transport is preserved regar
290
314
  entry without traversing it or disclosing its target outside the authorized inventory.
291
315
  T5 does not consume `assist.write-isolation`; the separate T6c native launch boundary does.
292
316
 
317
+ Invocation preflight for `dispatch_agent` and `spawn_research` validates the original
318
+ shape before normalization. Invalid input reports bounded safe field locations and
319
+ expected/actual types or reasons (`invalid_invocation_shape`), without raw values or
320
+ private payloads; unsafe unknown-key locations are redacted. This is distinct from
321
+ `invocation_persistence_failed`, where valid input could not be durably retained.
322
+ Both refuse before executor launch; persistence refusal releases the in-memory
323
+ reservation even when storage cannot retain failure evidence. Correct the named input
324
+ or storage prerequisite and re-invoke explicitly under unchanged gates and budgets.
325
+
293
326
  Recovery remains the single T1 contract: no automatic retry, queue, model fallback, or new
294
327
  numeric allowance. Busy work is refused before execution accounting or history mutation and is
295
328
  not recorded as no-progress failure. Runtime-owned preflight refusals (`not_started`,
@@ -406,7 +439,14 @@ work. Confirmed low-risk small work uses the existing T2 minimal acceptance path
406
439
  adds a separate review stage, while wide work adds plan and review stages. These obligations
407
440
  ratchet within a task, so lowering spend cannot erase them. Completed stage records name an
408
441
  artifact and revision but only prove that the stage occurred—not that model-authored review
409
- is semantically adequate.
442
+ is semantically adequate. Planner dispatch must use the persona-bearing `dispatch_agent`
443
+ contract with declared scope/deliverable and applicable backend policy. Direct `coms_send`
444
+ remains an anonymous child effect even when its target is named planner; an open plan
445
+ obligation refuses it before target resolution/send. Refusal points to planner dispatch
446
+ and human roster recovery; read-only coms inspection remains available. Declared plan
447
+ readback can satisfy plan occurrence, not independent acceptance or review. Exit 0,
448
+ prompt echoes, `PLAN_FILE` prose without the artifact, pending transport and stale-revision
449
+ verification/review cannot substitute for the separate current-evidence gates.
410
450
 
411
451
  The same code-owned state is consumed by dispatch acceptance in operator and orchestrator
412
452
  modes, appended as `agent-hub-process-state`, restored from the session log, and retained
@@ -719,7 +719,7 @@ targets an end-of-session compound pass writes lessons to.
719
719
  | `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
720
720
  | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
721
721
  | `watchdog-system1` | `off` | Native specialist consumer only: `off`, `shadow`, or explicitly opted-in experimental `active` for advisory `scope` only (0.95/0.05; not G2-validated). Requires the separate selected feature and shared config; no automatic outbound request from setup/doctor. |
722
- | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
722
+ | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-6-luna`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
723
723
  | `poll-panel` | none | Default panel name for `/af-poll` when `--panel` is omitted. Must match a panel in `.pi/agents/voices.yaml` when that file exists. Missing `--panel` and missing this key is a refusal. |
724
724
  | `append-prompt` | none | Comma-separated repo-relative files appended to the system prompt of every dispatched persona. Listed files must exist. Enable the communication contract with `append-prompt: references/communication-contract.md`. |
725
725
 
@@ -1007,7 +1007,7 @@ profile declares the whole execution model set independently of
1007
1007
  local-full:
1008
1008
  version: 2
1009
1009
  defaults:
1010
- model: &qwen36 omlx/Qwen3.6-35B-A3B-4bit
1010
+ model: &qwen36 incoai/Qwen3.8-27B-Splash
1011
1011
  thinking: off
1012
1012
  allowed-models:
1013
1013
  - *qwen36
@@ -1073,10 +1073,10 @@ from that session inherit its persona models, thinking, panel and fallback polic
1073
1073
  Separately started fleet sessions/standing peers retain their own configuration.
1074
1074
  The bundled `local-full` profile explicitly covers all shipped child roles and needs
1075
1075
  no project model overrides. Every role, service and panel entry uses the single
1076
- `omlx/Qwen3.6-35B-A3B-4bit` model. The `local-workers` profile uses that same local
1076
+ `incoai/Qwen3.8-27B-Splash` model. The `local-workers` profile uses that same local
1077
1077
  model for agents, subagents, services and panel voices, while leaving `orchestrator`
1078
1078
  to inherit its current selection; its peer allowlist refuses non-local coms models.
1079
- The model must be registered in Pi and served locally by oMLX. Selecting a profile
1079
+ The model must be registered in Pi and served by the incoai provider. Selecting a profile
1080
1080
  does not download or register models.
1081
1081
 
1082
1082
  ## System 1 dispatch advice and communication
@@ -55,8 +55,11 @@ configuration and merging into it is not something a pi install should decide.
55
55
  ```
56
56
 
57
57
  Without the hook the bridge falls back to asking Claude for a
58
- `<<COMS_DONE:msg_id>>` sentinel and scraping the pane — it works, but replies can
59
- carry TUI noise (tool-status lines). The hook returns exact text.
58
+ `<<COMS_DONE:msg_id>>` sentinel and scraping the pane. Fallback extraction requires
59
+ a unique current-request boundary (message ID plus per-submission nonce), a nonempty
60
+ reply after that boundary, and an exact terminal current-ID marker. Prompt echoes,
61
+ stale/foreign markers, missing or ambiguous boundaries and truncated captures do
62
+ not prove completion. Replies can still carry TUI noise; the hook returns exact text.
60
63
 
61
64
  2. **Skill:** install `peer-coms` so the bridged session knows it is a peer and how to
62
65
  use `coms-cli`. Point Claude Code at it the way you normally load project skills —
@@ -126,8 +129,18 @@ Older releases used the ambiguous name-only path `~/.pi/coms/cli/<name>/`. If th
126
129
  - **Blocked panes:** a Claude waiting on a permission prompt returns a readable error
127
130
  envelope ("blocked on a permission prompt — a human must approve it") instead of
128
131
  hanging until timeout.
129
- - **Busy panes:** a prompt arriving while Claude is mid-turn errors immediately
130
- ("mid-turn — try again shortly") rather than typing into a running turn.
132
+ - **Busy panes:** the bridge waits with bounded backoff before submitting; exhausting
133
+ that wait returns a mid-turn error without typing the prompt. One absolute reply
134
+ deadline covers both idle waiting and the reply, rather than extending the budget.
135
+ - **Pending versus completion:** after submission, exceeding the reply budget leaves
136
+ the original message pending. The bridge watches the same turn up to its hard
137
+ monitoring cap; a valid late reply resolves the original `msg_id` without resubmission.
138
+ At the cap it remains pending, not a fabricated successful or no-effects response.
139
+ Working→idle/done alone is insufficient: fallback also requires current reply provenance.
140
+ - **Hook freshness:** hook mode is latched once observed. The bridge snapshots hook
141
+ mtime immediately before submission (after any busy wait) and ignores unchanged or
142
+ malformed records. A newer valid record supports completion, but mtime is not
143
+ authenticated request identity: unrelated fresh hook traffic remains indistinguishable.
131
144
  - **Restarts:** the bridge is bound to the pane id, not the Claude process — restart
132
145
  Claude in the pane and the bridge keeps working.
133
146
  - **Fleet safety:** the bridge and skill never create or close panes; herdr driving
@@ -0,0 +1,48 @@
1
+ # External project AI content
2
+
3
+ Fleet lifecycle state stays in the checkout's real local `.ai/` directory. Project rules and documentation can be read from separately configured directories; these read grants never authorize writes, command execution, native resource registration, or remote capture.
4
+
5
+ ## Read grants
6
+
7
+ Configure local `.ai/agent-fleet-overrides.md` through the existing CLI:
8
+
9
+ ```bash
10
+ agent-fleet configure --rules ../rin-docs/.ai/rules --docs ../rin-docs --dry-run
11
+ # Review the preview, then use its expectedHash with --expect-hash and --yes.
12
+ ```
13
+
14
+ A directory-form docs grant authorizes its permitted descendants. An exact-file grant such as `../rin-docs/README.md` authorizes only that file, not its neighbors or parent inventory. Missing roots have diagnostics; ungranted siblings, secret/generated paths and descendant symlink escapes remain denied. An explicitly configured symlink root is admitted at its canonical destination and rechecked on access.
15
+
16
+ Paths resolve from the checkout, not from a nested child cwd. Each worktree resolves its own sibling paths; a missing sibling does not trigger parent-directory discovery. Child prompts use canonical external references. Filesystem handles retain source/root identity and hashes; changed grants or bytes invalidate readback. Snapshot writes remain managed and checkout-local.
17
+
18
+ ## System 1 policy and evidence
19
+
20
+ Existing `.ai/rules/...` bindings resolve through configured rules roots without changing the binding strings. Multiple candidates, including an old local copy plus an external copy, are ambiguous. Relocation never repins changed content: hash and heading occurrence still have to match.
21
+
22
+ `proactiveReview.include` is separate capture consent. External entries require an admitted content root; a read grant alone does not enable provider capture. Capture retains its redaction, byte/file/time limits and consumer mode. Independent external Git worktrees provide their own HEAD evidence, including earlier dirty modifications, deletions and untracked additions. Without Git, bounded turn snapshots can show only changes since capture; `external_history_unavailable` reports the earlier-history gap. Missing evidence and changed HEAD remain gaps, never a clean review.
23
+
24
+ File-discovery has narrower workspace-only export/include permissions. External policy read grants do not enable remote file-discovery ranking.
25
+
26
+ ## Native commands and skills
27
+
28
+ Pi does not register arbitrary `.ai/commands` or `.ai/codex-skills` directories merely because docs grants cover them. Use reviewed thin local `.pi/prompts` adapters that reference the canonical external command path, or explicitly register a skill path in Pi settings. Project resource settings resolve relative to `.pi`, not the checkout: an external skill can be listed as `../../rin-docs/.ai/codex-skills/example` or by absolute path. Review resource content and project trust separately. Discovery and prompt expansion do not execute skill scripts.
29
+
30
+ ## Reviewed generation destination
31
+
32
+ The project-AI API accepts a separate explicit destination, not an overrides write grant:
33
+
34
+ ```js
35
+ applyAcceptedProjectFiles({
36
+ workspace: checkout,
37
+ contentDestination: {
38
+ root: "../rin-docs",
39
+ acceptedDecision: "Maintainer approved writing adapted content here",
40
+ evidence: ["review:destination-approval"],
41
+ },
42
+ changes: reviewedChanges,
43
+ });
44
+ ```
45
+
46
+ Logical change paths remain `.ai/rules/...`, `.ai/commands/...`, or `.ai/agent-prompts/...`. The destination must already be a real separate directory, not a checkout ancestor, descendant or symlink. Existing adoption, reconciliation, per-content hashes and no-op semantics apply. Supply the reviewed destination again for later classification/apply; read settings never infer it.
47
+
48
+ The provenance sidecar, locks, transaction journal and recovery backups stay local. External content is never installer-owned; setup, upgrade, doctor and uninstall do not adopt or remove it. Recovery validates the recorded destination and backups before restoring touched files. Private recovery copies are temporary lifecycle artifacts, not installed content. Missing or unsafe destinations fail closed; repair them before recovery. Installer safety checks are not disabled.
@@ -11,6 +11,11 @@ lifecycle commands.
11
11
  - [What reconcile does to each file](#what-reconcile-does-to-each-file) — **read this before your first update**
12
12
  - [Doctor and uninstall](#doctor-and-uninstall)
13
13
 
14
+ Project content can live outside the checkout while configuration and lifecycle
15
+ state remain local. See [External project AI content](external-project-ai-content.md)
16
+ for read grants, separate reviewed generation destinations, native adapters and
17
+ System 1 evidence boundaries.
18
+
14
19
  ## First install
15
20
 
16
21
  Run the package command from the target repository. There is no `just fleet`
@@ -72,6 +72,33 @@ For A/B, explicitly opt into `allowToolOutputs: true`. Only new completed normal
72
72
 
73
73
  ## Sources, refusals and readback
74
74
 
75
+ ### Export scope and `git:tracked`
76
+
77
+ `consumers.agenticAsk.include` accepts explicit repo-relative file/directory prefixes and the opt-in selector `git:tracked`. Prefixes authorize all descendants, including untracked files. `include: ["git:tracked"]` instead authorizes only paths present in the current repository's Git index (`git ls-files --cached`). New/staged files qualify; untracked/ignored files do not unless explicitly added to the index. Selected content is the **current working-tree file**, not the committed/index blob. A file removed from the index no longer qualifies. Submodule contents are not recursively enumerated.
78
+
79
+ ```json
80
+ "agenticAsk": {
81
+ "mode": "recommended",
82
+ "remoteContextApproved": true,
83
+ "include": ["git:tracked"],
84
+ "allowToolOutputs": false
85
+ }
86
+ ```
87
+
88
+ This is a deliberate repository-wide export opt-in, not a default. Git tracking does **not** certify that content is non-secret. Existing forbidden-path, credential, local-access, symlink, size, encoding and change guards remain. Tracked `.ai` configuration, credentials and session/runtime stores are still refused. Git membership is checked before source content reads and rechecked for freshness, using literal pathspecs without inherited Git repository/index overrides. A missing/failing Git lookup or a workspace that is not a Git repository root fails closed. Linked Git worktree roots are supported. Mixed selectors/prefixes are a union: adding `"docs"` beside `"git:tracked"` also authorizes untracked files under `docs`.
89
+
90
+ The selector is implemented only for `agenticAsk`; it does not enable other consumers or capture tool outputs. It is one include entry, not a file enumeration: per-call file/byte/question/session limits remain unchanged. No inference is triggered by configuration changes. Restart the Hub session after changing configuration.
91
+
92
+ Before a file-backed call, check the approved include scope without exposing credentials. Pass actual repo-relative file paths and selected line ranges in `paths`, **not** `git:tracked`. `include: ["."]`, `include: ["**"]` and absolute paths are not supported.
93
+
94
+ ### Interpreting `source_denied`
95
+
96
+ `{"status":"unavailable","reason":"source_denied","advisory":true,"sourceSummary":[]}` is a **local input/source guard refusal**, not Jev's answer to the semantic question. The runtime validates input and collects approved sources before calling the provider; no provider judgment is produced for that refused call. An empty summary means collection did not successfully return source summaries; it does not identify which guard fired or prove that no local bytes were read (for example, the credential guard checks content).
97
+
98
+ Possible causes include a path outside `include`, local damage-control denial, forbidden/symlink/non-text sources, and credential-like input or file content. A selected range does not bypass whole-file safety checks or source-size limits. The `evaluationId` is a correlation identifier, not proof of inference, and `advisory: true` is the tool's authority boundary, not a success flag. Current configuration can explain a new refusal but does not prove the configuration or cause of a historical session, which uses its initialization snapshot.
99
+
100
+ Do not repeat an unchanged refused call, move/rename the source or paste denied source/output into `state` or `questions` to bypass export policy. Fall back to locally permitted reading/research. A state-only question is valid for independently permitted non-secret facts (for example, interpreting the public status code), but cannot evaluate unseen denied code. Any scope expansion requires a separate explicit human decision and a new Hub session.
101
+
75
102
  Files must pass the **current local damage-control policy**, including `zeroAccessPaths`, before content reads. `include` grants export scope only, never local file-access authority. Symlinks/escapes, non-files, invalid UTF-8, binary data, oversized/changing sources and obvious credentials refuse rather than silently truncate. Source code in dot directories may be explicitly included; credential files, VCS metadata, session stores and runtime data cannot be exported. Pattern checks cannot detect every possible secret; operators remain responsible for selecting non-sensitive data.
76
103
 
77
104
  Successful results contain `advisory: true`, a correlation `evaluationId`, validated answers/uncertainty, real provider metadata and `sourceSummary` with hashes, refs, selected ranges and coverage. **File/output bodies are not returned by this tool.** A selected range is marked incomplete relative to the full file but is a valid explicit selection. Missing usage is unknown, never zero; no USD prices or claimed savings are calculated.
@@ -27,6 +27,8 @@ Each optional section under `consumers` has its own permissions and budgets. Mis
27
27
  | `proactiveReview` | `mode: off`, `shadow`, or `advisory`; `remoteContext`, explicit `include`, `maxEvaluationsPerSession`, optional reviewed `localBindings` |
28
28
  | `dispatchTriage` | `mode: off`, `shadow`, or `advisory`; explicit `remoteContextApproved`, positive `maxCalls`, `maxStateBytes`, `maxTaskBytes`, `maxRoleBytes`; optional `profile`, `orchestratorBeforeDispatch` |
29
29
  | `taskTriage` | `mode: off` or `experimental`; explicit `remoteContextApproved`, pinned `questionVersion`, `policyVersion`, `limits`; inherits root provider/model |
30
+ | `agenticAsk` (D10) | `mode: off`, `advisory`, or `recommended`; independent `remoteContextApproved`, `include` (repo-relative prefixes or explicit `git:tracked` selector), `allowToolOutputs`, `limits`; parent-only typed judgment tool |
31
+ | `fileDiscovery` (D9) | `mode: off` or `active`; independent `remoteContextApproved`, nonempty `include` for approved active use, bounded `limits`; automatic full-list ranking |
30
32
 
31
33
  The top-level `mode: off` disables remote inference. Independently valid proactive local capture/checks can remain enabled. An off proactive section cannot authorize capture. Neither off nor migration failure/provider unavailability cancels persisted Task Triage process obligations.
32
34
 
@@ -47,7 +49,27 @@ Example task section (requires separate human data consent):
47
49
  }
48
50
  ```
49
51
 
50
- Those task limits are a pinned compatibility contract, not adjustable knobs. Profile thresholds for dispatch remain configurable. No `agenticAsk` section is enabled or accepted by D0; D10 owns its future contract.
52
+ Those task limits are a pinned compatibility contract, not adjustable knobs. Profile thresholds for dispatch remain configurable. D10 and D9 are implemented consumers of the same v2 service, not extra providers or config files. Example sections below require separate human consent and workspace-specific roots; this is not activation:
53
+
54
+ ```json
55
+ {
56
+ "agenticAsk": {
57
+ "mode": "recommended",
58
+ "remoteContextApproved": true,
59
+ "include": [".pi/harnesses", "bin", "docs"],
60
+ "allowToolOutputs": false
61
+ },
62
+ "fileDiscovery": {
63
+ "mode": "active",
64
+ "remoteContextApproved": true,
65
+ "include": [".pi/harnesses", "bin", "docs"]
66
+ }
67
+ }
68
+ ```
69
+
70
+ Merge these under `consumers`, preserving root settings and all human-owned sections. D10 recommended is model-facing advice for suitable typed questions; it does not activate D9 or grant D9 export consent. D9 uses deterministic discovery/pre-spawn hooks, retains every display-permitted candidate (including low/unscored), and pages large results without raising read budgets. Its complete/partial/unavailable/cancelled/skipped and independent discovery/evaluation coverage are not semantic accuracy guarantees. Start a new session after edits. See [D10](system1-agentic.md) and [D9 triggers, full-list contract, limitations and unpublished source/local-tarball commands](system1-file-discovery.md).
71
+
72
+ For a separately approved Git-tracked-only export scope, set only `consumers.agenticAsk.include` to `["git:tracked"]`. This dynamically checks the current Git index before reading sources and for freshness; selected text is from the working tree. Untracked files do not qualify, and sensitive-path/local-access/source guards still apply even to tracked files. It does not change `fileDiscovery` consent or output capture. Adding directory prefixes alongside the selector also permits their untracked descendants. See [D10 export scope and refusal handling](system1-agentic.md#export-scope-and-gittracked). Restart the Hub after editing.
51
73
 
52
74
  ## Explicit migration
53
75
 
@@ -0,0 +1,220 @@
1
+ # System 1 file discovery (D9)
2
+
3
+ D9 is an opt-in **automatic file ranker**, not a shortlist or an execution gate.
4
+ This checkout implements the runtime; published `@latest` is not evidence that
5
+ it contains D9. Default and Full installation leave System 1 off. Selection,
6
+ provider availability, independent export consent and consumer activation are
7
+ separate. Configuration is the human-owned [unified v2 document](system1-config.md).
8
+
9
+ ## Configuration and consent
10
+
11
+ Keep the existing root provider/model/key-env settings and all other consumer
12
+ sections. After human consent, add this section under `consumers`:
13
+
14
+ ```json
15
+ {
16
+ "fileDiscovery": {
17
+ "mode": "active",
18
+ "remoteContextApproved": true,
19
+ "include": [".pi/harnesses", "bin", "docs"]
20
+ }
21
+ }
22
+ ```
23
+
24
+ These roots are the separately approved roots for the Agent Fleet checkout,
25
+ **not defaults or consent for another repository**. In another repository the
26
+ human must explicitly choose its include roots. D10 `agenticAsk` consent never
27
+ activates D9. Missing/off D9 means no automatic capture, source export or
28
+ inference. Root `mode: off` disables inference; root `auto`, selected `system1`,
29
+ a valid consumer and caller-supplied `TYPESAFE_API_KEY` are needed for live use.
30
+ Never put key values in JSON, prompts or transcripts. Start a **new Hub session**
31
+ after configuration changes: the snapshot is immutable for the current session.
32
+
33
+ Defaults/maxima: concurrency 8, queued jobs 32, candidates 1024, evaluations/job
34
+ 256, logical calls/session 10000, file bytes 65536, request bytes 131072,
35
+ source bytes/job 16777216, discovery 1000 ms, job 20000 ms, page bytes 32768,
36
+ cache entries 2048. Positive values can reduce these bounds, not raise them.
37
+ The discovery deadline includes Pi worker startup; slow hosts may get partial
38
+ or unavailable discovery. Runtime never installs a missing discovery executable.
39
+ Candidate limits bound matched candidates, **not visited filesystem entries**.
40
+
41
+ ## Automatic surfaces and explicit A/B/C
42
+
43
+ With a known task and at least two unambiguous files, production `tool_result`
44
+ hooks rank before delivery to the next model step in both Hub work modes and
45
+ all task tiers:
46
+
47
+ - Parent `filesystem` inventory, typed `find`, `ls`, and parseable `grep`.
48
+ - Native research and specialist workers: initial full ranked context after
49
+ launch gates, then current discoveries through their production child extension.
50
+ - Allowed nested delegates: separately registered descendant task/query and
51
+ physical-attempt lease; never a copied parent capability.
52
+
53
+ The parent-only `ask_system1_files` uses the same engine:
54
+
55
+ ```json
56
+ {"paths":["docs/a.ts","docs/b.ts"]}
57
+ ```
58
+
59
+ ```json
60
+ {"directories":["docs"],"patterns":["*.ts"],"recursive":false}
61
+ ```
62
+
63
+ ```json
64
+ {"directories":["docs"],"patterns":["**/*.ts"],"recursive":true}
65
+ ```
66
+
67
+ A is explicit paths; B expands a directory/pattern; C recursively discovers and
68
+ orders all files without a mandatory second picker. Shallow discovery uses
69
+ immediate entries only; slash-containing shallow patterns refuse as
70
+ `invalid_pattern`, rather than silently claiming a complete empty result.
71
+ Up to 14 custom typed questions augment the two standard relevance/role
72
+ questions; `d9_relevance` and `d9_role` are reserved IDs.
73
+
74
+ No scope/read_scope means current same-task candidates, otherwise bounded
75
+ approved include roots, not a repository scan on every user turn. Scope hints
76
+ never grant read/export permission or replace writable scope. Missing task,
77
+ unknown/ambiguous shapes, fewer than two files, missing channel and technical
78
+ bounds give explicit skipped/unavailable/partial reasons. Off hooks are inert.
79
+ Arbitrary bash, external tools and coms/Claude peers are **not** covered.
80
+ `read`, excerpts and grep matches/line numbers remain original evidence.
81
+
82
+ ## Full-list semantics
83
+
84
+ D9 requires the `distribution` capability, not global `provider_confidence`.
85
+ Real Jev choice/ordinal answers retain their supplied confidence and uncertainty;
86
+ this does not add a global Jev confidence capability or imply calibration.
87
+
88
+ Every discovered, display-permitted candidate remains a row, including low
89
+ scores and `unscored` reasons: denied, oversized, changed, unavailable, cancelled,
90
+ not_evaluated. Unknown is not relevance zero. Metadata-hidden paths contribute
91
+ only an aggregate. Sort is relevance descending, then canonical path; role does
92
+ not discard tests, configuration or documentation. There is no 255-option cap,
93
+ top-K or hidden shortlist. The 256 evaluation cap leaves other discovered rows
94
+ explicitly unscored; the candidate cap instead makes the universe incomplete.
95
+
96
+ Statuses are `complete`, `partial`, `unavailable`, `cancelled`, `skipped`.
97
+ Discovery and evaluation completeness are independent. No successful evaluation
98
+ under provider failure is unavailable, never “no relevant files”. Interrupted
99
+ traversal has `remaining: "unknown"`; cancellation reaches the real native
100
+ process. Normal failure preserves original discovery and ordinary permitted reads;
101
+ user cancellation does not start fallback work.
102
+ Broker/client request expiry and runtime job expiry are deadlines, not user
103
+ cancellation. A client rank deadline is confirmed only by the broker's deadline
104
+ reply on the same authenticated request connection after its typed cause is
105
+ latched; terminal delivery failure or no acknowledgement within the existing
106
+ 1000 ms cleanup bound yields `channel_unavailable`, not a guessed deadline.
107
+ For a confirmed deadline, no successful rows yields `unavailable`; some successful rows yields
108
+ `partial`. Cancellation-derived unscored rows become `deadline`, while successful
109
+ rows and existing denial/size reasons remain. Genuine caller/task/session abort
110
+ remains `cancelled`. An advisory deadline does not kill a healthy owner or physical
111
+ attempt. Job/request budgets remain 20000 ms and discovery remains 1000 ms;
112
+ approved export/read policy is unchanged.
113
+
114
+ Large results use separately bounded managed pages with result identity, total,
115
+ offset, next locator and hash. Follow every `next` via already permitted read or
116
+ `filesystem` readback; an exhausted 64 KiB orchestrator turn needs the next turn.
117
+ No self-read budget or child tool cap is increased. A denied page path is an
118
+ explicit limitation, not delivery of all rows. A full list describes the actual
119
+ requested/discovered scope, not unseen files beyond a partial scan.
120
+
121
+ ## Ownership, cache and diagnostics
122
+
123
+ One parent scheduler/cache/budget serves Hub and native jobs. Logical calls are
124
+ reserved durably before inference; failures consume reservations. Full questions,
125
+ workspace/path/hash/task/query/model/policy and current permission participate in
126
+ identity. Each waiter rechecks its own rights after await; cancelling one waiter
127
+ does not kill another. Native owner authority follows the task ID; same-task Hub
128
+ follow-ups revise Hub cache identity but not a running child's immutable query.
129
+ Advisory lease expiry stops inference, not a healthy physical child. Actual task
130
+ switch, exit, cancellation and shutdown revoke physical ownership. Broker UDS is
131
+ private and bounded, not an isolation boundary against malicious same-OS-user
132
+ processes. Provider key and inherited D9 assignments are stripped at spawn;
133
+ only trusted fresh assignments reach each physical attempt. Sandbox remains unchanged.
134
+
135
+ Fleet `1`, then `e`, enables session-only, memory-only diagnostics in the existing
136
+ viewer. D9 projection contains hashed owner/attempt, enum trigger, counts, coverage,
137
+ elapsed and actual-or-unknown attempts/usage, **no paths, queries, file bodies,
138
+ provider payload extras or capability tokens**. Shared per-file D9 requests are
139
+ not captured. Partial/failure/cancellation/skips differ from success. Observer
140
+ failure cannot alter ranking or budget. Zero calls on cache reuse does not invent
141
+ zero token usage. `d` clears capture and fences late completions.
142
+
143
+ Residual limitations: a child capability remains in its process environment for
144
+ native delegation; shell tools must not print it. Worker preparation has a bounded
145
+ job deadline and post-await kill fence, but no direct operator-kill AbortSignal.
146
+ Non-admission registration failures degrade to ordinary discovery without a D9
147
+ assignment; authoritative admission still refuses startup. A same-task follow-up
148
+ between primary and fallback can invalidate pre-spawn admission. Darwin sandbox/UDS has policy tests, not a local macOS runtime proof.
149
+ These are separate review notes, not claims of strengthened guarantees.
150
+ Mandatory policy/rules/skills, named user files, original failure evidence and
151
+ process/permission/acceptance gates remain authoritative regardless of score.
152
+
153
+ ## Source/local-package selection and readiness
154
+
155
+ The following uses this unpublished checkout, **not `npx @latest`**. For another
156
+ repository set `TARGET` to its absolute path. `KEEP_FEATURES` is its complete
157
+ human-selected feature list including `system1`; `--features` replaces, not adds.
158
+ Review the preview before apply; no D9 config or consent is written by setup.
159
+
160
+ ```sh
161
+ FLEET_CHECKOUT=/home/nchankov/repos/agent-fleet
162
+ TARGET=/absolute/path/to/approved-workspace
163
+ KEEP_FEATURES=system1 # include every other existing feature you intend to retain
164
+ node "$FLEET_CHECKOUT/bin/cli.js" setup --workspace "$TARGET" --features "$KEEP_FEATURES" --save-desired --dry-run
165
+ node "$FLEET_CHECKOUT/bin/cli.js" setup --workspace "$TARGET" --features "$KEEP_FEATURES" --save-desired --yes
166
+ node "$FLEET_CHECKOUT/bin/cli.js" doctor --workspace "$TARGET" --json
167
+ ```
168
+
169
+ For a local tarball, create and extract outside `node_modules` (Node's type
170
+ stripper cannot import TS from inside `node_modules`), then use its CLI:
171
+
172
+ ```sh
173
+ LOCAL_PACKAGE=$(mktemp -d)
174
+ (cd "$FLEET_CHECKOUT" && npm pack --pack-destination "$LOCAL_PACKAGE")
175
+ mkdir "$LOCAL_PACKAGE/unpacked"
176
+ tar -xzf "$LOCAL_PACKAGE"/chankov-agent-fleet-*.tgz --strip-components=1 -C "$LOCAL_PACKAGE/unpacked"
177
+ node "$LOCAL_PACKAGE/unpacked/bin/cli.js" setup --workspace "$TARGET" --features "$KEEP_FEATURES" --save-desired --dry-run
178
+ node "$LOCAL_PACKAGE/unpacked/bin/cli.js" setup --workspace "$TARGET" --features "$KEEP_FEATURES" --save-desired --yes
179
+ node "$LOCAL_PACKAGE/unpacked/bin/cli.js" doctor --workspace "$TARGET" --json
180
+ ```
181
+
182
+ Setup copies files; it does **not** install runtime prerequisites. Before launch,
183
+ review and provision the workspace dependencies separately (these install commands
184
+ may use the network and are **not** part of the offline verification below):
185
+
186
+ ```sh
187
+ (cd "$TARGET" && just fleet deps)
188
+ # Optional native directory/pattern discovery requires this exact locally resolvable Pi library.
189
+ npm install --prefix "$TARGET/.pi/harnesses" --no-save --package-lock=false @earendil-works/pi-coding-agent@0.84.2
190
+ node "$FLEET_CHECKOUT/bin/cli.js" doctor --workspace "$TARGET" --json
191
+ ```
192
+
193
+ For a tarball use its extracted CLI for `doctor` instead. The library must resolve
194
+ from the copied harness, not merely exist as a global Pi executable. Installed-package
195
+ tests copy the real already-installed pinned library/dependency closure; they never
196
+ run these network-capable provisioning commands. Without the optional library,
197
+ package imports and explicit paths still work, while native discovery reports
198
+ unavailable. A missing `fd` executable is also unavailable; runtime never installs it.
199
+ See [runtime dependency setup](npm-install.md#then-install-the-runtime-dependencies).
200
+
201
+ Setup preserves human-owned `.ai/system1.json`. After separate final review and
202
+ consent, **manually merge** the D9 section above without overwriting root settings
203
+ or other consumers; use approved roots for that workspace. Supply the key through
204
+ the normal parent environment, then restart with `just fleet` from that workspace.
205
+ There is no D9 activation CLI. Setup alone never activates D9; activation takes effect in a new Hub session after explicit consent.
206
+
207
+ An offline snapshot check prints statuses only (Node with TS support required):
208
+
209
+ ```sh
210
+ TARGET="$TARGET" FLEET_CHECKOUT="$FLEET_CHECKOUT" node --input-type=module -e '
211
+ const {loadSystem1Snapshot}=await import(process.env.FLEET_CHECKOUT+"/.pi/harnesses/lib/system1/config-loader.js");
212
+ const s=loadSystem1Snapshot(process.env.TARGET);
213
+ console.log(JSON.stringify({root:s.status,fileDiscovery:s.consumers.fileDiscovery.status}));'
214
+ ```
215
+
216
+ Readiness is not a live inference, activation check or accuracy benchmark.
217
+ `npm run test:file-discovery` is guarded offline mechanics proof; package proof
218
+ uses a real tarball, copied workspace, guarded UDS and fake service. It proves
219
+ import closure, defaults, full-list/paging/cancellation/permissions, not semantic
220
+ accuracy, calibration, money/time savings or final independent acceptance.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "packageVersion": "2.0.17",
3
+ "packageVersion": "2.0.18",
4
4
  "groups": [
5
5
  {
6
6
  "id": "skills",