@chankov/agent-fleet 2.0.23 → 2.1.1

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 (1504) hide show
  1. package/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  2. package/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  3. package/.pi/agent-fleet/scripts/fleet.ts +3 -0
  4. package/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +106 -0
  5. package/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  6. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +367 -0
  7. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  8. package/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  9. package/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  10. package/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  11. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  12. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +116 -0
  13. package/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  14. package/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  15. package/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  16. package/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +406 -0
  17. package/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  18. package/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  19. package/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  20. package/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  21. package/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  22. package/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  23. package/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  24. package/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  25. package/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  26. package/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  27. package/.pi/agent-fleet/scripts/lib/fleet-command.ts +2 -0
  28. package/.pi/agent-fleet/scripts/package-lock.json +22 -0
  29. package/.pi/agent-fleet/scripts/package.json +1 -0
  30. package/.pi/agents/voices.yaml +1 -1
  31. package/.pi/harnesses/agent-hub/README.md +61 -4
  32. package/.pi/harnesses/agent-hub/acceptance.ts +8 -4
  33. package/.pi/harnesses/agent-hub/access-approval.ts +146 -21
  34. package/.pi/harnesses/agent-hub/assertion-ledger.js +1 -0
  35. package/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  36. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  37. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +2 -2
  38. package/.pi/harnesses/agent-hub/damage-guard-approval.ts +41 -17
  39. package/.pi/harnesses/agent-hub/damage-guard-hub.ts +16 -9
  40. package/.pi/harnesses/agent-hub/damage-guard-state.ts +2 -2
  41. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +4 -1
  42. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +7 -1
  43. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +8 -1
  44. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +1 -1
  45. package/.pi/harnesses/agent-hub/index.ts +102 -14
  46. package/.pi/harnesses/agent-hub/input/shortcuts.ts +3 -0
  47. package/.pi/harnesses/agent-hub/no-progress.ts +4 -4
  48. package/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  49. package/.pi/harnesses/agent-hub/orchestration-activation.ts +1 -1
  50. package/.pi/harnesses/agent-hub/package.json +1 -1
  51. package/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  52. package/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  53. package/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  54. package/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  55. package/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  56. package/.pi/harnesses/agent-hub/process-obligations.ts +26 -8
  57. package/.pi/harnesses/agent-hub/prompts/fragments.ts +1 -1
  58. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  59. package/.pi/harnesses/agent-hub/return-contract.js +24 -2
  60. package/.pi/harnesses/agent-hub/review-reuse.ts +3 -3
  61. package/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  62. package/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  63. package/.pi/harnesses/agent-hub/runtime-test-check.ts +19 -2
  64. package/.pi/harnesses/agent-hub/spawn.ts +50 -13
  65. package/.pi/harnesses/agent-hub/specialist-result.ts +15 -6
  66. package/.pi/harnesses/agent-hub/system1-communication-store.ts +8 -0
  67. package/.pi/harnesses/agent-hub/task-resume-contract.ts +10 -0
  68. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +36 -17
  69. package/.pi/harnesses/agent-hub/tools/action-executors.ts +4 -2
  70. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +4 -4
  71. package/.pi/harnesses/agent-hub/tools/context.ts +4 -1
  72. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +15 -11
  73. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +180 -44
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +1 -0
  75. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +11 -3
  76. package/.pi/harnesses/agent-hub/work-mode.ts +3 -1
  77. package/.pi/harnesses/ask-user-remote/README.md +2 -2
  78. package/.pi/harnesses/ask-user-remote/questions.ts +49 -2
  79. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +13 -6
  80. package/.pi/harnesses/coms/README.md +5 -0
  81. package/.pi/harnesses/coms/index.ts +25 -2
  82. package/.pi/harnesses/coms/package.json +1 -1
  83. package/.pi/harnesses/damage-control-continue/index.ts +69 -31
  84. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  85. package/.pi/harnesses/lib/bash-policy-analysis.ts +1 -1
  86. package/.pi/harnesses/lib/coms-core-io.ts +8 -1
  87. package/.pi/harnesses/lib/coms-core.ts +42 -8
  88. package/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  89. package/.pi/harnesses/lib/coms-observation.ts +74 -0
  90. package/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  91. package/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  92. package/.pi/harnesses/lib/damage-control-shared.ts +46 -15
  93. package/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  94. package/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  95. package/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  96. package/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  97. package/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  98. package/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  99. package/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  100. package/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  101. package/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  102. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  103. package/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  104. package/.pi/harnesses/lib/fleet-notification-validation.ts +66 -0
  105. package/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  106. package/.pi/harnesses/lib/update-check.ts +5 -0
  107. package/.versions/2.1.0/.pi/agent-fleet/hermes/README.md +347 -0
  108. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  109. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  110. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  111. package/.versions/2.1.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  112. package/.versions/2.1.0/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  113. package/.versions/2.1.0/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  114. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  115. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  116. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  117. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  118. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  119. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  120. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  121. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  122. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  123. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  124. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  125. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  126. package/.versions/2.1.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  127. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  128. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  129. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  130. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  131. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  132. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  133. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  134. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  135. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  136. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  137. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  138. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  139. package/.versions/2.1.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  140. package/.versions/2.1.0/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  141. package/.versions/2.1.0/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  142. package/.versions/2.1.0/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  143. package/.versions/2.1.0/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  144. package/.versions/2.1.0/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  145. package/.versions/2.1.0/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  146. package/.versions/2.1.0/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  147. package/.versions/2.1.0/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  148. package/.versions/2.1.0/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  149. package/.versions/2.1.0/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  150. package/.versions/2.1.0/.pi/agent-fleet/scripts/fleet.ts +248 -0
  151. package/.versions/2.1.0/.pi/agent-fleet/scripts/flow.ts +166 -0
  152. package/.versions/2.1.0/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  153. package/.versions/2.1.0/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  154. package/.versions/2.1.0/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  155. package/.versions/2.1.0/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  156. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  157. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +122 -0
  158. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  159. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  160. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  161. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +349 -0
  162. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  163. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +72 -0
  164. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  165. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +53 -0
  166. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +111 -0
  167. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  168. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  169. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  170. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +384 -0
  171. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  172. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  173. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  174. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  175. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  176. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  177. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +81 -0
  178. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  179. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  180. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  181. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/fleet-command.ts +268 -0
  182. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  183. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +238 -0
  184. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  185. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  186. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  187. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  188. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  189. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  190. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  191. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  192. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  193. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  194. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  195. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  196. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  197. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  198. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  199. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  200. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  201. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  202. package/.versions/2.1.0/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  203. package/.versions/2.1.0/.pi/agent-fleet/scripts/package-lock.json +57 -0
  204. package/.versions/2.1.0/.pi/agent-fleet/scripts/package.json +10 -0
  205. package/.versions/2.1.0/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  206. package/.versions/2.1.0/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  207. package/.versions/2.1.0/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  208. package/.versions/2.1.0/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  209. package/.versions/2.1.0/.pi/agent-fleet/scripts/team-up.ts +385 -0
  210. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  211. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  212. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  213. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  214. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  215. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  216. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/git.ts +99 -0
  217. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  218. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  219. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  220. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  221. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  222. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  223. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  224. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  225. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/quality.ts +65 -0
  226. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  227. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  228. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  229. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  230. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  231. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  232. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  233. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  234. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  235. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  236. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  237. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  238. package/.versions/2.1.0/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  239. package/.versions/2.1.0/.pi/agents/dispatch-policy.yaml +32 -0
  240. package/.versions/2.1.0/.pi/agents/model-profiles.yaml +134 -0
  241. package/.versions/2.1.0/.pi/agents/peers.yaml +147 -0
  242. package/.versions/2.1.0/.pi/agents/teams.yaml +41 -0
  243. package/.versions/2.1.0/.pi/agents/voices.yaml +13 -0
  244. package/.versions/2.1.0/.pi/damage-control-rules.yaml +297 -0
  245. package/.versions/2.1.0/.pi/extensions/btw/README.md +120 -0
  246. package/.versions/2.1.0/.pi/extensions/btw/index.ts +916 -0
  247. package/.versions/2.1.0/.pi/extensions/btw/package.json +6 -0
  248. package/.versions/2.1.0/.pi/extensions/btw/state.js +179 -0
  249. package/.versions/2.1.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  250. package/.versions/2.1.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  251. package/.versions/2.1.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  252. package/.versions/2.1.0/.pi/extensions/compact-and-continue/README.md +42 -0
  253. package/.versions/2.1.0/.pi/extensions/compact-and-continue/index.ts +136 -0
  254. package/.versions/2.1.0/.pi/extensions/compact-and-continue/package.json +6 -0
  255. package/.versions/2.1.0/.pi/extensions/mcp-bridge/README.md +46 -0
  256. package/.versions/2.1.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  257. package/.versions/2.1.0/.pi/extensions/mcp-bridge/package.json +6 -0
  258. package/.versions/2.1.0/.pi/extensions/package-lock.json +1175 -0
  259. package/.versions/2.1.0/.pi/extensions/package.json +9 -0
  260. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/README.md +224 -0
  261. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/config.ts +199 -0
  262. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  263. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  264. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  265. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  266. package/.versions/2.1.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  267. package/.versions/2.1.0/.pi/harnesses/agent-hub/README.md +1584 -0
  268. package/.versions/2.1.0/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  269. package/.versions/2.1.0/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  270. package/.versions/2.1.0/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  271. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  272. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  273. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  274. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  275. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  276. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  277. package/.versions/2.1.0/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  278. package/.versions/2.1.0/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  279. package/.versions/2.1.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  280. package/.versions/2.1.0/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  281. package/.versions/2.1.0/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  282. package/.versions/2.1.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  283. package/.versions/2.1.0/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  284. package/.versions/2.1.0/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  285. package/.versions/2.1.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  286. package/.versions/2.1.0/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  287. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  288. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  289. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  290. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  291. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  292. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  293. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  294. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  295. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  296. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  297. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  298. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  299. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  300. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  301. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  302. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  303. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  304. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  305. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  306. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  307. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  308. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  309. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  310. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  311. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  312. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  313. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  314. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  315. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  316. package/.versions/2.1.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  317. package/.versions/2.1.0/.pi/harnesses/agent-hub/config/agents.ts +181 -0
  318. package/.versions/2.1.0/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  319. package/.versions/2.1.0/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  320. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  321. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  322. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  323. package/.versions/2.1.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  324. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  325. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  326. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  327. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  328. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  329. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  330. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  331. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  332. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  333. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  334. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  335. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  336. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  337. package/.versions/2.1.0/.pi/harnesses/agent-hub/context-window.js +108 -0
  338. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  339. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  340. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  341. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  342. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  343. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  344. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  345. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  346. package/.versions/2.1.0/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  347. package/.versions/2.1.0/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  348. package/.versions/2.1.0/.pi/harnesses/agent-hub/delegate.ts +478 -0
  349. package/.versions/2.1.0/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  350. package/.versions/2.1.0/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  351. package/.versions/2.1.0/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  352. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  353. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  354. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  355. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +298 -0
  356. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +260 -0
  357. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  358. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  359. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  360. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  361. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  362. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  363. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  364. package/.versions/2.1.0/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  365. package/.versions/2.1.0/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  366. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  367. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  368. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  369. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  370. package/.versions/2.1.0/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  371. package/.versions/2.1.0/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  372. package/.versions/2.1.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  373. package/.versions/2.1.0/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  374. package/.versions/2.1.0/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  375. package/.versions/2.1.0/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  376. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  377. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  378. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  379. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  380. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  381. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  382. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  383. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  384. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  385. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  386. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  387. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  388. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  389. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  390. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  391. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  392. package/.versions/2.1.0/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  393. package/.versions/2.1.0/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  394. package/.versions/2.1.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  395. package/.versions/2.1.0/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  396. package/.versions/2.1.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  397. package/.versions/2.1.0/.pi/harnesses/agent-hub/helpers.ts +270 -0
  398. package/.versions/2.1.0/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  399. package/.versions/2.1.0/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  400. package/.versions/2.1.0/.pi/harnesses/agent-hub/index.ts +2682 -0
  401. package/.versions/2.1.0/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  402. package/.versions/2.1.0/.pi/harnesses/agent-hub/input/shortcuts.ts +23 -0
  403. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  404. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  405. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +145 -0
  406. package/.versions/2.1.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  407. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  408. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  409. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  410. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  411. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  412. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  413. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  414. package/.versions/2.1.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  415. package/.versions/2.1.0/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  416. package/.versions/2.1.0/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  417. package/.versions/2.1.0/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  418. package/.versions/2.1.0/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  419. package/.versions/2.1.0/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  420. package/.versions/2.1.0/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  421. package/.versions/2.1.0/.pi/harnesses/agent-hub/package.json +7 -0
  422. package/.versions/2.1.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  423. package/.versions/2.1.0/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  424. package/.versions/2.1.0/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  425. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  426. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  427. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  428. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  429. package/.versions/2.1.0/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  430. package/.versions/2.1.0/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  431. package/.versions/2.1.0/.pi/harnesses/agent-hub/presentation.ts +54 -0
  432. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  433. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  434. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  435. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  436. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  437. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  438. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  439. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  440. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  441. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  442. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  443. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  444. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-snapshot.ts +279 -0
  445. package/.versions/2.1.0/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  446. package/.versions/2.1.0/.pi/harnesses/agent-hub/process-obligations.ts +164 -0
  447. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  448. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  449. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  450. package/.versions/2.1.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  451. package/.versions/2.1.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  452. package/.versions/2.1.0/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  453. package/.versions/2.1.0/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  454. package/.versions/2.1.0/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  455. package/.versions/2.1.0/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  456. package/.versions/2.1.0/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  457. package/.versions/2.1.0/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  458. package/.versions/2.1.0/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  459. package/.versions/2.1.0/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  460. package/.versions/2.1.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  461. package/.versions/2.1.0/.pi/harnesses/agent-hub/return-contract.js +371 -0
  462. package/.versions/2.1.0/.pi/harnesses/agent-hub/return-extract.js +77 -0
  463. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  464. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  465. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-findings.js +96 -0
  466. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  467. package/.versions/2.1.0/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  468. package/.versions/2.1.0/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  469. package/.versions/2.1.0/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  470. package/.versions/2.1.0/.pi/harnesses/agent-hub/run-budget.js +342 -0
  471. package/.versions/2.1.0/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  472. package/.versions/2.1.0/.pi/harnesses/agent-hub/runtime-receipts.ts +60 -0
  473. package/.versions/2.1.0/.pi/harnesses/agent-hub/runtime-test-check.ts +79 -0
  474. package/.versions/2.1.0/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  475. package/.versions/2.1.0/.pi/harnesses/agent-hub/scope-gate.js +233 -0
  476. package/.versions/2.1.0/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  477. package/.versions/2.1.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  478. package/.versions/2.1.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  479. package/.versions/2.1.0/.pi/harnesses/agent-hub/spawn.ts +702 -0
  480. package/.versions/2.1.0/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  481. package/.versions/2.1.0/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  482. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  483. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  484. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  485. package/.versions/2.1.0/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  486. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  487. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-resume-contract.ts +75 -0
  488. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  489. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  490. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  491. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  492. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  493. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  494. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  495. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  496. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  497. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  498. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  499. package/.versions/2.1.0/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  500. package/.versions/2.1.0/.pi/harnesses/agent-hub/timeline.ts +72 -0
  501. package/.versions/2.1.0/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  502. package/.versions/2.1.0/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  503. package/.versions/2.1.0/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  504. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  505. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  506. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  507. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  508. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/context.ts +145 -0
  509. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +90 -0
  510. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +734 -0
  511. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  512. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  513. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  514. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  515. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/run-flow.ts +146 -0
  516. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  517. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  518. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  519. package/.versions/2.1.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  520. package/.versions/2.1.0/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  521. package/.versions/2.1.0/.pi/harnesses/agent-hub/types.ts +66 -0
  522. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  523. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  524. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  525. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  526. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +157 -0
  527. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  528. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  529. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  530. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  531. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  532. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  533. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  534. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  535. package/.versions/2.1.0/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  536. package/.versions/2.1.0/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  537. package/.versions/2.1.0/.pi/harnesses/agent-hub/version.ts +42 -0
  538. package/.versions/2.1.0/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  539. package/.versions/2.1.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  540. package/.versions/2.1.0/.pi/harnesses/agent-hub/work-mode.ts +188 -0
  541. package/.versions/2.1.0/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  542. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/README.md +59 -0
  543. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/index.ts +571 -0
  544. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  545. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  546. package/.versions/2.1.0/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  547. package/.versions/2.1.0/.pi/harnesses/coms/README.md +105 -0
  548. package/.versions/2.1.0/.pi/harnesses/coms/index.ts +308 -0
  549. package/.versions/2.1.0/.pi/harnesses/coms/package.json +7 -0
  550. package/.versions/2.1.0/.pi/harnesses/coms/version.ts +42 -0
  551. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/README.md +161 -0
  552. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/index.ts +659 -0
  553. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  554. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  555. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  556. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  557. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  558. package/.versions/2.1.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  559. package/.versions/2.1.0/.pi/harnesses/lib/approval-wait.ts +17 -0
  560. package/.versions/2.1.0/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  561. package/.versions/2.1.0/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  562. package/.versions/2.1.0/.pi/harnesses/lib/clarification-policy.ts +9 -0
  563. package/.versions/2.1.0/.pi/harnesses/lib/coms-core-io.ts +422 -0
  564. package/.versions/2.1.0/.pi/harnesses/lib/coms-core.ts +720 -0
  565. package/.versions/2.1.0/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  566. package/.versions/2.1.0/.pi/harnesses/lib/coms-observation.ts +74 -0
  567. package/.versions/2.1.0/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  568. package/.versions/2.1.0/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  569. package/.versions/2.1.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  570. package/.versions/2.1.0/.pi/harnesses/lib/context-budget-view.ts +112 -0
  571. package/.versions/2.1.0/.pi/harnesses/lib/context-budget.ts +114 -0
  572. package/.versions/2.1.0/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  573. package/.versions/2.1.0/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  574. package/.versions/2.1.0/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  575. package/.versions/2.1.0/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  576. package/.versions/2.1.0/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  577. package/.versions/2.1.0/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  578. package/.versions/2.1.0/.pi/harnesses/lib/damage-policy.ts +35 -0
  579. package/.versions/2.1.0/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  580. package/.versions/2.1.0/.pi/harnesses/lib/damage-result-view.ts +16 -0
  581. package/.versions/2.1.0/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  582. package/.versions/2.1.0/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  583. package/.versions/2.1.0/.pi/harnesses/lib/execution-trace.ts +45 -0
  584. package/.versions/2.1.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  585. package/.versions/2.1.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  586. package/.versions/2.1.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  587. package/.versions/2.1.0/.pi/harnesses/lib/fleet-codex-event-bridge.ts +81 -0
  588. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  589. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  590. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  591. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  592. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  593. package/.versions/2.1.0/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  594. package/.versions/2.1.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  595. package/.versions/2.1.0/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  596. package/.versions/2.1.0/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  597. package/.versions/2.1.0/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  598. package/.versions/2.1.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  599. package/.versions/2.1.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  600. package/.versions/2.1.0/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  601. package/.versions/2.1.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  602. package/.versions/2.1.0/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  603. package/.versions/2.1.0/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  604. package/.versions/2.1.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  605. package/.versions/2.1.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  606. package/.versions/2.1.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  607. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  608. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  609. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  610. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  611. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  612. package/.versions/2.1.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  613. package/.versions/2.1.0/.pi/harnesses/lib/identical-dialog.ts +27 -0
  614. package/.versions/2.1.0/.pi/harnesses/lib/installation-state.js +62 -0
  615. package/.versions/2.1.0/.pi/harnesses/lib/peer-target.ts +24 -0
  616. package/.versions/2.1.0/.pi/harnesses/lib/policy-roots.js +117 -0
  617. package/.versions/2.1.0/.pi/harnesses/lib/policy-roots.ts +32 -0
  618. package/.versions/2.1.0/.pi/harnesses/lib/process-shared.ts +9 -0
  619. package/.versions/2.1.0/.pi/harnesses/lib/resource-closure.js +26 -0
  620. package/.versions/2.1.0/.pi/harnesses/lib/safe-source-read.js +29 -0
  621. package/.versions/2.1.0/.pi/harnesses/lib/semantic-approval.ts +80 -0
  622. package/.versions/2.1.0/.pi/harnesses/lib/session-target.ts +62 -0
  623. package/.versions/2.1.0/.pi/harnesses/lib/spawned-peers.js +191 -0
  624. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  625. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  626. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  627. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  628. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-json.js +37 -0
  629. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-loader.js +53 -0
  630. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  631. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-triage.js +42 -0
  632. package/.versions/2.1.0/.pi/harnesses/lib/system1/config-v2.js +112 -0
  633. package/.versions/2.1.0/.pi/harnesses/lib/system1/config.js +50 -0
  634. package/.versions/2.1.0/.pi/harnesses/lib/system1/contracts.ts +154 -0
  635. package/.versions/2.1.0/.pi/harnesses/lib/system1/demo.ts +95 -0
  636. package/.versions/2.1.0/.pi/harnesses/lib/system1/jev.ts +503 -0
  637. package/.versions/2.1.0/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  638. package/.versions/2.1.0/.pi/harnesses/lib/system1/selection.js +11 -0
  639. package/.versions/2.1.0/.pi/harnesses/lib/system1/service.ts +245 -0
  640. package/.versions/2.1.0/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  641. package/.versions/2.1.0/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  642. package/.versions/2.1.0/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  643. package/.versions/2.1.0/.pi/harnesses/lib/target-capabilities.js +7 -0
  644. package/.versions/2.1.0/.pi/harnesses/lib/update-check.ts +227 -0
  645. package/.versions/2.1.0/.pi/harnesses/lib/workspace-context.js +115 -0
  646. package/.versions/2.1.0/.pi/harnesses/lib/workspace-context.ts +22 -0
  647. package/.versions/2.1.0/.pi/harnesses/package-lock.json +2121 -0
  648. package/.versions/2.1.0/.pi/harnesses/package.json +13 -0
  649. package/.versions/2.1.0/.pi/prompts/af-build.md +27 -0
  650. package/.versions/2.1.0/.pi/prompts/af-code-simplify.md +22 -0
  651. package/.versions/2.1.0/.pi/prompts/af-constraints.md +31 -0
  652. package/.versions/2.1.0/.pi/prompts/af-plan.md +17 -0
  653. package/.versions/2.1.0/.pi/prompts/af-review.md +16 -0
  654. package/.versions/2.1.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  655. package/.versions/2.1.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  656. package/.versions/2.1.0/.pi/prompts/af-setup-rules.md +20 -0
  657. package/.versions/2.1.0/.pi/prompts/af-ship.md +17 -0
  658. package/.versions/2.1.0/.pi/prompts/af-spec.md +15 -0
  659. package/.versions/2.1.0/.pi/prompts/af-test.md +19 -0
  660. package/.versions/2.1.0/.pi/skills/bowser/SKILL.md +145 -0
  661. package/.versions/2.1.0/.version +1 -0
  662. package/.versions/2.1.0/agents/architect.md +24 -0
  663. package/.versions/2.1.0/agents/bowser.md +28 -0
  664. package/.versions/2.1.0/agents/builder.md +55 -0
  665. package/.versions/2.1.0/agents/code-reviewer.md +209 -0
  666. package/.versions/2.1.0/agents/deep-researcher.md +32 -0
  667. package/.versions/2.1.0/agents/documenter.md +22 -0
  668. package/.versions/2.1.0/agents/orchestrator.md +22 -0
  669. package/.versions/2.1.0/agents/plan-reviewer.md +83 -0
  670. package/.versions/2.1.0/agents/planner.md +107 -0
  671. package/.versions/2.1.0/agents/releaser.md +24 -0
  672. package/.versions/2.1.0/agents/researcher.md +30 -0
  673. package/.versions/2.1.0/agents/security-auditor.md +167 -0
  674. package/.versions/2.1.0/agents/test-engineer.md +153 -0
  675. package/.versions/2.1.0/agents/web-debugger.md +44 -0
  676. package/.versions/2.1.0/agents/web-performance-auditor.md +194 -0
  677. package/.versions/2.1.0/bin/catalog/harness-runtime-closure.json +85 -0
  678. package/.versions/2.1.0/docs/ARCHITECTURE.md +1158 -0
  679. package/.versions/2.1.0/docs/agent-fleet-setup.md +1143 -0
  680. package/.versions/2.1.0/docs/claude-code-coms-bridge.md +147 -0
  681. package/.versions/2.1.0/docs/codex-local-mcp.md +434 -0
  682. package/.versions/2.1.0/docs/codex-session-bridge.md +44 -0
  683. package/.versions/2.1.0/docs/codex-setup.md +183 -0
  684. package/.versions/2.1.0/docs/coms-hermes-bridge.md +188 -0
  685. package/.versions/2.1.0/docs/fleet-native-voice.md +135 -0
  686. package/.versions/2.1.0/docs/getting-started.md +126 -0
  687. package/.versions/2.1.0/docs/npm-install.md +535 -0
  688. package/.versions/2.1.0/docs/pi-extensions.md +455 -0
  689. package/.versions/2.1.0/docs/pi-setup.md +92 -0
  690. package/.versions/2.1.0/docs/skill-anatomy.md +150 -0
  691. package/.versions/2.1.0/install-manifest.json +3216 -0
  692. package/.versions/2.1.0/justfile +247 -0
  693. package/.versions/2.1.0/manifest-meta.json +1086 -0
  694. package/.versions/2.1.0/references/accessibility-checklist.md +160 -0
  695. package/.versions/2.1.0/references/communication-contract.md +26 -0
  696. package/.versions/2.1.0/references/definition-of-done.md +67 -0
  697. package/.versions/2.1.0/references/fleet-coordination-patterns.md +171 -0
  698. package/.versions/2.1.0/references/observability-checklist.md +92 -0
  699. package/.versions/2.1.0/references/orchestration-patterns.md +370 -0
  700. package/.versions/2.1.0/references/performance-checklist.md +236 -0
  701. package/.versions/2.1.0/references/prompting-patterns.md +380 -0
  702. package/.versions/2.1.0/references/security-checklist.md +245 -0
  703. package/.versions/2.1.0/references/testing-patterns.md +235 -0
  704. package/.versions/2.1.0/references/workflow-authoring.md +304 -0
  705. package/.versions/2.1.0/skills/_internal/grilling.md +59 -0
  706. package/.versions/2.1.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  707. package/.versions/2.1.0/skills/code-review-and-quality/SKILL.md +396 -0
  708. package/.versions/2.1.0/skills/compound-learning/SKILL.md +137 -0
  709. package/.versions/2.1.0/skills/constraint-driven-development/SKILL.md +338 -0
  710. package/.versions/2.1.0/skills/constraint-driven-development/references/floor-guard.md +99 -0
  711. package/.versions/2.1.0/skills/context-engineering/SKILL.md +341 -0
  712. package/.versions/2.1.0/skills/deprecation-and-migration/SKILL.md +247 -0
  713. package/.versions/2.1.0/skills/designing-agents/SKILL.md +394 -0
  714. package/.versions/2.1.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  715. package/.versions/2.1.0/skills/drafting-workflows/SKILL.md +143 -0
  716. package/.versions/2.1.0/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  717. package/.versions/2.1.0/skills/fleet-native-voice/SKILL.md +73 -0
  718. package/.versions/2.1.0/skills/fleet-native-voice/agents/openai.yaml +4 -0
  719. package/.versions/2.1.0/skills/fleet-native-voice.zip +0 -0
  720. package/.versions/2.1.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  721. package/.versions/2.1.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  722. package/.versions/2.1.0/skills/idea-refine/SKILL.md +182 -0
  723. package/.versions/2.1.0/skills/idea-refine/examples.md +238 -0
  724. package/.versions/2.1.0/skills/idea-refine/frameworks.md +99 -0
  725. package/.versions/2.1.0/skills/idea-refine/refinement-criteria.md +113 -0
  726. package/.versions/2.1.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  727. package/.versions/2.1.0/skills/incremental-implementation/SKILL.md +353 -0
  728. package/.versions/2.1.0/skills/incremental-implementation.zip +0 -0
  729. package/.versions/2.1.0/skills/interview-me/SKILL.md +226 -0
  730. package/.versions/2.1.0/skills/orchestration-verification/SKILL.md +182 -0
  731. package/.versions/2.1.0/skills/peer-coms/SKILL.md +90 -0
  732. package/.versions/2.1.0/skills/performance-optimization/SKILL.md +496 -0
  733. package/.versions/2.1.0/skills/planning-and-task-breakdown/SKILL.md +318 -0
  734. package/.versions/2.1.0/skills/planning-and-task-breakdown.zip +0 -0
  735. package/.versions/2.1.0/skills/repository-ai-setup/SKILL.md +135 -0
  736. package/.versions/2.1.0/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  737. package/.versions/2.1.0/skills/repository-ai-setup/references/apply-contract.md +74 -0
  738. package/.versions/2.1.0/skills/repository-ai-setup/references/provenance-template.md +16 -0
  739. package/.versions/2.1.0/skills/repository-ai-setup/references/setup-flow.md +108 -0
  740. package/.versions/2.1.0/skills/repository-ai-setup/references/verify-setup.md +20 -0
  741. package/.versions/2.1.0/skills/repository-ai-setup.zip +0 -0
  742. package/.versions/2.1.0/skills/security-and-hardening/SKILL.md +524 -0
  743. package/.versions/2.1.0/skills/spec-driven-development/SKILL.md +295 -0
  744. package/.versions/2.1.0/skills/spec-driven-development.zip +0 -0
  745. package/.versions/2.1.0/skills/using-agent-skills/SKILL.md +198 -0
  746. package/.versions/2.1.0/vendor/agent-skills-upstream/LICENSE +21 -0
  747. package/.versions/2.1.0/vendor/agent-skills-upstream/README.md +430 -0
  748. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  749. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  750. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  751. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  752. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  753. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  754. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  755. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  756. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  757. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  758. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  759. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  760. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  761. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  762. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  763. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  764. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  765. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  766. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  767. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  768. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  769. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  770. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  771. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  772. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  773. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  774. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  775. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  776. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  777. package/.versions/2.1.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  778. package/.versions/2.1.1/.pi/agent-fleet/hermes/README.md +347 -0
  779. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  780. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  781. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  782. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  783. package/.versions/2.1.1/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  784. package/.versions/2.1.1/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  785. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  786. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  787. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  788. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  789. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  790. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  791. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  792. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  793. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  794. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  795. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  796. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  797. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  798. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  799. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  800. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  801. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  802. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  803. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  804. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  805. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  806. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  807. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  808. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  809. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  810. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  811. package/.versions/2.1.1/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  812. package/.versions/2.1.1/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  813. package/.versions/2.1.1/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  814. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  815. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  816. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  817. package/.versions/2.1.1/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  818. package/.versions/2.1.1/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  819. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  820. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  821. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet.ts +248 -0
  822. package/.versions/2.1.1/.pi/agent-fleet/scripts/flow.ts +166 -0
  823. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  824. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  825. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  826. package/.versions/2.1.1/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  827. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  828. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +106 -0
  829. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  830. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  831. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  832. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +367 -0
  833. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  834. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  835. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  836. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  837. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  838. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +116 -0
  839. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  840. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  841. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  842. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +406 -0
  843. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  844. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  845. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  846. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  847. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  848. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  849. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  850. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  851. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  852. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  853. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-command.ts +268 -0
  854. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  855. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +238 -0
  856. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  857. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  858. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  859. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  860. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  861. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  862. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  863. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  864. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  865. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  866. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  867. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  868. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  869. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  870. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  871. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  872. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  873. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  874. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  875. package/.versions/2.1.1/.pi/agent-fleet/scripts/package-lock.json +57 -0
  876. package/.versions/2.1.1/.pi/agent-fleet/scripts/package.json +10 -0
  877. package/.versions/2.1.1/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  878. package/.versions/2.1.1/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  879. package/.versions/2.1.1/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  880. package/.versions/2.1.1/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  881. package/.versions/2.1.1/.pi/agent-fleet/scripts/team-up.ts +385 -0
  882. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  883. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  884. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  885. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  886. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  887. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  888. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/git.ts +99 -0
  889. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  890. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  891. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  892. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  893. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  894. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  895. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  896. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  897. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/quality.ts +65 -0
  898. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  899. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  900. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  901. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  902. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  903. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  904. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  905. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  906. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  907. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  908. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  909. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  910. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  911. package/.versions/2.1.1/.pi/agents/dispatch-policy.yaml +32 -0
  912. package/.versions/2.1.1/.pi/agents/model-profiles.yaml +134 -0
  913. package/.versions/2.1.1/.pi/agents/peers.yaml +147 -0
  914. package/.versions/2.1.1/.pi/agents/teams.yaml +41 -0
  915. package/.versions/2.1.1/.pi/agents/voices.yaml +13 -0
  916. package/.versions/2.1.1/.pi/damage-control-rules.yaml +297 -0
  917. package/.versions/2.1.1/.pi/extensions/btw/README.md +120 -0
  918. package/.versions/2.1.1/.pi/extensions/btw/index.ts +916 -0
  919. package/.versions/2.1.1/.pi/extensions/btw/package.json +6 -0
  920. package/.versions/2.1.1/.pi/extensions/btw/state.js +179 -0
  921. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  922. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  923. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  924. package/.versions/2.1.1/.pi/extensions/compact-and-continue/README.md +42 -0
  925. package/.versions/2.1.1/.pi/extensions/compact-and-continue/index.ts +136 -0
  926. package/.versions/2.1.1/.pi/extensions/compact-and-continue/package.json +6 -0
  927. package/.versions/2.1.1/.pi/extensions/mcp-bridge/README.md +46 -0
  928. package/.versions/2.1.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  929. package/.versions/2.1.1/.pi/extensions/mcp-bridge/package.json +6 -0
  930. package/.versions/2.1.1/.pi/extensions/package-lock.json +1175 -0
  931. package/.versions/2.1.1/.pi/extensions/package.json +9 -0
  932. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/README.md +224 -0
  933. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/config.ts +199 -0
  934. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  935. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  936. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  937. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  938. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  939. package/.versions/2.1.1/.pi/harnesses/agent-hub/README.md +1584 -0
  940. package/.versions/2.1.1/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  941. package/.versions/2.1.1/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  942. package/.versions/2.1.1/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  943. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  944. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  945. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  946. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  947. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  948. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  949. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  950. package/.versions/2.1.1/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  951. package/.versions/2.1.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  952. package/.versions/2.1.1/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  953. package/.versions/2.1.1/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  954. package/.versions/2.1.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  955. package/.versions/2.1.1/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  956. package/.versions/2.1.1/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  957. package/.versions/2.1.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  958. package/.versions/2.1.1/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  959. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  960. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  961. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  962. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  963. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  964. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  965. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  966. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  967. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  968. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  969. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  970. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  971. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  972. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  973. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  974. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  975. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  976. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  977. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  978. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  979. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  980. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  981. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  982. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  983. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  984. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  985. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  986. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  987. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  988. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  989. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/agents.ts +181 -0
  990. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  991. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  992. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  993. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  994. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  995. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  996. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  997. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  998. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  999. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  1000. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  1001. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  1002. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  1003. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  1004. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  1005. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  1006. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  1007. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  1008. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  1009. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-window.js +108 -0
  1010. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  1011. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  1012. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  1013. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  1014. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  1015. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  1016. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  1017. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  1018. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  1019. package/.versions/2.1.1/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  1020. package/.versions/2.1.1/.pi/harnesses/agent-hub/delegate.ts +478 -0
  1021. package/.versions/2.1.1/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  1022. package/.versions/2.1.1/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  1023. package/.versions/2.1.1/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  1024. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  1025. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  1026. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  1027. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +301 -0
  1028. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +262 -0
  1029. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  1030. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  1031. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  1032. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  1033. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  1034. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  1035. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  1036. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  1037. package/.versions/2.1.1/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  1038. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  1039. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  1040. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  1041. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  1042. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  1043. package/.versions/2.1.1/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  1044. package/.versions/2.1.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  1045. package/.versions/2.1.1/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  1046. package/.versions/2.1.1/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  1047. package/.versions/2.1.1/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  1048. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  1049. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  1050. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  1051. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  1052. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  1053. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  1054. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  1055. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  1056. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  1057. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  1058. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  1059. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  1060. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  1061. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  1062. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  1063. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  1064. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  1065. package/.versions/2.1.1/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  1066. package/.versions/2.1.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  1067. package/.versions/2.1.1/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  1068. package/.versions/2.1.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  1069. package/.versions/2.1.1/.pi/harnesses/agent-hub/helpers.ts +270 -0
  1070. package/.versions/2.1.1/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  1071. package/.versions/2.1.1/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  1072. package/.versions/2.1.1/.pi/harnesses/agent-hub/index.ts +2705 -0
  1073. package/.versions/2.1.1/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  1074. package/.versions/2.1.1/.pi/harnesses/agent-hub/input/shortcuts.ts +23 -0
  1075. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  1076. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  1077. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +145 -0
  1078. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  1079. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  1080. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  1081. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  1082. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  1083. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  1084. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  1085. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  1086. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  1087. package/.versions/2.1.1/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  1088. package/.versions/2.1.1/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  1089. package/.versions/2.1.1/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  1090. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  1091. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  1092. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  1093. package/.versions/2.1.1/.pi/harnesses/agent-hub/package.json +7 -0
  1094. package/.versions/2.1.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  1095. package/.versions/2.1.1/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  1096. package/.versions/2.1.1/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  1097. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  1098. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  1099. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  1100. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  1101. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  1102. package/.versions/2.1.1/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  1103. package/.versions/2.1.1/.pi/harnesses/agent-hub/presentation.ts +54 -0
  1104. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  1105. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  1106. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  1107. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  1108. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  1109. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  1110. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  1111. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  1112. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  1113. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  1114. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  1115. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  1116. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  1117. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  1118. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  1119. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-snapshot.ts +279 -0
  1120. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  1121. package/.versions/2.1.1/.pi/harnesses/agent-hub/process-obligations.ts +177 -0
  1122. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  1123. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  1124. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  1125. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  1126. package/.versions/2.1.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  1127. package/.versions/2.1.1/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  1128. package/.versions/2.1.1/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  1129. package/.versions/2.1.1/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  1130. package/.versions/2.1.1/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  1131. package/.versions/2.1.1/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  1132. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  1133. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  1134. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  1135. package/.versions/2.1.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  1136. package/.versions/2.1.1/.pi/harnesses/agent-hub/return-contract.js +371 -0
  1137. package/.versions/2.1.1/.pi/harnesses/agent-hub/return-extract.js +77 -0
  1138. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  1139. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  1140. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-findings.js +96 -0
  1141. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  1142. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  1143. package/.versions/2.1.1/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  1144. package/.versions/2.1.1/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  1145. package/.versions/2.1.1/.pi/harnesses/agent-hub/run-budget.js +342 -0
  1146. package/.versions/2.1.1/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  1147. package/.versions/2.1.1/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  1148. package/.versions/2.1.1/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  1149. package/.versions/2.1.1/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  1150. package/.versions/2.1.1/.pi/harnesses/agent-hub/scope-gate.js +233 -0
  1151. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  1152. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  1153. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  1154. package/.versions/2.1.1/.pi/harnesses/agent-hub/spawn.ts +702 -0
  1155. package/.versions/2.1.1/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  1156. package/.versions/2.1.1/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  1157. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  1158. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  1159. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  1160. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  1161. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  1162. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  1163. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  1164. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  1165. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  1166. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  1167. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  1168. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  1169. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  1170. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  1171. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  1172. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  1173. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  1174. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  1175. package/.versions/2.1.1/.pi/harnesses/agent-hub/timeline.ts +72 -0
  1176. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  1177. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  1178. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  1179. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/action-executors.ts +216 -0
  1180. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  1181. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  1182. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  1183. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/context.ts +147 -0
  1184. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +92 -0
  1185. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +777 -0
  1186. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  1187. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  1188. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  1189. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  1190. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/run-flow.ts +146 -0
  1191. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  1192. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  1193. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  1194. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  1195. package/.versions/2.1.1/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  1196. package/.versions/2.1.1/.pi/harnesses/agent-hub/types.ts +66 -0
  1197. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  1198. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  1199. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  1200. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  1201. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +163 -0
  1202. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  1203. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  1204. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  1205. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  1206. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  1207. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  1208. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  1209. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  1210. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  1211. package/.versions/2.1.1/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  1212. package/.versions/2.1.1/.pi/harnesses/agent-hub/version.ts +42 -0
  1213. package/.versions/2.1.1/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  1214. package/.versions/2.1.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  1215. package/.versions/2.1.1/.pi/harnesses/agent-hub/work-mode.ts +188 -0
  1216. package/.versions/2.1.1/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  1217. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/README.md +59 -0
  1218. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/index.ts +571 -0
  1219. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  1220. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  1221. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  1222. package/.versions/2.1.1/.pi/harnesses/coms/README.md +105 -0
  1223. package/.versions/2.1.1/.pi/harnesses/coms/index.ts +308 -0
  1224. package/.versions/2.1.1/.pi/harnesses/coms/package.json +7 -0
  1225. package/.versions/2.1.1/.pi/harnesses/coms/version.ts +42 -0
  1226. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/README.md +161 -0
  1227. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/index.ts +659 -0
  1228. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  1229. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  1230. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  1231. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  1232. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  1233. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  1234. package/.versions/2.1.1/.pi/harnesses/lib/approval-wait.ts +17 -0
  1235. package/.versions/2.1.1/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  1236. package/.versions/2.1.1/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  1237. package/.versions/2.1.1/.pi/harnesses/lib/clarification-policy.ts +9 -0
  1238. package/.versions/2.1.1/.pi/harnesses/lib/coms-core-io.ts +422 -0
  1239. package/.versions/2.1.1/.pi/harnesses/lib/coms-core.ts +720 -0
  1240. package/.versions/2.1.1/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  1241. package/.versions/2.1.1/.pi/harnesses/lib/coms-observation.ts +74 -0
  1242. package/.versions/2.1.1/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  1243. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  1244. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  1245. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-view.ts +112 -0
  1246. package/.versions/2.1.1/.pi/harnesses/lib/context-budget.ts +114 -0
  1247. package/.versions/2.1.1/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  1248. package/.versions/2.1.1/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  1249. package/.versions/2.1.1/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  1250. package/.versions/2.1.1/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  1251. package/.versions/2.1.1/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  1252. package/.versions/2.1.1/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  1253. package/.versions/2.1.1/.pi/harnesses/lib/damage-policy.ts +35 -0
  1254. package/.versions/2.1.1/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  1255. package/.versions/2.1.1/.pi/harnesses/lib/damage-result-view.ts +16 -0
  1256. package/.versions/2.1.1/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  1257. package/.versions/2.1.1/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  1258. package/.versions/2.1.1/.pi/harnesses/lib/execution-trace.ts +45 -0
  1259. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  1260. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  1261. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  1262. package/.versions/2.1.1/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  1263. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  1264. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  1265. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  1266. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  1267. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  1268. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  1269. package/.versions/2.1.1/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  1270. package/.versions/2.1.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  1271. package/.versions/2.1.1/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  1272. package/.versions/2.1.1/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  1273. package/.versions/2.1.1/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  1274. package/.versions/2.1.1/.pi/harnesses/lib/fleet-notification-validation.ts +66 -0
  1275. package/.versions/2.1.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  1276. package/.versions/2.1.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  1277. package/.versions/2.1.1/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  1278. package/.versions/2.1.1/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  1279. package/.versions/2.1.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  1280. package/.versions/2.1.1/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  1281. package/.versions/2.1.1/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  1282. package/.versions/2.1.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  1283. package/.versions/2.1.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  1284. package/.versions/2.1.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  1285. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  1286. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  1287. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  1288. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  1289. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  1290. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  1291. package/.versions/2.1.1/.pi/harnesses/lib/identical-dialog.ts +27 -0
  1292. package/.versions/2.1.1/.pi/harnesses/lib/installation-state.js +62 -0
  1293. package/.versions/2.1.1/.pi/harnesses/lib/peer-target.ts +24 -0
  1294. package/.versions/2.1.1/.pi/harnesses/lib/policy-roots.js +117 -0
  1295. package/.versions/2.1.1/.pi/harnesses/lib/policy-roots.ts +32 -0
  1296. package/.versions/2.1.1/.pi/harnesses/lib/process-shared.ts +9 -0
  1297. package/.versions/2.1.1/.pi/harnesses/lib/resource-closure.js +26 -0
  1298. package/.versions/2.1.1/.pi/harnesses/lib/safe-source-read.js +29 -0
  1299. package/.versions/2.1.1/.pi/harnesses/lib/semantic-approval.ts +80 -0
  1300. package/.versions/2.1.1/.pi/harnesses/lib/session-target.ts +62 -0
  1301. package/.versions/2.1.1/.pi/harnesses/lib/spawned-peers.js +191 -0
  1302. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  1303. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  1304. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  1305. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  1306. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-json.js +37 -0
  1307. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-loader.js +53 -0
  1308. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  1309. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-triage.js +42 -0
  1310. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-v2.js +112 -0
  1311. package/.versions/2.1.1/.pi/harnesses/lib/system1/config.js +50 -0
  1312. package/.versions/2.1.1/.pi/harnesses/lib/system1/contracts.ts +154 -0
  1313. package/.versions/2.1.1/.pi/harnesses/lib/system1/demo.ts +95 -0
  1314. package/.versions/2.1.1/.pi/harnesses/lib/system1/jev.ts +503 -0
  1315. package/.versions/2.1.1/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  1316. package/.versions/2.1.1/.pi/harnesses/lib/system1/selection.js +11 -0
  1317. package/.versions/2.1.1/.pi/harnesses/lib/system1/service.ts +245 -0
  1318. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  1319. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  1320. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  1321. package/.versions/2.1.1/.pi/harnesses/lib/target-capabilities.js +7 -0
  1322. package/.versions/2.1.1/.pi/harnesses/lib/update-check.ts +227 -0
  1323. package/.versions/2.1.1/.pi/harnesses/lib/workspace-context.js +115 -0
  1324. package/.versions/2.1.1/.pi/harnesses/lib/workspace-context.ts +22 -0
  1325. package/.versions/2.1.1/.pi/harnesses/package-lock.json +2121 -0
  1326. package/.versions/2.1.1/.pi/harnesses/package.json +13 -0
  1327. package/.versions/2.1.1/.pi/prompts/af-build.md +27 -0
  1328. package/.versions/2.1.1/.pi/prompts/af-code-simplify.md +22 -0
  1329. package/.versions/2.1.1/.pi/prompts/af-constraints.md +31 -0
  1330. package/.versions/2.1.1/.pi/prompts/af-plan.md +17 -0
  1331. package/.versions/2.1.1/.pi/prompts/af-review.md +16 -0
  1332. package/.versions/2.1.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  1333. package/.versions/2.1.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  1334. package/.versions/2.1.1/.pi/prompts/af-setup-rules.md +20 -0
  1335. package/.versions/2.1.1/.pi/prompts/af-ship.md +17 -0
  1336. package/.versions/2.1.1/.pi/prompts/af-spec.md +15 -0
  1337. package/.versions/2.1.1/.pi/prompts/af-test.md +19 -0
  1338. package/.versions/2.1.1/.pi/skills/bowser/SKILL.md +145 -0
  1339. package/.versions/2.1.1/.version +1 -0
  1340. package/.versions/2.1.1/agents/architect.md +24 -0
  1341. package/.versions/2.1.1/agents/bowser.md +28 -0
  1342. package/.versions/2.1.1/agents/builder.md +55 -0
  1343. package/.versions/2.1.1/agents/code-reviewer.md +209 -0
  1344. package/.versions/2.1.1/agents/deep-researcher.md +32 -0
  1345. package/.versions/2.1.1/agents/documenter.md +22 -0
  1346. package/.versions/2.1.1/agents/orchestrator.md +22 -0
  1347. package/.versions/2.1.1/agents/plan-reviewer.md +83 -0
  1348. package/.versions/2.1.1/agents/planner.md +107 -0
  1349. package/.versions/2.1.1/agents/releaser.md +24 -0
  1350. package/.versions/2.1.1/agents/researcher.md +30 -0
  1351. package/.versions/2.1.1/agents/security-auditor.md +167 -0
  1352. package/.versions/2.1.1/agents/test-engineer.md +153 -0
  1353. package/.versions/2.1.1/agents/web-debugger.md +44 -0
  1354. package/.versions/2.1.1/agents/web-performance-auditor.md +194 -0
  1355. package/.versions/2.1.1/bin/catalog/harness-runtime-closure.json +85 -0
  1356. package/.versions/2.1.1/docs/ARCHITECTURE.md +1187 -0
  1357. package/.versions/2.1.1/docs/agent-fleet-setup.md +1143 -0
  1358. package/.versions/2.1.1/docs/claude-code-coms-bridge.md +147 -0
  1359. package/.versions/2.1.1/docs/codex-local-mcp.md +487 -0
  1360. package/.versions/2.1.1/docs/codex-session-bridge.md +44 -0
  1361. package/.versions/2.1.1/docs/codex-setup.md +183 -0
  1362. package/.versions/2.1.1/docs/coms-hermes-bridge.md +188 -0
  1363. package/.versions/2.1.1/docs/fleet-native-voice.md +137 -0
  1364. package/.versions/2.1.1/docs/getting-started.md +126 -0
  1365. package/.versions/2.1.1/docs/npm-install.md +535 -0
  1366. package/.versions/2.1.1/docs/pi-extensions.md +455 -0
  1367. package/.versions/2.1.1/docs/pi-setup.md +92 -0
  1368. package/.versions/2.1.1/docs/skill-anatomy.md +150 -0
  1369. package/.versions/2.1.1/install-manifest.json +3239 -0
  1370. package/.versions/2.1.1/justfile +247 -0
  1371. package/.versions/2.1.1/manifest-meta.json +1087 -0
  1372. package/.versions/2.1.1/references/accessibility-checklist.md +160 -0
  1373. package/.versions/2.1.1/references/communication-contract.md +26 -0
  1374. package/.versions/2.1.1/references/definition-of-done.md +67 -0
  1375. package/.versions/2.1.1/references/fleet-coordination-patterns.md +171 -0
  1376. package/.versions/2.1.1/references/observability-checklist.md +92 -0
  1377. package/.versions/2.1.1/references/orchestration-patterns.md +370 -0
  1378. package/.versions/2.1.1/references/performance-checklist.md +236 -0
  1379. package/.versions/2.1.1/references/prompting-patterns.md +380 -0
  1380. package/.versions/2.1.1/references/security-checklist.md +245 -0
  1381. package/.versions/2.1.1/references/testing-patterns.md +235 -0
  1382. package/.versions/2.1.1/references/workflow-authoring.md +304 -0
  1383. package/.versions/2.1.1/skills/_internal/grilling.md +59 -0
  1384. package/.versions/2.1.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  1385. package/.versions/2.1.1/skills/code-review-and-quality/SKILL.md +396 -0
  1386. package/.versions/2.1.1/skills/compound-learning/SKILL.md +137 -0
  1387. package/.versions/2.1.1/skills/constraint-driven-development/SKILL.md +338 -0
  1388. package/.versions/2.1.1/skills/constraint-driven-development/references/floor-guard.md +99 -0
  1389. package/.versions/2.1.1/skills/context-engineering/SKILL.md +341 -0
  1390. package/.versions/2.1.1/skills/deprecation-and-migration/SKILL.md +247 -0
  1391. package/.versions/2.1.1/skills/designing-agents/SKILL.md +394 -0
  1392. package/.versions/2.1.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  1393. package/.versions/2.1.1/skills/drafting-workflows/SKILL.md +143 -0
  1394. package/.versions/2.1.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  1395. package/.versions/2.1.1/skills/fleet-connect/SKILL.md +25 -0
  1396. package/.versions/2.1.1/skills/fleet-native-voice/SKILL.md +79 -0
  1397. package/.versions/2.1.1/skills/fleet-native-voice/agents/openai.yaml +4 -0
  1398. package/.versions/2.1.1/skills/fleet-native-voice.zip +0 -0
  1399. package/.versions/2.1.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  1400. package/.versions/2.1.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  1401. package/.versions/2.1.1/skills/idea-refine/SKILL.md +182 -0
  1402. package/.versions/2.1.1/skills/idea-refine/examples.md +238 -0
  1403. package/.versions/2.1.1/skills/idea-refine/frameworks.md +99 -0
  1404. package/.versions/2.1.1/skills/idea-refine/refinement-criteria.md +113 -0
  1405. package/.versions/2.1.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  1406. package/.versions/2.1.1/skills/incremental-implementation/SKILL.md +353 -0
  1407. package/.versions/2.1.1/skills/incremental-implementation.zip +0 -0
  1408. package/.versions/2.1.1/skills/interview-me/SKILL.md +226 -0
  1409. package/.versions/2.1.1/skills/orchestration-verification/SKILL.md +182 -0
  1410. package/.versions/2.1.1/skills/peer-coms/SKILL.md +90 -0
  1411. package/.versions/2.1.1/skills/performance-optimization/SKILL.md +496 -0
  1412. package/.versions/2.1.1/skills/planning-and-task-breakdown/SKILL.md +318 -0
  1413. package/.versions/2.1.1/skills/planning-and-task-breakdown.zip +0 -0
  1414. package/.versions/2.1.1/skills/repository-ai-setup/SKILL.md +135 -0
  1415. package/.versions/2.1.1/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  1416. package/.versions/2.1.1/skills/repository-ai-setup/references/apply-contract.md +74 -0
  1417. package/.versions/2.1.1/skills/repository-ai-setup/references/provenance-template.md +16 -0
  1418. package/.versions/2.1.1/skills/repository-ai-setup/references/setup-flow.md +108 -0
  1419. package/.versions/2.1.1/skills/repository-ai-setup/references/verify-setup.md +20 -0
  1420. package/.versions/2.1.1/skills/repository-ai-setup.zip +0 -0
  1421. package/.versions/2.1.1/skills/security-and-hardening/SKILL.md +524 -0
  1422. package/.versions/2.1.1/skills/spec-driven-development/SKILL.md +295 -0
  1423. package/.versions/2.1.1/skills/spec-driven-development.zip +0 -0
  1424. package/.versions/2.1.1/skills/using-agent-skills/SKILL.md +198 -0
  1425. package/.versions/2.1.1/vendor/agent-skills-upstream/LICENSE +21 -0
  1426. package/.versions/2.1.1/vendor/agent-skills-upstream/README.md +430 -0
  1427. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  1428. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  1429. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  1430. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  1431. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  1432. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  1433. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  1434. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  1435. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  1436. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  1437. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  1438. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  1439. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  1440. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  1441. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  1442. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  1443. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  1444. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  1445. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  1446. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  1447. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  1448. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  1449. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  1450. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  1451. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  1452. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  1453. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  1454. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  1455. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  1456. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  1457. package/CHANGELOG.md +31 -5
  1458. package/README.md +12 -11
  1459. package/agents/architect.md +1 -1
  1460. package/agents/bowser.md +1 -1
  1461. package/agents/builder.md +1 -1
  1462. package/agents/code-reviewer.md +1 -1
  1463. package/agents/plan-reviewer.md +1 -1
  1464. package/agents/planner.md +1 -1
  1465. package/agents/test-engineer.md +1 -1
  1466. package/agents/web-debugger.md +1 -1
  1467. package/agents/web-performance-auditor.md +1 -1
  1468. package/bin/cli.js +115 -1
  1469. package/bin/lib/apply.js +8 -1
  1470. package/bin/lib/features.js +4 -1
  1471. package/bin/lib/hermes-profile-artifact.js +21 -10
  1472. package/bin/lib/inspect.js +103 -0
  1473. package/bin/lib/mcp-probe.js +104 -0
  1474. package/bin/lib/public-plan.js +2 -0
  1475. package/bin/lib/repair-desired.js +1 -1
  1476. package/bin/lib/set-codex-mcp.js +699 -0
  1477. package/bin/lib/skill-zip.js +222 -0
  1478. package/bin/snapshot-version.js +3 -1
  1479. package/docs/ARCHITECTURE.md +176 -12
  1480. package/docs/MIGRATION-agent-fleet.md +2 -2
  1481. package/docs/agent-fleet-setup.md +39 -2
  1482. package/docs/codex-local-mcp.md +487 -0
  1483. package/docs/codex-session-bridge.md +28 -203
  1484. package/docs/codex-setup.md +183 -0
  1485. package/docs/fleet-native-voice.md +137 -0
  1486. package/docs/npm-install.md +2 -2
  1487. package/docs/session-worktree-targeting.md +79 -79
  1488. package/docs/system1-agentic.md +1 -1
  1489. package/docs/workflows.md +2 -2
  1490. package/install-manifest.json +54 -66
  1491. package/manifest-meta.json +48 -57
  1492. package/package.json +12 -7
  1493. package/skills/fleet-connect/SKILL.md +25 -0
  1494. package/skills/fleet-native-voice.zip +0 -0
  1495. package/skills/incremental-implementation/SKILL.md +1 -1
  1496. package/skills/incremental-implementation.zip +0 -0
  1497. package/.pi/agent-fleet/scripts/fleet-codex-client.ts +0 -69
  1498. package/.pi/agent-fleet/scripts/fleet-codex-read.py +0 -148
  1499. package/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +0 -63
  1500. package/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +0 -190
  1501. package/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +0 -166
  1502. package/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +0 -124
  1503. package/codex/fleet-session-client/SKILL.md +0 -34
  1504. package/codex/fleet-session-client.zip +0 -0
@@ -0,0 +1,1187 @@
1
+ # Agent Fleet Architecture
2
+
3
+ Agent Fleet is a Pi-centered multi-agent orchestration system. This page maps
4
+ the runtime responsibilities and where each module lives in the repository.
5
+
6
+ For the principles governing future plans and design decisions, read the
7
+ [project philosophy](PHILOSOPHY.md). That document states the intended direction;
8
+ this page describes the current architecture.
9
+
10
+ Native chat connection leases, exact-owner receiver control, notification renewal, Fleet View status, and remaining host-bootstrap limits are described in [Codex connections](codex-connections.md). The new workflow does not auto-start delivery or retarget sessions after restart.
11
+
12
+ ## Session worktree root contract
13
+
14
+ The intended external Fleet layout is:
15
+
16
+ ```text
17
+ root/
18
+ ├── af/ # Fleet workspace: justfile, .pi/, .ai/, runtime dependencies
19
+ ├── repo/ # application's main Git checkout; no Fleet installation
20
+ ├── repo.worktree/ # registered linked/detached application checkout
21
+ └── docs/ # separately configured rules/documentation repository
22
+ ```
23
+
24
+ Here `workspaceRoot` / `resourceRoot` / `configBase` are `root/af`,
25
+ `repositoryRoot` is `root/repo`, and `executionRoot` / `worktreeRoot` are
26
+ `root/repo.worktree`. Relative selectors are resolved from `af`, so that checkout
27
+ is `../repo.worktree`, not `./repo.worktree`. External docs/rules paths must be
28
+ explicitly configured relative to `af` (for example `../docs`); neither sibling
29
+ placement nor selecting a checkout grants read, write, or remote-export consent.
30
+ Fleet must not be copied or symlinked into the application's checkouts.
31
+
32
+ `just fleet --worktree <registered-checkout>` binds a session to immutable,
33
+ canonical filesystem/Git registry identities independently of HEAD. Configuration,
34
+ resources and Fleet evidence remain workspace-owned; a managed symlink install
35
+ also pins its separate physical Fleet resource root without moving human config.
36
+ Coding tools, Git, native
37
+ specialists and workflow data use the execution root. Communications, retention
38
+ and resume carry target identity. Serialized transport is revalidated, never a
39
+ permission. Scoped workflows do not mutate a global active checkout.
40
+
41
+ System 1 requires exact, separately approved per-consumer physical-target scopes.
42
+ Off, pending consent, invalid adaptation, unchecked provider health and actual
43
+ consumer results are distinct. A scout clone cannot borrow source-export consent
44
+ from its source checkout. Routing is not OS isolation or external-service
45
+ isolation. Targeted `/btw` and Hermes conductor explicitly refuse unsupported
46
+ combinations. Interactive Pi history retains its global cwd-scoped location;
47
+ Fleet artifacts and native session files remain partitioned in the workspace.
48
+
49
+ See [usage and boundaries](session-worktree-targeting.md) and the
50
+ [implementation/verification plan](plans/2026-0-archive/PLAN-session-worktree-targeting.md).
51
+ No target-local Fleet copy or cwd-only workaround is needed.
52
+
53
+ ## Runtime layers
54
+
55
+ | Layer | Role | Implementation |
56
+ | --- | --- | --- |
57
+ | **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
58
+ | **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
59
+ | **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` | `.pi/agent-fleet/scripts/flow.ts`, `.pi/agent-fleet/scripts/workflows/` — see [workflows.md](workflows.md) |
60
+ | **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `.pi/agent-fleet/scripts/lib/herdr-layout.ts` |
61
+ | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `.pi/agent-fleet/scripts/lib/coms-envelope.ts` and `.pi/agent-fleet/scripts/coms-cli.ts` |
62
+ | **Fleet config screen** | Read-only in-session view of what is configured and active (`/af-config`, Alt+,) in the Hub and every coms peer; file facts and hash checks locally, installer evaluation through the read-only `agent-fleet inspect` verb (`bin/lib/inspect.js`) via a shell-less CLI bridge, and changes only as confirmed `agent-fleet setup`/`configure` runs after a dry-run preview and a matching second dry run | `.pi/harnesses/lib/fleet-config/` (snapshot, view, transition, ui, cli-bridge, mutations); registrations in `.pi/harnesses/agent-hub/commands/config.ts` and `.pi/harnesses/coms/index.ts` — see [setup guide](agent-fleet-setup.md#viewing-configuration-from-a-live-session) |
63
+ | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `.pi/agent-fleet/scripts/coms-claude-bridge.ts`, `.pi/agent-fleet/hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
64
+ | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `.pi/agent-fleet/scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `.pi/agent-fleet/hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
65
+ | **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) |
66
+ | **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) |
67
+ | **Native Codex MCP** | Local exact-context, multi-session observations and human-confirmed actions; no daemon or idle wake | `.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts`; user-level registration and the `fleet-native-voice` skill copy through the explicit `agent-fleet set-codex-mcp` command (`bin/lib/set-codex-mcp.js`) — see [setup guide](codex-setup.md), [native guide](codex-local-mcp.md) and [retired CLI migration](codex-session-bridge.md) |
68
+ | **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` |
69
+ | **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) |
70
+ | **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) |
71
+ | **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) |
72
+ | **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) |
73
+ | **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) |
74
+ | **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
75
+
76
+ ## Private configuration-only verification
77
+
78
+ The Hub's explicit `private-config-current-state` mode uses
79
+ `private-config-current-state.ts` for bounded canonical notification-config/helper
80
+ fingerprints and `private-config-review.ts` for fresh native evidence and
81
+ independent-review validation. Pure shape/preview, exact-owner, loaded-catalog
82
+ and pinned queue-tuple validators live in
83
+ `.pi/harnesses/lib/fleet-notification-validation.ts`; the notification runtime
84
+ retains its original exports via compatibility re-exports. This keeps the Hub's
85
+ packed runtime import closure inside harnesses without importing script-side
86
+ notification activation or persistence code. A catalog parity regression binds
87
+ the pure expected tool names and assessment results to the public MCP catalog.
88
+ The MCP dispatcher retains its original catalog assessment and narrow dependency
89
+ allowlist; no notification runtime dependency is added there. Configuration
90
+ bodies are not model artifacts or proof output. `process-obligations.ts` retains a separate private proof, not Git
91
+ changed-file attribution or ordinary Git review evidence. It closes only a pure
92
+ configuration task's own acceptance/review stages; actual proof/gate use requires
93
+ live task/session/declaration, revision/fingerprint, receipt/evidence and
94
+ concurrency revalidation. Source obligations exclude private closure. The
95
+ composition root supplies live context to assertion proof and process reporting;
96
+ missing context fails closed. Old Git modes retain their contracts.
97
+
98
+ This advances deterministic, evidence-owned completion without a fake Git edit or
99
+ a generic waiver. Fixture support is not loaded-runtime/activation evidence;
100
+ independent whole-feature review and separate human activation remain outside
101
+ this implementation. See [verification contracts and limits](operator-current-state.md#private-configuration-only-current-state-separate-opt-in).
102
+
103
+ ## One Hub runtime, independent axes
104
+
105
+ Every public Pi launch through `just fleet` loads Fleet Core and the `agent-hub`
106
+ harness. Three independent choices shape that runtime:
107
+
108
+ | Axis | Choices | What it controls |
109
+ | --- | --- | --- |
110
+ | **Work Mode** | `operator`, `orchestrator` | Whether the main agent may use direct coding tools. Operator retains the captured `read`/`bash`/`edit`/`write` and approved extension surface; orchestrator removes those coding tools and keeps dispatch, research, assertions, `ask_user`, read-only `filesystem` stat/inventory/excerpt/readback, and available coms/Herdr tools. The orchestrator self-read ceiling is 64 KiB for one file and 64 KiB for the turn. Above that, research or a specialist gets the path, not the body. `dispatch_triage` is listed only when that consumer can evaluate. `/af-work-mode` and **Alt+M** switch this axis. |
111
+ | **Native roster** | empty or one entry from `.pi/agents/teams.yaml` | Which in-process Pi specialist personas `dispatch_agent` may start. Roster changes do not change work mode in a live session. |
112
+ | **Peer topology** | current terminal, Hub-only Herdr workspace, or Hub plus a `.pi/agents/peers.yaml` preset | Which separate, addressable Pi/Claude processes occupy sibling panes. Starting or spawning peers does not change work mode or the native roster. |
113
+
114
+ Bare `just fleet` therefore means operator work mode, an empty native roster, and
115
+ the current terminal. At startup an explicit `--work-mode` wins; otherwise
116
+ `--agents <roster>` implies orchestrator; otherwise operator is used. An
117
+ orchestrator startup requires a roster. `/af-work-mode` and **Alt+M** switch
118
+ only work mode in the live session, and `/af-agents-*` changes
119
+ only the native roster. Dispatch, research, nested delegation, and Verification
120
+ Contract rigor follow the **task tier** (`trivial`/`small`/`feature`/`project`),
121
+ not a session execution mode. Dispatch/research counts and active duration are
122
+ accounting metrics without turn or task continuation quotas. Planner and plan
123
+ review are optional; wide/high-risk work retains independent review and applicable
124
+ exact-action authorization without a pre-effect planning gate.
125
+
126
+ Approval memory is shared across Pi's isolated extension loaders within the
127
+ runtime. Semantic decisions remain bound to the accepted task/input revision and
128
+ exact path; task/session changes fence late answers. Only an exact-action dialog
129
+ that showed the human the command records a delete decision; free-form `ask_user`
130
+ answers are never recorded and never answered automatically, because prose cannot
131
+ prove which path or polarity the human chose. Remembered confirmation is
132
+ not a reusable effect grant: actual irreversible effects still consume their
133
+ runtime authorization. Identical concurrent dialogs coalesce, and cancellation
134
+ does not become consent.
135
+
136
+ Successful independent reviews retain role-specific evidence, reviewed file
137
+ revision, coverage, requirement declarations and input-artifact hashes in the
138
+ process journal. An identical covered review returns the retained evidence without
139
+ starting another child. Changed accepted input, source, requirements, task, scope, evidence,
140
+ concurrent writes or an explicit `review_reason` require a fresh review; unresolved
141
+ questions, blocking findings and rejected reviews cannot supply reusable approval.
142
+
143
+ The model's context hook projects older successful coordination/inspection bodies
144
+ to short references backed by exact local originals. It leaves the session journal,
145
+ user/assistant messages, questions, failures, images and latest tool batch intact,
146
+ and retains a recent inspection working set. The prompt capsule carries current
147
+ sourced requirements and critical conditions without treating recorded status as
148
+ fresh proof. Plain continue/resume inputs retain the accepted task; identical
149
+ classification declarations avoid new triage, revision hashing and journal writes.
150
+ Changed intent still uses the existing task-transition fence.
151
+
152
+ 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. The verification pack also exposes `set_task_tier` so direct operators can declare explicit risk/scope through the trusted producer without activating fleet dispatch. This does not clear any obligation or change work mode, roster, permissions, or the setter's existing transition/confirmation gates.
153
+
154
+ `/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. `/af-audit` is a separate read-only session audit over existing runtime-owned records: it reports allowlisted T1 recovery categories, T2 result states, T3 protocol failures, and T8 permission correlations while keeping root, child, compaction snapshot, and repeated-record identities distinct. It never copies prompts, model text, tool payloads, environment values, or transcript content, and unavailable evidence stays explicit rather than becoming a zero count. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Configured project rule and documentation pointers are rendered into the Hub prompt in both work modes and into native specialist, nested delegate, research, and coms handoffs. Files are read directly; folders are resolved index-first, with recursive rule discovery only when no index exists. The prompt carries pointers and selection instructions rather than bulk-injecting rule bodies, and the Hub ledger attributes that text as `hub/policy/project`. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
155
+
156
+ T12 diagnostics have been withdrawn by user decision; there is no command, runner, or replacement entry point. Historical results and accounting remain unchanged. `diagnostic-series-budget.ts` retains the shared v2 ledger, stage/per-unit ceilings, conservative input preflight, migration refusal for ambiguous history, ownership locks, and cancellation fences used by benchmark consumers. `diagnostic-probe-extension.ts` is now a side-effect-free compatibility library exposing only provider/API output-cap mapping, its types, and the transport refusal exit constant. It preserves the reviewed 2048 cap and rejects unsupported payload semantics; it does not register an extension or tool. Existing sessions must be reloaded after updating. The installer retires unchanged managed command/runner files; user-modified obsolete files are preserved and reported for manual review, never deleted automatically. Such retained files are not imported by the current Hub.
157
+
158
+ ### Context pressure and recovery
159
+
160
+ Standing prompt ceilings constrain the repeatable replacement prompt and active schemas; they do not
161
+ bound conversation messages or results accumulated inside a long tool loop. The Hub therefore has a
162
+ second, runtime pressure guard. It samples provider usage, projects a finalized tool result at
163
+ `message_end`, warns and exposes transient compaction support at **60%**, then at **70%** aborts the
164
+ pre-model continuation and waits for `agent_settled` before requesting one Pi compaction. This
165
+ ordering ensures the result is persisted before summarization and prevents an ordinary provider call
166
+ from escaping between pressure detection and recovery. Automatic compaction re-arms when measured
167
+ usage falls below 60%, or after the history grows by 10% of the window over the first measurement
168
+ after a compaction. At the **80%** ceiling, work stops after a failed recovery or when even the
169
+ compacted baseline is at or above the ceiling. A baseline between 70% and 80% only warns, because a
170
+ small window then keeps working until growth re-arms compaction.
171
+
172
+ Recovery is single-flight. High-context startup or concurrent input is retained in memory and
173
+ replayed exactly once after success; failure retains it for `/compact` or a larger-context model.
174
+ `/af-context` and the status line report phase, usage, thresholds, episode, and last outcome. Session
175
+ entries store only numeric/enumerated pressure metadata, never prompts, tool payloads, credentials,
176
+ error bodies, or summaries.
177
+
178
+ A persisted native roster is also metadata, not copied configuration: only its team name is stored
179
+ and it is re-resolved against current teams and persona definitions. A stale or absent roster in a
180
+ resumed orchestrator session fails closed—work mode remains orchestrator, direct tools remain removed,
181
+ and model input is blocked until `/af-agents-team`, an explicit `--agent-team <name>` restart, or an
182
+ explicit operator selection resolves it. Explicit CLI work mode and roster selections retain
183
+ precedence.
184
+
185
+ Pi's session JSONL is the authoritative append-only record for rebuilding a session, including
186
+ compaction and Hub metadata. Pressure and roster recovery operate through Pi/Hub lifecycle APIs;
187
+ they never rewrite prior entries. Operators must not edit, truncate, reorder, or synthesize JSONL to
188
+ recover a session.
189
+
190
+ The project selected by `--project <name>` is the coms namespace for the Hub
191
+ and every standing or dynamically spawned peer. The Hub-facing peer spawn API
192
+ cannot override it. Native subagents remain children of that Hub and inherit
193
+ its repository context; peers are separate processes in their own panes.
194
+
195
+ At dispatch time, `backend: "auto"` applies
196
+ `.pi/agents/dispatch-policy.yaml`; `backend: "native"` bypasses same-name peer
197
+ substitution; and `backend: "coms"` requires a visible same-name peer and never
198
+ falls back to a native child. `.pi/agents/peers.yaml` owns how a peer runs
199
+ (`runner`, persona, model, extensions, and declared `env_file`), not whether a
200
+ dispatch uses it.
201
+
202
+ ## Fleet hierarchy
203
+
204
+ Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and status flow **up** — as compact structured returns, never raw dumps.
205
+
206
+ ```mermaid
207
+ flowchart TD
208
+ You(["You · Hermes relay · Codex native text/voice"])
209
+
210
+ subgraph HUBL["HUB — guarded runtime (bare just fleet)"]
211
+ Hub["agent-hub harness<br/>operator or orchestrator work mode · routes tasks<br/>owns the Verification Contract on disk · keeps research dumps out of its own context"]
212
+ end
213
+
214
+ subgraph TEAML["OPTIONAL NATIVE ROSTER (.pi/agents/teams.yaml)"]
215
+ Team["default: builder · test-engineer · code-reviewer · documenter<br/>also: plan · debug · frontend · security · hotfix · release · info"]
216
+ end
217
+
218
+ subgraph RESL["RESEARCH HELPERS — read-only, always available"]
219
+ Research["researcher (fast tier — simple reads)<br/>deep-researcher (deep tier — hard, cross-cutting questions)"]
220
+ end
221
+
222
+ subgraph SUBL["SUB-AGENTS — focused children, narrow tools + models"]
223
+ Subs["planner → scout · rules · risk<br/>plan-reviewer → feasibility · deps<br/>builder → recon · verifier<br/>test-engineer → coverage-scout · conventions<br/>code-reviewer → preflight · quality · perf · docs<br/>security-auditor → recon · input-sweep · secrets-sweep"]
224
+ end
225
+
226
+ You -->|task| Hub
227
+ Hub -->|"dispatch_agent — one persona = one specialist session"| Team
228
+ Hub -->|"spawn_research"| Research
229
+ Research -.->|"findings written to disk — hub gets paths, not dumps"| Hub
230
+ Team -->|"subagents: block (delegate_depth ≥ 1)"| Subs
231
+ Subs -.->|"results return to the parent agent only"| Team
232
+ Team -.->|"structured return + evidence"| Hub
233
+ Hub -.->|"one status line: Assertions: 2✓ 1○ 1✗"| You
234
+ ```
235
+
236
+ Every specialist session is one persona from [`agents/`](../agents/) (installed to `.pi/agents/personas/`) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
237
+
238
+ The same idea as a tree:
239
+
240
+ ```text
241
+ hub (operator by default; orchestrator when selected)
242
+ ├── optional native roster (empty by default; example: default)
243
+ │ ├── builder → recon · verifier
244
+ │ ├── test-engineer → coverage-scout · conventions
245
+ │ ├── code-reviewer → preflight · quality · perf · docs
246
+ │ └── documenter
247
+ ├── research helpers (spawn_research, any time)
248
+ │ ├── researcher
249
+ │ └── deep-researcher
250
+ └── optional fleet peers (herdr + coms)
251
+ ├── architect / releaser / web-debugger panes
252
+ ├── Claude Code peer (coms bridge)
253
+ ├── Hermes (phone human · inbound ask_user)
254
+ └── Codex native MCP (compatible local host · existing Pi sessions)
255
+ ```
256
+
257
+ Composition rule: **the hub (or a slash command) orchestrates; personas do not invoke other personas as peers.** Specialists may only fan out to their configured **sub-agents**. Research helpers write findings to disk; the hub resumes specialists with paths, not raw dumps.
258
+
259
+ ### Automatic file discovery
260
+
261
+ The independently consented v2 `consumers.fileDiscovery` consumer intercepts eligible
262
+ parent inventory/find/ls/grep results and native research/worker/registered descendant
263
+ discoveries before the next model step. Pre-spawn context is prepared after launch
264
+ gates and rechecked after awaits. One parent runtime owns bounded scheduling,
265
+ durable logical reservations, full-question/current-permission cache identity and
266
+ individual waiter cancellation. The parent reads guarded files; native attempts
267
+ receive private, revocable broker assignments, never the provider key. Sandbox,
268
+ tool/depth/tree caps, task authority and mandatory policy remain unchanged.
269
+
270
+ All display-permitted candidates retain ranked or explicit unscored rows; >255 is
271
+ not a semantic limit. Managed per-page artifacts preserve total/offset/next/hash and
272
+ normal orchestrator self-read limits. Discovery/evaluation coverage and complete,
273
+ partial, unavailable, cancelled and skipped differ. Exact read/grep evidence is
274
+ not replaced. Fleet communication capture is opt-in and memory-only: D9 includes
275
+ only hashed owner/attempt, trigger, counts/coverage/elapsed and actual-or-unknown
276
+ usage, never source bodies, raw queries, arbitrary paths or tokens. Configuration
277
+ changes require a new session. Offline production lifecycle/package tests prove
278
+ mechanics, not semantic accuracy or final live activation. See the [D9 guide](system1-file-discovery.md)
279
+ for exact triggers, unsupported surfaces, residual limitations and unpublished
280
+ source/local-tarball commands.
281
+
282
+ ### Optional semantic damage guard
283
+
284
+ D6's parent Hub owns the shared service, task/accepted-input revision, durable
285
+ hold/denial state and shared approval coordinator. Baseline-allowed bash/write/edit
286
+ receive scoped pre-call assessment; only valid severe AND sufficient can hold an
287
+ exact action. When D6 is enabled or this task has a persisted hold/denial,
288
+ native specialists, research helpers and nested delegates have independent
289
+ physical-spawn registration, fresh/revocable assignments (including fallback),
290
+ stripped inherited assignments and no child provider credentials. Disabled D6
291
+ without a persisted fence skips its broker and registration entirely; ordinary
292
+ baseline-protected work does not depend on optional assessment IPC.
293
+ This is independent of D9 consent and cannot expand effective tools, admission,
294
+ OS isolation, budgets or baseline authority. Research stays read-only with
295
+ supported result screening; standalone Damage-Control without trusted assignment
296
+ has baseline only, and coms peers have no native D6 registration coverage.
297
+
298
+ Missing/off/invalid/root-off/unavailable-key means no new D6 inference, not
299
+ removal of durable fences. `/af-damage-override [actionId]` only re-arms a matching
300
+ human dialog, never executes, retries, clears denial or grants path access.
301
+ One-use semantic consent still requires current baseline authority after waiting.
302
+ Original→D6→D8 composition keeps frozen non-aliased original evidence separate
303
+ from appended visible advice; structured `damageGuard` and `fileDiscovery`
304
+ views preserve originals or envelope collisions. Failed capture is a gap and
305
+ warning absence never establishes trust. See the [D6 guide](system1-damage-guard.md)
306
+ for bounded provenance-checked result sources, exact structured API and deadlines.
307
+
308
+ Production wiring exists in the current worktree; named F10 no-network checks
309
+ record SDK/codemode 1.1.0 on Node v25.2.1, not universal compatibility. In that
310
+ SDK, non-structured error rejection exposes the original first block, not coverage
311
+ text (the nested outcome retains coverage/error). D6 remains incomplete/unaccepted:
312
+ A1–A8, independent review/final testing, F12 packaging and F13 final acceptance
313
+ remain open. Documentation and module presence do not close those gates.
314
+
315
+ ### Research search supervision
316
+
317
+ The shared `spawnPiAgent` seam supervises every `read`/`grep`/`find`/`ls` call from native
318
+ research helpers and nested delegate children. The supervisor tracks JSONL `toolCallId` values
319
+ independently, with a default 120-second deadline (`recon-search-timeout-s: 1..3600|off` under
320
+ `## agent-hub`). It is a per-tool watchdog; the whole-run bound is separate — the task-tier
321
+ per-run deadline (`agent-turn-timeout-s`), which terminates a hung run as `turn_timeout`.
322
+ On timeout or caller cancellation it owns and terminates the child's process group (SIGTERM,
323
+ then SIGKILL after a bounded grace), has a separate settlement timer for missing `close`/pipe
324
+ drain, and reports timeout separately from cancellation. Research helpers and nested delegates
325
+ are each given safe process-group ownership; delegates forward parent termination so no detached
326
+ child is orphaned. Full pattern catalog: [references/orchestration-patterns.md](../references/orchestration-patterns.md).
327
+
328
+ ### Usage accounting and supervision
329
+
330
+ The hub records dispatches, research, review rounds and active time across turns and
331
+ saved tasks (`run-budget.js`). None imposes a continuation quota. Legacy
332
+ `max-dispatches-per-turn`, `max-research-per-turn` and `turn-wall-time-s` overrides
333
+ are ignored with migration warnings. Usage remains visible with unlimited caps.
334
+ Task tiers still select delegation, specialist deadlines, recycling and role policy.
335
+ Planner and plan-reviewer are optional at every tier. Wide or high-risk classification
336
+ and System 1 additions retain independent review and action authorization, not a
337
+ Planner admission requirement. Gaps use research; new decisions use `ask_user` grilling.
338
+
339
+ The root operator and native specialists use the drift runtime. Repeated identical
340
+ calls or consecutive failures trigger a bounded judge; a current stuck/drifting
341
+ verdict requests cancellation. Root productive call volume alone never triggers it.
342
+ Judges are fenced at turn/input/session boundaries; an unavailable judge cannot
343
+ fabricate a stop. Root audit entries distinguish an abort request from a confirmed
344
+ physical child stop. This is tool-stream supervision, not a wall-time heartbeat or
345
+ visibility into an external coms peer's own tools. `watchdog: auto` arms it by default;
346
+ an explicit human `off` setting is respected.
347
+
348
+ Individual child deadlines and operator cancellation remain effective. Session
349
+ recycling at run-count/context thresholds and provider concurrency limits remain
350
+ independent resource controls. `agent-turn-timeout-s` and `session-recycle-runs`
351
+ can tighten their tier defaults. Active-time accounting excludes human waits.
352
+
353
+ ### Runtime acceptance and recovery
354
+
355
+ Writable specialist operations (`write`, `edit`, or `bash`) receive the same T2 minimal
356
+ acceptance contract at every task tier. The trigger is the actual operation/tool contract and
357
+ current assertion ledger, not user-language matching or the model's tier label. Read-only
358
+ operations remain lightweight. Language heuristics only expose the fuller verification pack;
359
+ they are supplementary and do not decide whether changed work needs evidence. Pending
360
+ capability leases survive a new-task transition, while stale task packs and assertion state
361
+ reset through the explicit lifecycle path.
362
+
363
+ The runtime-owned result schema is `agent-fleet.runtime-result/v1`. It records orthogonal
364
+ `execution` (`completed | failed | pending`), `changes` (`changed | unchanged | unknown`, with
365
+ `certain | uncertain | not_observed` attribution), `verification`
366
+ (`passed | failed | missing | stale | unsupported`), and `acceptance`
367
+ (`accepted | not_accepted`) dimensions, bound to task identity, before/after revision, command,
368
+ integer exit status, and evidence references. A changed result and failed verification can
369
+ therefore both be true. Compatibility presentation remains
370
+ `not_available | deliverable_failed | needs_verification | accepted` for the Hub and
371
+ `accepted | rejected` for flows.
372
+
373
+ Only native Pi children support trusted runtime checks. The Hub injects the code-owned
374
+ `runtime-test-check.ts` observer only when the native persona has `bash`; the observer wraps the
375
+ existing bash implementation and preserves the normal damage-control `tool_call` approval and
376
+ bash error-event semantics. The parent accepts a check only when producer schema, observed bash
377
+ start, exact declared command, task, coverage metadata, exit status, and unchanged inspected
378
+ revision agree. This proves exact command execution, not semantic adequacy: even a declared
379
+ `true` command can pass, so test quality remains subject to independent or human review.
380
+ Coms peers cannot produce trusted checks, and `manual`/`runtime-ui` requirements currently have
381
+ no trusted producer; all three paths fail closed as missing or unsupported.
382
+
383
+ The observer and trusted event-correlation path have an observed compatibility dependency on
384
+ `@earendil-works/pi-coding-agent@0.84.2`: they rely on its `createBashToolDefinition`, `tool_result`
385
+ hook, `args.path`, and JSON-event passthrough contracts. This records the currently verified API
386
+ surface rather than changing or independently pinning the package version; Pi upgrades must
387
+ re-verify these integration points.
388
+
389
+ Native runs also retain a bounded record of actual tool starts/ends by tool-call identity. T3
390
+ uses those code-owned events only to correlate a terminal, unfenced pseudo-write claim with the
391
+ readback of an explicitly declared deliverable. It never executes tool-shaped text. Fenced
392
+ XML/JSON documentation examples are excluded; a real matching write event with failed readback
393
+ remains a T2 verification/effect failure rather than being relabelled as a protocol failure.
394
+
395
+ A mismatch emits `agent-fleet.tool-protocol-diagnostic/v1` with category
396
+ `tool_protocol_error`, task-or-controlled-probe origin, effective backend/model/tool
397
+ configuration, the claimed effect, matching-event and deliverable facts, `none | partial`
398
+ effects, this-run-only conclusion, and evidence references. The T2 runtime-result dimensions
399
+ remain unchanged and orthogonal. For a real task, the retained diagnostic artifact is the only
400
+ input accepted by the task-generation-bound `establishEffects` recovery port; it records what
401
+ already happened so unchanged retries cannot replay partial effects. It does not authorize a
402
+ retry by itself and does not turn a task failure into a probe result or a universal model
403
+ judgment. The withdrawn T12 runner is not part of this path; historical evidence remains archived.
404
+
405
+ T5's opt-in `filesystem` tool performs deterministic inventory, byte excerpts, artifact readback, and
406
+ local-file-only source snapshots without another model run. It is registered in the Hub and native
407
+ children but appears in their effective tool surface only while the inherited complete profile has
408
+ `assist.deterministic-tools: true`; stale or forged calls are refused at execution too. Profile and
409
+ work-mode changes rebuild the truthful T4 catalog, and compaction reconciles that effective surface.
410
+ Orchestrator mode may use this narrow inspection/managed-snapshot exception, but still has no generic
411
+ bash, edit, or write tools. Orchestrator excerpt, readback, and inventory share a 64 KiB turn ceiling and refuse a file above 64 KiB without returning its body. Excerpt hashes and reads a window, not the whole file into memory. The recovery is `spawn_research` or a specialist dispatch that carries the path, not the contents. Native specialist, research, and nested-delegate explicit tool caps remain
412
+ authoritative: the assist flag cannot append `filesystem` outside a declared cap.
413
+ Opaque handles bind canonical paths,
414
+ content hashes/fingerprints, and offsets; continuation fails on stale bytes or directory state,
415
+ and canonical-root checks reject symlink escape. Snapshot bytes and provenance metadata are
416
+ stored separately under the owning current session, marked untrusted, and never interpreted as analysis
417
+ or fetched from a network origin. Snapshot destinations are runtime-owned and cannot be supplied by the
418
+ caller; this narrow artifact creation path grants no general write or shell authority. Every source
419
+ path—including the path resolved from a readback handle—passes through the existing damage-control
420
+ `zeroAccessPaths` hook before execution, preserving its exemptions and interactive/headless approval
421
+ semantics; a denial occurs before source bytes or snapshot artifacts are created. Handle decoding is
422
+ single-sourced in `.pi/harnesses/lib/deterministic-handle-path.ts`, so damage-control retains this guard
423
+ when installed with its declared shared-library companion but without agent-hub. Inventory names and
424
+ all other operation results are marked untrusted. Because snapshot has a managed artifact side effect,
425
+ `filesystem` is not classified as replay-safe for automatic mid-run model fallback.
426
+ `assist.deterministic-tools` and `assist.bounded-output` are independent. Enabling
427
+ `bounded-output` alone bounds read-only tool results inside native specialists, research helpers,
428
+ and nested delegates before the next model continuation, and bounds parent reply transport too;
429
+ `deterministic-tools` controls the deterministic filesystem assistance without being a prerequisite
430
+ for output bounds. The fixed bounds are 500 inventory entries per page, 64 KiB per content/reply,
431
+ and 180 Unicode characters per preview; truncation always names a retained full-output path and
432
+ retrieval handle. With `bounded-output` off, legacy transport is preserved regardless of the
433
+ `deterministic-tools` setting. Inventory records an escaping or unavailable symlink as a denied
434
+ entry without traversing it or disclosing its target outside the authorized inventory.
435
+ T5 does not consume `assist.write-isolation`; the separate T6c native launch boundary does.
436
+ `assist.return-extraction` is opt-in help for models that forget `submit_result`: a native
437
+ specialist with tracked assertions that never submits gets the cheap read-only extraction pass
438
+ over its written report. The recovered block is labelled extracted, `resultProtocol` stays
439
+ `submission_missing`, and acceptance still depends on runtime evidence.
440
+
441
+ Invocation preflight for `dispatch_agent` and `spawn_research` validates the original
442
+ shape before normalization. Invalid input reports bounded safe field locations and
443
+ expected/actual types or reasons (`invalid_invocation_shape`), without raw values or
444
+ private payloads; unsafe unknown-key locations are redacted. This is distinct from
445
+ `invocation_persistence_failed`, where valid input could not be durably retained.
446
+ Both refuse before executor launch; persistence refusal releases the in-memory
447
+ reservation even when storage cannot retain failure evidence. Correct the named input
448
+ or storage prerequisite and re-invoke explicitly under unchanged gates and budgets.
449
+
450
+ Recovery remains the single T1 contract: no automatic retry, queue, model fallback, or new
451
+ numeric allowance. Busy work is refused before execution accounting or history mutation and is
452
+ not recorded as no-progress failure. Runtime-owned preflight refusals (`not_started`,
453
+ `started:false`, `effects:none`) never launched a process and never become indeterminate
454
+ attempts: correcting the input/prerequisite (tier, scope, artifacts, catalog, process) and
455
+ re-invoking explicitly proceeds without slash reset, grant, or reconcile, with 0 physical
456
+ launches and 0 indeterminate attempts. Refusals use separate accounting and never consume
457
+ turn/task launch counters; the anti-loop boundary stays in the guard (unchanged fingerprint
458
+ stays refused) while budgets still fail closed on real launches. A settled indeterminate failure permits at most one
459
+ explicit, warned, human-authorized retry per logical operation after the prior process is
460
+ confirmed finished and the executor is idle; partial side effects may be duplicated. Neither
461
+ `/af-recover retry <operationId> <attemptId>` nor legacy `/af-retry <dispatchId>` executes work:
462
+ both use the same authorization lane and offer a stored original-contract invocation for a
463
+ separate explicit tool call under unchanged budgets and safety gates. Pending/unknown process,
464
+ second grant, stale IDs, and missing/invalid/abandoned contracts each fail closed with their
465
+ own reason and next actions (independent inspection stays allowed; replay without a validated
466
+ contract does not). `/af-recover inspect` is
467
+ read-only and reports `not_started` history as needing no slash reset; `reconcile` clears only a technical block when independent current-revision
468
+ readback and nonblocking reviewer evidence cover the failed attempt, leaving the immutable
469
+ failure and open T2/T11 requirements intact; `abandon` never satisfies dependent work.
470
+ Wrapper and evidence producers share one canonical executor identity
471
+ (`canonical([cwd, actor])`), so production reconcile matches; task-scoped logical identity is
472
+ separate from the persistent effect fence (phantom `not_started` from another task is never
473
+ inherited, while cancel/unknown-write/indeterminate fences survive task/model/scope changes).
474
+ Launch/close/termination facts travel separately from exit/acceptance: safety refusal and
475
+ spawn failure never launched, timeout without close stays uncertain, and integer exit alone
476
+ never proves settlement. Unknown shell/backend stays a potential effect with no regex
477
+ exemption; the usable inspection route is the effective catalog's read/grep/find/ls (or the
478
+ opt-in filesystem tool) with an explicit target path. Tool availability is never gate
479
+ admission. Legacy preflight history is freed only with positive runtime-owned no-launch
480
+ evidence, never by missing records; unsupported schemas refuse effects without state deletion.
481
+ Operator cancellation fences the same agent identity until a fresh, one-use authorization is consumed.
482
+ Other agent identities—including the anonymous, read-only research actor—remain independent,
483
+ and a task reset does not erase the cancellation fence. Native session reuse is bound to an exact,
484
+ normalized current-task contract (task identity, instructions, scope, deliverables, input artifacts,
485
+ effective model, and permissions). A different/narrower task starts with a fresh session and
486
+ replacement manifest; only an exact continuation, including the auto-research continuation path,
487
+ receives Pi resume transport. This remains context hygiene rather than confinement.
488
+
489
+ When `assist.write-isolation` is explicitly true, dispatch snapshots that effective setting before
490
+ routing and forces a native child. Explicit coms is refused because remote isolation cannot be
491
+ claimed. The complete Pi process and descendants run under Linux bubblewrap or macOS Seatbelt;
492
+ the repository/root view is read-only except for existing exact relative files, expressly allowed
493
+ existing recursive directories, and separate current-run runtime/artifact/temp roots. Glob scope,
494
+ absolute/escaping scope, symlinked grants, an empty writable grant set, absent or wrong-platform
495
+ backends, and sandbox launch failure all fail closed without an unsandboxed retry. Damage-control remains the policy/audit/
496
+ approval overlay, but an approval cannot widen the OS boundary already created for a run; a wider
497
+ path requires a new explicitly authorized dispatch contract. Network, model, and read access are
498
+ otherwise unchanged. Turning the profile flag off does not dismantle an
499
+ active process boundary; the next run takes a new snapshot. Opt-out retains the legacy spawn path.
500
+ The sandbox never rolls back or deletes user edits, and it cannot protect an allowlisted file from
501
+ a concurrent writer. Exact-file grants support direct writes to the existing inode but intentionally
502
+ block temp-file-plus-rename atomic saves; callers must explicitly grant the containing directory for
503
+ that behavior, and the runtime never widens the grant automatically. Sandboxed spawn uses exactly
504
+ three pipe stdio entries and rejects extra inherited descriptors, closing the known writable-FD
505
+ bypass. Linux deliberately preserves the Hub-owned process group instead of adding a PID namespace,
506
+ and `/dev/tty` remains narrowly available; confinement therefore assumes host ptrace and terminal
507
+ injection controls prevent same-uid cross-process escape (for example Linux Yama ptrace restrictions
508
+ and disabled legacy TIOCSTI). Linux enforcement is exercised on a real bubblewrap host. Seatbelt
509
+ canonicalizes only trusted runtime/artifact/temp aliases such as `/tmp` → `/private/tmp`, while user
510
+ scope grants retain strict symlink rejection; its only device write exceptions are literal
511
+ `/dev/null` and `/dev/tty`, never a blanket `/dev` grant. The Seatbelt profile has contract coverage
512
+ but still requires a Darwin runtime check before T6c is fully verified.
513
+
514
+ T4 adds a code-owned effective-tool catalog without creating another recovery policy. Every
515
+ application of work-mode tools compares the actual active catalog before and after
516
+ `setActiveTools` and can emit `agent-fleet.tool-catalog-delta/v1`: removed, added/available,
517
+ active substitutes with explicit limitations, `permissionExpansion: false`, and SHA-256 catalog
518
+ identities. The delta is persisted as a trusted session entry and included in the next system
519
+ prompt. Orchestrator mode still excludes direct `write`, `edit`, and `bash`; a substitute is only
520
+ an already-active path such as `dispatch_agent` or read-only inspection, and is never invoked by
521
+ the catalog machinery.
522
+
523
+ The runtime latches the effective catalog at `before_agent_start`. Actual assistant tool-call
524
+ blocks are compared to that originating-turn catalog on the real `message_end` path, so a
525
+ next-turn mode switch cannot charge an unknown-tool refusal for a call that was legal when the
526
+ turn began; text blocks are ignored and no pseudo-tool text is executed. On `session_compact`,
527
+ the runtime reconciles the restored `agent-fleet.tool-catalog-state/v1` identity with Pi's current
528
+ active tools, persists restore evidence, and retains the task-scoped unknown-tool counter. Catalog
529
+ errors are recorded fail-closed but cannot skip the existing compaction settlement/deferred-input
530
+ lifecycle.
531
+
532
+ Each unavailable tool refusal is keyed by normalized task and tool, while normalized arguments
533
+ and catalog identity record whether the request or availability was reevaluated. The
534
+ operator-approved limit is exactly three counted refusals, including the first. Mode switches,
535
+ compaction, prose, and real catalog changes never refill it; only the explicit new-task lifecycle
536
+ resets it. A real `unknown_tool` dispatch failure is stamped by the Hub with the latched,
537
+ code-owned catalog identity; a result-supplied identity is ignored. A later successfully persisted
538
+ effective-catalog event can establish `toolStateChanged` evidence for the existing T1
539
+ `unknown_tool` `recoveryDecision`, but still requires explicit reinvocation and existing general
540
+ budgets; it never schedules an automatic retry.
541
+
542
+ Qualitative guardrails remain separate from usage accounting. **Task triage** classifies
543
+ the current task (`trivial`/`small`/`feature`/`project`) for delegation, role and
544
+ individual-process resource policy. It survives follow-ups; lowering is free and
545
+ raising needs a recorded reason. Skipped triage assumes small. Near-identical
546
+ dispatches retain the duplicate guard. Architect, security-auditor and deep-researcher
547
+ retain the trivial/small persona gate; Planner and plan-reviewer are optional at
548
+ every tier. Review rounds are uncapped. Review findings retain their advisory
549
+ budget and source-invariant rule; findings are never silently demoted by position.
550
+ **Process obligations (T11)** are task-scoped and independent of that budget tier. The
551
+ `set_task_tier` tool accepts explicit `risk` (`unknown | low | high`) and process `scope`
552
+ (`read-only | small | wide`); neither is inferred from task prose. Legacy/omitted risk is
553
+ `unknown`, risk changes require a reason, and scope expansion requires a reason plus an
554
+ explicit risk reassessment. Unknown permits read-only research but cannot accept changed
555
+ work. Confirmed low-risk small work uses the existing T2 minimal acceptance path; high risk
556
+ adds a separate review stage; wide work also requires independent review. Planning
557
+ is optional and never a pre-effect gate. Current stage evidence names an artifact
558
+ and revision, without claiming that a model review is semantically adequate. A
559
+ requested Planner still needs genuine declared artifact readback to record plan
560
+ occurrence. Missing optional planning cannot block an authorized builder, direct
561
+ operator or coms peer. Exact-action authorization, independent review, current
562
+ verification and task-transition fencing still govern their respective effects.
563
+ Exit 0, prompt echoes, pending transport and stale evidence cannot replace them.
564
+
565
+ Sensitive-work prohibitions remain distinct from positive requests in handoff
566
+ advice; neither positive nor ambiguous wording mandates a Planner. Resolve factual
567
+ gaps with focused research and additional decisions with `ask_user` grilling.
568
+
569
+ Dispatch observation preserves the existing snapshot when the session cwd is a Git
570
+ worktree. For a non-Git parent it resolves only the literal anchors of declared scopes to
571
+ their nearest nested Git roots, rejects roots outside the workspace, and runs path-bounded
572
+ status there without recursive discovery or file-content capture. Each repository retains
573
+ its HEAD and file metadata separately. Deltas and compiler diagnostics are reported with
574
+ workspace-relative paths; compiler discovery runs at the owning repository. Missing roots
575
+ and changed HEADs create scope-specific gaps while other roots remain observable. Partial
576
+ observation or unavailable compiler coverage cannot establish acceptance through a passing
577
+ sibling repository. Runtime session outputs are excluded from nested observation. These
578
+ are local source guarantees, not evidence that an installed workspace copy was upgraded.
579
+
580
+ The same code-owned state is consumed by dispatch acceptance in operator and orchestrator
581
+ modes, appended as `agent-hub-process-state`, restored from the session log, and retained
582
+ through compaction and mode changes. Only `set_task_tier(new_task: true)` creates fresh
583
+ unknown-risk process state. `/af-audit` exports allowlisted satisfied/open/unsupported
584
+ obligation statuses and explains that the budget tier limits spend rather than correctness;
585
+ reasons and task prose are not copied. This extends the existing task/acceptance/audit paths
586
+ and is not a second workflow engine.
587
+
588
+ **Docs lane** (`docs-lane.js`): a dispatch whose whole declared `scope` is documentation
589
+ refuses review personas (overridable with `review_reason`) and tells the dispatcher not to
590
+ open a review gate; an absent scope is never the lighter lane. **External-blocker stop**
591
+ (`external-blocker.js`): a specialist emits `EXTERNAL_BLOCKED: …` when it needs something
592
+ outside the fleet's reach (account, permission, credential, telemetry destination), and the
593
+ hub refuses the next dispatch with an owner-escalation packet until the human is addressed —
594
+ the alternative, observed, is hours spent approximating the missing fact with scripts,
595
+ manifests and fixtures while the assertion still ends UNPROVEN. **Drift watchdog**
596
+ (`drift-watchdog.js`): armed dispatches are
597
+ observed in-flight from the JSON event stream — deterministic rules (out-of-scope writes
598
+ against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
599
+ escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
600
+ `drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
601
+ (`watchdog` key, `/af-watchdog`, `watchdog` param). Orchestrator work mode auto-arms the
602
+ watchdog when the hub setting is `auto`/`on`; a dispatch `watchdog: false` cannot disarm it
603
+ there. Hub or per-agent `off` remains the opt-out. Two rules about scope: the session's
604
+ own `artifacts/`, `findings/`, and `delegations/` subtrees are implicitly in scope (the
605
+ deliverable protocol *orders* specialists to write there, and the judge is told so), and the
606
+ `scope` rule is non-terminal — it reports a drift advisory on the result and never stops a
607
+ run by itself, matching the post-run scope gate, which reverts nothing. **Dynamic teams**: `/af-agents-add`,
608
+ `/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
609
+ every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
610
+ when nested delegation is on (feature/project), with user notification. `/af-hub-report` accounts each turn's dispatches,
611
+ tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
612
+
613
+ ## Runtime stack (tools the fleet sits on)
614
+
615
+ ```mermaid
616
+ flowchart TD
617
+ AF["<b>Agent Fleet</b><br/>agent-hub · personas · skills · coms · bridges · CLI"]
618
+ AF -->|primary runtime| PI["<b>pi</b><br/>coding agent — loads harnesses,<br/>extensions, prompts, personas"]
619
+ AF -->|control plane| HERDR["<b>herdr</b><br/>tiled peer workspaces,<br/>presence, snapshot/resume"]
620
+ AF -->|coms peer only| CC["<b>Claude Code</b><br/>bidirectional peer via<br/>the coms bridge<br/><i>not an install target</i>"]
621
+ AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed to your phone,<br/>plus the Desktop fleet panel"]
622
+ AF -->|Local native MCP| CODEX["<b>Codex native workflow</b><br/>explicit existing sessions<br/>text or voice; no idle wake"]
623
+ ```
624
+
625
+ ### Explicit operator current-state verification
626
+
627
+ `dispatch_agent.review_mode="operator-current-state"` is an explicit native-only verification contract for current Git-visible scoped files, not reconstructed edit authorship. It snapshots the current task/revision, requires complete independent same-state review plus fresh runtime checks for every active automated assertion and AF-MIN-CHANGE, and preserves default changed-task/review/cancellation/action-confirmation gates. Process path/origin distinguishes current-state acceptance; read-only child `changes=unchanged`/`taskAccepted=false` and unsupported manual assertions are not rewritten. Scope mutation, stale input/revision, missing checks or concurrent writers fail closed. No automatic reload, grants, historical records or ledger proof is added. See [contract and manual activation](operator-current-state.md).
628
+
629
+ ### Local Codex observation boundary (experimental)
630
+
631
+ The STDIO MCP adapter, registered at the user level by `agent-fleet set-codex-mcp` ([setup guide](codex-setup.md)) or through a manual project-local table, uses validated per-call host conversation context and an exact Fleet epoch allowlist (D2-L: cooperative same-user routing, not cryptographic authority). Discovery/read checks are registry-only; `fleet_observe` authorizes before and after one bounded local snapshot. `fleet_overview` aggregates 1–4 explicit selectors with target-local errors and summary-only question previews. Observations never send prompts or answers. Separate instruction/answer prepare/commit/receipt tools require current rights. An explicit user send in the native chat to one unambiguous, already selected current session with read+send authorizes faithful relay without a second confirmation; the client still checks the prepared payload and commits once. Ambiguity requires clarification, changed sessions stop dispatch, and model-initiated or substantively expanded instructions require fresh preview confirmation. This cooperative client interpretation is not server-attested human consent and does not relax binding/grant, question-answer, host approval or receiver execution safeguards. Unknown/partial data and non-atomic snapshots remain explicit; neither registry presence nor a turn boundary establishes task completion. There is no CLI transport fallback, external listener or implicit binding grant. The separately opt-in experimental Desktop queue adapter has limited externally smoke-tested wake evidence, not a general delivery guarantee. Question notifications share a canonical lossless reference codec across ingress, packet and reply; legacy-safe references remain stable, while opaque IDs use a versioned encoding with a derived finite wire bound. The native ID contract, authorization and replay/deadline checks are unchanged. See the [native contract](codex-local-mcp.md).
632
+
633
+ S5c adds observation-only durable metadata in a separate private `<policyRoot>.observations` namespace, keyed by validated conversation and exact target epoch; it does not alter the allowlist schema or import legacy CLI authority. Stable opaque event/window identities extend the bounded receiver projection. Typed `fleet_resync` and active `fleet_watch` declare local writes (`readOnlyHint=false`), preserve pre/post authorization, and report independent gaps/reset/unsupported continuity and pending/resolved question observations. Cursors are not permission or human-delivery receipts. Watch is bounded by duration, frames, output and concurrency; it does not create background jobs/model wake or cancel Pi work. Source/local verification is not native receiver/MCP activation; any lifecycle/epoch changes remain human-controlled and separate.
634
+
635
+ ### External dependencies
636
+
637
+ These are the external systems Agent Fleet assumes or integrates with — not npm packages, but the **runtime stack** the fleet operates on top of.
638
+
639
+ | Dependency | Role | Required? |
640
+ | --- | --- | --- |
641
+ | **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for `just fleet` |
642
+ | **[herdr](https://herdr.dev)** | Workspace control plane: Hub/peer panes, presence push events, team snapshot/resume | Required for `--herdr` or `--peers`; optional for bare `just fleet` |
643
+ | **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class coms peer via the [coms bridge](claude-code-coms-bridge.md) — cross-model review and analysis. Never an install target: it hosts no skills, commands, or personas | Optional peer |
644
+ | **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions — [coms-hermes-bridge](coms-hermes-bridge.md)) and the Desktop fleet panel ([hermes-desktop-plugins](hermes-desktop-plugins.md), needs v0.19.0+ and the Desktop app) | Optional |
645
+ | **Compatible Codex host** | Local native MCP with real per-call UUID context, Node 22.18+ and existing COMS sessions — [guide](codex-local-mcp.md) | Explicit local configuration; CLI-only hosts retired, no mobile/remote promise |
646
+ | **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)** | Upstream skill library (manually vendored) | Bundled (vendored) |
647
+ | **[disler/pi-vs-claude-code](https://github.com/disler/pi-vs-claude-code)** | Source inspiration / MIT port origin for pi harnesses | Design lineage (ported in-repo) |
648
+ | **LLM providers** | Models per persona (`model:` / `models:` in agent frontmatter) — e.g. OpenAI Codex, GitHub Copilot, Ollama, … | Yes (at least one provider your agents can call) |
649
+ | **Chrome DevTools MCP** / **Playwright Agent CLI** | Browser verify (`browser-testing-with-devtools`) and headless automation (`bowser`) | Optional, feature-specific |
650
+ | **Node.js + npm** | CLI (`npx @chankov/agent-fleet`), package install, `just` recipes | Yes for install & tooling |
651
+
652
+ The existing `agent-fleet doctor` command also performs a read-only manifest preflight. It reports exact selected installation files and manifest-declared tool probes as environment readiness, distinguishes missing installation from unknown or unavailable platforms, and names the existing explicit remediation path. Bare doctor never repairs or installs; `doctor --fix` remains the only repair activation, and package/tool installation remains behind its existing explicit consent path.
653
+
654
+ ### System 1 watchdog consumer (off by default)
655
+
656
+ The native specialist Layer 1 drift watchdog can use the shared System 1 runtime
657
+ only after explicit `watchdog-system1: shadow|active` in `## agent-hub`, feature selection,
658
+ valid provider configuration, an available key and an armed watchdog. It takes a
659
+ session snapshot; setup and doctor do not infer. Shadow starts the LLM judge at
660
+ once and separately observes the same bounded state with Jev. Only the LLM
661
+ verdict may terminate a child; an unavailable LLM judge is recorded as
662
+ `judge_unavailable` and gets one revalidated retry at 5 s, not a successful
663
+ 90 s cooldown. Successful decisions keep 90 s. Every physical attempt has
664
+ separate identities; D1 retries create a new snapshot and do not reuse or
665
+ repeat the previous System 1 evaluation.
666
+
667
+ The state carries a redacted task, relative scope/paths, up to 40 structured
668
+ kinds/outcomes/repeat counts, rule facts and coverage, not raw arguments,
669
+ commands, edit bodies or outputs. This limit applies to System 1 only: the
670
+ existing parallel LLM judge prompt contains the original task, scope and a
671
+ recent trail with up to 120 characters of raw tool arguments per call. Use
672
+ only reviewed nonsecret pilot inputs; manual review does not rule out
673
+ unexpected agent actions. The native spawn boundary removes
674
+ `TYPESAFE_API_KEY` after env overrides. This cannot prevent file reads or
675
+ requests from other launchers. The append-only session watchdog trace stores
676
+ only safe metadata, with explicit unknown usage and interrupted readback.
677
+ The below-chat Fleet strip and `/af-agents` owner detail share a projection;
678
+ `/af-watchdog` shows readiness/active blocking, `/af-hub-report` separates
679
+ watchdog checks, S1 evaluations and LLM attempts, and `/af-audit` lists safe
680
+ read-only lifecycle outcomes. UI/trace failure does not change judgment.
681
+
682
+ `watchdog-system1: active` explicitly opts into an **uncalibrated experimental**
683
+ shortcut available in installed workspaces: only advisory `scope` may skip LLM
684
+ when Jev `jev-1.13.0` reports provider on-track with confidence and on-track
685
+ distribution ≥0.95 and all three contradiction probabilities ≤0.05. Terminal
686
+ rules always use the LLM; System 1 cannot stop a child. The watchdog status
687
+ labels the mode `experimental: scope only; G2 not validated`; default remains
688
+ off and production approved profiles remain empty. Human snapshot labels,
689
+ session-separated held-out measurement and independent maintainer G2 approval
690
+ are still required before calling this calibrated or expanding its authority. Offline tests and installed-package checks do not
691
+ constitute a live pilot (G1) or active approval (G2). Roll back with
692
+ `watchdog-system1: off` and restart Hub; cancel the current run if needed.
693
+
694
+ ### Proactive turn review (separate opt-in consumer)
695
+
696
+ The Hub's `proactive-*` modules compose a separate, off-by-default consumer of the
697
+ existing shared System 1 library and its provider/key; they do not create another
698
+ provider owner or change watchdog authority. A human-owned per-repository
699
+ `consumers.proactiveReview` in `.ai/system1.json` selects `off`, `shadow`, or `advisory` and exact
700
+ repository-relative include scope. Missing/off means **zero proactive capture,
701
+ inference, and feedback**. Enabled config with `remoteContext: "disabled"` is
702
+ local-only: bounded source/rule capture and reviewed local validators may run,
703
+ but no semantic provider assessment. `selected-excerpts` separately permits
704
+ bounded selected source/assistant excerpts to the shared System 1 service when
705
+ it is ready; shadow records findings without delivery, advisory may deliver
706
+ feedback at the next *already-occurring* context hook for the same owner,
707
+ attempt, task, and bound rule/source revision. It never creates a turn, fixes
708
+ code, terminates work, changes acceptance gates, or suppresses the watchdog.
709
+ No activation, outbound transmission, or remote repository authorization is
710
+ conferred by installing this code or reading this documentation.
711
+
712
+ At `turn_start`/`turn_end`, Hub and supported native Pi specialists bind the
713
+ explicit task/plan and session rule catalog, collect bounded immutable
714
+ before/after worktree and text evidence, and retain private snapshots separately
715
+ from metadata-only finding/report projections. Source-backed rules come from
716
+ `rules:` folders in `## agent-hub` (legacy `## agent-team`), with index-first
717
+ Markdown discovery, explicit linked sections, and bounded fallback; discovery
718
+ is read-only and never executes rule instructions. Rule identity includes path,
719
+ heading occurrence and hash. Incomplete discovery, unselected sections,
720
+ unsupported Markdown, missing plan (`task_only`), concurrent edits, and
721
+ changed source stays partial, unsupported, uncertain or stale—not
722
+ confirmed passes. Rule references use the session-bound revision: on-disk rule
723
+ edits do not themselves stale a finding, and a restart is required to adopt them. Only explicitly reviewed bindings support deterministic
724
+ local link-form and new-file-placement checks; model findings remain
725
+ suspicions, not validated bugs. Rules are **bound per session**: editing a rule
726
+ in a running session does not reload it; restart to adopt edits. Research
727
+ helpers, nested delegates, coms peers and Hermes are not instrumented by this
728
+ consumer. Native observer hooks/integration were checked with repo-local Pi
729
+ 0.84.2; Node 18 compatibility concerns the extracted installer CLI/doctor,
730
+ not running the TypeScript observer under Node 18.
731
+
732
+ Limits and exclusions, exact config, local report/labels usage, and consent
733
+ sequence are in [Project Files — Proactive turn review](agent-fleet-setup.md#proactive-turn-review-experimental).
734
+ Offline/installed tests and C5 operator visibility establish neither live-pilot
735
+ utility nor universal correctness. The finding-label source fix passed final independent source/docs review;
736
+ this establishes offline/package readiness, not human-labelled semantic acceptance. Only retained finding keys
737
+ are exposed for human labels: checked-clear units lack an operator-accessible
738
+ key, so miss/true-negative labeling and full recall evaluation are not operational.
739
+ C7 human acceptance and any release/deployment remain separate. Current caveats include
740
+ unknown native delivery without a receipt and a rare async-close error risk.
741
+
742
+ ### Experimental System 1 foundation
743
+
744
+ System 1 is a shared Fleet library for bounded structured judgments, not a Pi
745
+ model and not a workflow stage. Its provider-neutral contract exposes
746
+ `choice`, `predicate`, and `ordinal` questions with explicit `ok`, `skipped`,
747
+ `unavailable`, `unsupported`, and `cancelled` outcomes. A valid judgment never
748
+ grants action authority. The contract retains distributions, predicate
749
+ probabilities, and provider confidence when supplied and required, but never
750
+ invents missing uncertainty or treats provider confidence as universal
751
+ calibration.
752
+
753
+ The shared service requires saved desired selection of experimental `system1`,
754
+ directly or via its `system1-task-triage` feature dependency; automatic Full
755
+ excludes both. Use `--save-desired` for permanent CLI changes over an existing
756
+ human-owned `.ai/agent-fleet.json`. Provider configuration is a
757
+ separate human-owned `.ai/system1.json` with exactly this version-1 contract:
758
+
759
+ ```json
760
+ {
761
+ "version": 2,
762
+ "mode": "auto",
763
+ "provider": "typesafe",
764
+ "model": "jev-1.13.0",
765
+ "apiKeyEnv": "TYPESAFE_API_KEY",
766
+ "consumers": {}
767
+ }
768
+ ```
769
+
770
+ Selection, valid `mode: "auto"` configuration, and a nonempty key in the
771
+ caller's environment are all required. `mode: "off"` wins, and key presence by
772
+ itself never activates the service. The runtime and imports do not load `.env`
773
+ or mutate global environment. Managed `just` launches may load the workspace
774
+ root `.env`; direct Node launches must export or inject the key themselves.
775
+
776
+ The only phase-0 production adapter uses the fixed official TypeSafe endpoint
777
+ and pinned `jev-1.13.0` model. It has a 2,000 ms total deadline, including body
778
+ collection and at most one budget-fitting retry for 429/529, rejects redirects,
779
+ and bounds request and response bodies at 1 MiB without truncation. Cancellation
780
+ prevents retry and late-result use; a 401 latches that service instance. Normal
781
+ failures return structured, sanitized outcomes rather than raw response bodies.
782
+ There is no arbitrary endpoint, SDK dependency, Pi/local-model fallback, daemon,
783
+ or local-model installation.
784
+
785
+ Doctor reuses the shared configuration validator and is advisory, read-only,
786
+ and offline—even with `--fix`. It does not inspect or load `.env`; key presence
787
+ in its current process remains local readiness, never API validity. The standalone
788
+ demo is also offline by default; only explicit `--live` sends its embedded
789
+ synthetic Bulgarian/English examples. Public setup and commands are documented
790
+ in [Install and lifecycle](npm-install.md#experimental-system-1-foundation).
791
+
792
+ Consumers own their field allowlists, data consent and policy separately. The
793
+ native managed child spawn filters the shared key, but this is not universal
794
+ file/environment isolation for arbitrary launchers. Watchdog's active scope
795
+ shortcut, profile-gated dispatch advice and active uncalibrated task triage are
796
+ different contracts; one consumer's profile/consent cannot enable another.
797
+
798
+ Evidence stays split: Node 18 verifies installer/doctor portability, real-Pi
799
+ synthetic sessions verify registered runtime hooks, and an extracted tarball
800
+ verifies install/import closure and disable/resume gates. Human UI observation
801
+ and independent checkpoint reviews are separate. None proves live Jev accuracy,
802
+ calibration, semantic assertion adequacy or universal remote effects.
803
+
804
+ ### Task triage: additive process evidence, not spend authority
805
+
806
+ The separately consented `system1-task-triage` consumer evaluates accepted user
807
+ input before the first Hub model turn, using the existing shared service even
808
+ with watchdog off. It supplies bounded user text and declared scope, not file
809
+ bodies, environment, transcripts or tool output. Runtime limits are 40 KiB
810
+ aggregate task/clarifications, 64 KiB serialized state, 100 logical evaluations
811
+ per saved session and a 2,000 ms deadline including adapter retries. Cache keys
812
+ bind input/scope/version; task adoption and compaction/resume cannot refill the
813
+ allowance. Physical attempts and unknown usage remain distinct from logical calls.
814
+
815
+ Independent intent-aware predicates at inclusive thresholds add review
816
+ (`security_change` ≥0.80), review (`wide_change` ≥0.85), or exact-action human
817
+ confirmation (`irreversible_execution` ≥0.80). They do not set risk/tier, select
818
+ a model/roster, increase spend or weaken baseline protections. Low probabilities
819
+ are not clearance; missing/invalid/provider-failed results add nothing while
820
+ existing obligations persist. This is active experimental policy, not calibrated
821
+ persona advice or a watchdog stop profile.
822
+
823
+ Source additions retain task/evaluation/input provenance and union with baseline
824
+ requirements. New scope invalidates uncovered evidence. A narrow correlated
825
+ human waiver releases one bound addition as `waived`, not `satisfied`; baseline
826
+ and other-source requirements survive. Pending task transition and authoritative
827
+ 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
828
+ Optional native planning and required review use the existing evidence path; exact-action
829
+ confirmation supports Hub direct bash/edit/write, not arbitrary child/remote/coms
830
+ execution. The human question shows complete tool inputs as JSON and cwd with
831
+ an **8 KiB (8192 bytes)** full-detail cap: invalid, missing, sensitive,
832
+ terminal/bidi-control, oversized or mismatched details refuse **without
833
+ truncation or partial redaction**. JSON preserves non-ASCII input through escapes;
834
+ sensitive-text detection remains heuristic. The one-use binding and pre-effect
835
+ recheck include task/revision, tool call, operation, input hash and cwd.
836
+ The question is **not local-only**: configured ask-user local/remote human routes
837
+ can carry action paths/content. Normal Pi tool/session rendering, human-route
838
+ records and clipboard are separate from metadata-only audit and its caps.
839
+ Unsupported bindings refuse the affected operation.
840
+
841
+ The full Fleet dashboard and `/af-audit` separate declared classification,
842
+ assessment, effective obligations, source waivers, blockers, logical calls,
843
+ physical attempts and recorded action grant/consumption/tool result. None means
844
+ semantic task acceptance by itself. New persistent trace/audit projections are
845
+ metadata-only; optional observation failure cannot alter enforcement. The
846
+ communication viewer stays separately opt-in, memory-only and capped at 32 KiB;
847
+ a larger valid task payload is withheld, not truncated. Task-triage presentation
848
+ is session-level and does not fabricate worker rows or a second dashboard.
849
+
850
+ Setup creates absent nonsecret consumer/provider templates transactionally only
851
+ with explicit task-context consent; it preserves existing configs/off. Disable
852
+ and restart stop future calls without deleting resumed obligations. Detailed
853
+ schema, saved desired selection, role/budget recovery, narrow waiver and rollback
854
+ are in [Project Files](agent-fleet-setup.md#task-triage-active-experimental-off-by-default).
855
+
856
+ ### Execution tracing and baseline policy classification
857
+
858
+ The Hub records `agent-hub-execution-trace` custom entries in the existing Pi
859
+ session JSONL journal. By default Pi keeps it under `~/.pi/agent/sessions/`, in a
860
+ directory named after the workspace's absolute path (for `/home/user/project`:
861
+ `--home-user-project--`); a configured Pi session directory may differ. These entries complement the Fleet session directory under
862
+ `.pi/agent-sessions/sessions/<fleet-session-id>/` and existing coms/Herdr logs.
863
+ `/af-audit` exposes their sanitized chronological `executionTrace` projection.
864
+ Schema v2 writes one row per finished span (start, end and outcome together);
865
+ turn and child spans also journal their start so an interrupted session still shows
866
+ what was in flight, and other unfinished spans appear in the live audit only. Older
867
+ v1 journals with separate start and end rows remain readable.
868
+
869
+ Root Pi hooks record input, turns, model rounds and tool requests/results. Existing
870
+ native callbacks link children to their dispatch and report child tool activity.
871
+ The shared Pi event bus connects process/baseline/semantic guard decisions and
872
+ runtime/model questions across isolated extension loaders. Native semantic-broker
873
+ requests join a tool only for one exact input fingerprint, owner and time range;
874
+ ambiguous requests stay visibly unlinked. Remote peers without these callbacks do
875
+ not acquire complete telemetry automatically.
876
+
877
+ Pi emits tool start before permission hooks. A denied request therefore has tool
878
+ activity but no fabricated execution duration. Actual execution duration comes
879
+ from the SDK; human waits and queue waits are separate observations. Overlapping
880
+ intervals count once. Model-round timing includes preparation and is not provider
881
+ latency alone. All aggregates cover only the retained 5,000-row trace window;
882
+ dropped, open, interrupted, invalid and unlinked records remain explicit. Old
883
+ journals without trace return `not_recorded` and unknown timing. Persistence
884
+ failure cannot block work: the live audit uses available memory and reports
885
+ `live_degraded`. Session shutdown releases the bus listener and fences late
886
+ completions; a proposed switch that is subsequently cancelled keeps its spans.
887
+
888
+ Only allowlisted metadata and hashed task/input/call/rule identities are stored
889
+ in the new trace. Commands, paths, user prose, answers, results and credentials
890
+ are excluded. Other existing Pi/session/coms logs retain their own payload rules.
891
+ Trace never grants permission, proves progress or accepts a task.
892
+
893
+ Baseline Bash policy now distinguishes supported static operands from literal
894
+ data. This fixes repository-relative `/bin/` collisions, read-only inspection of
895
+ `dist/` or lockfiles and quoted cat/tee heredoc fixtures containing protected-path
896
+ or deletion examples. Real redirects, writes, deletion and compound effects stay
897
+ guarded. Expanding shell syntax, interpreters, `sed`, `file` and ambiguous attached
898
+ short options retain conservative text checks; the trace labels which analysis was
899
+ used. This is a narrow classifier, not a shell sandbox or a guarantee against all
900
+ future false positives. Reload/restart the harness to activate updated sources;
901
+ separate copied installations still need their normal workspace update.
902
+
903
+ ## Repository module map
904
+
905
+ ### Agent Hub composition
906
+
907
+ `.pi/harnesses/agent-hub/index.ts` owns mutable Hub state and composes the extracted concerns without merging their context contracts:
908
+
909
+ ```text
910
+ agent-hub/
911
+ ├── index.ts # bounded composition root; constructs root-owned mutable ports
912
+ ├── types.ts # shared Hub agent/state contracts
913
+ ├── config/ # agent/frontmatter, teams, profiles, dispatch policy, overrides
914
+ ├── context/ # state, budgets, assertions/artifacts, session-health factories
915
+ ├── commands/ # 27 typed /af-* command registrars
916
+ ├── tools/ # 16 tools plus dispatch/research execution orchestration
917
+ ├── dispatch-core.ts # facade over native, coms, and observability dispatch
918
+ ├── dispatch-*.ts # native preparation/spawn/completion and backend adapters
919
+ ├── acceptance.ts # agent-fleet.runtime-result/v1 and minimal acceptance evaluation
920
+ ├── runtime-test-check.ts # code-owned native bash observer for trusted runtime checks
921
+ ├── tool-protocol.ts # T3 event/readback correlation and shared diagnostic schema
922
+ ├── recovery-contract.ts # shared typed failure/recovery policy
923
+ ├── damage-guard-*.ts # D6 parent state, approval, ownership and broker (acceptance open)
924
+ ├── policy/ # model, roster, capability, and work-mode decisions
925
+ ├── research/ # helper runtime, spawn transitions, and controls
926
+ ├── ui/ # grid, dashboard, detail, context, pool, zoom, and history
927
+ ├── input/ # shortcuts and completion derivation
928
+ ├── lifecycle/ # turn, pressure, monitor, session, and shutdown orchestration
929
+ ├── prompts/ # data-oriented system/session templates + HubPromptContext
930
+ ├── session-start.ts # typed ordered session_start step runner
931
+ ├── presentation.ts # marker, name, thinking, and delegate-path helpers
932
+ ├── timeline.ts # bounded transcript/timeline append helpers
933
+ ├── monitor-*.ts # local monitor transport and recovery primitives
934
+ └── *.test.{ts,js} # registration, loader, parity, and behavior contracts
935
+ ```
936
+
937
+ Cross-harness coms lifecycle remains shared in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; it is not owned by the Hub composition root.
938
+
939
+ ```text
940
+ .pi/ # Pi runtime: harnesses, extensions, agents config, prompts
941
+ .pi/agent-fleet/ # The fleet runtime, mirrored verbatim into a workspace:
942
+ scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
943
+ scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
944
+ hermes/ # Hermes-facing skills/integration assets
945
+ hooks/ # the coms bridge Stop hook
946
+ docs/ # the one doc that installs into a workspace (workflows.md)
947
+ skills/ # Agent Fleet-native skills (shadow vendored names)
948
+ agents/ # Personas/subagents; installed to a workspace's .pi/agents/personas/
949
+ vendor/agent-skills-upstream/ # Manually imported upstream skills (pinned SHA)
950
+ bin/ # npm CLI: setup/doctor/uninstall, the installer engine, explicit operator controllers (bin/lib/)
951
+ references/ # Supplementary checklists, installed with the skills that cite them
952
+ docs/ # This file, setup guides, bridge references, vendoring policy
953
+ ```
954
+
955
+ `bin/lib/` holds the deterministic installer engine (`manifest.js`, `state.js`, `verify.js`,
956
+ `plan.js`, `apply.js`, `merge-forms.js`), which writes only inside a workspace, and the explicit
957
+ operator controllers, the only modules that write outside one: `set-hermes-watchdog.js` and `set-hermes-telegram.js` for a Hermes profile
958
+ (receipts and atomic installs in `hermes-profile-artifact.js`), and `set-codex-mcp.js` for the
959
+ user-level Codex registration, with `skill-zip.js` (a bounded, dependency-free reader for the
960
+ packaged `skills/*.zip`) and `mcp-probe.js` (one STDIO `initialize` + `tools/list` exchange that
961
+ proves a launcher before any write). Each controller runs only when the operator invokes its
962
+ `agent-fleet set-*` command; `setup` never calls them.
963
+
964
+ The fleet runtime keeps its *source* layout identical to its *installed* layout.
965
+ That is not cosmetic: `companion:harness-runtime-closure` and its siblings copy
966
+ with `preserveLayout`, so a relative import written here resolves the same way in
967
+ a workspace — including the ones reaching from the stationary `.pi/harnesses/`
968
+ into the movable `.pi/agent-fleet/scripts/`. `bin/test/path-boundaries.test.js`
969
+ holds that invariant.
970
+
971
+ Reserved for future modules (do not repurpose these paths):
972
+
973
+ ```text
974
+ apps/dashboard/ # future dashboard: Kanban state, Herdr workspaces, peer status
975
+ packages/fleet-core/ # future extracted core orchestration library
976
+ packages/herdr-bridge/ # future Herdr integration package
977
+ packages/hermes-bridge/ # future Hermes integration package
978
+ ```
979
+
980
+ ## Design rules
981
+
982
+ - **Workflow engine remains single-sourced.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one flow acceptance decision. It uses the clean spawn/context seams and keeps its clean-tree guard while staying on the current branch by default; creating a flow branch requires explicit `--branch`; normal traces live under `.pi/flow-sessions/`. Explicit flow branches retain source/result metadata, while reserved `cleanup` and `merge` delegate safe removal and squash integration to Worktrunk. The initial Hub `run_flow` adapter calls the same exported dispatcher directly and permits only read-only `scout`: it runs in a stable detached snapshot with no flow branch, stores trace/manifest in the current Hub session, and has one Hub budget/cancellation owner. Snapshot overlay operations validate plain parents before mutation and never follow a HEAD symlink leaf. The native process and descendants use `confineNativeChild`, with only the session-owned phase directory writable; the actual `read`/`grep`/`find`/`ls` data paths are separately limited to the snapshot while damage-control remains loaded. Runtime/model libraries and provider configuration remain readable for Pi startup, so this is intentionally not a global no-read claim. Duplicate identity is idempotent; stale/busy calls are uncharged. All setup/result exceptions settle as structured failures, release active ownership, and preserve honest charged/started state. Owned scout snapshots are cleaned on settlement, with visible cleanup status/errors; traces and explicit branches are retained. Flow acceptance never promotes parent assertions or closes T11 obligations. Writable/committing flows remain outside this adapter pending a separate review.
983
+ - **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
984
+ context if it can live on disk or in a one-line status. Research findings,
985
+ the Verification Contract ledger, and team snapshots are all disk-first.
986
+ - **A harness fault must never look like a specialist fault.** The hub passes
987
+ `--session <file>` on every run, so one corrupt session file used to fail a
988
+ persona in ~1s with no output — indistinguishable from a bad agent, and
989
+ unrecoverable by drop + re-add. Unusable session files are now validated and
990
+ quarantined (`session-health.js`) with the reset named in the result. Same rule
991
+ for the return contract: a report the parser cannot read gets one cheap
992
+ read-only extraction pass (`return-extract.js`) before its assertions are
993
+ written off as unproven, and extracted evidence is always labelled as weaker
994
+ than declared evidence. The converse also holds: a run that errored or timed
995
+ out writes to `artifacts/failures/`, never `returns/` — an error stub filed
996
+ as a return reads as a specialist verdict and gets acted on as one.
997
+ - **A pool status field beats reading the screen.** `coms_list` publishes each
998
+ peer's `pane_id`, waiting-only `queue_depth`, and `status`
999
+ (`idle`/`queued`/`working`/`booting`). `working` means an active turn;
1000
+ `queued` means accepted work is waiting to start. `herdr_spawn_peer` waits
1001
+ for the peer to register and returns `peer_ready`
1002
+ rather than a bare pane id. A spawned peer boots idle and does nothing until
1003
+ addressed, so peers spawned and never sent to are named at turn end and in
1004
+ `/af-hub-report` (`spawned-peers.js`); closing stays the human's call.
1005
+ - **A declared requirement carries its origin.** Every assertion in the ledger
1006
+ names its source (`assertion-ledger.js`), and the open ledger is soft-capped
1007
+ at 8 — an id nobody can trace back to a plan line costs a dispatch and an
1008
+ ASK_USER cycle to re-derive.
1009
+ - **Pre-flight validation is free.** Anything the hub can reject before spawning
1010
+ — an unresolvable artifact path, an unknown research persona, a heavy persona
1011
+ at a low tier, a reviewer on a docs-only scope — is refused without spending a
1012
+ budget slot. Artifact paths also resolve across artifact kinds when the name is
1013
+ unique, since the hub writes every auto-return under `returns/` while
1014
+ dispatchers reasonably guess `reviews/`.
1015
+ - **Evidence is archived, never overwritten.** Session start moves the previous
1016
+ session's `artifacts/` into an immutable `.pi/agent-sessions/runs/<runId>/`
1017
+ namespace with a read-only `meta.json` and an appended `runs/index.json`
1018
+ (`run-namespace.js`), retained per `run-history-keep` (default 10). The old
1019
+ behaviour — delete `artifacts/` at start, name returns by a per-session counter
1020
+ — collided two ways at once and made a post-mortem record eleven specialist
1021
+ returns and two reviews as NOT RECOVERABLE. A failed archive leaves the
1022
+ artifacts in place: a stale tree is recoverable, a deleted one is not.
1023
+ - **Herdr owns panes, presence, and lifecycle; coms owns messages.** Herdr
1024
+ topology recipes (`--herdr` or `--peers`) require a running server and refuse
1025
+ with an actionable message otherwise. Bare Fleet does not require Herdr.
1026
+ `--no-coms` leaves direct/native execution available but disables peer
1027
+ messaging, peer-backed dispatch, and handoff from the Hub.
1028
+ - **External agents are peers, not plugins.** Claude Code (and future CLI
1029
+ agents) join the fleet through bridge adaptors that speak coms envelopes —
1030
+ the fleet core stays agent-agnostic. Hermes remains the inbound `ask_user`/
1031
+ Telegram route. Codex uses the local native MCP workflow; both the former
1032
+ remote-control conductor and the Fleet CLI client are retired.
1033
+ - **Hermes monitor presentation is outside the fleet core.** Agent Fleet exposes owner-only
1034
+ local monitor operations for Hub-owned state; a consumer owns its UI and lifecycle. The
1035
+ worktree contains additive monitor/event/invoke code, but that implementation and its local
1036
+ tests are not proof of a durable external identity or live delivery contract. `invoke`, where
1037
+ available, is Hub-owned and queues dispatcher work rather than exposing tools directly.
1038
+ - **Packaged Hermes source is opt-in, never auto-installed.** The npm tarball carries the
1039
+ `hub-watchdog` skill (`.pi/agent-fleet/hermes/skills/`) plus the backend and Desktop monitor plugin source
1040
+ (`.pi/agent-fleet/hermes/plugins/`, `.pi/agent-fleet/hermes/desktop-plugins/`) as runtime-only source. Shipping that source
1041
+ makes it available to an operator; installing it into a Hermes profile is always an explicit
1042
+ action through `agent-fleet set-hermes-watchdog` (skill) or the consumer's own flow (plugins).
1043
+ Nothing is enabled, launched, or configured by installing the package.
1044
+ - **Codex registration is an explicit operator command, never part of `setup`.** `bin/lib/set-codex-mcp.js`
1045
+ registers the native `af-local-read` server in the user-level Codex configuration and installs the
1046
+ `fleet-native-voice` skill copy under `~/.agents/skills`; `skill-zip.js` reads the packaged archive and
1047
+ `mcp-probe.js` proves the exact launcher over STDIO before anything is written. Like `set-hermes-watchdog`,
1048
+ these modules write outside a workspace only when the operator invokes them, only through
1049
+ `codex mcp add`/`remove` with a `config.toml` backup, and only with receipts that let `uninstall` remove
1050
+ exactly what they created. `setup`, `apply.js`, and the manifest are untouched; no policy state, event
1051
+ relay, auto policy, or Desktop queue is created. See [codex-setup.md](codex-setup.md).
1052
+ - **Watchdog delivery is capability-gated and currently unproven.** No checked-in
1053
+ Gate O live artifact proves Hermes origin identity, updates, reconnect, or two-chat isolation,
1054
+ so its supported posture is journal-only/dormant: no delivery, steering, or surgical use. It
1055
+ never manages services, gateways, Herdr, or shell commands. Local runtime evidence — including
1056
+ a real foreground watcher against a disposable Hub UDS — is `synthetic-local` and proves none of
1057
+ those capabilities; see [the watchdog runbook](hermes-watchdog-supervisor.md).
1058
+ - **External conductor contracts are advisory.** Pi damage-control wraps Pi
1059
+ tool calls, not Hermes or Codex processes; human approvals and their
1060
+ contracts reduce risk but do not provide an OS command allowlist.
1061
+ - **Destructive fleet verbs are damage-control-guarded.** Specialists cannot
1062
+ spawn/close herdr panes; the human confirms destructive actions.
1063
+ - **Native-over-vendored skills.** The skill catalogue resolves `skills/`
1064
+ first, then the vendored upstream import; upstream updates are explicit
1065
+ maintainer actions ([UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md)).
1066
+
1067
+ ## History
1068
+
1069
+ Agent Fleet began as a fork of `addyosmani/agent-skills` and was split into a
1070
+ standalone repository in July 2026, with upstream demoted to vendored content.
1071
+ The one-time migration record, including the history-filtering commands, lives
1072
+ in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md). The product
1073
+ requirements that drove the split were a one-off planning document and are no
1074
+ longer maintained.
1075
+
1076
+ ## Unified System 1 v2 configuration
1077
+
1078
+ The runtime source is `.ai/system1.json` version 2 with independent consumer sections, one immutable session snapshot and a shared service. Installation selection remains separate. See [the unified configuration contract](system1-config.md) for setup, explicit migration, retained backups, diagnostics and remote/local off semantics. Legacy JSON files and `watchdog-system1` in Markdown are not runtime sources. v1 requires explicit migration and cannot start inference. Persisted Task Triage obligations remain enforced when inference is off or unavailable. D10 is not activated by this change.
1079
+
1080
+
1081
+ ## Local Codex S6a addressed instruction boundary
1082
+
1083
+ The local STDIO MCP source adds explicit `grant_send`/`revoke_send` policy previews
1084
+ and separate exact instruction prepare/commit/receipt tools (11 tools at the historical S6a checkpoint; the current source catalog has 21).
1085
+ Validated native conversation identity, existing S2 revision-bound rights and a
1086
+ separate private `.instructions` durable intent ledger precede any one-shot
1087
+ addressed write. Duplicates return history, unknown never triggers a resend,
1088
+ and no exactly-once execution or human-authentication claim is made.
1089
+ An optional versioned COMS capability and pre-enqueue exact-owner check protect
1090
+ the new sender from legacy receivers. Bounded terminal receipts are projections
1091
+ of actual computed responses, correlated by owner/wire ID and recoverable only
1092
+ through read-authorized exact lookup; legacy prompts remain unchanged.
1093
+ Code/local fixtures do not activate receivers/MCP or authorize live actions.
1094
+ See [the local MCP contract](codex-local-mcp.md).
1095
+
1096
+ ## Local Codex machine permission boundary (source checkpoint)
1097
+
1098
+ `fleet_permissions`, `fleet_permission_decide` and `fleet_permission_receipt`
1099
+ are separate from human question
1100
+ answers. A new per-binding `approve` right defaults off; `send` never implies it.
1101
+ Explicit approve grants upgrade only that allowlist namespace to v2 while
1102
+ preserving existing read/send; stale/rebound epochs drop approve. Machine decisions
1103
+ carry `codex_machine`, task/revision/action binding, reason and native thread ID,
1104
+ with no human or Codex-turn attestation. Pi checks the action again before one-use
1105
+ consumption. Baseline path/bash asks, D6, exact triage actions and per-spawn child
1106
+ access share the one-winner permission latch; material triage waivers remain
1107
+ human-only. Machine decisions do not seed human turn/session or semantic memory. `<policyRoot>.permissions` isolates durable attempt reservations
1108
+ from instruction/answer history. Unknown is never replayed, and latch acceptance
1109
+ or authority consumption is not tool completion. The local machine boundary is
1110
+ cooperative same-UID policy, not malicious-same-user protection.
1111
+
1112
+ An optional user-owned `.pi/damage-control-auto-policy.yaml` is outside installer
1113
+ ownership. It is disabled when missing/empty/invalid, allows only exact static
1114
+ once-only rules, carries `auto_policy` provenance, and cannot bypass D6 holds.
1115
+ No policy file/rules or live approve rights are created by this checkpoint.
1116
+
1117
+ The independently tested event pump covers explicitly addressed messages,
1118
+ questions and permissions, with exact binding/epoch checks and bounded deadlines.
1119
+ Production hooks in COMS prompt admission, ready question offers and permission
1120
+ holds publish reference/digest-only events into an explicitly enabled exact-owner
1121
+ runtime. `/af-codex-events prepare|enable <private-config>` and `disable` are the
1122
+ opt-in bootstrap; no configuration discovery or default activation occurs. Startup
1123
+ validates all restart state and reconciles before accepting new ingress. Source ACK
1124
+ requires a synchronous durable admission result; async/void consumers are refused.
1125
+ The separate `<stateRoot>.event-ingress` journal preserves never-attempted events
1126
+ and reconciles attempted/unknown ones without replay. Core receipts alone remain
1127
+ process-local, not durable evidence. An opt-in `CodexDesktopQueueHost` uses the externally
1128
+ smoke-tested experimental shared `thread/queue/add` path via connect-only
1129
+ WS-over-Unix. The user-owned private managed socket alias and canonical socket
1130
+ are checked and fenced against retargeting. It never starts/resumes a daemon,
1131
+ reads authentication, grants rights or forwards raw event payloads. Explicit
1132
+ host-supplied mapping/version/schema evidence is required; it is not live or
1133
+ cryptographic attestation. Known daemon-loaded targets are refused, but concurrent
1134
+ consumer changes cannot be atomically excluded by this shared-queue API.
1135
+ `queue_accepted` means ACK only, with `user_input` transport and machine provenance,
1136
+ not human consent or model delivery. The separate `<stateRoot>.desktop-events`
1137
+ ledger persists attempted-before-write/no-replay across restarts; durable producer
1138
+ ingestion is a separate journal, not inferred from this transport receipt. Unknown ACKs are never resent; queue absence does not
1139
+ prove consumption. Budgets of 10 seconds or less are refused. The busy smoke
1140
+ included an intentional 60s tool sleep, then 55ms dispatch after turn completion;
1141
+ the total wait still counts against the original deadline. A separately authorized single temporary adapter probe observed model input at
1142
+ 1.418s and an exact machine reply at 8.005s inside its original 30s deadline;
1143
+ there were no model tool calls or real permission grants. This is not persistent
1144
+ production activation, exclusive-process/UI attestation, a model permission-decision
1145
+ test, or a 5s SLA. Saved thread reads and active-turn first-party message
1146
+ delivery alone still do not establish external idle wake.
1147
+ The earlier **21/24** host observation is historical. On 2026-11-04 the user
1148
+ reported **24/24** in main after completed receiver reload/rebind, with permission
1149
+ state available and zero pending. No repeat restart/reload is required for that
1150
+ checkpoint. This does not establish live approve rights, production notification
1151
+ activation or model-to-Pi acceptance; those remain separate gates.
1152
+ `replyFleetEvent` separately checks actual native thread metadata, re-inspects
1153
+ permissions before deciding, and leaves question commit behind its existing human
1154
+ confirmation workflow. The latency harness distinguishes local monotonic phases,
1155
+ remote clock uncertainty, recorded host input, actual model awareness and Pi
1156
+ one-use consumption; fixture timings are never model SLA evidence.
1157
+ See [the native contract](codex-local-mcp.md) for API and proof limits.
1158
+
1159
+ ## Local Codex human question actions and voice
1160
+
1161
+ The current source catalog contains 24 native tools, including answer/journal-upgrade operations and local diagnostics/history/snapshot tools. Source availability is not loaded-host proof. The bounded S6b native checkpoint exercised answers, selection, question-scoped refusal, explicit migration and cleanup. The S7 desktop voice check exercised native discovery and read-policy checks; it did not prove voice mutations, mobile or remote support. See the [native MCP guide](codex-local-mcp.md) and [voice workflow](fleet-native-voice.md).
1162
+ The exact owner/project/peer/sessionId/startedAt, pending questionId/toolCallId,
1163
+ full question/effective-flags digest and canonical human response digest bind each action.
1164
+ An actual human answer/refusal and a separate exact preview confirmation are required;
1165
+ a bare tool call is not independent human attestation. Question refusal is not Pi-turn cancellation.
1166
+ An optional question RPC v2 uses the existing QuestionChannel and first-winner latch;
1167
+ legacy v1/local behavior remains unchanged. An inherited legacy shared-channel instance
1168
+ without the guarded method fails unsupported rather than being silently replaced.
1169
+ Bounded volatile proof is owner-bound; missing evidence stays unknown, without retries.
1170
+
1171
+ The SAME `.instructions` namespace/file/lock is the common v2 action ledger for
1172
+ instruction/answer/refusal IDs. V1 is read-only history until a separately consented
1173
+ CAS upgrade, with exact original receipts/timestamps/wire/digest/result preservation
1174
+ and an exact raw backup. Explicit journal-upgrade preview and commit tools support a separately confirmed migration after the operator has stopped old writers; there is no automatic migration. Old v1 binaries reject v2;
1175
+ rollback retains v2-capable data/reader or fails closed, never restoring old dedup snapshots.
1176
+ Shared proposal budgets remain16/context64/process and8 active calls. Sender reservation
1177
+ and attempt precede the single mutating write; this is not an atomic filesystem-to-Pi
1178
+ transaction, exactly-once execution, strong host/human authentication or hostile-UID isolation.
1179
+ No policy/config/lifecycle/native action is implied by source changes. The S6a and S6b bounded native checkpoints are complete; their test grants were revoked.
1180
+
1181
+ ### CLI retirement and historical data
1182
+
1183
+ The native workflow replaces all active Fleet CLI entrypoints, installer items and routing. Retired `chatgpt-client`/`codex-remote` selections require explicit narrow config repair with an original backup; there is no automatic native enrollment. Shared COMS, question v1/v2 handlers and Hermes reader consumers remain independent.
1184
+
1185
+ `fleet_diagnostics` reports local runtime/tool metadata without source probes; `fleet_receipts` lists historical native actions without refresh. Explicit `fleet_snapshot` retains one bounded redacted report per chat/selector under a no-steal lock in `<policyRoot>.reports`; `fleet_replay` returns that historical content, including after revoke, without claiming live rights or current state. Ordinary observations do not archive report content.
1186
+
1187
+ An optional trusted launcher `--legacy-state-root` enables exact-native-UUID, read-only `fleet_legacy_history` over original selection/runtime files. Original archives are never rewritten or converted to new delivery intents. Matching legacy instruction/question-response IDs block new native action attempts; active old writer locks, unsafe/corrupt/missing configured roots fail closed. There is no cross-identity auto-import or grant transfer. Historic release snapshots and original journals are retained. Read-only compatibility and native fixture tests are distinct from host activation or actual voice mutation coverage.