@chankov/agent-fleet 2.0.19 → 2.0.20

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 (784) hide show
  1. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +5 -5
  2. package/.pi/extensions/compact-and-continue/index.ts +18 -2
  3. package/.pi/harnesses/agent-hub/README.md +163 -130
  4. package/.pi/harnesses/agent-hub/access-approval.ts +15 -9
  5. package/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  6. package/.pi/harnesses/agent-hub/agentic-sources.ts +1 -1
  7. package/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  8. package/.pi/harnesses/agent-hub/assist-profile.ts +3 -0
  9. package/.pi/harnesses/agent-hub/budget-recovery.ts +4 -95
  10. package/.pi/harnesses/agent-hub/commands/context.ts +0 -1
  11. package/.pi/harnesses/agent-hub/config/model-profiles.ts +3 -2
  12. package/.pi/harnesses/agent-hub/config/overrides.ts +2 -2
  13. package/.pi/harnesses/agent-hub/context/budgets.ts +12 -66
  14. package/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  15. package/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  16. package/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  17. package/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  18. package/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  19. package/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  20. package/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  21. package/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  22. package/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  23. package/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  24. package/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  25. package/.pi/harnesses/agent-hub/context-pressure.ts +37 -6
  26. package/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  27. package/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  28. package/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  29. package/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  30. package/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  31. package/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  32. package/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  33. package/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  34. package/.pi/harnesses/agent-hub/delegate.ts +4 -4
  35. package/.pi/harnesses/agent-hub/deterministic-fs.ts +33 -7
  36. package/.pi/harnesses/agent-hub/dispatch-coms.ts +3 -2
  37. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +1 -1
  38. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +32 -7
  39. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +24 -4
  40. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +26 -0
  41. package/.pi/harnesses/agent-hub/dispatch-native.ts +2 -0
  42. package/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  43. package/.pi/harnesses/agent-hub/file-discovery/adapters.ts +9 -3
  44. package/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +10 -4
  45. package/.pi/harnesses/agent-hub/file-discovery/broker.ts +8 -5
  46. package/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +17 -8
  47. package/.pi/harnesses/agent-hub/file-discovery/descendant.ts +5 -1
  48. package/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +1 -1
  49. package/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +14 -5
  50. package/.pi/harnesses/agent-hub/file-discovery/hub.ts +33 -16
  51. package/.pi/harnesses/agent-hub/file-discovery/results.ts +7 -6
  52. package/.pi/harnesses/agent-hub/file-discovery/runtime.ts +21 -11
  53. package/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  54. package/.pi/harnesses/agent-hub/file-discovery/sources.ts +2 -2
  55. package/.pi/harnesses/agent-hub/filesystem-tool.ts +6 -25
  56. package/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  57. package/.pi/harnesses/agent-hub/hub-state-audit.js +0 -24
  58. package/.pi/harnesses/agent-hub/index.ts +102 -113
  59. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +122 -24
  60. package/.pi/harnesses/agent-hub/no-progress.ts +42 -15
  61. package/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  62. package/.pi/harnesses/agent-hub/orchestration-activation.ts +18 -21
  63. package/.pi/harnesses/agent-hub/orchestration-route.ts +8 -16
  64. package/.pi/harnesses/agent-hub/package.json +1 -1
  65. package/.pi/harnesses/agent-hub/policy/work-mode.ts +8 -3
  66. package/.pi/harnesses/agent-hub/proactive-runtime.ts +1 -1
  67. package/.pi/harnesses/agent-hub/process-obligations.ts +23 -22
  68. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -2
  69. package/.pi/harnesses/agent-hub/prompts/fragments.ts +21 -30
  70. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  71. package/.pi/harnesses/agent-hub/recovery-contract.ts +2 -1
  72. package/.pi/harnesses/agent-hub/research/runtime.ts +14 -0
  73. package/.pi/harnesses/agent-hub/research/spawn-run.ts +41 -14
  74. package/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  75. package/.pi/harnesses/agent-hub/review-findings.js +2 -10
  76. package/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  77. package/.pi/harnesses/agent-hub/run-budget.js +17 -229
  78. package/.pi/harnesses/agent-hub/scope-gate.js +99 -15
  79. package/.pi/harnesses/agent-hub/session-audit.ts +22 -4
  80. package/.pi/harnesses/agent-hub/spawn.ts +87 -11
  81. package/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  82. package/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  83. package/.pi/harnesses/agent-hub/system1-communication-store.ts +29 -2
  84. package/.pi/harnesses/agent-hub/system1-runtime.ts +7 -0
  85. package/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  86. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +43 -14
  87. package/.pi/harnesses/agent-hub/task-triage-config.ts +5 -14
  88. package/.pi/harnesses/agent-hub/task-triage-obligations.ts +17 -1
  89. package/.pi/harnesses/agent-hub/task-triage-runtime.ts +15 -10
  90. package/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +1 -1
  91. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +18 -7
  92. package/.pi/harnesses/agent-hub/tools/action-executors.ts +11 -10
  93. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +2 -2
  94. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +144 -64
  95. package/.pi/harnesses/agent-hub/ui/context-budget.ts +5 -3
  96. package/.pi/harnesses/agent-hub/ui/grid.ts +1 -1
  97. package/.pi/harnesses/agent-hub/work-mode.ts +3 -4
  98. package/.pi/harnesses/ask-user-remote/index.ts +13 -2
  99. package/.pi/harnesses/ask-user-remote/questions.ts +4 -6
  100. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +16 -1
  101. package/.pi/harnesses/coms/package.json +1 -1
  102. package/.pi/harnesses/damage-control-continue/README.md +26 -0
  103. package/.pi/harnesses/damage-control-continue/index.ts +87 -20
  104. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  105. package/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  106. package/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  107. package/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  108. package/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  109. package/.pi/harnesses/lib/approval-wait.ts +17 -0
  110. package/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  111. package/.pi/harnesses/lib/clarification-policy.ts +9 -0
  112. package/.pi/harnesses/lib/coms-core-io.ts +2 -1
  113. package/.pi/harnesses/lib/coms-core.ts +3 -2
  114. package/.pi/harnesses/lib/coms-registry-entry.ts +4 -2
  115. package/.pi/harnesses/lib/context-budget-child-prompt.ts +8 -14
  116. package/.pi/harnesses/lib/context-budget-view.ts +5 -0
  117. package/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  118. package/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  119. package/.pi/harnesses/lib/damage-control-shared.ts +3 -0
  120. package/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  121. package/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  122. package/.pi/harnesses/lib/damage-result-view.ts +16 -0
  123. package/.pi/harnesses/lib/execution-trace.ts +45 -0
  124. package/.pi/harnesses/lib/herdr-presence.ts +4 -4
  125. package/.pi/harnesses/lib/identical-dialog.ts +27 -0
  126. package/.pi/harnesses/lib/installation-state.js +62 -0
  127. package/.pi/harnesses/lib/process-shared.ts +9 -0
  128. package/.pi/harnesses/lib/semantic-approval.ts +80 -0
  129. package/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  130. package/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  131. package/.pi/harnesses/lib/system1/config-file-discovery.js +4 -2
  132. package/.pi/harnesses/lib/system1/config-v2.js +11 -5
  133. package/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  134. package/.pi/harnesses/lib/system1/service.ts +1 -1
  135. package/.pi/harnesses/package-lock.json +1041 -959
  136. package/.pi/harnesses/package.json +3 -0
  137. package/.versions/2.0.20/.pi/agent-fleet/hermes/README.md +347 -0
  138. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  139. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  140. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  141. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  142. package/.versions/2.0.20/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  143. package/.versions/2.0.20/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  144. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  145. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  146. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  147. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  148. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  149. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  150. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  151. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  152. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  153. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  154. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  155. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  156. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  157. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  158. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  159. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  160. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  161. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  162. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  163. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  164. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  165. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  166. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  167. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  168. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  169. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  170. package/.versions/2.0.20/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  171. package/.versions/2.0.20/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  172. package/.versions/2.0.20/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  173. package/.versions/2.0.20/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  174. package/.versions/2.0.20/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  175. package/.versions/2.0.20/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  176. package/.versions/2.0.20/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  177. package/.versions/2.0.20/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  178. package/.versions/2.0.20/.pi/agent-fleet/scripts/fleet.ts +217 -0
  179. package/.versions/2.0.20/.pi/agent-fleet/scripts/flow.ts +157 -0
  180. package/.versions/2.0.20/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  181. package/.versions/2.0.20/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  182. package/.versions/2.0.20/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  183. package/.versions/2.0.20/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  184. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  185. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  186. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  187. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  188. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  189. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  190. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  191. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  192. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  193. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  194. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  195. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  196. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  197. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  198. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  199. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  200. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  201. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  202. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  203. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  204. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  205. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  206. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  207. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  208. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  209. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  210. package/.versions/2.0.20/.pi/agent-fleet/scripts/package-lock.json +35 -0
  211. package/.versions/2.0.20/.pi/agent-fleet/scripts/package.json +9 -0
  212. package/.versions/2.0.20/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  213. package/.versions/2.0.20/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  214. package/.versions/2.0.20/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  215. package/.versions/2.0.20/.pi/agent-fleet/scripts/team-up.ts +378 -0
  216. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  217. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  218. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  219. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  220. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  221. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  222. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  223. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  224. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  225. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  226. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  227. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  228. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  229. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  230. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  231. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  232. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  233. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  234. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  235. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  236. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  237. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  238. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  239. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  240. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  241. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  242. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  243. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  244. package/.versions/2.0.20/.pi/agents/dispatch-policy.yaml +32 -0
  245. package/.versions/2.0.20/.pi/agents/model-profiles.yaml +134 -0
  246. package/.versions/2.0.20/.pi/agents/peers.yaml +147 -0
  247. package/.versions/2.0.20/.pi/agents/teams.yaml +41 -0
  248. package/.versions/2.0.20/.pi/agents/voices.yaml +13 -0
  249. package/.versions/2.0.20/.pi/damage-control-rules.yaml +297 -0
  250. package/.versions/2.0.20/.pi/extensions/btw/README.md +120 -0
  251. package/.versions/2.0.20/.pi/extensions/btw/index.ts +914 -0
  252. package/.versions/2.0.20/.pi/extensions/btw/package.json +6 -0
  253. package/.versions/2.0.20/.pi/extensions/btw/state.js +179 -0
  254. package/.versions/2.0.20/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  255. package/.versions/2.0.20/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  256. package/.versions/2.0.20/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  257. package/.versions/2.0.20/.pi/extensions/compact-and-continue/README.md +42 -0
  258. package/.versions/2.0.20/.pi/extensions/compact-and-continue/index.ts +136 -0
  259. package/.versions/2.0.20/.pi/extensions/compact-and-continue/package.json +6 -0
  260. package/.versions/2.0.20/.pi/extensions/mcp-bridge/README.md +46 -0
  261. package/.versions/2.0.20/.pi/extensions/mcp-bridge/index.ts +206 -0
  262. package/.versions/2.0.20/.pi/extensions/mcp-bridge/package.json +6 -0
  263. package/.versions/2.0.20/.pi/extensions/package-lock.json +1175 -0
  264. package/.versions/2.0.20/.pi/extensions/package.json +9 -0
  265. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/README.md +224 -0
  266. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/config.ts +198 -0
  267. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  268. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/index.ts +248 -0
  269. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/package.json +6 -0
  270. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  271. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  272. package/.versions/2.0.20/.pi/harnesses/agent-hub/README.md +1516 -0
  273. package/.versions/2.0.20/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  274. package/.versions/2.0.20/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  275. package/.versions/2.0.20/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  276. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  277. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  278. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  279. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  280. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  281. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  282. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  283. package/.versions/2.0.20/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  284. package/.versions/2.0.20/.pi/harnesses/agent-hub/artifacts.js +146 -0
  285. package/.versions/2.0.20/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  286. package/.versions/2.0.20/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  287. package/.versions/2.0.20/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  288. package/.versions/2.0.20/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  289. package/.versions/2.0.20/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  290. package/.versions/2.0.20/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  291. package/.versions/2.0.20/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  292. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  293. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  294. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  295. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  296. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  297. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  298. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  299. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  300. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  301. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  302. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  303. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  304. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  305. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  306. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  307. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  308. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  309. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  310. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  311. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  312. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  313. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  314. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  315. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  316. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  317. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  318. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  319. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  320. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  321. package/.versions/2.0.20/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  322. package/.versions/2.0.20/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  323. package/.versions/2.0.20/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  324. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  325. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  326. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  327. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  328. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  329. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  330. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  331. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  332. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  333. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  334. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  335. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  336. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  337. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  338. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  339. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  340. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  341. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-window.js +108 -0
  342. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  343. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  344. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  345. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  346. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  347. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  348. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  349. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  350. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  351. package/.versions/2.0.20/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  352. package/.versions/2.0.20/.pi/harnesses/agent-hub/delegate.ts +478 -0
  353. package/.versions/2.0.20/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  354. package/.versions/2.0.20/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  355. package/.versions/2.0.20/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  356. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  357. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  358. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  359. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  360. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +253 -0
  361. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  362. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  363. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  364. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  365. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  366. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  367. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  368. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  369. package/.versions/2.0.20/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  370. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  371. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  372. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  373. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  374. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  375. package/.versions/2.0.20/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  376. package/.versions/2.0.20/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  377. package/.versions/2.0.20/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  378. package/.versions/2.0.20/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  379. package/.versions/2.0.20/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  380. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  381. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  382. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  383. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  384. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  385. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  386. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  387. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  388. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  389. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  390. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  391. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  392. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  393. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  394. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  395. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  396. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  397. package/.versions/2.0.20/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  398. package/.versions/2.0.20/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  399. package/.versions/2.0.20/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  400. package/.versions/2.0.20/.pi/harnesses/agent-hub/footer.ts +30 -0
  401. package/.versions/2.0.20/.pi/harnesses/agent-hub/helpers.ts +270 -0
  402. package/.versions/2.0.20/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  403. package/.versions/2.0.20/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  404. package/.versions/2.0.20/.pi/harnesses/agent-hub/index.ts +2614 -0
  405. package/.versions/2.0.20/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  406. package/.versions/2.0.20/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  407. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  408. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  409. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  410. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  411. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  412. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  413. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  414. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  415. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  416. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  417. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  418. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  419. package/.versions/2.0.20/.pi/harnesses/agent-hub/no-progress.ts +620 -0
  420. package/.versions/2.0.20/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  421. package/.versions/2.0.20/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  422. package/.versions/2.0.20/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  423. package/.versions/2.0.20/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  424. package/.versions/2.0.20/.pi/harnesses/agent-hub/package.json +7 -0
  425. package/.versions/2.0.20/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  426. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  427. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  428. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  429. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  430. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  431. package/.versions/2.0.20/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  432. package/.versions/2.0.20/.pi/harnesses/agent-hub/presentation.ts +48 -0
  433. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  434. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  435. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  436. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  437. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  438. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  439. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  440. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  441. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  442. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  443. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  444. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  445. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  446. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  447. package/.versions/2.0.20/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  448. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  449. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  450. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  451. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  452. package/.versions/2.0.20/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  453. package/.versions/2.0.20/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  454. package/.versions/2.0.20/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  455. package/.versions/2.0.20/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  456. package/.versions/2.0.20/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  457. package/.versions/2.0.20/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  458. package/.versions/2.0.20/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  459. package/.versions/2.0.20/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  460. package/.versions/2.0.20/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  461. package/.versions/2.0.20/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  462. package/.versions/2.0.20/.pi/harnesses/agent-hub/return-contract.js +349 -0
  463. package/.versions/2.0.20/.pi/harnesses/agent-hub/return-extract.js +77 -0
  464. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  465. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  466. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-findings.js +96 -0
  467. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  468. package/.versions/2.0.20/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  469. package/.versions/2.0.20/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  470. package/.versions/2.0.20/.pi/harnesses/agent-hub/run-budget.js +342 -0
  471. package/.versions/2.0.20/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  472. package/.versions/2.0.20/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  473. package/.versions/2.0.20/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  474. package/.versions/2.0.20/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  475. package/.versions/2.0.20/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  476. package/.versions/2.0.20/.pi/harnesses/agent-hub/session-health.js +110 -0
  477. package/.versions/2.0.20/.pi/harnesses/agent-hub/session-start.ts +42 -0
  478. package/.versions/2.0.20/.pi/harnesses/agent-hub/spawn.ts +639 -0
  479. package/.versions/2.0.20/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  480. package/.versions/2.0.20/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  481. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  482. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  483. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  484. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  485. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  486. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  487. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  488. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  489. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  490. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  491. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  492. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  493. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  494. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  495. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  496. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  497. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  498. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  499. package/.versions/2.0.20/.pi/harnesses/agent-hub/timeline.ts +72 -0
  500. package/.versions/2.0.20/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  501. package/.versions/2.0.20/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  502. package/.versions/2.0.20/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  503. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  504. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  505. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  506. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  507. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  508. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  509. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +640 -0
  510. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  511. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  512. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  513. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  514. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  515. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  516. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  517. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  518. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  519. package/.versions/2.0.20/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  520. package/.versions/2.0.20/.pi/harnesses/agent-hub/types.ts +66 -0
  521. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  522. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  523. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  524. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  525. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  526. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  527. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  528. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  529. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  530. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  531. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  532. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  533. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  534. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  535. package/.versions/2.0.20/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  536. package/.versions/2.0.20/.pi/harnesses/agent-hub/version.ts +42 -0
  537. package/.versions/2.0.20/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  538. package/.versions/2.0.20/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  539. package/.versions/2.0.20/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  540. package/.versions/2.0.20/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  541. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/README.md +59 -0
  542. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/index.ts +569 -0
  543. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  544. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  545. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  546. package/.versions/2.0.20/.pi/harnesses/coms/README.md +100 -0
  547. package/.versions/2.0.20/.pi/harnesses/coms/index.ts +282 -0
  548. package/.versions/2.0.20/.pi/harnesses/coms/package.json +7 -0
  549. package/.versions/2.0.20/.pi/harnesses/coms/version.ts +42 -0
  550. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/README.md +161 -0
  551. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/index.ts +600 -0
  552. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/package.json +7 -0
  553. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  554. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  555. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  556. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  557. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/version.ts +42 -0
  558. package/.versions/2.0.20/.pi/harnesses/lib/approval-wait.ts +17 -0
  559. package/.versions/2.0.20/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  560. package/.versions/2.0.20/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  561. package/.versions/2.0.20/.pi/harnesses/lib/clarification-policy.ts +9 -0
  562. package/.versions/2.0.20/.pi/harnesses/lib/coms-core-io.ts +386 -0
  563. package/.versions/2.0.20/.pi/harnesses/lib/coms-core.ts +578 -0
  564. package/.versions/2.0.20/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  565. package/.versions/2.0.20/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  566. package/.versions/2.0.20/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  567. package/.versions/2.0.20/.pi/harnesses/lib/context-budget-view.ts +112 -0
  568. package/.versions/2.0.20/.pi/harnesses/lib/context-budget.ts +114 -0
  569. package/.versions/2.0.20/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  570. package/.versions/2.0.20/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  571. package/.versions/2.0.20/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  572. package/.versions/2.0.20/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  573. package/.versions/2.0.20/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  574. package/.versions/2.0.20/.pi/harnesses/lib/damage-result-view.ts +16 -0
  575. package/.versions/2.0.20/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  576. package/.versions/2.0.20/.pi/harnesses/lib/execution-trace.ts +45 -0
  577. package/.versions/2.0.20/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  578. package/.versions/2.0.20/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  579. package/.versions/2.0.20/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  580. package/.versions/2.0.20/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  581. package/.versions/2.0.20/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  582. package/.versions/2.0.20/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  583. package/.versions/2.0.20/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  584. package/.versions/2.0.20/.pi/harnesses/lib/fleet-panel.ts +34 -0
  585. package/.versions/2.0.20/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  586. package/.versions/2.0.20/.pi/harnesses/lib/fleet-selection.ts +24 -0
  587. package/.versions/2.0.20/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  588. package/.versions/2.0.20/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  589. package/.versions/2.0.20/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  590. package/.versions/2.0.20/.pi/harnesses/lib/herdr-client.ts +472 -0
  591. package/.versions/2.0.20/.pi/harnesses/lib/herdr-presence.ts +399 -0
  592. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  593. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  594. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  595. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  596. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  597. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  598. package/.versions/2.0.20/.pi/harnesses/lib/identical-dialog.ts +27 -0
  599. package/.versions/2.0.20/.pi/harnesses/lib/installation-state.js +62 -0
  600. package/.versions/2.0.20/.pi/harnesses/lib/policy-roots.js +106 -0
  601. package/.versions/2.0.20/.pi/harnesses/lib/policy-roots.ts +31 -0
  602. package/.versions/2.0.20/.pi/harnesses/lib/process-shared.ts +9 -0
  603. package/.versions/2.0.20/.pi/harnesses/lib/safe-source-read.js +29 -0
  604. package/.versions/2.0.20/.pi/harnesses/lib/semantic-approval.ts +80 -0
  605. package/.versions/2.0.20/.pi/harnesses/lib/spawned-peers.js +191 -0
  606. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  607. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  608. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  609. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  610. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-json.js +37 -0
  611. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-loader.js +44 -0
  612. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  613. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-triage.js +42 -0
  614. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-v2.js +112 -0
  615. package/.versions/2.0.20/.pi/harnesses/lib/system1/config.js +50 -0
  616. package/.versions/2.0.20/.pi/harnesses/lib/system1/contracts.ts +154 -0
  617. package/.versions/2.0.20/.pi/harnesses/lib/system1/demo.ts +95 -0
  618. package/.versions/2.0.20/.pi/harnesses/lib/system1/jev.ts +503 -0
  619. package/.versions/2.0.20/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  620. package/.versions/2.0.20/.pi/harnesses/lib/system1/selection.js +11 -0
  621. package/.versions/2.0.20/.pi/harnesses/lib/system1/service.ts +245 -0
  622. package/.versions/2.0.20/.pi/harnesses/lib/update-check.ts +222 -0
  623. package/.versions/2.0.20/.pi/harnesses/package-lock.json +2121 -0
  624. package/.versions/2.0.20/.pi/harnesses/package.json +13 -0
  625. package/.versions/2.0.20/.pi/prompts/af-build.md +27 -0
  626. package/.versions/2.0.20/.pi/prompts/af-code-simplify.md +22 -0
  627. package/.versions/2.0.20/.pi/prompts/af-constraints.md +31 -0
  628. package/.versions/2.0.20/.pi/prompts/af-plan.md +17 -0
  629. package/.versions/2.0.20/.pi/prompts/af-review.md +16 -0
  630. package/.versions/2.0.20/.pi/prompts/af-set-hermes-telegram.md +15 -0
  631. package/.versions/2.0.20/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  632. package/.versions/2.0.20/.pi/prompts/af-setup-rules.md +20 -0
  633. package/.versions/2.0.20/.pi/prompts/af-ship.md +17 -0
  634. package/.versions/2.0.20/.pi/prompts/af-spec.md +15 -0
  635. package/.versions/2.0.20/.pi/prompts/af-test.md +19 -0
  636. package/.versions/2.0.20/.pi/skills/bowser/SKILL.md +145 -0
  637. package/.versions/2.0.20/.version +1 -0
  638. package/.versions/2.0.20/agents/architect.md +24 -0
  639. package/.versions/2.0.20/agents/bowser.md +28 -0
  640. package/.versions/2.0.20/agents/builder.md +55 -0
  641. package/.versions/2.0.20/agents/code-reviewer.md +209 -0
  642. package/.versions/2.0.20/agents/deep-researcher.md +32 -0
  643. package/.versions/2.0.20/agents/documenter.md +22 -0
  644. package/.versions/2.0.20/agents/orchestrator.md +22 -0
  645. package/.versions/2.0.20/agents/plan-reviewer.md +83 -0
  646. package/.versions/2.0.20/agents/planner.md +107 -0
  647. package/.versions/2.0.20/agents/releaser.md +24 -0
  648. package/.versions/2.0.20/agents/researcher.md +30 -0
  649. package/.versions/2.0.20/agents/security-auditor.md +167 -0
  650. package/.versions/2.0.20/agents/test-engineer.md +153 -0
  651. package/.versions/2.0.20/agents/web-debugger.md +44 -0
  652. package/.versions/2.0.20/agents/web-performance-auditor.md +194 -0
  653. package/.versions/2.0.20/bin/catalog/harness-runtime-closure.json +73 -0
  654. package/.versions/2.0.20/codex/fleet-session-client/SKILL.md +34 -0
  655. package/.versions/2.0.20/codex/fleet-session-client.zip +0 -0
  656. package/.versions/2.0.20/docs/ARCHITECTURE.md +977 -0
  657. package/.versions/2.0.20/docs/agent-fleet-setup.md +1103 -0
  658. package/.versions/2.0.20/docs/claude-code-coms-bridge.md +147 -0
  659. package/.versions/2.0.20/docs/codex-session-bridge.md +219 -0
  660. package/.versions/2.0.20/docs/coms-hermes-bridge.md +188 -0
  661. package/.versions/2.0.20/docs/getting-started.md +126 -0
  662. package/.versions/2.0.20/docs/npm-install.md +535 -0
  663. package/.versions/2.0.20/docs/pi-extensions.md +455 -0
  664. package/.versions/2.0.20/docs/pi-setup.md +92 -0
  665. package/.versions/2.0.20/docs/skill-anatomy.md +150 -0
  666. package/.versions/2.0.20/install-manifest.json +3210 -0
  667. package/.versions/2.0.20/justfile +247 -0
  668. package/.versions/2.0.20/manifest-meta.json +1088 -0
  669. package/.versions/2.0.20/references/accessibility-checklist.md +160 -0
  670. package/.versions/2.0.20/references/communication-contract.md +26 -0
  671. package/.versions/2.0.20/references/definition-of-done.md +67 -0
  672. package/.versions/2.0.20/references/fleet-coordination-patterns.md +171 -0
  673. package/.versions/2.0.20/references/observability-checklist.md +92 -0
  674. package/.versions/2.0.20/references/orchestration-patterns.md +370 -0
  675. package/.versions/2.0.20/references/performance-checklist.md +236 -0
  676. package/.versions/2.0.20/references/prompting-patterns.md +380 -0
  677. package/.versions/2.0.20/references/security-checklist.md +245 -0
  678. package/.versions/2.0.20/references/testing-patterns.md +235 -0
  679. package/.versions/2.0.20/references/workflow-authoring.md +304 -0
  680. package/.versions/2.0.20/skills/_internal/grilling.md +59 -0
  681. package/.versions/2.0.20/skills/browser-testing-with-devtools/SKILL.md +351 -0
  682. package/.versions/2.0.20/skills/code-review-and-quality/SKILL.md +396 -0
  683. package/.versions/2.0.20/skills/compound-learning/SKILL.md +137 -0
  684. package/.versions/2.0.20/skills/constraint-driven-development/SKILL.md +338 -0
  685. package/.versions/2.0.20/skills/constraint-driven-development/references/floor-guard.md +99 -0
  686. package/.versions/2.0.20/skills/context-engineering/SKILL.md +341 -0
  687. package/.versions/2.0.20/skills/deprecation-and-migration/SKILL.md +247 -0
  688. package/.versions/2.0.20/skills/designing-agents/SKILL.md +394 -0
  689. package/.versions/2.0.20/skills/designing-agents/pi-harness-authoring.md +222 -0
  690. package/.versions/2.0.20/skills/drafting-workflows/SKILL.md +143 -0
  691. package/.versions/2.0.20/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  692. package/.versions/2.0.20/skills/frontend-ui-engineering/SKILL.md +328 -0
  693. package/.versions/2.0.20/skills/git-workflow-and-versioning/SKILL.md +316 -0
  694. package/.versions/2.0.20/skills/idea-refine/SKILL.md +182 -0
  695. package/.versions/2.0.20/skills/idea-refine/examples.md +238 -0
  696. package/.versions/2.0.20/skills/idea-refine/frameworks.md +99 -0
  697. package/.versions/2.0.20/skills/idea-refine/refinement-criteria.md +113 -0
  698. package/.versions/2.0.20/skills/idea-refine/scripts/idea-refine.sh +15 -0
  699. package/.versions/2.0.20/skills/incremental-implementation/SKILL.md +353 -0
  700. package/.versions/2.0.20/skills/incremental-implementation.zip +0 -0
  701. package/.versions/2.0.20/skills/interview-me/SKILL.md +226 -0
  702. package/.versions/2.0.20/skills/orchestration-verification/SKILL.md +182 -0
  703. package/.versions/2.0.20/skills/peer-coms/SKILL.md +90 -0
  704. package/.versions/2.0.20/skills/performance-optimization/SKILL.md +496 -0
  705. package/.versions/2.0.20/skills/planning-and-task-breakdown/SKILL.md +318 -0
  706. package/.versions/2.0.20/skills/planning-and-task-breakdown.zip +0 -0
  707. package/.versions/2.0.20/skills/repository-ai-setup/SKILL.md +135 -0
  708. package/.versions/2.0.20/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  709. package/.versions/2.0.20/skills/repository-ai-setup/references/apply-contract.md +74 -0
  710. package/.versions/2.0.20/skills/repository-ai-setup/references/provenance-template.md +16 -0
  711. package/.versions/2.0.20/skills/repository-ai-setup/references/setup-flow.md +108 -0
  712. package/.versions/2.0.20/skills/repository-ai-setup/references/verify-setup.md +20 -0
  713. package/.versions/2.0.20/skills/repository-ai-setup.zip +0 -0
  714. package/.versions/2.0.20/skills/security-and-hardening/SKILL.md +524 -0
  715. package/.versions/2.0.20/skills/spec-driven-development/SKILL.md +295 -0
  716. package/.versions/2.0.20/skills/spec-driven-development.zip +0 -0
  717. package/.versions/2.0.20/skills/using-agent-skills/SKILL.md +198 -0
  718. package/.versions/2.0.20/vendor/agent-skills-upstream/LICENSE +21 -0
  719. package/.versions/2.0.20/vendor/agent-skills-upstream/README.md +430 -0
  720. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  721. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  722. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  723. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  724. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  725. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  726. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  727. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  728. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  729. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  730. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  731. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  732. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  733. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  734. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  735. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  736. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  737. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  738. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  739. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  740. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  741. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  742. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  743. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  744. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  745. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  746. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  747. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  748. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  749. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  750. package/CHANGELOG.md +32 -0
  751. package/README.md +3 -2
  752. package/agents/builder.md +1 -1
  753. package/agents/planner.md +6 -4
  754. package/bin/cli.js +9 -2
  755. package/bin/lib/apply.js +4 -0
  756. package/bin/lib/desired.js +2 -0
  757. package/bin/lib/doctor.js +13 -7
  758. package/bin/lib/state.js +7 -4
  759. package/bin/lib/transaction.js +6 -1
  760. package/bin/lib/validate-overrides.js +7 -3
  761. package/bin/lib/verify.js +9 -2
  762. package/docs/ARCHITECTURE.md +177 -74
  763. package/docs/agent-fleet-setup.md +10 -8
  764. package/docs/external-project-ai-content.md +17 -2
  765. package/docs/pi-extensions.md +7 -6
  766. package/docs/system1-agentic.md +4 -4
  767. package/docs/system1-config.md +144 -1
  768. package/docs/system1-context-continuity.md +224 -0
  769. package/docs/system1-damage-guard.md +172 -0
  770. package/docs/system1-dispatch-triage.md +169 -0
  771. package/docs/system1-file-discovery.md +16 -4
  772. package/docs/system1.example.json +102 -0
  773. package/install-manifest.json +17 -4
  774. package/manifest-meta.json +14 -1
  775. package/package.json +21 -9
  776. package/skills/_internal/grilling.md +54 -54
  777. package/skills/incremental-implementation/SKILL.md +8 -8
  778. package/skills/incremental-implementation.zip +0 -0
  779. package/skills/planning-and-task-breakdown/SKILL.md +7 -7
  780. package/skills/planning-and-task-breakdown.zip +0 -0
  781. package/skills/spec-driven-development/SKILL.md +1 -1
  782. package/skills/spec-driven-development.zip +0 -0
  783. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -13
  784. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +0 -10
@@ -21,10 +21,11 @@ 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/agenticAsk/fileDiscovery 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/contextCompaction/damageGuard 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
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) |
28
+ | **System 1 damage guard (D6)** | Off-by-default independent commands/edits/results scopes over mandatory Damage-Control baseline; parent-owned durable decisions, approval and native capability transport; production wiring exists, acceptance remains open | `.pi/harnesses/agent-hub/damage-guard-*.ts`, `damage-control-continue/system1-*.ts`, `result-screen.ts` — [contract and limits](system1-damage-guard.md) |
28
29
  | **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) |
29
30
  | **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
30
31
 
@@ -46,9 +47,36 @@ orchestrator startup requires a roster. `/af-work-mode` and **Alt+M** switch
46
47
  only work mode in the live session, and `/af-agents-*` changes
47
48
  only the native roster. Dispatch, research, nested delegation, and Verification
48
49
  Contract rigor follow the **task tier** (`trivial`/`small`/`feature`/`project`),
49
- not a session execution mode. One orchestrator exception: the turn dispatch
50
- allowance is at least 3 unless `max-dispatches-per-turn` sets a lower ceiling.
51
- The task envelope stays 3× the tier turn budget, not 3× that floor.
50
+ not a session execution mode. Dispatch/research counts and active duration are
51
+ accounting metrics without turn or task continuation quotas. Planner and plan
52
+ review are optional; wide/high-risk work retains independent review and applicable
53
+ exact-action authorization without a pre-effect planning gate.
54
+
55
+ Approval memory is shared across Pi's isolated extension loaders within the
56
+ runtime. Semantic decisions remain bound to the accepted task/input revision and
57
+ exact path; task/session changes fence late answers. Only an exact-action dialog
58
+ that showed the human the command records a delete decision; free-form `ask_user`
59
+ answers are never recorded and never answered automatically, because prose cannot
60
+ prove which path or polarity the human chose. Remembered confirmation is
61
+ not a reusable effect grant: actual irreversible effects still consume their
62
+ runtime authorization. Identical concurrent dialogs coalesce, and cancellation
63
+ does not become consent.
64
+
65
+ Successful independent reviews retain role-specific evidence, reviewed file
66
+ revision, coverage, requirement declarations and input-artifact hashes in the
67
+ process journal. An identical covered review returns the retained evidence without
68
+ starting another child. Changed accepted input, source, requirements, task, scope, evidence,
69
+ concurrent writes or an explicit `review_reason` require a fresh review; unresolved
70
+ questions, blocking findings and rejected reviews cannot supply reusable approval.
71
+
72
+ The model's context hook projects older successful coordination/inspection bodies
73
+ to short references backed by exact local originals. It leaves the session journal,
74
+ user/assistant messages, questions, failures, images and latest tool batch intact,
75
+ and retains a recent inspection working set. The prompt capsule carries current
76
+ sourced requirements and critical conditions without treating recorded status as
77
+ fresh proof. Plain continue/resume inputs retain the accepted task; identical
78
+ classification declarations avoid new triage, revision hashing and journal writes.
79
+ Changed intent still uses the existing task-transition fence.
52
80
 
53
81
  All Hub-owned slash commands remain registered in both work modes. Capability packs are resolved automatically from explicit task intent, work mode, tier, pending work, and compaction state—there is no activation command. Runtime **readiness** (a coms or Herdr connection) is not model-visible capability: ready-but-unrequested peer/workspace packs remain inactive. Ambiguous fleet, peer, and workspace requests are provisionally visible but require one `ask_user` confirmation before their first side effect; a rejection removes the provisional pack. Task packs persist across follow-ups and reset only through `set_task_tier(new_task: true)`, while mandatory work mode and pending-operation leases remain.
54
82
 
@@ -61,10 +89,14 @@ T12 diagnostics have been withdrawn by user decision; there is no command, runne
61
89
  Standing prompt ceilings constrain the repeatable replacement prompt and active schemas; they do not
62
90
  bound conversation messages or results accumulated inside a long tool loop. The Hub therefore has a
63
91
  second, runtime pressure guard. It samples provider usage, projects a finalized tool result at
64
- `message_end`, warns and exposes transient compaction support at **80%**, then at **90%** aborts the
92
+ `message_end`, warns and exposes transient compaction support at **60%**, then at **70%** aborts the
65
93
  pre-model continuation and waits for `agent_settled` before requesting one Pi compaction. This
66
94
  ordering ensures the result is persisted before summarization and prevents an ordinary provider call
67
- from escaping between pressure detection and recovery.
95
+ from escaping between pressure detection and recovery. Automatic compaction re-arms when measured
96
+ usage falls below 60%, or after the history grows by 10% of the window over the first measurement
97
+ after a compaction. At the **80%** ceiling, work stops after a failed recovery or when even the
98
+ compacted baseline is at or above the ceiling. A baseline between 70% and 80% only warns, because a
99
+ small window then keeps working until growth re-arms compaction.
68
100
 
69
101
  Recovery is single-flight. High-context startup or concurrent input is retained in memory and
70
102
  replayed exactly once after success; failure retains it for `/compact` or a larger-context model.
@@ -176,6 +208,36 @@ mechanics, not semantic accuracy or final live activation. See the [D9 guide](sy
176
208
  for exact triggers, unsupported surfaces, residual limitations and unpublished
177
209
  source/local-tarball commands.
178
210
 
211
+ ### Optional semantic damage guard
212
+
213
+ D6's parent Hub owns the shared service, task/accepted-input revision, durable
214
+ hold/denial state and shared approval coordinator. Baseline-allowed bash/write/edit
215
+ receive scoped pre-call assessment; only valid severe AND sufficient can hold an
216
+ exact action. Native specialists, research helpers and nested delegates have
217
+ independent physical-spawn registration, fresh/revocable assignments (including
218
+ fallback), stripped inherited assignments and no child provider credentials.
219
+ This is independent of D9 consent and cannot expand effective tools, admission,
220
+ OS isolation, budgets or baseline authority. Research stays read-only with
221
+ supported result screening; standalone Damage-Control without trusted assignment
222
+ has baseline only, and coms peers have no native D6 registration coverage.
223
+
224
+ Missing/off/invalid/root-off/unavailable-key means no new D6 inference, not
225
+ removal of durable fences. `/af-damage-override [actionId]` only re-arms a matching
226
+ human dialog, never executes, retries, clears denial or grants path access.
227
+ One-use semantic consent still requires current baseline authority after waiting.
228
+ Original→D6→D8 composition keeps frozen non-aliased original evidence separate
229
+ from appended visible advice; structured `damageGuard` and `fileDiscovery`
230
+ views preserve originals or envelope collisions. Failed capture is a gap and
231
+ warning absence never establishes trust. See the [D6 guide](system1-damage-guard.md)
232
+ for bounded provenance-checked result sources, exact structured API and deadlines.
233
+
234
+ Production wiring exists in the current worktree; named F10 no-network checks
235
+ record SDK/codemode 1.1.0 on Node v25.2.1, not universal compatibility. In that
236
+ SDK, non-structured error rejection exposes the original first block, not coverage
237
+ text (the nested outcome retains coverage/error). D6 remains incomplete/unaccepted:
238
+ A1–A8, independent review/final testing, F12 packaging and F13 final acceptance
239
+ remain open. Documentation and module presence do not close those gates.
240
+
179
241
  ### Research search supervision
180
242
 
181
243
  The shared `spawnPiAgent` seam supervises every `read`/`grep`/`find`/`ls` call from native
@@ -189,46 +251,30 @@ drain, and reports timeout separately from cancellation. Research helpers and ne
189
251
  are each given safe process-group ownership; delegates forward parent termination so no detached
190
252
  child is orphaned. Full pattern catalog: [references/orchestration-patterns.md](../references/orchestration-patterns.md).
191
253
 
192
- ### Task-tier budgets
193
-
194
- The hub enforces per-user-turn budgets in code (`run-budget.js`): the current **task tier**
195
- caps `dispatch_agent` calls, `spawn_research` calls, and active time per turn, sets the
196
- per-run deadline above, and controls nested delegation (`off` at trivial/small). Exhausted
197
- budgets make the dispatch tools refuse and request one Yes/No `ask_user` confirmation; Yes
198
- renews the turn in the same tool loop. A normal new user message also opens a fresh turn
199
- window.
200
- Specialist context pressure is measured over input + cacheRead + cacheWrite against **that
201
- agent's own** model window, resolved from pi's model registry with the source recorded
202
- (`context-window.js`) — measuring a 49k local model against the dispatcher's window is what
203
- made readings like "315%" unactionable; anything over 100% now emits a one-time diagnostic
204
- naming the window and where it came from. Specialist sessions are recycled (fresh spawn
205
- instead of `-c` resume) after `session-recycle-runs` runs, at ≥60% measured context, and
206
- unconditionally at a full window; a resumed session whose *projected* prompt would overflow
207
- is recycled before the spawn rather than after the run. Requests to one provider are capped
208
- per process (`provider-semaphore.js`: 2 in flight for `custom/*` by default, unlimited
209
- elsewhere, `AGENT_HUB_PROVIDER_LIMITS` to override) — the cap is per level of the delegation
210
- tree, and a nested spawn reuses its parent's permit so it can never wait on its own ancestor.
211
- Configured under `## agent-hub` (`max-dispatches-per-turn`,
212
- `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`,
213
- `run-history-keep`) as ceilings (`min` with the tier). A leftover `mode:` key is ignored with
214
- a warning.
215
-
216
- A per-message allowance cannot bound a task, so a second envelope sits above the turn one:
217
- the **task budget** (`run-budget.js`, `3×` the turn envelope) counts dispatches, research
218
- runs and **active** time across the WHOLE task and is *not* reset by a user message. Both turn
219
- and task active time exclude `ask_user` waits — billing human idle false-stops a normal steered
220
- session and teaches people to reset reflexively. The auto-research pipe is exempt from the turn
221
- budget but charged against the task envelope, so it cannot smuggle 8 helpers per dispatch past
222
- the outer bound.
223
-
224
- Either envelope stops before another dispatch/research call and asks one localized Yes/No
225
- `ask_user` question. A confirmed turn continuation renews its counters/clock in the same tool
226
- loop. A confirmed task continuation opens one audited tranche, also renews the turn, and
227
- preserves task tier, assertions, capability packs, label, blockers, and progress. No typed
228
- `continue` message or slash command is required. `set_task_tier` with `new_task: true` is only
229
- for genuinely different work and clears task identity/state. This is the guardrail the
230
- post-mortem run never hit: every steering message reopened the turn window,
231
- so one workspace stayed open 47 hours on a change that took 13 minutes in a narrow one.
254
+ ### Usage accounting and supervision
255
+
256
+ The hub records dispatches, research, review rounds and active time across turns and
257
+ saved tasks (`run-budget.js`). None imposes a continuation quota. Legacy
258
+ `max-dispatches-per-turn`, `max-research-per-turn` and `turn-wall-time-s` overrides
259
+ are ignored with migration warnings. Usage remains visible with unlimited caps.
260
+ Task tiers still select delegation, specialist deadlines, recycling and role policy.
261
+ Planner and plan-reviewer are optional at every tier. Wide or high-risk classification
262
+ and System 1 additions retain independent review and action authorization, not a
263
+ Planner admission requirement. Gaps use research; new decisions use `ask_user` grilling.
264
+
265
+ The root operator and native specialists use the drift runtime. Repeated identical
266
+ calls or consecutive failures trigger a bounded judge; a current stuck/drifting
267
+ verdict requests cancellation. Root productive call volume alone never triggers it.
268
+ Judges are fenced at turn/input/session boundaries; an unavailable judge cannot
269
+ fabricate a stop. Root audit entries distinguish an abort request from a confirmed
270
+ physical child stop. This is tool-stream supervision, not a wall-time heartbeat or
271
+ visibility into an external coms peer's own tools. `watchdog: auto` arms it by default;
272
+ an explicit human `off` setting is respected.
273
+
274
+ Individual child deadlines and operator cancellation remain effective. Session
275
+ recycling at run-count/context thresholds and provider concurrency limits remain
276
+ independent resource controls. `agent-turn-timeout-s` and `session-recycle-runs`
277
+ can tighten their tier defaults. Active-time accounting excludes human waits.
232
278
 
233
279
  ### Runtime acceptance and recovery
234
280
 
@@ -313,6 +359,10 @@ retrieval handle. With `bounded-output` off, legacy transport is preserved regar
313
359
  `deterministic-tools` setting. Inventory records an escaping or unavailable symlink as a denied
314
360
  entry without traversing it or disclosing its target outside the authorized inventory.
315
361
  T5 does not consume `assist.write-isolation`; the separate T6c native launch boundary does.
362
+ `assist.return-extraction` is opt-in help for models that forget `submit_result`: a native
363
+ specialist with tracked assertions that never submits gets the cheap read-only extraction pass
364
+ over its written report. The recovered block is labelled extracted, `resultProtocol` stays
365
+ `submission_missing`, and acceptance still depends on runtime evidence.
316
366
 
317
367
  Invocation preflight for `dispatch_agent` and `spawn_research` validates the original
318
368
  shape before normalization. Invalid input reports bounded safe field locations and
@@ -415,38 +465,43 @@ effective-catalog event can establish `toolStateChanged` evidence for the existi
415
465
  `unknown_tool` `recoveryDecision`, but still requires explicit reinvocation and existing general
416
466
  budgets; it never schedules an automatic retry.
417
467
 
418
- On top of the tier envelope sit several qualitative guardrails. **Task triage**: the dispatcher
419
- classifies the current TASK via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
420
- and that classification *is* the budget. The tier is task-scoped and **ratcheted** — it survives
421
- the user's next message, lowering is free, raising needs a stated `reason` — because a
422
- turn-scoped tier reset to `feature` on every correction. Three refusals enforce
423
- proportionality in code rather than prose: a duplicate-dispatch guard (near-identical
424
- re-dispatches within a turn), a **tier persona gate** (`planner`, `plan-reviewer`,
425
- `architect`, `security-auditor`, `deep-researcher` are refused at trivial/small — each opens
426
- a document/finding loop), and a **review round cap** (review dispatches per task, by tier).
427
- Skipping triage assumes `small`, not `feature`: the tier latches for the task, and the case
428
- where it was never declared is exactly the case where proportionality was not being
429
- considered. The review **finding** budget is the one thing deliberately left advisory — the
430
- hub counts blocking findings (`review-findings.js`) and reports an over-budget return, but
431
- never reclassifies one, because no rule it can evaluate separates an invented manifest from
432
- a leaked credential; the round cap is what carries the enforcement.
468
+ Qualitative guardrails remain separate from usage accounting. **Task triage** classifies
469
+ the current task (`trivial`/`small`/`feature`/`project`) for delegation, role and
470
+ individual-process resource policy. It survives follow-ups; lowering is free and
471
+ raising needs a recorded reason. Skipped triage assumes small. Near-identical
472
+ dispatches retain the duplicate guard. Architect, security-auditor and deep-researcher
473
+ retain the trivial/small persona gate; Planner and plan-reviewer are optional at
474
+ every tier. Review rounds are uncapped. Review findings retain their advisory
475
+ budget and source-invariant rule; findings are never silently demoted by position.
433
476
  **Process obligations (T11)** are task-scoped and independent of that budget tier. The
434
477
  `set_task_tier` tool accepts explicit `risk` (`unknown | low | high`) and process `scope`
435
478
  (`read-only | small | wide`); neither is inferred from task prose. Legacy/omitted risk is
436
479
  `unknown`, risk changes require a reason, and scope expansion requires a reason plus an
437
480
  explicit risk reassessment. Unknown permits read-only research but cannot accept changed
438
481
  work. Confirmed low-risk small work uses the existing T2 minimal acceptance path; high risk
439
- adds a separate review stage, while wide work adds plan and review stages. These obligations
440
- ratchet within a task, so lowering spend cannot erase them. Completed stage records name an
441
- artifact and revision but only prove that the stage occurred—not that model-authored review
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.
482
+ adds a separate review stage; wide work also requires independent review. Planning
483
+ is optional and never a pre-effect gate. Current stage evidence names an artifact
484
+ and revision, without claiming that a model review is semantically adequate. A
485
+ requested Planner still needs genuine declared artifact readback to record plan
486
+ occurrence. Missing optional planning cannot block an authorized builder, direct
487
+ operator or coms peer. Exact-action authorization, independent review, current
488
+ verification and task-transition fencing still govern their respective effects.
489
+ Exit 0, prompt echoes, pending transport and stale evidence cannot replace them.
490
+
491
+ Sensitive-work prohibitions remain distinct from positive requests in handoff
492
+ advice; neither positive nor ambiguous wording mandates a Planner. Resolve factual
493
+ gaps with focused research and additional decisions with `ask_user` grilling.
494
+
495
+ Dispatch observation preserves the existing snapshot when the session cwd is a Git
496
+ worktree. For a non-Git parent it resolves only the literal anchors of declared scopes to
497
+ their nearest nested Git roots, rejects roots outside the workspace, and runs path-bounded
498
+ status there without recursive discovery or file-content capture. Each repository retains
499
+ its HEAD and file metadata separately. Deltas and compiler diagnostics are reported with
500
+ workspace-relative paths; compiler discovery runs at the owning repository. Missing roots
501
+ and changed HEADs create scope-specific gaps while other roots remain observable. Partial
502
+ observation or unavailable compiler coverage cannot establish acceptance through a passing
503
+ sibling repository. Runtime session outputs are excluded from nested observation. These
504
+ are local source guarantees, not evidence that an installed workspace copy was upgraded.
450
505
 
451
506
  The same code-owned state is consumed by dispatch acceptance in operator and orchestrator
452
507
  modes, appended as `agent-hub-process-state`, restored from the session log, and retained
@@ -674,7 +729,7 @@ bind input/scope/version; task adoption and compaction/resume cannot refill the
674
729
  allowance. Physical attempts and unknown usage remain distinct from logical calls.
675
730
 
676
731
  Independent intent-aware predicates at inclusive thresholds add review
677
- (`security_change` ≥0.80), plan/review (`wide_change` ≥0.85), or exact-action human
732
+ (`security_change` ≥0.80), review (`wide_change` ≥0.85), or exact-action human
678
733
  confirmation (`irreversible_execution` ≥0.80). They do not set risk/tier, select
679
734
  a model/roster, increase spend or weaken baseline protections. Low probabilities
680
735
  are not clearance; missing/invalid/provider-failed results add nothing while
@@ -686,7 +741,7 @@ requirements. New scope invalidates uncovered evidence. A narrow correlated
686
741
  human waiver releases one bound addition as `waived`, not `satisfied`; baseline
687
742
  and other-source requirements survive. Pending task transition and authoritative
688
743
  state/grant/consumption persistence refusal fence dependent effects. While that fence is up, `set_task_tier` and `ask_user` remain callable; any other tool is a diversion. The first assistant step that calls another tool is refused with the bind hint on every tool in that step and is not aborted, so the model can call `set_task_tier` next. A later step that still does not bind stops the turn, including its parallel batch, by aborting the run instead of repeating the same retryable refusal. The fence is persisted and restored on resume until `set_task_tier` clears it. Supported
689
- native planner/reviewer stages use the existing evidence path; exact-action
744
+ Optional native planning and required review use the existing evidence path; exact-action
690
745
  confirmation supports Hub direct bash/edit/write, not arbitrary child/remote/coms
691
746
  execution. The human question shows complete tool inputs as JSON and cwd with
692
747
  an **8 KiB (8192 bytes)** full-detail cap: invalid, missing, sensitive,
@@ -714,6 +769,53 @@ and restart stop future calls without deleting resumed obligations. Detailed
714
769
  schema, saved desired selection, role/budget recovery, narrow waiver and rollback
715
770
  are in [Project Files](agent-fleet-setup.md#task-triage-active-experimental-off-by-default).
716
771
 
772
+ ### Execution tracing and baseline policy classification
773
+
774
+ The Hub records `agent-hub-execution-trace` custom entries in the existing Pi
775
+ session JSONL journal. By default Pi keeps it under `~/.pi/agent/sessions/`, in a
776
+ directory named after the workspace's absolute path (for `/home/user/project`:
777
+ `--home-user-project--`); a configured Pi session directory may differ. These entries complement the Fleet session directory under
778
+ `.pi/agent-sessions/sessions/<fleet-session-id>/` and existing coms/Herdr logs.
779
+ `/af-audit` exposes their sanitized chronological `executionTrace` projection.
780
+ Schema v2 writes one row per finished span (start, end and outcome together);
781
+ turn and child spans also journal their start so an interrupted session still shows
782
+ what was in flight, and other unfinished spans appear in the live audit only. Older
783
+ v1 journals with separate start and end rows remain readable.
784
+
785
+ Root Pi hooks record input, turns, model rounds and tool requests/results. Existing
786
+ native callbacks link children to their dispatch and report child tool activity.
787
+ The shared Pi event bus connects process/baseline/semantic guard decisions and
788
+ runtime/model questions across isolated extension loaders. Native semantic-broker
789
+ requests join a tool only for one exact input fingerprint, owner and time range;
790
+ ambiguous requests stay visibly unlinked. Remote peers without these callbacks do
791
+ not acquire complete telemetry automatically.
792
+
793
+ Pi emits tool start before permission hooks. A denied request therefore has tool
794
+ activity but no fabricated execution duration. Actual execution duration comes
795
+ from the SDK; human waits and queue waits are separate observations. Overlapping
796
+ intervals count once. Model-round timing includes preparation and is not provider
797
+ latency alone. All aggregates cover only the retained 5,000-row trace window;
798
+ dropped, open, interrupted, invalid and unlinked records remain explicit. Old
799
+ journals without trace return `not_recorded` and unknown timing. Persistence
800
+ failure cannot block work: the live audit uses available memory and reports
801
+ `live_degraded`. Session shutdown releases the bus listener and fences late
802
+ completions; a proposed switch that is subsequently cancelled keeps its spans.
803
+
804
+ Only allowlisted metadata and hashed task/input/call/rule identities are stored
805
+ in the new trace. Commands, paths, user prose, answers, results and credentials
806
+ are excluded. Other existing Pi/session/coms logs retain their own payload rules.
807
+ Trace never grants permission, proves progress or accepts a task.
808
+
809
+ Baseline Bash policy now distinguishes supported static operands from literal
810
+ data. This fixes repository-relative `/bin/` collisions, read-only inspection of
811
+ `dist/` or lockfiles and quoted cat/tee heredoc fixtures containing protected-path
812
+ or deletion examples. Real redirects, writes, deletion and compound effects stay
813
+ guarded. Expanding shell syntax, interpreters, `sed`, `file` and ambiguous attached
814
+ short options retain conservative text checks; the trace labels which analysis was
815
+ used. This is a narrow classifier, not a shell sandbox or a guarantee against all
816
+ future false positives. Reload/restart the harness to activate updated sources;
817
+ separate copied installations still need their normal workspace update.
818
+
717
819
  ## Repository module map
718
820
 
719
821
  ### Agent Hub composition
@@ -734,6 +836,7 @@ agent-hub/
734
836
  ├── runtime-test-check.ts # code-owned native bash observer for trusted runtime checks
735
837
  ├── tool-protocol.ts # T3 event/readback correlation and shared diagnostic schema
736
838
  ├── recovery-contract.ts # shared typed failure/recovery policy
839
+ ├── damage-guard-*.ts # D6 parent state, approval, ownership and broker (acceptance open)
737
840
  ├── policy/ # model, roster, capability, and work-mode decisions
738
841
  ├── research/ # helper runtime, spawn transitions, and controls
739
842
  ├── ui/ # grid, dashboard, detail, context, pool, zoom, and history
@@ -107,10 +107,12 @@ that the deprecated grammar will remain indefinitely.
107
107
 
108
108
  The Hub distinguishes the **pre-turn surface** (stable replacement prompt, volatile state capsule,
109
109
  and active tool schemas) from **intra-turn pressure** (conversation and tool results accumulated in
110
- the live model window). `/af-context` shows both. At 80% live usage the Hub warns and transiently makes
111
- compaction support available; at 90% it blocks the next provider continuation and requests a
110
+ the live model window). `/af-context` shows both. At 60% live usage the Hub warns and transiently makes
111
+ compaction support available; at 70% it blocks the next provider continuation and requests a
112
112
  single automatic compaction after the current result is persisted. A prompt submitted during
113
- startup/recovery is retained in memory and replayed once after success.
113
+ startup/recovery is retained in memory and replayed once after success. At the 80% ceiling, work stops
114
+ only after a failed recovery or when even the compacted baseline is at or above 80%; see
115
+ [context continuity](system1-context-continuity.md#automatic-compaction-monitoring).
114
116
 
115
117
  If automatic recovery fails, the prompt remains retained. Pi's built-in command is the bare-runtime
116
118
  fallback:
@@ -328,8 +330,8 @@ consumers from making requests. Restart Hub to adopt configuration changes.
328
330
  - For a missing plan producer, ask the human to use `/af-agents-add planner` or
329
331
  `/af-agents-team`. For review, use `/af-agents-add code-reviewer` (or the
330
332
  permitted plan-reviewer/security-auditor) or select a suitable roster. There is
331
- no automatic roster change. Exhausted dispatch/review caps need existing
332
- explicit budget continuation; refusal leaves requirements open.
333
+ no automatic roster change. Dispatch and review counts are usage, not caps;
334
+ an unfinished requirement stays open until its evidence exists.
333
335
  - `/af-task-triage-waive <addition-id> <reason>` asks for a correlated human
334
336
  decision over one bound addition. It stays **waived**, never satisfied, and
335
337
  cannot remove baseline or other-source requirements. Stale, denied, forged or
@@ -712,9 +714,9 @@ targets an end-of-session compound pass writes lessons to.
712
714
  | `research-keep` | — | **Removed.** Ignored with a session-start warning; live research helpers disappear from the Fleet Dashboard (`Alt+A`) on every terminal outcome. Session, transcript, and findings files plus `/af-agents-history` records remain. Delete the key. |
713
715
  | `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
714
716
  | `mode` | — | **Removed.** Ignored with a warning; budgets follow task tier. Delete the key. |
715
- | `max-dispatches-per-turn` | tier default (1/2/8/12) | Ceiling on `dispatch_agent` calls per user turn (`min` with the task-tier envelope). Positive integer or `off` (stays at the tier). |
716
- | `max-research-per-turn` | tier default (1/2/4/6) | Ceiling on dispatcher-initiated `spawn_research` calls per user turn. The automatic `NEEDS_RESEARCH:` pipe is exempt from the turn budget but still counts against the task research envelope. Positive integer or `off` (stays at the tier). |
717
- | `turn-wall-time-s` | tier default (900/900/3600/5400) | Active-time ceiling, in seconds, per user turn; time blocked in `ask_user` is excluded. Once exceeded, further dispatch/research calls refuse until the one-click continuation is accepted or a new user turn begins. Positive integer or `off` (stays at the tier). |
717
+ | `max-dispatches-per-turn` | — | **Removed.** Ignored with a warning: continuation quotas were removed, dispatch counts stay visible and the watchdog supervises progress. Delete the key. |
718
+ | `max-research-per-turn` | — | **Removed.** Ignored with a warning, like `max-dispatches-per-turn`. Delete the key. |
719
+ | `turn-wall-time-s` | — | **Removed.** Ignored with a warning; active time stays visible, and `agent-turn-timeout-s` still bounds each child run. Delete the key. |
718
720
  | `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
719
721
  | `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
722
  | `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. |
@@ -1,6 +1,6 @@
1
1
  # External project AI content
2
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.
3
+ Fleet lifecycle state stays in the workspace's real `.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
4
 
5
5
  ## Read grants
6
6
 
@@ -23,7 +23,7 @@ Existing `.ai/rules/...` bindings resolve through configured rules roots without
23
23
 
24
24
  ### Non-Git parent workspaces
25
25
 
26
- A workspace may contain independent application and docs repositories, for example `ringithub/` and `rin-docs/`. Keep the existing runtime installation; configure paths relative to the parent:
26
+ A workspace may contain independent application and docs repositories, for example `ringithub/` and `rin-docs/`. Install Fleet directly at the parent and configure paths relative to it:
27
27
 
28
28
  ```markdown
29
29
  ## agent-hub
@@ -39,6 +39,21 @@ The parent must own real `.ai/system1.json` and `.ai/agent-fleet.json` files. Sy
39
39
 
40
40
  File-discovery has narrower workspace-only export/include permissions. External policy read grants do not enable remote file-discovery ranking.
41
41
 
42
+ The parent owns its runtime and local `.ai/agent-fleet-state.json` installation
43
+ ledger. Run setup, upgrades, doctor and recovery at that parent; Git operations
44
+ still target the individual child repositories. Parent installation requires no
45
+ shared-owner field, linked runtime or duplicated child ledger.
46
+
47
+ The former `installationOwner` mode is no longer supported. Old configurations
48
+ are rejected, not silently treated as local or redirected to a child. Moving an
49
+ old shared installation to a standalone parent requires separately reviewed
50
+ setup and persistence choices; no runtime, ledger or configuration is migrated,
51
+ adopted or deleted automatically. Merely removing the field is not a migration.
52
+ Bounded local ledger reads still reject symlinked/nonregular paths, malformed or
53
+ unsupported state and replacement during reads. Missing local state continues
54
+ to support manual consumer configuration; it does not authorize installation
55
+ ownership or remote capture.
56
+
42
57
  ## Native commands and skills
43
58
 
44
59
  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.
@@ -178,7 +178,7 @@ harnesses:
178
178
  - **Two live Work Modes** — bare `just fleet` starts as an operator with direct coding tools and an
179
179
  empty native roster; `/af-work-mode operator|orchestrator` switches prompt and tool surface without
180
180
  restarting or losing session state, while `/af-work-mode` without an argument and **Alt+M** open
181
- the picker. Orchestrator removes `bash`/`edit`/`write`, keeps read-only `filesystem` inspection, refuses self-read above 64 KiB per file or per turn, and raises a trivial/small turn to at least 3 dispatches unless a lower ceiling is configured. A pending task transition lets `set_task_tier` and `ask_user` through; the second other tool call stops the turn, including a parallel batch, and the fence survives resume. Research, nested delegation, and the task envelope follow task tier. All Hub slash commands remain registered in both work modes; capability-off actions
181
+ the picker. Orchestrator removes `bash`/`edit`/`write`, keeps read-only `filesystem` inspection, refuses self-read above 64 KiB per file or per turn. Dispatch and research counts are usage, never a per-turn allowance. A pending task transition lets `set_task_tier` and `ask_user` through; the second other tool call stops the turn, including a parallel batch, and the fence survives resume. Research, nested delegation, and the task envelope follow task tier. All Hub slash commands remain registered in both work modes; capability-off actions
182
182
  refuse actionably.
183
183
  - **Fleet widget** — **`Alt+I`**, registered through Pi's shortcut API, expands or collapses the
184
184
  bounded below-editor fleet view when its focus, empty-editor, autocomplete/modal, row, and height
@@ -208,9 +208,9 @@ harnesses:
208
208
  assertions — see the [`orchestration-verification`](../skills/orchestration-verification/SKILL.md)
209
209
  skill, which the `orchestrator` persona drives. Advisory in this phase (surfaced, not a hard
210
210
  dispatch refusal).
211
- - **Operator controls** — `/af-zoom` timeline inspection plus child-agent kill/restart controls. `/af-context` is a separate read-only full-screen context-budget view: provider totals/cache fields are authoritative, component estimates are labelled heuristic or provider-scaled, stable prompt and volatile-state cost are separated, loaded-but-excluded and inactive packs visibly cost zero, and fleet members use separate model-window denominators. It also shows live pressure phase, measured usage, the 80%/90% thresholds, episode, and last recovery outcome. It never reveals or persists raw prompts, schemas, conversation content, error bodies, or compaction summaries.
211
+ - **Operator controls** — `/af-zoom` timeline inspection plus child-agent kill/restart controls. `/af-context` is a separate read-only full-screen context-budget view: provider totals/cache fields are authoritative, component estimates are labelled heuristic or provider-scaled, stable prompt and volatile-state cost are separated, loaded-but-excluded and inactive packs visibly cost zero, and fleet members use separate model-window denominators. It also shows live pressure phase, measured usage, the 60%/70% thresholds and 80% ceiling, episode, and last recovery outcome. It never reveals or persists raw prompts, schemas, conversation content, error bodies, or compaction summaries.
212
212
  - **Automatic capability packs** — no activation command is needed. Intent, work mode, tier, pending work, and runtime state resolve the model-visible tools before the turn; readiness alone does not make coms/Herdr visible. Ambiguous fleet, peer, or workspace use asks once before its first side effect. The compact pack is transient when explicitly requested or pressure is imminent; ordinary task packs persist until `set_task_tier(new_task: true)`. Managed children receive selected replacement prompts/manifests (`--no-skills` and `--no-context-files` where applicable), not inherited global context.
213
- - **One-click budget continuation** — turn and task refusals ask one localized Yes/No `ask_user` question. Yes renews the budget in the same tool loop, without a typed `continue` or slash command. Task continuation opens an audited tranche while preserving task tier, assertions, capability packs, blockers, label, and progress; genuinely different work uses `set_task_tier(new_task: true)`. Turn and task active-time clocks both exclude human wait time.
213
+ - **Usage without continuation quotas** — dispatch, research and review counts and active time stay visible per turn and task, but authorized work never stops for a budget renewal. The watchdog supervises repeated work; genuinely different work uses `set_task_tier(new_task: true)`. Active-time clocks exclude human wait time.
214
214
  - **Damage-control + ask_user by default** — `just fleet` and `just fleet --no-coms` load the
215
215
  `damage-control-continue` safety harness and `ask-user-remote` before `agent-hub`, so the
216
216
  dispatcher's tool calls are checked against the rules file and the `askUserAvailable` probe sees
@@ -238,9 +238,10 @@ harnesses:
238
238
  #### Context and roster recovery troubleshooting
239
239
 
240
240
  A green standing-prompt budget does not guarantee that a long tool loop fits: messages and tool
241
- results continue accumulating inside the current model window. Agent Hub warns at **80%** live
242
- usage. At **90%** it aborts the next same-turn provider request, waits for persistence/settlement,
243
- and starts one automatic Pi compaction. Startup or newly submitted input is retained in memory and
241
+ results continue accumulating inside the current model window. Agent Hub warns at **60%** live
242
+ usage. At **70%** it aborts the next same-turn provider request, waits for persistence/settlement,
243
+ and starts one automatic Pi compaction. The **80%** ceiling stops work only after a failed recovery
244
+ or when even the compacted baseline is at or above it. Startup or newly submitted input is retained in memory and
244
245
  replayed exactly once after recovery. Use `/af-context` to distinguish `warning`, `compacting`,
245
246
  `recovered`, and `failed` pressure from stable prompt/schema cost.
246
247
 
@@ -32,13 +32,13 @@ This is an opt-in example, **not** an installed default. The provider credential
32
32
  |---|---|
33
33
  | `off` (or absent section) | No capture or evaluation; tool unavailable. Installed default. |
34
34
  | `advisory` | Available when approved; the Hub chooses when an optional consultation helps. |
35
- | `recommended` | Available when approved; the Hub is instructed to call first for suitable bounded semantic judgments. |
35
+ | `recommended` | Available when approved; the Hub is reminded to use it when a concrete unresolved question benefits from bounded semantic assistance. |
36
36
 
37
37
  `recommended` actively favors `ask_system1` for classification, selected-file relevance/scope, risk and assumptions, request clarity and failure interpretation. These are examples, not an exhaustive allowlist. It applies to **all task tiers, including trivial/small**, in both work modes, without waiting for the user to request a call. The model selects permitted paths/ranges directly when that avoids reading whole files into its own context just to make the same judgment.
38
38
 
39
- For matching judgments it is the exclusive first route before extended independent reasoning or research for the same question. Exact lookup/search/calculation, gathering missing facts, required reading before editing, tests, independent review and user decisions still use their appropriate tools. Dedicated task/dispatch triage and review workflows remain separate obligations; `ask_system1` cannot satisfy their gates.
39
+ No preliminary helper call is required before independent reasoning, search or bounded reads. Exact lookup/search/calculation, gathering missing facts, required reading before editing, tests, independent review and user decisions use their appropriate tools. Dedicated task/dispatch triage and review workflows remain separate; advice cannot satisfy their gates.
40
40
 
41
- The routing policy treats useful calls as **free and fast**: no financial rationing and no invented “one or two calls per task” quota. Batch related independent questions, reuse current answers, and avoid repeat calls to obtain agreement. This is an operator preference, not a measured price/latency claim; diagnostics still report actual usage or unknown. The technical session cap, timeouts and input bounds below remain in force.
41
+ Choose among configured helper profiles using measured task accuracy, latency and tool reliability. Provider names, parameter counts and unmeasured claims of speed or price are not evidence. If measurements are unavailable, keep configuration unchanged and suitability unknown. Batch related questions and reuse current answers. Technical session caps, timeouts and input bounds remain in force.
42
42
 
43
43
  Refusal, unavailable service, missing evidence, stale/inconclusive advice or an exhausted budget falls back to ordinary reading, research or independent reasoning without automatic retries. Modes do not expand consent, file scope, output capture or process authority. Results in both enabled modes retain `advisory: true`.
44
44
 
@@ -103,7 +103,7 @@ Files must pass the **current local damage-control policy**, including `zeroAcce
103
103
 
104
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.
105
105
 
106
- File summaries use their repo-relative path for normal local readback: use `filesystem` stat, then excerpt within the existing self-read budget. Output summaries expose `readbackHandle`: use `filesystem` readback with that deterministic handle. Readback is still subject to current artifact/source-path policy, task/session binding and content hash. Known source paths are checked; arbitrary shell output cannot be claimed to reveal all source paths. Output handles are private, bounded, evicted oldest-first and removed on disposal. Replaced/evicted/cross-session refs are not recovered by scanning historical logs. Use `spawn_research`/dispatch when local readback exceeds the existing self-read limit.
106
+ File summaries use their repo-relative path for normal local readback: use `filesystem` stat, then excerpt within the existing self-read budget. Output summaries expose `readbackHandle`: use `filesystem` readback with that deterministic handle. Readback is still subject to current artifact/source-path policy, task/session binding and content hash. Known source paths are checked; arbitrary shell output cannot be claimed to reveal all source paths. Output handles are private, bounded, evicted oldest-first and removed on disposal. Replaced/evicted/cross-session refs are not recovered by scanning historical logs. Use a smaller bounded page, continue next turn, or choose a helper when that adds value.
107
107
 
108
108
  Refusals include `consumer_off`, `not_approved`, `invalid_input`, `source_denied`, `source_changed`, `evidence_incomplete`, `evidence_unavailable`, `state_too_large`, `budget_exhausted`, and fail-closed counter/persistence errors. Provider `skipped`, `unavailable`, `unsupported`, and `cancelled` remain distinct. Cancellation discards late success; source/task changes make otherwise successful advice `stale`.
109
109