@chankov/agent-fleet 2.1.1 → 2.2.0

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 (1548) hide show
  1. package/.pi/agent-fleet/hooks/coms-stop-hook.mjs +53 -13
  2. package/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/README.md +223 -0
  3. package/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile-0.167.json +5627 -0
  4. package/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +4 -0
  5. package/.pi/agent-fleet/scripts/fleet.ts +13 -17
  6. package/.pi/agent-fleet/scripts/flow.ts +2 -2
  7. package/.pi/agent-fleet/scripts/lib/codex-bootstrap-files.ts +46 -0
  8. package/.pi/agent-fleet/scripts/lib/codex-bootstrap-probe.ts +44 -0
  9. package/.pi/agent-fleet/scripts/lib/codex-bootstrap-producer.ts +131 -0
  10. package/.pi/agent-fleet/scripts/lib/codex-daemon-observer.ts +137 -0
  11. package/.pi/agent-fleet/scripts/lib/codex-desktop-discovery.ts +84 -0
  12. package/.pi/agent-fleet/scripts/lib/codex-desktop-preflight.ts +130 -0
  13. package/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +20 -13
  14. package/.pi/agent-fleet/scripts/lib/codex-measurement.ts +218 -0
  15. package/.pi/agent-fleet/scripts/lib/codex-native-presence.ts +61 -0
  16. package/.pi/agent-fleet/scripts/lib/codex-probe-transcript.ts +135 -0
  17. package/.pi/agent-fleet/scripts/lib/codex-send-lineage.ts +72 -0
  18. package/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +23 -13
  19. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +100 -14
  20. package/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +1 -1
  21. package/.pi/agent-fleet/scripts/lib/fleet-codex-bootstrap.ts +204 -0
  22. package/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +10 -4
  23. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +32 -16
  24. package/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +3 -1
  25. package/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +52 -23
  26. package/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +21 -0
  27. package/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
  28. package/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
  29. package/.pi/agent-fleet/scripts/lib/fleet-command.ts +4 -8
  30. package/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +2 -1
  31. package/.pi/agent-fleet/scripts/lib/team-project.ts +0 -2
  32. package/.pi/agent-fleet/scripts/team-up.ts +5 -12
  33. package/.pi/agent-fleet/scripts/workflows/lib/git.ts +9 -0
  34. package/.pi/agent-fleet/scripts/workflows/lib/quality.ts +17 -4
  35. package/.pi/agents/model-profiles.yaml +0 -2
  36. package/.pi/harnesses/agent-hub/README.md +117 -68
  37. package/.pi/harnesses/agent-hub/capability-packs.ts +7 -4
  38. package/.pi/harnesses/agent-hub/codex-bootstrap.ts +117 -0
  39. package/.pi/harnesses/agent-hub/commands/context.ts +0 -4
  40. package/.pi/harnesses/agent-hub/commands/recover.ts +2 -1
  41. package/.pi/harnesses/agent-hub/config/agents.ts +3 -1
  42. package/.pi/harnesses/agent-hub/config/model-profiles.ts +3 -0
  43. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +14 -1
  44. package/.pi/harnesses/agent-hub/context-continuity-compat.ts +18 -3
  45. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +17 -0
  46. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +3 -1
  47. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +4 -0
  48. package/.pi/harnesses/agent-hub/dispatch-native.ts +9 -3
  49. package/.pi/harnesses/agent-hub/drift-watchdog.js +5 -10
  50. package/.pi/harnesses/agent-hub/execution-trace.ts +1 -1
  51. package/.pi/harnesses/agent-hub/filesystem-tool.ts +1 -1
  52. package/.pi/harnesses/agent-hub/footer.ts +2 -3
  53. package/.pi/harnesses/agent-hub/helpers.ts +4 -5
  54. package/.pi/harnesses/agent-hub/history-projection.ts +1 -1
  55. package/.pi/harnesses/agent-hub/index.ts +213 -196
  56. package/.pi/harnesses/agent-hub/input/shortcuts.ts +0 -7
  57. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +0 -2
  58. package/.pi/harnesses/agent-hub/no-progress.ts +14 -9
  59. package/.pi/harnesses/agent-hub/operator-current-state.ts +5 -1
  60. package/.pi/harnesses/agent-hub/package.json +1 -1
  61. package/.pi/harnesses/agent-hub/policy/roster.ts +12 -3
  62. package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -49
  63. package/.pi/harnesses/agent-hub/poll-command.ts +12 -4
  64. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +12 -4
  65. package/.pi/harnesses/agent-hub/process-obligations.ts +42 -9
  66. package/.pi/harnesses/agent-hub/prompts/context.ts +17 -0
  67. package/.pi/harnesses/agent-hub/prompts/fragments.ts +9 -1
  68. package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -3
  69. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +25 -8
  70. package/.pi/harnesses/agent-hub/provider-semaphore.js +5 -0
  71. package/.pi/harnesses/agent-hub/review-continuity.ts +5 -2
  72. package/.pi/harnesses/agent-hub/review-reuse.ts +2 -1
  73. package/.pi/harnesses/agent-hub/run-budget.js +22 -2
  74. package/.pi/harnesses/agent-hub/scope-gate.js +38 -0
  75. package/.pi/harnesses/agent-hub/scope-overlap.ts +46 -0
  76. package/.pi/harnesses/agent-hub/task-brief.ts +98 -0
  77. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +4 -0
  78. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +5 -3
  79. package/.pi/harnesses/agent-hub/tools/action-executors.ts +5 -7
  80. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  81. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +2 -1
  82. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +184 -33
  83. package/.pi/harnesses/agent-hub/tools/poll-panel-core.ts +30 -0
  84. package/.pi/harnesses/agent-hub/tools/poll-panel.ts +33 -0
  85. package/.pi/harnesses/agent-hub/tools/run-flow.ts +41 -10
  86. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +1 -1
  87. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +12 -2
  88. package/.pi/harnesses/agent-hub/work-mode.ts +44 -49
  89. package/.pi/harnesses/agent-hub/write-isolation.ts +53 -8
  90. package/.pi/harnesses/coms/package.json +1 -1
  91. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  92. package/.pi/harnesses/lib/codex-compat.ts +97 -0
  93. package/.pi/harnesses/lib/codex-contract.ts +259 -0
  94. package/.pi/harnesses/lib/codex-notification-profile.ts +75 -0
  95. package/.pi/harnesses/lib/coms-core.ts +29 -11
  96. package/.pi/harnesses/lib/coms-response-read.ts +107 -0
  97. package/.pi/harnesses/lib/context-budget-child-prompt.ts +1 -1
  98. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +6 -3
  99. package/.pi/harnesses/lib/fleet-bootstrap-channel.ts +148 -0
  100. package/.pi/harnesses/lib/fleet-codex-catalog.ts +30 -0
  101. package/.pi/harnesses/lib/fleet-codex-chat-view.ts +43 -0
  102. package/.pi/harnesses/lib/fleet-codex-namespace.ts +2 -0
  103. package/.pi/harnesses/lib/fleet-codex-policy-snapshot.ts +10 -0
  104. package/.pi/harnesses/lib/fleet-connection-control.ts +20 -3
  105. package/.pi/harnesses/lib/fleet-notification-admission.ts +32 -0
  106. package/.pi/harnesses/lib/fleet-notification-bootstrap.ts +152 -0
  107. package/.pi/harnesses/lib/fleet-notification-validation.ts +80 -24
  108. package/.pi/harnesses/lib/fleet-target-identity.ts +9 -0
  109. package/.pi/harnesses/lib/fleet-transcript-store.ts +1 -1
  110. package/.versions/2.1.2/.pi/agent-fleet/hermes/README.md +347 -0
  111. package/.versions/2.1.2/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  112. package/.versions/2.1.2/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  113. package/.versions/2.1.2/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  114. package/.versions/2.1.2/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  115. package/.versions/2.1.2/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  116. package/.versions/2.1.2/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  117. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  118. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  119. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  120. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  121. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  122. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  123. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  124. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  125. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  126. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  127. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  128. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  129. package/.versions/2.1.2/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  130. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  131. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  132. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  133. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  134. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  135. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  136. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  137. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  138. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  139. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  140. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  141. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  142. package/.versions/2.1.2/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  143. package/.versions/2.1.2/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  144. package/.versions/2.1.2/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  145. package/.versions/2.1.2/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  146. package/.versions/2.1.2/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  147. package/.versions/2.1.2/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  148. package/.versions/2.1.2/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  149. package/.versions/2.1.2/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  150. package/.versions/2.1.2/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  151. package/.versions/2.1.2/.pi/agent-fleet/scripts/fixtures/response-fixture.ts +23 -0
  152. package/.versions/2.1.2/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  153. package/.versions/2.1.2/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  154. package/.versions/2.1.2/.pi/agent-fleet/scripts/fleet.ts +248 -0
  155. package/.versions/2.1.2/.pi/agent-fleet/scripts/flow.ts +166 -0
  156. package/.versions/2.1.2/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  157. package/.versions/2.1.2/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  158. package/.versions/2.1.2/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  159. package/.versions/2.1.2/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  160. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  161. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +106 -0
  162. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  163. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  164. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  165. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +367 -0
  166. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  167. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  168. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  169. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  170. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  171. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +116 -0
  172. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  173. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  174. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +175 -0
  175. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +415 -0
  176. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  177. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  178. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  179. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  180. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  181. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  182. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  183. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  184. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  185. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
  186. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
  187. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  188. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/fleet-command.ts +268 -0
  189. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  190. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +238 -0
  191. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  192. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  193. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  194. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  195. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  196. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  197. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  198. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  199. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  200. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  201. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  202. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  203. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  204. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  205. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  206. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  207. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  208. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  209. package/.versions/2.1.2/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  210. package/.versions/2.1.2/.pi/agent-fleet/scripts/package-lock.json +57 -0
  211. package/.versions/2.1.2/.pi/agent-fleet/scripts/package.json +10 -0
  212. package/.versions/2.1.2/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  213. package/.versions/2.1.2/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  214. package/.versions/2.1.2/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  215. package/.versions/2.1.2/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  216. package/.versions/2.1.2/.pi/agent-fleet/scripts/team-up.ts +385 -0
  217. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  218. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  219. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  220. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  221. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  222. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  223. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/git.ts +99 -0
  224. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  225. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  226. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  227. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  228. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  229. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  230. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  231. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  232. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/quality.ts +65 -0
  233. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  234. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  235. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  236. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  237. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  238. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  239. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  240. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  241. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  242. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  243. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  244. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  245. package/.versions/2.1.2/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  246. package/.versions/2.1.2/.pi/agents/dispatch-policy.yaml +32 -0
  247. package/.versions/2.1.2/.pi/agents/model-profiles.yaml +134 -0
  248. package/.versions/2.1.2/.pi/agents/peers.yaml +147 -0
  249. package/.versions/2.1.2/.pi/agents/teams.yaml +41 -0
  250. package/.versions/2.1.2/.pi/agents/voices.yaml +13 -0
  251. package/.versions/2.1.2/.pi/damage-control-rules.yaml +297 -0
  252. package/.versions/2.1.2/.pi/extensions/btw/README.md +120 -0
  253. package/.versions/2.1.2/.pi/extensions/btw/index.ts +916 -0
  254. package/.versions/2.1.2/.pi/extensions/btw/package.json +6 -0
  255. package/.versions/2.1.2/.pi/extensions/btw/state.js +179 -0
  256. package/.versions/2.1.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  257. package/.versions/2.1.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  258. package/.versions/2.1.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  259. package/.versions/2.1.2/.pi/extensions/compact-and-continue/README.md +42 -0
  260. package/.versions/2.1.2/.pi/extensions/compact-and-continue/index.ts +136 -0
  261. package/.versions/2.1.2/.pi/extensions/compact-and-continue/package.json +6 -0
  262. package/.versions/2.1.2/.pi/extensions/mcp-bridge/README.md +46 -0
  263. package/.versions/2.1.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  264. package/.versions/2.1.2/.pi/extensions/mcp-bridge/package.json +6 -0
  265. package/.versions/2.1.2/.pi/extensions/package-lock.json +1175 -0
  266. package/.versions/2.1.2/.pi/extensions/package.json +9 -0
  267. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/README.md +224 -0
  268. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/config.ts +199 -0
  269. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  270. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  271. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  272. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  273. package/.versions/2.1.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  274. package/.versions/2.1.2/.pi/harnesses/agent-hub/README.md +1584 -0
  275. package/.versions/2.1.2/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  276. package/.versions/2.1.2/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  277. package/.versions/2.1.2/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  278. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  279. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  280. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  281. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  282. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  283. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  284. package/.versions/2.1.2/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  285. package/.versions/2.1.2/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  286. package/.versions/2.1.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  287. package/.versions/2.1.2/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  288. package/.versions/2.1.2/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  289. package/.versions/2.1.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  290. package/.versions/2.1.2/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  291. package/.versions/2.1.2/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  292. package/.versions/2.1.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  293. package/.versions/2.1.2/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  294. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  295. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  296. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  297. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  298. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  299. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  300. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  301. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  302. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  303. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  304. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  305. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  306. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  307. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  308. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  309. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  310. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  311. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  312. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  313. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  314. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  315. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  316. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  317. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  318. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  319. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  320. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  321. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  322. package/.versions/2.1.2/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  323. package/.versions/2.1.2/.pi/harnesses/agent-hub/config/agents.ts +181 -0
  324. package/.versions/2.1.2/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  325. package/.versions/2.1.2/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  326. package/.versions/2.1.2/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  327. package/.versions/2.1.2/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  328. package/.versions/2.1.2/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  329. package/.versions/2.1.2/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  330. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  331. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  332. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  333. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  334. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  335. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  336. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  337. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  338. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity-compat.ts +45 -0
  339. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  340. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  341. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  342. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  343. package/.versions/2.1.2/.pi/harnesses/agent-hub/context-window.js +108 -0
  344. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  345. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  346. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  347. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  348. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  349. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  350. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  351. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  352. package/.versions/2.1.2/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  353. package/.versions/2.1.2/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  354. package/.versions/2.1.2/.pi/harnesses/agent-hub/delegate.ts +478 -0
  355. package/.versions/2.1.2/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  356. package/.versions/2.1.2/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  357. package/.versions/2.1.2/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  358. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  359. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  360. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  361. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +301 -0
  362. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +262 -0
  363. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  364. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  365. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  366. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  367. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  368. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  369. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  370. package/.versions/2.1.2/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  371. package/.versions/2.1.2/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  372. package/.versions/2.1.2/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  373. package/.versions/2.1.2/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  374. package/.versions/2.1.2/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  375. package/.versions/2.1.2/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  376. package/.versions/2.1.2/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  377. package/.versions/2.1.2/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  378. package/.versions/2.1.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  379. package/.versions/2.1.2/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  380. package/.versions/2.1.2/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  381. package/.versions/2.1.2/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  382. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  383. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  384. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  385. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  386. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  387. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  388. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  389. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  390. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  391. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  392. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  393. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  394. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  395. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  396. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  397. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  398. package/.versions/2.1.2/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  399. package/.versions/2.1.2/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  400. package/.versions/2.1.2/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  401. package/.versions/2.1.2/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  402. package/.versions/2.1.2/.pi/harnesses/agent-hub/footer.ts +30 -0
  403. package/.versions/2.1.2/.pi/harnesses/agent-hub/helpers.ts +270 -0
  404. package/.versions/2.1.2/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  405. package/.versions/2.1.2/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  406. package/.versions/2.1.2/.pi/harnesses/agent-hub/index.ts +2705 -0
  407. package/.versions/2.1.2/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  408. package/.versions/2.1.2/.pi/harnesses/agent-hub/input/shortcuts.ts +23 -0
  409. package/.versions/2.1.2/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  410. package/.versions/2.1.2/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  411. package/.versions/2.1.2/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +145 -0
  412. package/.versions/2.1.2/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  413. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  414. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  415. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  416. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  417. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  418. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  419. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  420. package/.versions/2.1.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  421. package/.versions/2.1.2/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  422. package/.versions/2.1.2/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  423. package/.versions/2.1.2/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  424. package/.versions/2.1.2/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  425. package/.versions/2.1.2/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  426. package/.versions/2.1.2/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  427. package/.versions/2.1.2/.pi/harnesses/agent-hub/package.json +7 -0
  428. package/.versions/2.1.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  429. package/.versions/2.1.2/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  430. package/.versions/2.1.2/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  431. package/.versions/2.1.2/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  432. package/.versions/2.1.2/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  433. package/.versions/2.1.2/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  434. package/.versions/2.1.2/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  435. package/.versions/2.1.2/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  436. package/.versions/2.1.2/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  437. package/.versions/2.1.2/.pi/harnesses/agent-hub/presentation.ts +54 -0
  438. package/.versions/2.1.2/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  439. package/.versions/2.1.2/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  440. package/.versions/2.1.2/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  441. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  442. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  443. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  444. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  445. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  446. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  447. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  448. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  449. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  450. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  451. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  452. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  453. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-snapshot.ts +279 -0
  454. package/.versions/2.1.2/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  455. package/.versions/2.1.2/.pi/harnesses/agent-hub/process-obligations.ts +177 -0
  456. package/.versions/2.1.2/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  457. package/.versions/2.1.2/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  458. package/.versions/2.1.2/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  459. package/.versions/2.1.2/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  460. package/.versions/2.1.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  461. package/.versions/2.1.2/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  462. package/.versions/2.1.2/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  463. package/.versions/2.1.2/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  464. package/.versions/2.1.2/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  465. package/.versions/2.1.2/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  466. package/.versions/2.1.2/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  467. package/.versions/2.1.2/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  468. package/.versions/2.1.2/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  469. package/.versions/2.1.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  470. package/.versions/2.1.2/.pi/harnesses/agent-hub/return-contract.js +371 -0
  471. package/.versions/2.1.2/.pi/harnesses/agent-hub/return-extract.js +77 -0
  472. package/.versions/2.1.2/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  473. package/.versions/2.1.2/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  474. package/.versions/2.1.2/.pi/harnesses/agent-hub/review-findings.js +96 -0
  475. package/.versions/2.1.2/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  476. package/.versions/2.1.2/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  477. package/.versions/2.1.2/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  478. package/.versions/2.1.2/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  479. package/.versions/2.1.2/.pi/harnesses/agent-hub/run-budget.js +342 -0
  480. package/.versions/2.1.2/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  481. package/.versions/2.1.2/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  482. package/.versions/2.1.2/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  483. package/.versions/2.1.2/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  484. package/.versions/2.1.2/.pi/harnesses/agent-hub/scope-gate.js +233 -0
  485. package/.versions/2.1.2/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  486. package/.versions/2.1.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  487. package/.versions/2.1.2/.pi/harnesses/agent-hub/session-start.ts +42 -0
  488. package/.versions/2.1.2/.pi/harnesses/agent-hub/spawn.ts +702 -0
  489. package/.versions/2.1.2/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  490. package/.versions/2.1.2/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  491. package/.versions/2.1.2/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  492. package/.versions/2.1.2/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  493. package/.versions/2.1.2/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  494. package/.versions/2.1.2/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  495. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  496. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  497. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  498. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  499. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  500. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  501. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  502. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  503. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  504. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  505. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  506. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  507. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  508. package/.versions/2.1.2/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  509. package/.versions/2.1.2/.pi/harnesses/agent-hub/timeline.ts +72 -0
  510. package/.versions/2.1.2/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  511. package/.versions/2.1.2/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  512. package/.versions/2.1.2/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  513. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/action-executors.ts +216 -0
  514. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  515. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  516. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  517. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/context.ts +147 -0
  518. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +92 -0
  519. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +777 -0
  520. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  521. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  522. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  523. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  524. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/run-flow.ts +146 -0
  525. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  526. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  527. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  528. package/.versions/2.1.2/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  529. package/.versions/2.1.2/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  530. package/.versions/2.1.2/.pi/harnesses/agent-hub/types.ts +66 -0
  531. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  532. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  533. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  534. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  535. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +163 -0
  536. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  537. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  538. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  539. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  540. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  541. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  542. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  543. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  544. package/.versions/2.1.2/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  545. package/.versions/2.1.2/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  546. package/.versions/2.1.2/.pi/harnesses/agent-hub/version.ts +42 -0
  547. package/.versions/2.1.2/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  548. package/.versions/2.1.2/.pi/harnesses/agent-hub/work-mode.ts +188 -0
  549. package/.versions/2.1.2/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  550. package/.versions/2.1.2/.pi/harnesses/ask-user-remote/README.md +59 -0
  551. package/.versions/2.1.2/.pi/harnesses/ask-user-remote/index.ts +571 -0
  552. package/.versions/2.1.2/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  553. package/.versions/2.1.2/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  554. package/.versions/2.1.2/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  555. package/.versions/2.1.2/.pi/harnesses/coms/README.md +105 -0
  556. package/.versions/2.1.2/.pi/harnesses/coms/index.ts +308 -0
  557. package/.versions/2.1.2/.pi/harnesses/coms/package.json +7 -0
  558. package/.versions/2.1.2/.pi/harnesses/coms/version.ts +42 -0
  559. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/README.md +161 -0
  560. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/index.ts +659 -0
  561. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  562. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  563. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  564. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  565. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  566. package/.versions/2.1.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  567. package/.versions/2.1.2/.pi/harnesses/lib/approval-wait.ts +17 -0
  568. package/.versions/2.1.2/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  569. package/.versions/2.1.2/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  570. package/.versions/2.1.2/.pi/harnesses/lib/clarification-policy.ts +9 -0
  571. package/.versions/2.1.2/.pi/harnesses/lib/coms-core-io.ts +422 -0
  572. package/.versions/2.1.2/.pi/harnesses/lib/coms-core.ts +734 -0
  573. package/.versions/2.1.2/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  574. package/.versions/2.1.2/.pi/harnesses/lib/coms-observation.ts +74 -0
  575. package/.versions/2.1.2/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  576. package/.versions/2.1.2/.pi/harnesses/lib/coms-response-read.ts +107 -0
  577. package/.versions/2.1.2/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  578. package/.versions/2.1.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  579. package/.versions/2.1.2/.pi/harnesses/lib/context-budget-view.ts +112 -0
  580. package/.versions/2.1.2/.pi/harnesses/lib/context-budget.ts +114 -0
  581. package/.versions/2.1.2/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  582. package/.versions/2.1.2/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  583. package/.versions/2.1.2/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  584. package/.versions/2.1.2/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  585. package/.versions/2.1.2/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  586. package/.versions/2.1.2/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  587. package/.versions/2.1.2/.pi/harnesses/lib/damage-policy.ts +35 -0
  588. package/.versions/2.1.2/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  589. package/.versions/2.1.2/.pi/harnesses/lib/damage-result-view.ts +16 -0
  590. package/.versions/2.1.2/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  591. package/.versions/2.1.2/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  592. package/.versions/2.1.2/.pi/harnesses/lib/execution-trace.ts +45 -0
  593. package/.versions/2.1.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  594. package/.versions/2.1.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  595. package/.versions/2.1.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  596. package/.versions/2.1.2/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  597. package/.versions/2.1.2/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  598. package/.versions/2.1.2/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  599. package/.versions/2.1.2/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  600. package/.versions/2.1.2/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  601. package/.versions/2.1.2/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  602. package/.versions/2.1.2/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  603. package/.versions/2.1.2/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  604. package/.versions/2.1.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  605. package/.versions/2.1.2/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  606. package/.versions/2.1.2/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  607. package/.versions/2.1.2/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  608. package/.versions/2.1.2/.pi/harnesses/lib/fleet-notification-validation.ts +67 -0
  609. package/.versions/2.1.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  610. package/.versions/2.1.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  611. package/.versions/2.1.2/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  612. package/.versions/2.1.2/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  613. package/.versions/2.1.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  614. package/.versions/2.1.2/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  615. package/.versions/2.1.2/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  616. package/.versions/2.1.2/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  617. package/.versions/2.1.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  618. package/.versions/2.1.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  619. package/.versions/2.1.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  620. package/.versions/2.1.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  621. package/.versions/2.1.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  622. package/.versions/2.1.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  623. package/.versions/2.1.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  624. package/.versions/2.1.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  625. package/.versions/2.1.2/.pi/harnesses/lib/identical-dialog.ts +27 -0
  626. package/.versions/2.1.2/.pi/harnesses/lib/installation-state.js +62 -0
  627. package/.versions/2.1.2/.pi/harnesses/lib/peer-target.ts +24 -0
  628. package/.versions/2.1.2/.pi/harnesses/lib/policy-roots.js +117 -0
  629. package/.versions/2.1.2/.pi/harnesses/lib/policy-roots.ts +32 -0
  630. package/.versions/2.1.2/.pi/harnesses/lib/process-shared.ts +9 -0
  631. package/.versions/2.1.2/.pi/harnesses/lib/resource-closure.js +26 -0
  632. package/.versions/2.1.2/.pi/harnesses/lib/safe-source-read.js +29 -0
  633. package/.versions/2.1.2/.pi/harnesses/lib/semantic-approval.ts +80 -0
  634. package/.versions/2.1.2/.pi/harnesses/lib/session-target.ts +62 -0
  635. package/.versions/2.1.2/.pi/harnesses/lib/spawned-peers.js +191 -0
  636. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  637. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  638. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  639. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  640. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-json.js +37 -0
  641. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-loader.js +53 -0
  642. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  643. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-triage.js +42 -0
  644. package/.versions/2.1.2/.pi/harnesses/lib/system1/config-v2.js +112 -0
  645. package/.versions/2.1.2/.pi/harnesses/lib/system1/config.js +50 -0
  646. package/.versions/2.1.2/.pi/harnesses/lib/system1/contracts.ts +154 -0
  647. package/.versions/2.1.2/.pi/harnesses/lib/system1/demo.ts +95 -0
  648. package/.versions/2.1.2/.pi/harnesses/lib/system1/jev.ts +503 -0
  649. package/.versions/2.1.2/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  650. package/.versions/2.1.2/.pi/harnesses/lib/system1/selection.js +11 -0
  651. package/.versions/2.1.2/.pi/harnesses/lib/system1/service.ts +245 -0
  652. package/.versions/2.1.2/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  653. package/.versions/2.1.2/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  654. package/.versions/2.1.2/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  655. package/.versions/2.1.2/.pi/harnesses/lib/target-capabilities.js +7 -0
  656. package/.versions/2.1.2/.pi/harnesses/lib/update-check.ts +227 -0
  657. package/.versions/2.1.2/.pi/harnesses/lib/workspace-context.js +115 -0
  658. package/.versions/2.1.2/.pi/harnesses/lib/workspace-context.ts +22 -0
  659. package/.versions/2.1.2/.pi/harnesses/package-lock.json +2121 -0
  660. package/.versions/2.1.2/.pi/harnesses/package.json +13 -0
  661. package/.versions/2.1.2/.pi/prompts/af-build.md +27 -0
  662. package/.versions/2.1.2/.pi/prompts/af-code-simplify.md +22 -0
  663. package/.versions/2.1.2/.pi/prompts/af-constraints.md +31 -0
  664. package/.versions/2.1.2/.pi/prompts/af-plan.md +17 -0
  665. package/.versions/2.1.2/.pi/prompts/af-review.md +16 -0
  666. package/.versions/2.1.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  667. package/.versions/2.1.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  668. package/.versions/2.1.2/.pi/prompts/af-setup-rules.md +20 -0
  669. package/.versions/2.1.2/.pi/prompts/af-ship.md +17 -0
  670. package/.versions/2.1.2/.pi/prompts/af-spec.md +15 -0
  671. package/.versions/2.1.2/.pi/prompts/af-test.md +19 -0
  672. package/.versions/2.1.2/.pi/skills/bowser/SKILL.md +145 -0
  673. package/.versions/2.1.2/.version +1 -0
  674. package/.versions/2.1.2/agents/architect.md +24 -0
  675. package/.versions/2.1.2/agents/bowser.md +28 -0
  676. package/.versions/2.1.2/agents/builder.md +55 -0
  677. package/.versions/2.1.2/agents/code-reviewer.md +209 -0
  678. package/.versions/2.1.2/agents/deep-researcher.md +32 -0
  679. package/.versions/2.1.2/agents/documenter.md +22 -0
  680. package/.versions/2.1.2/agents/plan-reviewer.md +83 -0
  681. package/.versions/2.1.2/agents/planner.md +107 -0
  682. package/.versions/2.1.2/agents/releaser.md +24 -0
  683. package/.versions/2.1.2/agents/researcher.md +30 -0
  684. package/.versions/2.1.2/agents/security-auditor.md +167 -0
  685. package/.versions/2.1.2/agents/test-engineer.md +153 -0
  686. package/.versions/2.1.2/agents/web-debugger.md +44 -0
  687. package/.versions/2.1.2/agents/web-performance-auditor.md +194 -0
  688. package/.versions/2.1.2/bin/catalog/harness-runtime-closure.json +85 -0
  689. package/.versions/2.1.2/docs/ARCHITECTURE.md +1195 -0
  690. package/.versions/2.1.2/docs/agent-fleet-setup.md +1143 -0
  691. package/.versions/2.1.2/docs/claude-code-coms-bridge.md +147 -0
  692. package/.versions/2.1.2/docs/codex-local-mcp.md +503 -0
  693. package/.versions/2.1.2/docs/codex-session-bridge.md +44 -0
  694. package/.versions/2.1.2/docs/codex-setup.md +183 -0
  695. package/.versions/2.1.2/docs/coms-hermes-bridge.md +188 -0
  696. package/.versions/2.1.2/docs/fleet-native-voice.md +145 -0
  697. package/.versions/2.1.2/docs/getting-started.md +126 -0
  698. package/.versions/2.1.2/docs/npm-install.md +535 -0
  699. package/.versions/2.1.2/docs/pi-extensions.md +455 -0
  700. package/.versions/2.1.2/docs/pi-setup.md +92 -0
  701. package/.versions/2.1.2/docs/skill-anatomy.md +150 -0
  702. package/.versions/2.1.2/install-manifest.json +3239 -0
  703. package/.versions/2.1.2/justfile +247 -0
  704. package/.versions/2.1.2/manifest-meta.json +1087 -0
  705. package/.versions/2.1.2/references/accessibility-checklist.md +160 -0
  706. package/.versions/2.1.2/references/communication-contract.md +26 -0
  707. package/.versions/2.1.2/references/definition-of-done.md +67 -0
  708. package/.versions/2.1.2/references/fleet-coordination-patterns.md +171 -0
  709. package/.versions/2.1.2/references/observability-checklist.md +92 -0
  710. package/.versions/2.1.2/references/orchestration-patterns.md +370 -0
  711. package/.versions/2.1.2/references/performance-checklist.md +236 -0
  712. package/.versions/2.1.2/references/prompting-patterns.md +380 -0
  713. package/.versions/2.1.2/references/security-checklist.md +245 -0
  714. package/.versions/2.1.2/references/testing-patterns.md +235 -0
  715. package/.versions/2.1.2/references/workflow-authoring.md +304 -0
  716. package/.versions/2.1.2/skills/_internal/grilling.md +59 -0
  717. package/.versions/2.1.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  718. package/.versions/2.1.2/skills/code-review-and-quality/SKILL.md +396 -0
  719. package/.versions/2.1.2/skills/compound-learning/SKILL.md +137 -0
  720. package/.versions/2.1.2/skills/constraint-driven-development/SKILL.md +338 -0
  721. package/.versions/2.1.2/skills/constraint-driven-development/references/floor-guard.md +99 -0
  722. package/.versions/2.1.2/skills/context-engineering/SKILL.md +341 -0
  723. package/.versions/2.1.2/skills/deprecation-and-migration/SKILL.md +247 -0
  724. package/.versions/2.1.2/skills/designing-agents/SKILL.md +394 -0
  725. package/.versions/2.1.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  726. package/.versions/2.1.2/skills/drafting-workflows/SKILL.md +143 -0
  727. package/.versions/2.1.2/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  728. package/.versions/2.1.2/skills/fleet-connect/SKILL.md +25 -0
  729. package/.versions/2.1.2/skills/fleet-native-voice/SKILL.md +87 -0
  730. package/.versions/2.1.2/skills/fleet-native-voice/agents/openai.yaml +4 -0
  731. package/.versions/2.1.2/skills/fleet-native-voice.zip +0 -0
  732. package/.versions/2.1.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  733. package/.versions/2.1.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  734. package/.versions/2.1.2/skills/idea-refine/SKILL.md +182 -0
  735. package/.versions/2.1.2/skills/idea-refine/examples.md +238 -0
  736. package/.versions/2.1.2/skills/idea-refine/frameworks.md +99 -0
  737. package/.versions/2.1.2/skills/idea-refine/refinement-criteria.md +113 -0
  738. package/.versions/2.1.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  739. package/.versions/2.1.2/skills/incremental-implementation/SKILL.md +353 -0
  740. package/.versions/2.1.2/skills/incremental-implementation.zip +0 -0
  741. package/.versions/2.1.2/skills/interview-me/SKILL.md +226 -0
  742. package/.versions/2.1.2/skills/orchestration-verification/SKILL.md +182 -0
  743. package/.versions/2.1.2/skills/peer-coms/SKILL.md +90 -0
  744. package/.versions/2.1.2/skills/performance-optimization/SKILL.md +496 -0
  745. package/.versions/2.1.2/skills/planning-and-task-breakdown/SKILL.md +318 -0
  746. package/.versions/2.1.2/skills/planning-and-task-breakdown.zip +0 -0
  747. package/.versions/2.1.2/skills/repository-ai-setup/SKILL.md +135 -0
  748. package/.versions/2.1.2/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  749. package/.versions/2.1.2/skills/repository-ai-setup/references/apply-contract.md +74 -0
  750. package/.versions/2.1.2/skills/repository-ai-setup/references/provenance-template.md +16 -0
  751. package/.versions/2.1.2/skills/repository-ai-setup/references/setup-flow.md +108 -0
  752. package/.versions/2.1.2/skills/repository-ai-setup/references/verify-setup.md +20 -0
  753. package/.versions/2.1.2/skills/repository-ai-setup.zip +0 -0
  754. package/.versions/2.1.2/skills/security-and-hardening/SKILL.md +524 -0
  755. package/.versions/2.1.2/skills/spec-driven-development/SKILL.md +295 -0
  756. package/.versions/2.1.2/skills/spec-driven-development.zip +0 -0
  757. package/.versions/2.1.2/skills/using-agent-skills/SKILL.md +198 -0
  758. package/.versions/2.1.2/vendor/agent-skills-upstream/LICENSE +21 -0
  759. package/.versions/2.1.2/vendor/agent-skills-upstream/README.md +430 -0
  760. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  761. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  762. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  763. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  764. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  765. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  766. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  767. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  768. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  769. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  770. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  771. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  772. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  773. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  774. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  775. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  776. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  777. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  778. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  779. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  780. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  781. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  782. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  783. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  784. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  785. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  786. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  787. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  788. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  789. package/.versions/2.1.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  790. package/.versions/2.2.0/.pi/agent-fleet/hermes/README.md +347 -0
  791. package/.versions/2.2.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  792. package/.versions/2.2.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  793. package/.versions/2.2.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  794. package/.versions/2.2.0/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  795. package/.versions/2.2.0/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  796. package/.versions/2.2.0/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  797. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  798. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  799. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  800. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  801. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  802. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  803. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  804. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  805. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  806. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  807. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  808. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  809. package/.versions/2.2.0/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  810. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  811. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  812. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  813. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  814. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  815. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  816. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  817. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  818. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  819. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  820. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  821. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  822. package/.versions/2.2.0/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  823. package/.versions/2.2.0/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  824. package/.versions/2.2.0/.pi/agent-fleet/hooks/coms-stop-hook.mjs +124 -0
  825. package/.versions/2.2.0/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  826. package/.versions/2.2.0/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  827. package/.versions/2.2.0/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  828. package/.versions/2.2.0/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  829. package/.versions/2.2.0/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  830. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/0.167-shared.json +1900 -0
  831. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/README.md +223 -0
  832. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/assessment.md +83 -0
  833. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile-0.167.json +5627 -0
  834. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile.md +43 -0
  835. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap.md +45 -0
  836. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture-profile.ts +53 -0
  837. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture.ts +102 -0
  838. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/catalog.md +91 -0
  839. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/channel.md +21 -0
  840. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurement.md +133 -0
  841. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurements.json +74 -0
  842. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/notification-profile-0.167.json +2679 -0
  843. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/observer.md +101 -0
  844. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/opaque-response.md +57 -0
  845. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/open-sent.md +68 -0
  846. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/probe-reader.md +51 -0
  847. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/profile.md +71 -0
  848. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/projection.md +147 -0
  849. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/reconnect.md +40 -0
  850. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/response-unions.md +74 -0
  851. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/semver.md +124 -0
  852. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/surface.md +73 -0
  853. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  854. package/.versions/2.2.0/.pi/agent-fleet/scripts/fixtures/response-fixture.ts +23 -0
  855. package/.versions/2.2.0/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  856. package/.versions/2.2.0/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +63 -0
  857. package/.versions/2.2.0/.pi/agent-fleet/scripts/fleet.ts +244 -0
  858. package/.versions/2.2.0/.pi/agent-fleet/scripts/flow.ts +166 -0
  859. package/.versions/2.2.0/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  860. package/.versions/2.2.0/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  861. package/.versions/2.2.0/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  862. package/.versions/2.2.0/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  863. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  864. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-bootstrap-files.ts +46 -0
  865. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-bootstrap-probe.ts +44 -0
  866. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-bootstrap-producer.ts +131 -0
  867. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-daemon-observer.ts +137 -0
  868. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-desktop-discovery.ts +84 -0
  869. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-desktop-preflight.ts +130 -0
  870. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +113 -0
  871. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-measurement.ts +218 -0
  872. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-native-presence.ts +61 -0
  873. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-probe-transcript.ts +135 -0
  874. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-send-lineage.ts +72 -0
  875. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +101 -0
  876. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  877. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  878. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +453 -0
  879. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  880. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  881. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  882. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-bootstrap.ts +204 -0
  883. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +76 -0
  884. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  885. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +132 -0
  886. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  887. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  888. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +175 -0
  889. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +435 -0
  890. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  891. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  892. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  893. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  894. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  895. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +44 -0
  896. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  897. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  898. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  899. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
  900. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
  901. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  902. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/fleet-command.ts +264 -0
  903. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  904. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +239 -0
  905. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  906. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  907. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  908. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  909. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  910. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  911. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  912. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  913. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  914. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  915. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  916. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  917. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  918. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  919. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  920. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  921. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  922. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/team-project.ts +176 -0
  923. package/.versions/2.2.0/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  924. package/.versions/2.2.0/.pi/agent-fleet/scripts/package-lock.json +57 -0
  925. package/.versions/2.2.0/.pi/agent-fleet/scripts/package.json +10 -0
  926. package/.versions/2.2.0/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  927. package/.versions/2.2.0/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  928. package/.versions/2.2.0/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  929. package/.versions/2.2.0/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  930. package/.versions/2.2.0/.pi/agent-fleet/scripts/team-up.ts +378 -0
  931. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  932. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  933. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  934. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  935. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  936. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  937. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/git.ts +108 -0
  938. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  939. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  940. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  941. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  942. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  943. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  944. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  945. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  946. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/quality.ts +78 -0
  947. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  948. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  949. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  950. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  951. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  952. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  953. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  954. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  955. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  956. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  957. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  958. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  959. package/.versions/2.2.0/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  960. package/.versions/2.2.0/.pi/agents/dispatch-policy.yaml +32 -0
  961. package/.versions/2.2.0/.pi/agents/model-profiles.yaml +132 -0
  962. package/.versions/2.2.0/.pi/agents/peers.yaml +147 -0
  963. package/.versions/2.2.0/.pi/agents/teams.yaml +41 -0
  964. package/.versions/2.2.0/.pi/agents/voices.yaml +13 -0
  965. package/.versions/2.2.0/.pi/damage-control-rules.yaml +297 -0
  966. package/.versions/2.2.0/.pi/extensions/btw/README.md +120 -0
  967. package/.versions/2.2.0/.pi/extensions/btw/index.ts +916 -0
  968. package/.versions/2.2.0/.pi/extensions/btw/package.json +6 -0
  969. package/.versions/2.2.0/.pi/extensions/btw/state.js +179 -0
  970. package/.versions/2.2.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  971. package/.versions/2.2.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  972. package/.versions/2.2.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  973. package/.versions/2.2.0/.pi/extensions/compact-and-continue/README.md +42 -0
  974. package/.versions/2.2.0/.pi/extensions/compact-and-continue/index.ts +136 -0
  975. package/.versions/2.2.0/.pi/extensions/compact-and-continue/package.json +6 -0
  976. package/.versions/2.2.0/.pi/extensions/mcp-bridge/README.md +46 -0
  977. package/.versions/2.2.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  978. package/.versions/2.2.0/.pi/extensions/mcp-bridge/package.json +6 -0
  979. package/.versions/2.2.0/.pi/extensions/package-lock.json +1175 -0
  980. package/.versions/2.2.0/.pi/extensions/package.json +9 -0
  981. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/README.md +224 -0
  982. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/config.ts +199 -0
  983. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  984. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  985. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  986. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  987. package/.versions/2.2.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  988. package/.versions/2.2.0/.pi/harnesses/agent-hub/README.md +1633 -0
  989. package/.versions/2.2.0/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  990. package/.versions/2.2.0/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  991. package/.versions/2.2.0/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  992. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  993. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  994. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  995. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  996. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  997. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  998. package/.versions/2.2.0/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  999. package/.versions/2.2.0/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  1000. package/.versions/2.2.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  1001. package/.versions/2.2.0/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  1002. package/.versions/2.2.0/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  1003. package/.versions/2.2.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  1004. package/.versions/2.2.0/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  1005. package/.versions/2.2.0/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  1006. package/.versions/2.2.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  1007. package/.versions/2.2.0/.pi/harnesses/agent-hub/capability-packs.ts +187 -0
  1008. package/.versions/2.2.0/.pi/harnesses/agent-hub/codex-bootstrap.ts +117 -0
  1009. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  1010. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  1011. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  1012. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  1013. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  1014. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  1015. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  1016. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  1017. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  1018. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  1019. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  1020. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  1021. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  1022. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  1023. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  1024. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  1025. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  1026. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  1027. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  1028. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  1029. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  1030. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  1031. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  1032. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/recover.ts +62 -0
  1033. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  1034. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  1035. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  1036. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  1037. package/.versions/2.2.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  1038. package/.versions/2.2.0/.pi/harnesses/agent-hub/config/agents.ts +183 -0
  1039. package/.versions/2.2.0/.pi/harnesses/agent-hub/config/model-profiles.ts +240 -0
  1040. package/.versions/2.2.0/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  1041. package/.versions/2.2.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  1042. package/.versions/2.2.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +234 -0
  1043. package/.versions/2.2.0/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  1044. package/.versions/2.2.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  1045. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  1046. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  1047. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  1048. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  1049. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  1050. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  1051. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  1052. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  1053. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity-compat.ts +45 -0
  1054. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  1055. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  1056. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  1057. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  1058. package/.versions/2.2.0/.pi/harnesses/agent-hub/context-window.js +108 -0
  1059. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  1060. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  1061. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  1062. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  1063. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  1064. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  1065. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  1066. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  1067. package/.versions/2.2.0/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  1068. package/.versions/2.2.0/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  1069. package/.versions/2.2.0/.pi/harnesses/agent-hub/delegate.ts +478 -0
  1070. package/.versions/2.2.0/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  1071. package/.versions/2.2.0/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  1072. package/.versions/2.2.0/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  1073. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  1074. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  1075. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  1076. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +318 -0
  1077. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +264 -0
  1078. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +297 -0
  1079. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-native.ts +242 -0
  1080. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  1081. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  1082. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  1083. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  1084. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  1085. package/.versions/2.2.0/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  1086. package/.versions/2.2.0/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  1087. package/.versions/2.2.0/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  1088. package/.versions/2.2.0/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  1089. package/.versions/2.2.0/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  1090. package/.versions/2.2.0/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  1091. package/.versions/2.2.0/.pi/harnesses/agent-hub/drift-watchdog.js +344 -0
  1092. package/.versions/2.2.0/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  1093. package/.versions/2.2.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  1094. package/.versions/2.2.0/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  1095. package/.versions/2.2.0/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  1096. package/.versions/2.2.0/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  1097. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  1098. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  1099. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  1100. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  1101. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  1102. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  1103. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  1104. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  1105. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  1106. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  1107. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  1108. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  1109. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  1110. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  1111. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  1112. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  1113. package/.versions/2.2.0/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  1114. package/.versions/2.2.0/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  1115. package/.versions/2.2.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  1116. package/.versions/2.2.0/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  1117. package/.versions/2.2.0/.pi/harnesses/agent-hub/footer.ts +29 -0
  1118. package/.versions/2.2.0/.pi/harnesses/agent-hub/helpers.ts +269 -0
  1119. package/.versions/2.2.0/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  1120. package/.versions/2.2.0/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  1121. package/.versions/2.2.0/.pi/harnesses/agent-hub/index.ts +2722 -0
  1122. package/.versions/2.2.0/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  1123. package/.versions/2.2.0/.pi/harnesses/agent-hub/input/shortcuts.ts +16 -0
  1124. package/.versions/2.2.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  1125. package/.versions/2.2.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  1126. package/.versions/2.2.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  1127. package/.versions/2.2.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  1128. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  1129. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  1130. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  1131. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  1132. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  1133. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  1134. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  1135. package/.versions/2.2.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  1136. package/.versions/2.2.0/.pi/harnesses/agent-hub/no-progress.ts +627 -0
  1137. package/.versions/2.2.0/.pi/harnesses/agent-hub/operator-current-state.ts +57 -0
  1138. package/.versions/2.2.0/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  1139. package/.versions/2.2.0/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  1140. package/.versions/2.2.0/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  1141. package/.versions/2.2.0/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  1142. package/.versions/2.2.0/.pi/harnesses/agent-hub/package.json +7 -0
  1143. package/.versions/2.2.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  1144. package/.versions/2.2.0/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  1145. package/.versions/2.2.0/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  1146. package/.versions/2.2.0/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  1147. package/.versions/2.2.0/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  1148. package/.versions/2.2.0/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  1149. package/.versions/2.2.0/.pi/harnesses/agent-hub/policy/roster.ts +103 -0
  1150. package/.versions/2.2.0/.pi/harnesses/agent-hub/policy/work-mode.ts +103 -0
  1151. package/.versions/2.2.0/.pi/harnesses/agent-hub/poll-command.ts +184 -0
  1152. package/.versions/2.2.0/.pi/harnesses/agent-hub/presentation.ts +54 -0
  1153. package/.versions/2.2.0/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  1154. package/.versions/2.2.0/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  1155. package/.versions/2.2.0/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  1156. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  1157. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  1158. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  1159. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  1160. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  1161. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  1162. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  1163. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  1164. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  1165. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  1166. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  1167. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  1168. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-snapshot.ts +287 -0
  1169. package/.versions/2.2.0/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  1170. package/.versions/2.2.0/.pi/harnesses/agent-hub/process-obligations.ts +210 -0
  1171. package/.versions/2.2.0/.pi/harnesses/agent-hub/prompts/context.ts +72 -0
  1172. package/.versions/2.2.0/.pi/harnesses/agent-hub/prompts/fragments.ts +94 -0
  1173. package/.versions/2.2.0/.pi/harnesses/agent-hub/prompts/session-start.ts +89 -0
  1174. package/.versions/2.2.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +142 -0
  1175. package/.versions/2.2.0/.pi/harnesses/agent-hub/provider-semaphore.js +143 -0
  1176. package/.versions/2.2.0/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  1177. package/.versions/2.2.0/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  1178. package/.versions/2.2.0/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  1179. package/.versions/2.2.0/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  1180. package/.versions/2.2.0/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  1181. package/.versions/2.2.0/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  1182. package/.versions/2.2.0/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  1183. package/.versions/2.2.0/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  1184. package/.versions/2.2.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  1185. package/.versions/2.2.0/.pi/harnesses/agent-hub/return-contract.js +371 -0
  1186. package/.versions/2.2.0/.pi/harnesses/agent-hub/return-extract.js +77 -0
  1187. package/.versions/2.2.0/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  1188. package/.versions/2.2.0/.pi/harnesses/agent-hub/review-continuity.ts +76 -0
  1189. package/.versions/2.2.0/.pi/harnesses/agent-hub/review-findings.js +96 -0
  1190. package/.versions/2.2.0/.pi/harnesses/agent-hub/review-reuse.ts +48 -0
  1191. package/.versions/2.2.0/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  1192. package/.versions/2.2.0/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  1193. package/.versions/2.2.0/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  1194. package/.versions/2.2.0/.pi/harnesses/agent-hub/run-budget.js +362 -0
  1195. package/.versions/2.2.0/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  1196. package/.versions/2.2.0/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  1197. package/.versions/2.2.0/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  1198. package/.versions/2.2.0/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  1199. package/.versions/2.2.0/.pi/harnesses/agent-hub/scope-gate.js +271 -0
  1200. package/.versions/2.2.0/.pi/harnesses/agent-hub/scope-overlap.ts +46 -0
  1201. package/.versions/2.2.0/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  1202. package/.versions/2.2.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  1203. package/.versions/2.2.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  1204. package/.versions/2.2.0/.pi/harnesses/agent-hub/spawn.ts +702 -0
  1205. package/.versions/2.2.0/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  1206. package/.versions/2.2.0/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  1207. package/.versions/2.2.0/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  1208. package/.versions/2.2.0/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  1209. package/.versions/2.2.0/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  1210. package/.versions/2.2.0/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  1211. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-brief.ts +98 -0
  1212. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  1213. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  1214. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  1215. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  1216. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  1217. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  1218. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  1219. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  1220. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  1221. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  1222. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  1223. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  1224. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  1225. package/.versions/2.2.0/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  1226. package/.versions/2.2.0/.pi/harnesses/agent-hub/timeline.ts +72 -0
  1227. package/.versions/2.2.0/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +83 -0
  1228. package/.versions/2.2.0/.pi/harnesses/agent-hub/tool-catalog-state.ts +125 -0
  1229. package/.versions/2.2.0/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  1230. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  1231. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  1232. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  1233. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  1234. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/context.ts +149 -0
  1235. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +93 -0
  1236. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +928 -0
  1237. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  1238. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  1239. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  1240. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  1241. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/poll-panel-core.ts +30 -0
  1242. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/poll-panel.ts +33 -0
  1243. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/run-flow.ts +177 -0
  1244. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  1245. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  1246. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  1247. package/.versions/2.2.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  1248. package/.versions/2.2.0/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  1249. package/.versions/2.2.0/.pi/harnesses/agent-hub/types.ts +66 -0
  1250. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  1251. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  1252. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  1253. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  1254. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +173 -0
  1255. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  1256. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  1257. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  1258. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  1259. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  1260. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  1261. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  1262. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  1263. package/.versions/2.2.0/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  1264. package/.versions/2.2.0/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  1265. package/.versions/2.2.0/.pi/harnesses/agent-hub/version.ts +42 -0
  1266. package/.versions/2.2.0/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  1267. package/.versions/2.2.0/.pi/harnesses/agent-hub/work-mode.ts +183 -0
  1268. package/.versions/2.2.0/.pi/harnesses/agent-hub/write-isolation.ts +232 -0
  1269. package/.versions/2.2.0/.pi/harnesses/ask-user-remote/README.md +59 -0
  1270. package/.versions/2.2.0/.pi/harnesses/ask-user-remote/index.ts +571 -0
  1271. package/.versions/2.2.0/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  1272. package/.versions/2.2.0/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  1273. package/.versions/2.2.0/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  1274. package/.versions/2.2.0/.pi/harnesses/coms/README.md +105 -0
  1275. package/.versions/2.2.0/.pi/harnesses/coms/index.ts +308 -0
  1276. package/.versions/2.2.0/.pi/harnesses/coms/package.json +7 -0
  1277. package/.versions/2.2.0/.pi/harnesses/coms/version.ts +42 -0
  1278. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/README.md +161 -0
  1279. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/index.ts +659 -0
  1280. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  1281. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  1282. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  1283. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  1284. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  1285. package/.versions/2.2.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  1286. package/.versions/2.2.0/.pi/harnesses/lib/approval-wait.ts +17 -0
  1287. package/.versions/2.2.0/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  1288. package/.versions/2.2.0/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  1289. package/.versions/2.2.0/.pi/harnesses/lib/clarification-policy.ts +9 -0
  1290. package/.versions/2.2.0/.pi/harnesses/lib/codex-compat.ts +97 -0
  1291. package/.versions/2.2.0/.pi/harnesses/lib/codex-contract.ts +259 -0
  1292. package/.versions/2.2.0/.pi/harnesses/lib/codex-notification-profile.ts +75 -0
  1293. package/.versions/2.2.0/.pi/harnesses/lib/coms-core-io.ts +422 -0
  1294. package/.versions/2.2.0/.pi/harnesses/lib/coms-core.ts +738 -0
  1295. package/.versions/2.2.0/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  1296. package/.versions/2.2.0/.pi/harnesses/lib/coms-observation.ts +74 -0
  1297. package/.versions/2.2.0/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  1298. package/.versions/2.2.0/.pi/harnesses/lib/coms-response-read.ts +107 -0
  1299. package/.versions/2.2.0/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  1300. package/.versions/2.2.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +124 -0
  1301. package/.versions/2.2.0/.pi/harnesses/lib/context-budget-view.ts +112 -0
  1302. package/.versions/2.2.0/.pi/harnesses/lib/context-budget.ts +114 -0
  1303. package/.versions/2.2.0/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  1304. package/.versions/2.2.0/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  1305. package/.versions/2.2.0/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  1306. package/.versions/2.2.0/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  1307. package/.versions/2.2.0/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  1308. package/.versions/2.2.0/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  1309. package/.versions/2.2.0/.pi/harnesses/lib/damage-policy.ts +35 -0
  1310. package/.versions/2.2.0/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  1311. package/.versions/2.2.0/.pi/harnesses/lib/damage-result-view.ts +16 -0
  1312. package/.versions/2.2.0/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  1313. package/.versions/2.2.0/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  1314. package/.versions/2.2.0/.pi/harnesses/lib/execution-trace.ts +45 -0
  1315. package/.versions/2.2.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  1316. package/.versions/2.2.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  1317. package/.versions/2.2.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  1318. package/.versions/2.2.0/.pi/harnesses/lib/fleet-bootstrap-channel.ts +148 -0
  1319. package/.versions/2.2.0/.pi/harnesses/lib/fleet-codex-catalog.ts +30 -0
  1320. package/.versions/2.2.0/.pi/harnesses/lib/fleet-codex-chat-view.ts +43 -0
  1321. package/.versions/2.2.0/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  1322. package/.versions/2.2.0/.pi/harnesses/lib/fleet-codex-namespace.ts +2 -0
  1323. package/.versions/2.2.0/.pi/harnesses/lib/fleet-codex-policy-snapshot.ts +10 -0
  1324. package/.versions/2.2.0/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  1325. package/.versions/2.2.0/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  1326. package/.versions/2.2.0/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  1327. package/.versions/2.2.0/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  1328. package/.versions/2.2.0/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  1329. package/.versions/2.2.0/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  1330. package/.versions/2.2.0/.pi/harnesses/lib/fleet-connection-control.ts +94 -0
  1331. package/.versions/2.2.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  1332. package/.versions/2.2.0/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  1333. package/.versions/2.2.0/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  1334. package/.versions/2.2.0/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  1335. package/.versions/2.2.0/.pi/harnesses/lib/fleet-notification-admission.ts +32 -0
  1336. package/.versions/2.2.0/.pi/harnesses/lib/fleet-notification-bootstrap.ts +152 -0
  1337. package/.versions/2.2.0/.pi/harnesses/lib/fleet-notification-validation.ts +122 -0
  1338. package/.versions/2.2.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  1339. package/.versions/2.2.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  1340. package/.versions/2.2.0/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  1341. package/.versions/2.2.0/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  1342. package/.versions/2.2.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  1343. package/.versions/2.2.0/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  1344. package/.versions/2.2.0/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  1345. package/.versions/2.2.0/.pi/harnesses/lib/fleet-target-identity.ts +9 -0
  1346. package/.versions/2.2.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  1347. package/.versions/2.2.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  1348. package/.versions/2.2.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  1349. package/.versions/2.2.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  1350. package/.versions/2.2.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  1351. package/.versions/2.2.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  1352. package/.versions/2.2.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  1353. package/.versions/2.2.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  1354. package/.versions/2.2.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  1355. package/.versions/2.2.0/.pi/harnesses/lib/identical-dialog.ts +27 -0
  1356. package/.versions/2.2.0/.pi/harnesses/lib/installation-state.js +62 -0
  1357. package/.versions/2.2.0/.pi/harnesses/lib/peer-target.ts +24 -0
  1358. package/.versions/2.2.0/.pi/harnesses/lib/policy-roots.js +117 -0
  1359. package/.versions/2.2.0/.pi/harnesses/lib/policy-roots.ts +32 -0
  1360. package/.versions/2.2.0/.pi/harnesses/lib/process-shared.ts +9 -0
  1361. package/.versions/2.2.0/.pi/harnesses/lib/resource-closure.js +26 -0
  1362. package/.versions/2.2.0/.pi/harnesses/lib/safe-source-read.js +29 -0
  1363. package/.versions/2.2.0/.pi/harnesses/lib/semantic-approval.ts +80 -0
  1364. package/.versions/2.2.0/.pi/harnesses/lib/session-target.ts +62 -0
  1365. package/.versions/2.2.0/.pi/harnesses/lib/spawned-peers.js +191 -0
  1366. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  1367. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  1368. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  1369. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  1370. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-json.js +37 -0
  1371. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-loader.js +53 -0
  1372. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  1373. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-triage.js +42 -0
  1374. package/.versions/2.2.0/.pi/harnesses/lib/system1/config-v2.js +112 -0
  1375. package/.versions/2.2.0/.pi/harnesses/lib/system1/config.js +50 -0
  1376. package/.versions/2.2.0/.pi/harnesses/lib/system1/contracts.ts +154 -0
  1377. package/.versions/2.2.0/.pi/harnesses/lib/system1/demo.ts +95 -0
  1378. package/.versions/2.2.0/.pi/harnesses/lib/system1/jev.ts +503 -0
  1379. package/.versions/2.2.0/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  1380. package/.versions/2.2.0/.pi/harnesses/lib/system1/selection.js +11 -0
  1381. package/.versions/2.2.0/.pi/harnesses/lib/system1/service.ts +245 -0
  1382. package/.versions/2.2.0/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  1383. package/.versions/2.2.0/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  1384. package/.versions/2.2.0/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  1385. package/.versions/2.2.0/.pi/harnesses/lib/target-capabilities.js +7 -0
  1386. package/.versions/2.2.0/.pi/harnesses/lib/update-check.ts +227 -0
  1387. package/.versions/2.2.0/.pi/harnesses/lib/workspace-context.js +115 -0
  1388. package/.versions/2.2.0/.pi/harnesses/lib/workspace-context.ts +22 -0
  1389. package/.versions/2.2.0/.pi/harnesses/package-lock.json +2121 -0
  1390. package/.versions/2.2.0/.pi/harnesses/package.json +13 -0
  1391. package/.versions/2.2.0/.pi/prompts/af-build.md +27 -0
  1392. package/.versions/2.2.0/.pi/prompts/af-code-simplify.md +22 -0
  1393. package/.versions/2.2.0/.pi/prompts/af-constraints.md +31 -0
  1394. package/.versions/2.2.0/.pi/prompts/af-plan.md +17 -0
  1395. package/.versions/2.2.0/.pi/prompts/af-review.md +16 -0
  1396. package/.versions/2.2.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  1397. package/.versions/2.2.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  1398. package/.versions/2.2.0/.pi/prompts/af-setup-rules.md +20 -0
  1399. package/.versions/2.2.0/.pi/prompts/af-ship.md +17 -0
  1400. package/.versions/2.2.0/.pi/prompts/af-spec.md +15 -0
  1401. package/.versions/2.2.0/.pi/prompts/af-test.md +19 -0
  1402. package/.versions/2.2.0/.pi/skills/bowser/SKILL.md +145 -0
  1403. package/.versions/2.2.0/.version +1 -0
  1404. package/.versions/2.2.0/agents/architect.md +24 -0
  1405. package/.versions/2.2.0/agents/bowser.md +28 -0
  1406. package/.versions/2.2.0/agents/builder.md +55 -0
  1407. package/.versions/2.2.0/agents/code-reviewer.md +209 -0
  1408. package/.versions/2.2.0/agents/deep-researcher.md +32 -0
  1409. package/.versions/2.2.0/agents/documenter.md +22 -0
  1410. package/.versions/2.2.0/agents/plan-reviewer.md +83 -0
  1411. package/.versions/2.2.0/agents/planner.md +107 -0
  1412. package/.versions/2.2.0/agents/releaser.md +24 -0
  1413. package/.versions/2.2.0/agents/researcher.md +30 -0
  1414. package/.versions/2.2.0/agents/security-auditor.md +167 -0
  1415. package/.versions/2.2.0/agents/test-engineer.md +153 -0
  1416. package/.versions/2.2.0/agents/web-debugger.md +44 -0
  1417. package/.versions/2.2.0/agents/web-performance-auditor.md +194 -0
  1418. package/.versions/2.2.0/bin/catalog/harness-runtime-closure.json +85 -0
  1419. package/.versions/2.2.0/docs/ARCHITECTURE.md +1291 -0
  1420. package/.versions/2.2.0/docs/agent-fleet-setup.md +1161 -0
  1421. package/.versions/2.2.0/docs/claude-code-coms-bridge.md +147 -0
  1422. package/.versions/2.2.0/docs/codex-local-mcp.md +520 -0
  1423. package/.versions/2.2.0/docs/codex-session-bridge.md +44 -0
  1424. package/.versions/2.2.0/docs/codex-setup.md +183 -0
  1425. package/.versions/2.2.0/docs/coms-hermes-bridge.md +188 -0
  1426. package/.versions/2.2.0/docs/fleet-native-voice.md +151 -0
  1427. package/.versions/2.2.0/docs/getting-started.md +126 -0
  1428. package/.versions/2.2.0/docs/npm-install.md +535 -0
  1429. package/.versions/2.2.0/docs/pi-extensions.md +450 -0
  1430. package/.versions/2.2.0/docs/pi-setup.md +92 -0
  1431. package/.versions/2.2.0/docs/skill-anatomy.md +150 -0
  1432. package/.versions/2.2.0/install-manifest.json +3226 -0
  1433. package/.versions/2.2.0/justfile +246 -0
  1434. package/.versions/2.2.0/manifest-meta.json +1098 -0
  1435. package/.versions/2.2.0/references/accessibility-checklist.md +160 -0
  1436. package/.versions/2.2.0/references/communication-contract.md +26 -0
  1437. package/.versions/2.2.0/references/definition-of-done.md +67 -0
  1438. package/.versions/2.2.0/references/fleet-coordination-patterns.md +171 -0
  1439. package/.versions/2.2.0/references/observability-checklist.md +92 -0
  1440. package/.versions/2.2.0/references/orchestration-patterns.md +370 -0
  1441. package/.versions/2.2.0/references/performance-checklist.md +236 -0
  1442. package/.versions/2.2.0/references/prompting-patterns.md +380 -0
  1443. package/.versions/2.2.0/references/security-checklist.md +245 -0
  1444. package/.versions/2.2.0/references/testing-patterns.md +235 -0
  1445. package/.versions/2.2.0/references/workflow-authoring.md +304 -0
  1446. package/.versions/2.2.0/skills/_internal/grilling.md +59 -0
  1447. package/.versions/2.2.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  1448. package/.versions/2.2.0/skills/code-review-and-quality/SKILL.md +396 -0
  1449. package/.versions/2.2.0/skills/compound-learning/SKILL.md +137 -0
  1450. package/.versions/2.2.0/skills/constraint-driven-development/SKILL.md +338 -0
  1451. package/.versions/2.2.0/skills/constraint-driven-development/references/floor-guard.md +99 -0
  1452. package/.versions/2.2.0/skills/context-engineering/SKILL.md +341 -0
  1453. package/.versions/2.2.0/skills/deprecation-and-migration/SKILL.md +247 -0
  1454. package/.versions/2.2.0/skills/designing-agents/SKILL.md +394 -0
  1455. package/.versions/2.2.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  1456. package/.versions/2.2.0/skills/drafting-workflows/SKILL.md +143 -0
  1457. package/.versions/2.2.0/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  1458. package/.versions/2.2.0/skills/fleet-connect/SKILL.md +29 -0
  1459. package/.versions/2.2.0/skills/fleet-connect.zip +0 -0
  1460. package/.versions/2.2.0/skills/fleet-native-voice/SKILL.md +103 -0
  1461. package/.versions/2.2.0/skills/fleet-native-voice/agents/openai.yaml +4 -0
  1462. package/.versions/2.2.0/skills/fleet-native-voice.zip +0 -0
  1463. package/.versions/2.2.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  1464. package/.versions/2.2.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  1465. package/.versions/2.2.0/skills/idea-refine/SKILL.md +182 -0
  1466. package/.versions/2.2.0/skills/idea-refine/examples.md +238 -0
  1467. package/.versions/2.2.0/skills/idea-refine/frameworks.md +99 -0
  1468. package/.versions/2.2.0/skills/idea-refine/refinement-criteria.md +113 -0
  1469. package/.versions/2.2.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  1470. package/.versions/2.2.0/skills/incremental-implementation/SKILL.md +353 -0
  1471. package/.versions/2.2.0/skills/incremental-implementation.zip +0 -0
  1472. package/.versions/2.2.0/skills/interview-me/SKILL.md +226 -0
  1473. package/.versions/2.2.0/skills/orchestration-verification/SKILL.md +182 -0
  1474. package/.versions/2.2.0/skills/peer-coms/SKILL.md +90 -0
  1475. package/.versions/2.2.0/skills/performance-optimization/SKILL.md +496 -0
  1476. package/.versions/2.2.0/skills/planning-and-task-breakdown/SKILL.md +318 -0
  1477. package/.versions/2.2.0/skills/planning-and-task-breakdown.zip +0 -0
  1478. package/.versions/2.2.0/skills/repository-ai-setup/SKILL.md +135 -0
  1479. package/.versions/2.2.0/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  1480. package/.versions/2.2.0/skills/repository-ai-setup/references/apply-contract.md +74 -0
  1481. package/.versions/2.2.0/skills/repository-ai-setup/references/provenance-template.md +16 -0
  1482. package/.versions/2.2.0/skills/repository-ai-setup/references/setup-flow.md +108 -0
  1483. package/.versions/2.2.0/skills/repository-ai-setup/references/verify-setup.md +20 -0
  1484. package/.versions/2.2.0/skills/repository-ai-setup.zip +0 -0
  1485. package/.versions/2.2.0/skills/security-and-hardening/SKILL.md +524 -0
  1486. package/.versions/2.2.0/skills/spec-driven-development/SKILL.md +295 -0
  1487. package/.versions/2.2.0/skills/spec-driven-development.zip +0 -0
  1488. package/.versions/2.2.0/skills/using-agent-skills/SKILL.md +198 -0
  1489. package/.versions/2.2.0/vendor/agent-skills-upstream/LICENSE +21 -0
  1490. package/.versions/2.2.0/vendor/agent-skills-upstream/README.md +430 -0
  1491. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  1492. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  1493. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  1494. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  1495. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  1496. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  1497. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  1498. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  1499. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  1500. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  1501. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  1502. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  1503. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  1504. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  1505. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  1506. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  1507. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  1508. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  1509. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  1510. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  1511. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  1512. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  1513. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  1514. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  1515. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  1516. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  1517. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  1518. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  1519. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  1520. package/.versions/2.2.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  1521. package/CHANGELOG.md +40 -0
  1522. package/README.md +7 -10
  1523. package/bin/lib/set-codex-mcp.js +1 -1
  1524. package/bin/lib/validate-overrides.js +8 -1
  1525. package/docs/ARCHITECTURE.md +130 -26
  1526. package/docs/MIGRATION-agent-fleet.md +26 -5
  1527. package/docs/agent-fleet-setup.md +44 -26
  1528. package/docs/claude-code-coms-bridge.md +1 -1
  1529. package/docs/codex-local-mcp.md +44 -11
  1530. package/docs/codex-session-bridge.md +2 -2
  1531. package/docs/codex-setup.md +1 -1
  1532. package/docs/fleet-native-voice.md +18 -4
  1533. package/docs/npm-install.md +1 -1
  1534. package/docs/pi-extensions.md +13 -18
  1535. package/docs/system1-agentic.md +1 -1
  1536. package/docs/system1-context-continuity.md +11 -5
  1537. package/docs/system1-file-discovery.md +2 -2
  1538. package/docs/workflows.md +24 -1
  1539. package/install-manifest.json +15 -28
  1540. package/justfile +3 -4
  1541. package/manifest-meta.json +13 -2
  1542. package/package.json +4 -2
  1543. package/skills/fleet-connect/SKILL.md +20 -16
  1544. package/skills/fleet-connect.zip +0 -0
  1545. package/skills/fleet-native-voice.zip +0 -0
  1546. /package/{.pi → .versions/2.1.2/.pi}/harnesses/agent-hub/commands/work-mode.ts +0 -0
  1547. /package/{.pi → .versions/2.1.2/.pi}/harnesses/agent-hub/work-mode-controls.ts +0 -0
  1548. /package/{agents → .versions/2.1.2/agents}/orchestrator.md +0 -0
@@ -0,0 +1,1143 @@
1
+ # Agent Fleet — Project Files
2
+
3
+ With an external Fleet workspace, these files remain under `af`, not under the selected
4
+ application worktree. See [launch, consent, and resume](session-worktree-targeting.md).
5
+
6
+ agent-fleet keeps a few small files in a project's `.ai/` directory. They have
7
+ different readers and different lifetimes, so they are kept separate.
8
+
9
+ | File | Read by | When |
10
+ |------|---------|------|
11
+ | `.ai/agent-fleet-overrides.md` | `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`, `git-workflow-and-versioning`, `compound-learning` (the `rules:`/`docs:` keys of `## agent-hub`), `agent-hub` pi harness | Every run of those skills / every session start of the harness |
12
+ | `.ai/agent-fleet.json` | the deterministic `agent-fleet` lifecycle (`setup`) — human-owned desired state (preset/features); intended to be committed | Every setup plan; created/updated when setup persists desired state or migrates legacy installs |
13
+ | `.ai/agent-fleet-state.json` | the deterministic `agent-fleet` lifecycle (`setup`, `doctor`, `uninstall`) | Every lifecycle plan and apply |
14
+ | `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
15
+ | `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
16
+ | `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
17
+ | `.ai/system1.json` *(optional)* | System 1 shared runtime and doctor | When `system1` is selected directly or through `system1-task-triage` |
18
+ | `consumers.taskTriage` in `.ai/system1.json` *(optional)* | Hub task-triage consumer and doctor | At Hub session start; missing/off/invalid means no new task-triage inference |
19
+ | `consumers.proactiveReview` in `.ai/system1.json` *(optional)* | Hub proactive turn review consumer | At Hub session start; missing means off |
20
+
21
+ The `.ai/system1.json` file is human-owned, non-secret provider configuration.
22
+ Selecting the foundation alone prints its required shape. Consented task-triage
23
+ setup additionally proposes this template when absent, in the same exact-plan
24
+ transaction as the consumer config; existing provider files, including explicit
25
+ off, are preserved. Its `apiKeyEnv` field names a caller-environment variable; it never contains the
26
+ credential itself. See [System 1 configuration](#system-1-configuration).
27
+
28
+ The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
29
+ extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
30
+ **no secrets** — it names the env vars (`apiKeyEnv`, plus the Azure endpoint var) whose values
31
+ live in a gitignored root `.env`. See [pi-voice-stt config](#ai-sttjson) below.
32
+
33
+ Keep them split: the overrides file is loaded into context constantly, so it
34
+ must stay minimal; the install record is read only by the CLI, so it can be
35
+ large.
36
+
37
+ ## Unified Fleet runtime configuration
38
+
39
+ A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
40
+ plus Agent Hub in **operator** work mode, in the current terminal, with no native
41
+ specialists active:
42
+
43
+ ```bash
44
+ just fleet
45
+ just fleet --project af
46
+ ```
47
+
48
+ Work mode, native roster, and peer topology are separate controls:
49
+
50
+ ```bash
51
+ # Direct tools plus an available native roster.
52
+ just fleet --work-mode operator --agents frontend --project af
53
+
54
+ # A roster implies orchestrator when work mode is not explicit.
55
+ just fleet --agents frontend --project af
56
+
57
+ # Herdr Hub-only and Hub-plus-peer topologies.
58
+ just fleet --herdr --project af
59
+ just fleet --agents frontend --peers frontend --project af
60
+ ```
61
+
62
+ Startup precedence is deterministic: explicit `--work-mode` wins; otherwise an
63
+ explicit `--agents` roster implies `orchestrator`; otherwise work mode is
64
+ `operator`. An orchestrator startup must name a roster. `--herdr` affects only
65
+ placement, while `--peers <preset>` implies Herdr and starts the selected peer
66
+ preset. Neither topology option selects a native roster.
67
+
68
+ `--project <name>` selects one coms namespace for the Hub and every standing or
69
+ dynamically spawned peer. Dynamic peer tools deliberately expose no project
70
+ override, so an agent cannot cross that boundary. The default project is
71
+ `default`; use an explicit project when multiple fleets share a machine.
72
+
73
+ The configuration files have distinct ownership:
74
+
75
+ | File | Controls |
76
+ | --- | --- |
77
+ | `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
78
+ | `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
79
+ | `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
80
+ | `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budget ceilings, watchdog, and related execution policy. It does not choose startup work mode or topology. |
81
+
82
+ For deterministic routing, `backend: "native"` always starts the local Pi
83
+ specialist even if a same-name peer is visible. `backend: "coms"` requires a
84
+ visible same-name peer and refuses without native fallback. The default
85
+ `backend: "auto"` follows `dispatch-policy.yaml` and preserves its configured
86
+ fallback behavior.
87
+
88
+ Capability packs load automatically—do not run an activation command. Explicit task intent activates the matching ready surface; readiness alone never exposes coms or Herdr tools to the model. Ambiguous fleet/peer/workspace intent gets one confirmation before its first side effect, and active task packs persist until the explicit `set_task_tier(new_task: true)` reset.
89
+
90
+ Capability flags and runtime gates fail closed:
91
+
92
+ - `--no-coms` keeps operator direct tools and native dispatch available, but
93
+ peer dispatch, `coms_send`/`coms_await`, and `/af-handoff` refuse actionably.
94
+ - `--herdr` and `--peers` require a running [Herdr](https://herdr.dev) server.
95
+ Without Herdr, bare Fleet still works and dynamic pane tools stay inactive.
96
+ - `--browser` adds the browser extension surface and `--all-extensions` opts
97
+ into the complete approved extension set. Missing optional dependencies do
98
+ not grant tools merely because a flag was supplied.
99
+ - Hub-owned slash commands remain registered in both work modes. A missing coms
100
+ runtime, Herdr connection, target peer, or native roster produces a
101
+ capability refusal rather than a missing command.
102
+
103
+ During the migration release, `just fleet hub`, `just fleet team <preset>`,
104
+ `just fleet team <preset> --no-hub`, and `--solo` remain accepted and print a
105
+ canonical replacement. New automation should use `just fleet` with
106
+ `--agents`, `--peers`, `--herdr`, and `--no-coms`; compatibility does not imply
107
+ that the deprecated grammar will remain indefinitely.
108
+
109
+ ### Resume and recovery
110
+
111
+ The Hub distinguishes the **pre-turn surface** (stable replacement prompt, volatile state capsule,
112
+ and active tool schemas) from **intra-turn pressure** (conversation and tool results accumulated in
113
+ the live model window). `/af-context` shows both. At 60% live usage the Hub warns and transiently makes
114
+ compaction support available; at 70% it blocks the next provider continuation and requests a
115
+ single automatic compaction after the current result is persisted. A prompt submitted during
116
+ startup/recovery is retained in memory and replayed once after success. At the 80% ceiling, work stops
117
+ only after a failed recovery or when even the compacted baseline is at or above 80%; see
118
+ [context continuity](system1-context-continuity.md#automatic-compaction-monitoring).
119
+
120
+ If automatic recovery fails, the prompt remains retained. Pi's built-in command is the bare-runtime
121
+ fallback:
122
+
123
+ ```text
124
+ /compact Preserve the current goal, decisions, modified files, pending operations, blockers, and next step.
125
+ ```
126
+
127
+ You can also switch to a larger-context model. Do not try to make room by editing the session file.
128
+ The JSONL shown by `/session` under `~/.pi/agent/sessions/` is Pi's authoritative append-only record;
129
+ resume with `/resume`, `pi -c`, or `pi --session <path|id>`. Never edit, truncate, reorder, or add
130
+ synthetic entries to recover from context pressure.
131
+
132
+ A resumed orchestrator session may instead be blocked because its persisted team name no longer
133
+ resolves against the current `.pi/agents/teams.yaml` and persona files. This is a fail-closed roster
134
+ recovery gate: orchestrator work mode and its direct-tool restrictions remain in force. Choose a valid
135
+ team with `/af-agents-team`, restart publicly with `just fleet --agents <name>`, or explicitly choose
136
+ operator work mode with `/af-work-mode operator` / `just fleet --work-mode operator`. Direct Pi launches
137
+ use `--agent-team <name>` or `--work-mode operator`. Explicit startup flags win over persisted state;
138
+ fix missing or renamed team/persona declarations before selecting them.
139
+
140
+ ## System 1 configuration
141
+
142
+ System 1 is an experimental named feature and is excluded from automatic
143
+ Default/Full selection. Select it explicitly and persist that desired state when
144
+ needed:
145
+
146
+ ```bash
147
+ npx @chankov/agent-fleet@latest setup \
148
+ --preset default --features system1 --save-desired --yes
149
+ ```
150
+
151
+ Then create the human-owned `.ai/system1.json` with exactly these version-1
152
+ fields and values:
153
+
154
+ ```json
155
+ {
156
+ "version": 2,
157
+ "mode": "auto",
158
+ "provider": "typesafe",
159
+ "model": "jev-1.13.0",
160
+ "apiKeyEnv": "TYPESAFE_API_KEY",
161
+ "consumers": {}
162
+ }
163
+ ```
164
+
165
+ `mode: "off"` disables the service even when a key exists. Selection plus
166
+ `mode: "auto"` still requires the valid configuration and a nonempty
167
+ `TYPESAFE_API_KEY` in the caller environment. Key presence alone never enables
168
+ System 1. The runtime does not execute `.env`: the managed `just` launcher can
169
+ load the root `.env`, while a direct Node invocation must receive an exported or
170
+ otherwise injected variable.
171
+
172
+ `agent-fleet doctor` reads the desired state and configuration as data. Its
173
+ System 1 result is advisory and read-only, including with `--fix`; it performs
174
+ no provider request and does not validate the key. Doctor does not inspect or
175
+ load `.env`; declaration status is unknown (`envDeclared: null`). It checks only
176
+ key presence in its current process environment and never prints the value.
177
+
178
+ The installed demo is offline unless `--live` is supplied. Both forms require a
179
+ Node runtime supporting `--experimental-strip-types`:
180
+
181
+ ```bash
182
+ # Readiness only; no provider call.
183
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
184
+ .pi/harnesses/lib/system1/demo.ts
185
+
186
+ # Explicit live request using only embedded synthetic Bulgarian/English data.
187
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
188
+ .pi/harnesses/lib/system1/demo.ts --live
189
+ ```
190
+
191
+ The only phase-0 production provider/model is TypeSafe Jev `jev-1.13.0` at its
192
+ fixed official endpoint. No local model is installed and no fallback model is
193
+ selected. Outputs preserve available uncertainty but do not establish truth,
194
+ action authority, or calibration for a particular domain/language. The native specialist drift watchdog has a separate **consumer opt-in**:
195
+ `watchdog-system1: off|shadow|active` in `## agent-hub` (default `off`).
196
+ It also requires an armed watchdog, explicit feature selection, valid shared
197
+ configuration and a key. `off` makes no System 1 evaluation. `shadow` runs the
198
+ LLM judge immediately and System 1 in parallel; only the LLM can stop a child.
199
+ `active` is an **uncalibrated, explicitly opted-in experiment**: only the
200
+ advisory `scope` rule may skip LLM when Jev `jev-1.13.0` returns provider
201
+ `on_track` with confidence and on-track distribution ≥0.95 and all three
202
+ contradiction probabilities ≤0.05. Terminal `loop`, `failures`, and `toolcap`
203
+ always use LLM. `/af-watchdog` labels this `experimental: scope only; G2 not
204
+ validated`. This can miss a scope advisory; it is not G2 approval. Missing or
205
+ mismatched provider/config returns to LLM; default consumer mode remains off. Restart Hub to apply a
206
+ consumer mode/config snapshot; `/af-watchdog on|off|auto` changes Layer 1 arming,
207
+ not the System 1 consumer mode. For rollback set `watchdog-system1: off` for the
208
+ next session (cancel the current run if needed).
209
+
210
+ **Watchdog System 1 outbound state** is limited to a redacted task, normalized relative
211
+ scope/paths, 40 structured tool events without commands, bodies, arguments or
212
+ outputs, rule facts, coverage and counters (32 KiB maximum). This does **not**
213
+ limit the existing parallel LLM judge prompt: it includes the original task,
214
+ scope and a recent trail with up to 120 characters of raw tool arguments per
215
+ call. Both paths can reveal data. For a future pilot, review the tasks, files
216
+ and likely tool arguments; never use client/production data or secrets. Manual
217
+ review cannot guarantee that an agent will not produce unexpected arguments.
218
+ The final native spawn env removes `TYPESAFE_API_KEY`; this does not protect
219
+ against file reads or other launchers. Trace (`<sessionDir>/artifacts/watchdog/events.jsonl`)
220
+ records only allowlisted metadata. `/af-watchdog` shows readiness/checks, the
221
+ strip under chat and `/af-agents` show owner badges and detail history;
222
+ `/af-hub-report` counts evaluations/LLM attempts separately; `/af-audit`
223
+ shows read-only decision status including `judge_unavailable`. Missing usage
224
+ is unknown, not zero. A failed judge gets one live, revalidated retry after 5 s
225
+ rather than the 90 s success cooldown. Offline report code and mock tests are
226
+ not a real shadow pilot. G1 requires manual/outbound review; G2 additionally
227
+ requires independent human labels identifying the snapshot **and LLM attempt**,
228
+ held-out session evaluation and an explicit maintainer-approved profile. Older
229
+ labels without an LLM attempt ID cannot qualify. No gate is inferred from doctor readiness.
230
+
231
+ ## Task triage (active experimental; off by default)
232
+
233
+ Task triage is a separate Hub consumer, not `dispatch_triage` persona advice,
234
+ watchdog calibration, or the spend classification performed by `set_task_tier`.
235
+ It uses the shared TypeSafe `jev-1.13.0` service, even with watchdog off. After
236
+ explicit configuration and remote-context consent, it assesses user input before
237
+ the first Hub model turn and adds process requirements; it is **active but not
238
+ calibrated**. Selecting the foundation, having a key, `--yes`, or automatic Full
239
+ does not grant task-context consent.
240
+
241
+ ### Enable and preserve the desired selection
242
+
243
+ In a source checkout, use the local CLI (no publishing is implied):
244
+
245
+ ```bash
246
+ # Preview only; no inference or target writes.
247
+ node bin/cli.js setup --workspace ~/projects/my-app --preset default \
248
+ --features system1-task-triage --save-desired --dry-run
249
+
250
+ # Separate task-context consent plus approval of the exact file plan.
251
+ node bin/cli.js setup --workspace ~/projects/my-app --preset default \
252
+ --features system1-task-triage --save-desired --task-triage-consent --yes
253
+ ```
254
+
255
+ For a package containing this implementation, use
256
+ `npx @chankov/agent-fleet@<version> setup` with the same options from the target
257
+ workspace. The checkout does not
258
+ change an already published package. A real TTY asks separately for task-context
259
+ consent, including Full + all features, before final exact-plan approval.
260
+
261
+ `--features` names the **complete desired feature set**, not an additive toggle;
262
+ include any features you want to keep. Over an existing `.ai/agent-fleet.json`,
263
+ flags are temporary unless `--save-desired` is passed. Use it for persistent
264
+ headless opt-in/disable: the shared service reads the saved desired features,
265
+ while the consumer separately checks applied installer selection. A temporary
266
+ opt-in can therefore install an active config while the shared service remains
267
+ unselected. `config active` alone is not runtime readiness. Task-triage implies
268
+ the `system1` dependency without rewriting it as a directly requested feature.
269
+
270
+ Setup transactionally creates an absent consumer config and an absent nonsecret
271
+ provider template. It does not collect a key or create `.env`. Existing human
272
+ files, including explicit off, remain byte-for-byte unchanged: another consent
273
+ flag does not flip them on. Runtime dependencies still require the existing
274
+ `--allow-exec` path or `just fleet deps`; file installation is not dependency
275
+ readiness. After persisting your selection, use `just fleet deps` or run setup
276
+ with `--allow-exec --yes` and no replacement feature flags to retain that selection.
277
+ Supply the key through the caller environment before launching Hub.
278
+
279
+ The exact unified v2 template (with the service initially off) is:
280
+
281
+ ```json
282
+ {
283
+ "version": 2,
284
+ "mode": "off",
285
+ "provider": "typesafe",
286
+ "model": "jev-1.13.0",
287
+ "apiKeyEnv": "TYPESAFE_API_KEY",
288
+ "consumers": {
289
+ "taskTriage": {
290
+ "mode": "experimental",
291
+ "remoteContextApproved": true,
292
+ "questionVersion": "task-triage/questions/v1",
293
+ "policyVersion": "task-triage/policy/v1",
294
+ "limits": {
295
+ "maxTaskBytes": 40960,
296
+ "maxStateBytes": 65536,
297
+ "maxCallsPerSession": 100,
298
+ "timeoutMs": 2000
299
+ }
300
+ }
301
+ }
302
+ }
303
+ ```
304
+
305
+ Unsupported versions/fields/limits or provider/model mismatch do not become
306
+ calibrated defaults. To turn this config off manually, retain its complete schema
307
+ and change **both** `mode` to `"off"` and `remoteContextApproved` to `false`.
308
+ Provider `.ai/system1.json` remains separate; provider off prevents all its
309
+ consumers from making requests. Restart Hub to adopt configuration changes.
310
+
311
+ ### Input, requirements and recovery
312
+
313
+ - The runtime input is user task/follow-up text plus its declared process scope.
314
+ The state builder supports allowlisted relative path/kind metadata, but does
315
+ not discover or read file bodies. Aggregate task/clarifications are limited to
316
+ **40 KiB UTF-8**, serialized state to **64 KiB**. Sensitive, incomplete or
317
+ oversized input is refused, not silently truncated; this is not a guarantee
318
+ that all possible private text can be detected.
319
+ - At most **100 logical evaluations per saved session**, **2,000 ms total** per
320
+ evaluation including adapter retries. Identical input/scope reuses the cache;
321
+ task adoption/compaction/resume does not refill the budget. New scope can cause
322
+ a second evaluation. Physical attempts and logical calls are distinct; unknown
323
+ usage/cost stays unknown. These are not the separate live-pilot billing caps.
324
+ - Requested `security_change` at **p ≥ 0.80** adds review before acceptance, not
325
+ before authoring. `wide_change` at **p ≥ 0.85** adds plan before dependent
326
+ effects plus review. `irreversible_execution` at **p ≥ 0.80** adds exact-action,
327
+ one-use human confirmation. Signals are independent; no multiplied score or
328
+ automatic tier/model/permission increase. A low score is not a safety clearance.
329
+ - Additions retain task/evaluation/input provenance. Provider failure, low later
330
+ scores, disable and resume do not erase them. Classification and budgets remain
331
+ separate. Pending input must be bound through `set_task_tier` before dependent
332
+ effects; genuine new-task supersession can require human authorization.
333
+ - For a missing plan producer, ask the human to use `/af-agents-add planner` or
334
+ `/af-agents-team`. For review, use `/af-agents-add code-reviewer` (or the
335
+ permitted plan-reviewer/security-auditor) or select a suitable roster. There is
336
+ no automatic roster change. Dispatch and review counts are usage, not caps;
337
+ an unfinished requirement stays open until its evidence exists.
338
+ - `/af-task-triage-waive <addition-id> <reason>` asks for a correlated human
339
+ decision over one bound addition. It stays **waived**, never satisfied, and
340
+ cannot remove baseline or other-source requirements. Stale, denied, forged or
341
+ replayed grants do not authorize anything. `/af-task-triage-recover` retries a
342
+ blocked authoritative process append/readback; refusal requires session
343
+ inspection or valid resume, not editing JSONL.
344
+ - Direct Hub `bash`/`edit`/`write` confirmation binds the exact tool call, input
345
+ fingerprint and working directory. The human question shows the **complete
346
+ tool inputs as JSON**, labelled data rather than instructions: bash command/
347
+ timeout, write path/content, or edit path/all replacements, plus cwd. The
348
+ complete detail block is capped at **8 KiB (8192 bytes)**; missing, invalid,
349
+ sensitive/credential-like/email, terminal/bidi-control, mismatched or oversized
350
+ details refuse authorization, **without truncation or partial redaction**.
351
+ Non-ASCII characters are losslessly escaped in JSON. Sensitive-text detection
352
+ is heuristic, not comprehensive secret/PII detection. Inputs/cwd/task/revision/
353
+ operation/call ID are rechecked before one-use consumption. Generic bash has
354
+ no new read-only exemption. Native stage-producer
355
+ exceptions are bounded to the existing supported path. Arbitrary child/coms/
356
+ remote action binding is not universally supported; a confirmation-required
357
+ effect without supported binding is refused. Damage-control remains separate.
358
+
359
+ ### Observe, disable and verify
360
+
361
+ Doctor is offline advisory: it distinguishes missing/unapproved/invalid config,
362
+ policy mismatch, provider off/missing key and locally missing canonical roles.
363
+ `locally_ready` means no API validation; local persona files do not prove a live
364
+ roster. Doctor/`--fix` do not activate inference or rewrite human triage/provider
365
+ files, and do not inspect `.env` or print key values.
366
+
367
+ `/af-agents-list` opens the full Fleet dashboard with session-level assessment,
368
+ probabilities, effective obligations, active/waived additions and blockers, even
369
+ without worker rows. Task triage is not added to the small below-editor strip.
370
+ Fleet `1` opens the communication viewer: `e` explicitly enables memory-only
371
+ capture, Enter inspects, left/right and Enter copy, `d` disables/clears. The
372
+ **32 KiB viewer payload limit** is unchanged: a valid larger task may be withheld,
373
+ not truncated. Clipboard may retain copied synthetic/sanitized data after clear.
374
+
375
+ `/af-audit` exposes metadata-only evaluation/action history and unknown/degraded
376
+ states. Observation failure does not change enforcement; authoritative state,
377
+ grant or consumption persistence failure refuses dependent effects. Exact action
378
+ inputs are not added to metadata audit, but the **human question is not local-only**:
379
+ it uses the existing ask-user local/remote human route and can expose action
380
+ paths/content to that configured human endpoint. That route, ordinary Pi tool/
381
+ session rendering, terminal recordings and clipboard have separate privacy
382
+ boundaries; the metadata/viewer caps do not sanitize them. Provider ok,
383
+ assessment applied, process complete, an action grant and a tool result are
384
+ separate facts; none by itself is independent semantic task acceptance.
385
+
386
+ To stop future evaluations while keeping the human config and saved obligations:
387
+
388
+ ```bash
389
+ node bin/cli.js setup --workspace ~/projects/my-app --preset default \
390
+ --features none --save-desired --yes
391
+ ```
392
+
393
+ Use your complete remaining feature set instead of `none` if retaining other
394
+ features. Restart/resume Hub after disabling; cancel in-flight work normally if
395
+ immediate stopping is required. Do not delete additions or edit session JSONL to
396
+ roll back. Re-enable only through reviewed desired selection and valid human
397
+ consent/config; a preserved explicit off must be changed by the human.
398
+
399
+ Source verification is offline: `npm run test:task-triage` runs guarded policy,
400
+ authority, runtime, real-Pi and combined extracted-tarball/disable-resume tests;
401
+ `npm run test:full` includes it and existing regressions. Node 18 checks CLI/doctor
402
+ compatibility, not the TypeScript Pi runtime. A separate live pilot requires its
403
+ own approved data/budget; offline success and UI approval do not prove accuracy,
404
+ calibration or release readiness.
405
+
406
+ ## Proactive turn review (experimental)
407
+
408
+ This is a **separate per-repository opt-in**, not a new provider or an installer
409
+ feature flag. The Hub/native consumer uses the existing shared System 1 service
410
+ (`system1` feature, `.ai/system1.json`, caller-owned key) only when selected
411
+ excerpts are explicitly permitted and the service is ready. Its config is
412
+ human-owned `consumers.proactiveReview` in `.ai/system1.json`; setup/doctor do not create or activate
413
+ it. Missing config or valid `{"version":1,"mode":"off"}` causes **zero
414
+ proactive capture, inference, and feedback**. Invalid configuration fails closed.
415
+ Nothing here authorizes a live pilot, client repository, ringithub, provider
416
+ request, release, deployment or active configuration change.
417
+
418
+ Modes: `shadow` records bounded local evidence/findings without feedback;
419
+ `advisory` additionally offers bounded feedback at the next **natural** turn,
420
+ never starting a turn itself. With `remoteContext: "disabled"` (the default),
421
+ either enabled mode is **local-only**: source-bound deterministic checks may
422
+ run, but no semantic model review; no finding does not mean reviewed. With
423
+ `remoteContext: "selected-excerpts"`, permitted included source/assistant
424
+ excerpts may be transmitted to the already configured System 1 provider for
425
+ semantic assessment. This is not a blanket secrecy guarantee: source is
426
+ selected within approved scope and bounded/excluded, but automatic comprehensive
427
+ redaction of unknown secrets is not established. Review the *exact outbound
428
+ payload* and scope before any real opt-in. No auto-fix, kill, blocking,
429
+ acceptance authority, watchdog override, or autonomous continuation follows a
430
+ finding. Feedback is restricted to the same owner/attempt/task and current
431
+ source hashes and the session-bound rule revision, once per finding revision, at an already-occurring context
432
+ hook; changed evidence is refused.
433
+
434
+ **Schema illustration only — NOT executed, NOT authorization or a recommended
435
+ repository scope:** after separate human approval of the exact repository,
436
+ paths, outbound categories, budget and payload, a human may choose values in
437
+ this shape; do not copy these example paths into active configuration:
438
+
439
+ ```json
440
+ {
441
+ "version": 1,
442
+ "mode": "shadow",
443
+ "remoteContext": "selected-excerpts",
444
+ "include": ["src/**", "docs/**"],
445
+ "maxEvaluationsPerSession": 100
446
+ }
447
+ ```
448
+
449
+ Only `version`, `mode`, `remoteContext`, `include`,
450
+ `maxEvaluationsPerSession`, `localBindings` are accepted. Version is `1`;
451
+ mode is `off|shadow|advisory`; remote context is
452
+ `disabled|selected-excerpts`. Enabled modes require a nonempty explicit
453
+ repository-relative `include` (≤32 distinct entries, ≤256 characters each;
454
+ no absolute/dot/traversal paths, hidden segments, backslashes, special
455
+ bracket/negation patterns or dependency/build/runtime directories). The
456
+ session evaluation budget is an integer 0–100, default 100 in enabled modes.
457
+ The optional `localBindings` (≤16) require reviewed source-bound Markdown
458
+ `rule` path/heading/positive occurrence/lowercase SHA-256 hash,
459
+ `applicability` paths and added/modified kinds, and explicit paths/legacy
460
+ exceptions; `new-file-placement` also needs an added-only prefix, while
461
+ `relative-markdown-links` checks link form/escape, **not target existence**.
462
+ These are not prose-rule compilation or a general Markdown/AST validator.
463
+ Off must not retain active includes, remote permission, bindings or explicit
464
+ nonzero budget: rollback uses the complete minimal off JSON above, then a
465
+ **new Hub session**. Cancel current work if immediate interruption is needed;
466
+ do not delete session evidence or user config as cleanup.
467
+
468
+ Rules come read-only from `rules:` roots in `## agent-hub` (legacy
469
+ `## agent-team`): index-first, literal Markdown links/references and bounded
470
+ recursive fallback. The catalog binds file/path, heading occurrence and hash
471
+ for the **session**; edits do not reload in-session, and a restart adopts them.
472
+ It cannot execute instructions in rules. Discovery has a 64-file/256 KiB
473
+ budget; selection at most 20 sections/32 KiB, with coverage gaps for missing,
474
+ unsafe, partial, unselected or unsupported sources. Only the explicit task
475
+ and explicitly supplied plan bind the review; absent plan is `task_only`, not
476
+ a search for the newest plan. Incomplete work, exceptions, parallel authorship
477
+ and same-turn rule edits can remain uncertain. No silence or skipped check is
478
+ proof of compliance. Hub and supported native specialists are covered;
479
+ research helpers, nested delegates, coms peers and Hermes are not.
480
+
481
+ Per turn: at most 20 source units, 256 KiB retained excerpts (64 KiB/file),
482
+ 32 KiB evaluation state, 16 questions/batch, two calls/turn, one active
483
+ job/session, one pending/owner with backlog ≤8 and 5 s queue wait. Capture
484
+ phase has a 1 s deadline; evaluation job has a 2 s deadline. Feedback is
485
+ ≤3 findings/1,500 characters; finding history/private snapshots are bounded
486
+ at 100, so readback/retention is **not** a complete session record. Captures
487
+ bind pre/post worktree bytes, hashes and offsets; private evidence can be
488
+ locally reopened with validated references, whereas trace/report summaries
489
+ contain metadata only. Exclude `.env`, credentials, `.git`, dependencies,
490
+ build/runtime/session/transcript trees, binaries and realpath escapes; never
491
+ assume redaction catches every secret. Review coverage can be `partial`, `not_checked`, `unsupported`, `stale`,
492
+ `unavailable` or `unknown` rather than a confirmed pass. Operator TUI/history retain a completed row briefly (10 s); metadata
493
+ readback persists within the bounded session record.
494
+
495
+ ### Release readiness and evaluation limits
496
+
497
+ The opt-in runtime, native observer, local validators, advisory delivery, Fleet
498
+ history/evidence, reports and package installation are implemented and
499
+ independently reviewed. Offline integration uses repo-local Pi **0.84.2**;
500
+ Node 18 compatibility applies separately to the installed CLI/doctor, not the
501
+ Pi harness. Review history and evidence retain the dashboard's fixed-height
502
+ frame, including blank rows, rather than exposing dispatcher chat underneath.
503
+
504
+ A maintainer-authorized synthetic Jev smoke has verified real provider
505
+ communication and the evaluator path. It is **not** the planned 30-case
506
+ human-labelled semantic evaluation, nor evidence of general accuracy or recall.
507
+ That evaluation and final semantic acceptance remain outstanding; findings-only
508
+ label-key access also limits operational miss/true-negative evaluation.
509
+
510
+ A release installs the capability, **not its activation**. Setup does not create
511
+ `consumers.proactiveReview` in `.ai/system1.json`, and preserves an existing human-owned file. The
512
+ maintainer's active config and repo-specific rule catalog are not release
513
+ artifacts. Each target repository needs its own explicit scope, rules and
514
+ outbound-data consent. Configuration/rules are loaded at session start; start a
515
+ fresh Fleet session after changing them. When testing file placement, verify
516
+ that the file is really inside the configured repository include path, not a
517
+ session `artifacts/` directory with a similar relative suffix.
518
+
519
+ ### Read-only reports and explicit human labels
520
+
521
+ `/af-hub-report` and `/af-audit` separate proactive and watchdog totals.
522
+ For measured comparison only, add `--labels /absolute/path/to/CURRENT_SESSION/artifacts/labels.json`
523
+ to **either** command. No default, file discovery, provider request or
524
+ automatic label inference occurs. The actual path must be an absolute regular
525
+ `.json` file below the *current* session's `artifacts/`, without symlink escape;
526
+ maximum 64 KiB and 320 labels. Only retained findings currently expose operator-readable label keys. In Fleet
527
+ Dashboard (**Alt+A**), open review history with **`p`**, select a finding with
528
+ **`n`**, then press **`e`** for its local captured evidence; alternatively open
529
+ the specialist detail, select a finding with **`n`**, and press **`e`**. Scroll
530
+ with ↑/↓ (or j/k), PgUp/PgDn, Home/End; Esc returns to the previous review-history or detail view. The evidence
531
+ view displays a JSON record with the exact `snapshotId`, slash-bearing catalog
532
+ `ruleId` (`path#heading@occurrence:hash`), session-bound `ruleHash`, and
533
+ `subject` for that finding. At narrow widths the JSON is wrapped into visual
534
+ chunks: remove one indentation column from each chunk and concatenate the
535
+ chunks to reconstruct the record. Unavailable evidence shows no template;
536
+ do not guess a key. Copy the reconstructed record into an explicit local
537
+ current-session artifacts `.json` array, leaving `expected` as `unknown` until
538
+ a human judges that finding (`violation` or `clean`). Never use raw
539
+ source/prompt payloads as label keys. This illustrative shape is not a
540
+ substitute for the evidence-view values:
541
+
542
+ ```json
543
+ [
544
+ {
545
+ "snapshotId": "<actual lowercase 64-hex snapshot ID>",
546
+ "ruleId": "<actual evidence-view catalog rule ID, including path/slashes>",
547
+ "ruleHash": "<actual bound lowercase 64-hex rule hash>",
548
+ "subject": "src/example.ts",
549
+ "expected": "unknown"
550
+ }
551
+ ]
552
+ ```
553
+
554
+ Each object has **exactly** these five keys; `expected` is
555
+ `violation|clean|unknown`. Match snapshot, rule ID, session-bound rule hash and subject to retained
556
+ finding evidence; a valid unmatched label is `unchecked`, not a false
557
+ pass/miss. Report comparison can join checked-clear verdicts, but the operator
558
+ UI exposes keys only for retained findings, not checked-clear units. Human
559
+ miss/true-negative labels cannot currently be authored from this UI; absent
560
+ human labels remain `unknown`. This is a partial finding-backed workflow, not
561
+ fully operational misses or recall evaluation. Missing/invalid labels yield `unavailable` with null
562
+ measurement counts; empty valid array is not a precision/recall score.
563
+ Counts distinguish reviewed/partial/coverage-unknown/skipped, uncovered rules,
564
+ deterministic findings versus System 1 suspicions, unknown usage and unknown
565
+ native delivery (no receipt). Trace-only readback does not reconstruct missing
566
+ coverage or invent zeroes. Any precision or miss count describes only *labelled checked* evidence, not
567
+ unlabelled clear units or universal correctness.
568
+
569
+ ### Offline installed-package runbook (not executed by this documentation change)
570
+
571
+ Use a fresh **temporary** directory/workspace, with Node supporting native
572
+ TypeScript for the observer, repo-local Pi 0.84.2, and existing dependencies;
573
+ Node 18 is checked separately for the extracted CLI. These are test-backed
574
+ instructions, **not** commands run by this documentation patch. From this
575
+ repository's root, the safest reproducible run is:
576
+
577
+ ```sh
578
+ node --test .pi/agent-fleet/scripts/docs-links.test.mjs
579
+ # Supply an actual installed Node 18 executable; the test fails if unavailable.
580
+ AF_NODE18=/absolute/path/to/node18 node --test bin/test/proactive-installed.test.js
581
+ node --test --test-name-pattern='isolated tarball supports' bin/test/package-surfaces.test.js
582
+ ```
583
+
584
+ The installed test packs with `npm pack --json --pack-destination <temp>`,
585
+ extracts with `tar -xzf <tarball> --strip-components=1 -C <temp>/package`,
586
+ and runs `node <temp>/package/bin/cli.js setup --workspace <temp>/installed
587
+ --preset default --features none --yes` under a scrubbed offline environment.
588
+ It checks the installed 12-file runtime closure and an offline fake-provider Pi
589
+ observer/capture, no auto `consumers.proactiveReview` in `.ai/system1.json` or proactive desired-state
590
+ key, preservation of a **test-only HUMAN fixture** across repeat setup and
591
+ `doctor`/`doctor --fix`, and extracted-CLI version/help/readonly doctor under
592
+ Node 18. Doctor may return 0 or findings exit 2. The smoke reuses existing
593
+ repository dependencies, not a fresh dependency install; its network guard is
594
+ limited and does not prove every step physically network-isolated. Do not
595
+ create the illustrative active config above in a real workspace while testing.
596
+ The operator must run the link test and installed test on the final changed
597
+ state; this document alone is not verification.
598
+
599
+ ### Separate live pilot and acceptance
600
+
601
+ C5 operator visibility was human accepted, and the final post-fix source/docs
602
+ review accepted the C6 offline/package work. The later review-history overlay
603
+ fix is covered by fixed-frame and real Pi compositor regression tests; its
604
+ human visual retest is separate. Implemented/offline/installed evidence is not
605
+ live semantic accuracy. Explicit advisory activation in the maintainer's
606
+ repository and a synthetic Jev transport/evaluator smoke have occurred; neither
607
+ completes the planned human-labelled pilot or C7 semantic acceptance. For a new
608
+ repository, first review synthetic/offline evidence, then require **explicit
609
+ repo-specific shadow consent**, including exact include/exclusion paths,
610
+ reviewed bindings, session budget, outbound categories and representative
611
+ exact payload review; separate explicit consent is required for advisory.
612
+ There is no implied ringithub/customer repo authorization. A subsequent pilot
613
+ requires ≥30 **human-labelled** code/text assessments including ≥10 known
614
+ violations/deviations, BG/EN, legacy/new code, interim work, exceptions,
615
+ text-only and no-plan cases; manually review selector omissions and uncertain
616
+ cases. Measure finding-backed labelled precision and false alarms alongside coverage,
617
+ capture overhead, model p50/p95 latency, queue drops and known/unknown usage.
618
+ Miss/true-negative human-label keys for checked-clear units are not exposed;
619
+ report miss joins from synthetic/offline tests do not establish operational
620
+ miss/recall measurement. Record that gap explicitly in any pilot assessment
621
+ rather than treating unknown labels as negatives. Synthetic/offline success is not semantic or live
622
+ proof; no automatic mode promotion or invented accuracy threshold. C7 asks
623
+ the maintainer to accept limitations/evidence and explicitly choose each
624
+ repository's off/shadow/advisory state. No release or deployment follows from
625
+ these docs or C6.
626
+
627
+ ## Viewing configuration from a live session
628
+
629
+ Inside a running Hub (`just fleet`) or coms peer (`just fleet peer`), `/af-config [tab]` or **Alt+,**
630
+ opens a read-only full-screen view of the files this guide describes: `.ai/agent-fleet.json` (preset and
631
+ feature switches as written), `.ai/agent-fleet-state.json` (recorded items with a sha256 check of every
632
+ recorded file: unchanged / modified / missing), `.ai/agent-fleet-overrides.md` (sections and keys with
633
+ their line numbers, plus the values the Hub parsed at session start and its warnings),
634
+ `.ai/agent-fleet-ai-state.json` (accepted project files with their local hash state), `.ai/system1.json`,
635
+ `.ai/stt.json`, the `.pi/agents/*.yaml` files and the damage-control rule files. Each row shows where the
636
+ value comes from, and a file edited after the session started is flagged because the running session
637
+ still uses what it read at start.
638
+
639
+ The screen only reads files and compares hashes. It does not re-derive installer decisions: pressing `i`
640
+ runs the read-only `agent-fleet inspect` verb (verify item states and findings, doctor findings and
641
+ preflight, the desired state with feature availability and dependencies, provenance validity) and shows
642
+ the CLI's own words in the Overview, Setup, State and AI State tabs. The CLI is resolved from the
643
+ recorded `sourceRoot` when its `bin/cli.js` exists, otherwise through `npx` pinned to the recorded package
644
+ version (never `@latest`); three-way conflicts and repairs still belong to `agent-fleet setup`.
645
+
646
+ Changes from the screen are CLI runs, not file edits. Setup tab: `Space` toggles a feature and `p`
647
+ cycles the preset in an unsaved draft; `a` previews `agent-fleet setup --dry-run --json` for the draft and
648
+ shows the CLI's plan; confirming re-runs the dry run (a different plan digest means the workspace moved
649
+ and nothing is applied) and then runs `agent-fleet setup --yes --save-desired`, which writes
650
+ `.ai/agent-fleet.json` and the installed files under the CLI's lock and transaction journal. Conflicts and
651
+ first-migration blocks are shown with the exact terminal command and cannot be applied from the screen;
652
+ `system1-task-triage` asks the separate data consent before `--task-triage-consent`; a rejected desired
653
+ file is shown as the CLI's repair preview and applies only with `--repair-config` after confirmation.
654
+ Overrides tab: `a` asks for rules/docs roots, previews `agent-fleet configure --dry-run` as a line diff and
655
+ applies with `--yes --expect-hash`; the CLI refuses when the file changed since the preview. The running
656
+ session keeps what it read at start, so every applied change ends with a restart note.
657
+
658
+ Outside a session, `just fleet config` (or `npx @chankov/agent-fleet inspect`) prints the same read-only
659
+ report as JSON. It never shows an
660
+ environment variable's value — only the variable name and whether it is set in the session's process — and
661
+ it never writes a configuration file itself; the deterministic CLI remains the only writer. Tabs: Overview, Setup,
662
+ State, Overrides, AI State, System 1, STT, Fleet, Safety and Runtime (Hub only).
663
+
664
+ ## The overrides file — `.ai/agent-fleet-overrides.md`
665
+
666
+ Some skills and pi harnesses need facts specific to each project — where specs
667
+ and plans are saved, how to start a dev server, whether the agent may create
668
+ branches, or which user-facing language a dispatcher should use. Each reader
669
+ ships a sensible **default**; a project that needs something different declares
670
+ it here, and the reader picks it up.
671
+
672
+ - **Location:** `.ai/agent-fleet-overrides.md` at the project root.
673
+ - **Format:** Markdown. One `## <section-name>` section per skill or harness reader, with terse
674
+ `key: value` lines. Block values use the `key: |` multi-line form. No prose
675
+ and no install detail — readers parse it by key and load it on every run/session start.
676
+ - **Commit it.** Shared project configuration belongs in version control. Make
677
+ sure no `.gitignore` rule (for example a broad `.env*` pattern) excludes it.
678
+ - **No secrets.** For anything sensitive (test-account credentials), reference
679
+ the **name** of an environment variable; the real value lives in a gitignored
680
+ `.env`.
681
+ - If the file is absent, or a reader has no section in it, that reader uses its
682
+ built-in default.
683
+ - **Settings writer:** ordinary `agent-fleet setup` leaves non-empty overrides byte-identical. To add rule/doc roots explicitly, preview with `agent-fleet configure --rules .ai/rules --docs docs --dry-run --workspace <project>`; review `before`, `after`, and `expectedHash`, then apply with the same roots, `--expect-hash <expectedHash> --yes`. Omit a key to leave it unchanged. The CLI appends/deduplicates roots, keeps other sections/settings and the legacy `agent-team` section, and refuses duplicate/conflicting sections or keys for manual resolution. A changed setting takes effect in a new session; missing roots remain advisory. The interactive path is `/af-setup-rules` (the `repository-ai-setup` skill: discovery → proposal → grilling → diff → apply → verify); it hands accepted roots to this same CLI and never edits the file directly.
684
+ - **Validation.** Because an unknown section or key silently falls back to the
685
+ default, typos are invisible at runtime. `agent-fleet doctor` (and the
686
+ runtime's Agent Fleet doctor command) validates the file — unknown sections,
687
+ unknown keys in known sections, invalid values for the mechanically parsed
688
+ `agent-hub` keys, missing `rules:` folders, missing `append-prompt:` files,
689
+ unknown `poll-panel:` names, and unset `## env` vars — as
690
+ **advisory, warn-only findings**; it never edits the file.
691
+
692
+ ### `spec-driven-development`
693
+
694
+ | Key | Default | Meaning |
695
+ |-----|---------|---------|
696
+ | `spec-dir` | `docs/prds/{area}` | Directory specs are written to |
697
+ | `naming` | `PRD{n}-{topic}` | File name pattern; `{n}` = next free PRD number, `{topic}` = kebab-case slug |
698
+
699
+ Default output: `docs/prds/{area}/PRD{n}-{topic}.md`.
700
+
701
+ ### `planning-and-task-breakdown`
702
+
703
+ | Key | Default | Meaning |
704
+ |-----|---------|---------|
705
+ | `plan-dir` | `docs/plans/{area}` | Directory plans are written to |
706
+ | `naming` | `PLAN-{prd-name}-{phase}` | File name pattern; `{phase}` suffix only when a plan spans multiple files |
707
+ | `todo` | `embedded` | `embedded` keeps the task list inside the plan; `separate` writes a standalone `todo.md` |
708
+
709
+ Default output: `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, task list embedded.
710
+
711
+ ### `browser-testing-with-devtools`
712
+
713
+ This skill has **no default** — the section is required for browser testing,
714
+ because dev-server commands and login flows cannot be guessed.
715
+
716
+ | Key | Meaning |
717
+ |-----|---------|
718
+ | `dev-server` | Command to start the local dev server |
719
+ | `ready-check` | How to confirm the server is up |
720
+ | `base-url` | Root URL for navigation |
721
+ | `auth-flow` | Steps to log in (multi-line `|` block) |
722
+ | `roles` | Test account per privilege level, referenced by env-var name |
723
+ | `notes` | Anything else the agent should know (certs, seed data, ...) |
724
+
725
+ ### `git-workflow-and-versioning`
726
+
727
+ | Key | Default | Meaning |
728
+ |-----|---------|---------|
729
+ | `branching` | `never` | `never` = agent works in the current branch and never creates or switches branches; `allow` = agent may create feature branches |
730
+
731
+ ### `agent-hub`
732
+
733
+ Read by the `.pi/harnesses/agent-hub/` pi harness on every session start. The canonical
734
+ section name is `## agent-hub`; the harness also accepts the legacy `## agent-team` name
735
+ (from before the standalone `agent-team` harness was retired), so existing project
736
+ override files keep working unchanged. When both sections are present their keys merge,
737
+ with later lines winning.
738
+
739
+ The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
740
+ skill (and the `/af-compound` agent-hub command built on it) resolves them as the
741
+ targets an end-of-session compound pass writes lessons to.
742
+
743
+ | Key | Default | Meaning |
744
+ |-----|---------|---------|
745
+ | `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
746
+ | `persona-gate` | — | **Removed.** Ignored with a doctor warning; dispatcher flavor is no longer selectable. Use `/af-work-mode` for operator vs orchestrator. Delete the key. |
747
+ | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). If the override reports a model/provider error or aborted request before producing text or starting a tool (including a local-model memory-limit failure), agent-hub restores the child session and retries once with the original frontmatter model; it does not fallback after work starts, cancellation, timeout, drift stop, or process-spawn failure. |
748
+ | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
749
+ | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
750
+ | `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>][, thinking=<off\|minimal\|low\|medium\|high\|xhigh>]`. Other declared roles keep their frontmatter values. Existing roles retain their original frontmatter model as the same one-shot, pre-work-only runtime fallback; model-only overrides retain the declared tool cap. An invalid `thinking=` value is ignored with a session-start warning and the role stays at `off` unless frontmatter already set a valid level. |
751
+ | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
752
+ | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
753
+ | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
754
+ | `research-keep` | — | **Removed.** Ignored with a session-start warning; live research helpers disappear from the Fleet Dashboard (`Alt+A`) on every terminal outcome. Session, transcript, and findings files plus `/af-agents-history` records remain. Delete the key. |
755
+ | `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
756
+ | `mode` | — | **Removed.** Ignored with a warning; budgets follow task tier. Delete the key. |
757
+ | `max-dispatches-per-turn` | — | **Removed.** Ignored with a warning: continuation quotas were removed, dispatch counts stay visible and the watchdog supervises progress. Delete the key. |
758
+ | `max-research-per-turn` | — | **Removed.** Ignored with a warning, like `max-dispatches-per-turn`. Delete the key. |
759
+ | `turn-wall-time-s` | — | **Removed.** Ignored with a warning; active time stays visible, and `agent-turn-timeout-s` still bounds each child run. Delete the key. |
760
+ | `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
761
+ | `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
762
+ | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
763
+ | `watchdog-system1` | `off` | Native specialist consumer only: `off`, `shadow`, or explicitly opted-in experimental `active` for advisory `scope` only (0.95/0.05; not G2-validated). Requires the separate selected feature and shared config; no automatic outbound request from setup/doctor. |
764
+ | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-6-luna`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
765
+ | `poll-panel` | none | Default panel name for `/af-poll` when `--panel` is omitted. Must match a panel in `.pi/agents/voices.yaml` when that file exists. Missing `--panel` and missing this key is a refusal. |
766
+ | `append-prompt` | none | Comma-separated repo-relative files appended to the system prompt of every dispatched persona. Listed files must exist. Enable the communication contract with `append-prompt: references/communication-contract.md`. |
767
+
768
+ Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
769
+ code-reviewer's thinking level, move the code-reviewer's docs sub-reviewer to a
770
+ different model, and point the team at the project's rule folders and doc entry
771
+ points:
772
+
773
+ ```markdown
774
+ ## agent-hub
775
+ language: Bulgarian
776
+ model.builder: github-copilot/claude-sonnet-4.6
777
+ models.builder: github-copilot/claude-sonnet-4.6, github-copilot/claude-haiku-4.5
778
+ thinking.code-reviewer: xhigh
779
+ subagents.code-reviewer.docs: github-copilot/claude-sonnet-4.6, tools=read,grep, thinking=medium
780
+ delegate-depth.code-reviewer: 1
781
+ recon-search-timeout-s: 120 # or off to disable the per-tool watchdog
782
+ poll-panel: default
783
+ append-prompt: references/communication-contract.md
784
+ rules: docs/rules, .ai/rules
785
+ docs: Docs/AGENTS.md, Docs/architecture/ARCHITECTURE_OVERVIEW.md
786
+ ```
787
+
788
+ ### `env` (optional, read by the doctor)
789
+
790
+ The overrides file references environment variables by **name** — test-account
791
+ credentials for `browser-testing-with-devtools`, the `pi-voice-stt` API key —
792
+ while the values live in a gitignored root `.env`. The optional `## env`
793
+ section declares which names the project's readers expect, so a fresh clone
794
+ can find out what's missing *before* a skill fails mid-run:
795
+
796
+ | Key | Meaning |
797
+ |-----|---------|
798
+ | `required` | Comma-separated env-var **names** (never values) the project's sections reference |
799
+
800
+ ```markdown
801
+ ## env
802
+ required: APP_TEST_ADMIN_USER, APP_TEST_ADMIN_PASS, AZURE_SPEECH_KEY
803
+ ```
804
+
805
+ No skill or harness loads this section. Its only reader is `agent-fleet doctor`
806
+ (and the runtime's Agent Fleet doctor command), which warns when a declared name is neither set in
807
+ the environment nor declared in the workspace root `.env`.
808
+
809
+ ### Per-peer env files (`env_file:` in peers.yaml)
810
+
811
+ Fleet peers spawned through `--peers`, `just fleet peer`, or the Hub's
812
+ constrained dynamic peer tool can carry their own environment: an `env_file:`
813
+ entry in `.pi/agents/peers.yaml` names a
814
+ **repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
815
+ that herdr injects into the peer's pane before the command runs — no `source`,
816
+ no leaking into sibling panes. The file must exist at spawn (team-up refuses
817
+ otherwise, never mid-run), and its **values never appear in `--dry-run`
818
+ output** — only the path. Keep these files gitignored exactly like the root
819
+ `.env` this section describes.
820
+
821
+ ## The install record — `.ai/agent-fleet-state.json` and `.ai/agent-fleet-setup.md`
822
+
823
+ Two files, one source of truth. `.ai/agent-fleet-state.json` is what the
824
+ installer writes and the only thing it reads back: agent, method, package
825
+ version, source root, and one entry per installed item with a per-file sha256
826
+ (or, in symlink mode, the resolved link target). `.ai/agent-fleet-setup.md` is
827
+ **rendered from it** on every apply and never parsed back, so the two cannot
828
+ disagree — it exists for humans and for older readers that still look for
829
+ `version:` and `agent:`.
830
+
831
+ Ownership is the point of the state file. An entry means "agent-fleet installed
832
+ this"; anything not listed is never removed or overwritten. That lookup is what
833
+ replaced the prose ownership rule the setup skill used to carry.
834
+
835
+ | State-file field | Meaning |
836
+ |---|---|
837
+ | `agent`, `method`, `sourceRoot` | How and from where this workspace was installed |
838
+ | `packageVersion` | The version that performed the last apply — provenance for reconciliation and legacy three-way compatibility |
839
+ | `items` | One entry per installed artifact: strategy, method, files with hashes, JSON key paths |
840
+ | `externalPackages` | Packages the user was told to install; recorded, never installed for them |
841
+ | `events` | Last few applies (verb, version, action count, conflicts) |
842
+
843
+ **No secrets, ever.** Only env-var *names* may appear — for example in the
844
+ `pi-voice-stt` record. A test asserts nothing value-shaped is persisted.
845
+
846
+ ### The recorded version and the three-way merge
847
+
848
+ The recorded `packageVersion` gives every comparison a baseline. For each
849
+ recorded artifact, the engine compares *source@recorded* from the package's
850
+ `.versions/<x.y.z>/` snapshot tree, the installed copy on disk, and
851
+ *source@current*. Deterministic `setup` is the public reconciliation command.
852
+
853
+ | Outcome | What `setup` does |
854
+ |---|---|
855
+ | Neither moved | Kept |
856
+ | Only the source moved | Clean refresh |
857
+ | Only your copy moved | **Refreshed — your edit is overwritten.** Reported in the plan as *"locally modified — selecting it overwrites your edits"*, so `--dry-run` shows it before it happens |
858
+ | Both moved, to different content | **Conflict**: the run exits `3` before writing anything. Resolve with `--on-conflict theirs` or `--on-conflict ours` |
859
+ | Retired upstream | Kept by `setup`; the deprecated `upgrade` proposes removal by name, subject to the ownership rule |
860
+
861
+ Reconciling toward the package is the point of `setup`: the workspace is meant
862
+ to match the version it records. That is why editing a shipped artifact in place
863
+ is not a supported customization route — use `.ai/agent-fleet-overrides.md`, add
864
+ artifacts under names Agent Fleet does not ship, or leave the item out of the
865
+ selection (`setup` never removes what it does not select, so an unselected item
866
+ stays installed and frozen). The deprecated `upgrade` verb preserves local edits
867
+ instead of overwriting them; if you have relied on that, it is the behavioural
868
+ difference to plan for.
869
+
870
+ If the snapshot is missing (an unpublished local build, or a version older than
871
+ `.versions/` retention), the comparison degrades to two-way, the installed copy
872
+ is treated as canonical, and the read-only auxiliary `verify` command reports it
873
+ as an advisory finding rather than pretending a diff exists.
874
+
875
+ ### Pre-engine workspaces
876
+
877
+ A workspace with only `.ai/agent-fleet-setup.md` and no state file predates the
878
+ installer engine. `setup --migrate --dry-run` previews what it can infer from
879
+ that markdown (`agent:`, `version:`) without adopting unrecorded paths. To
880
+ mutate a legacy workspace, use `setup --migrate` with an explicit preset,
881
+ features, and `--yes`. A workspace with no `version:` at all has no recorded
882
+ baseline, so no three-way merge is attempted.
883
+
884
+ Commit these files if the team should share install state — keep paths relative
885
+ so they stay portable. A self-referencing checkout (agent-fleet itself) may
886
+ instead `.gitignore` them, since their recorded paths are local to one machine.
887
+
888
+ ## Coms-backed team members
889
+
890
+ A team member the `agent-hub` harness dispatches (`.pi/agents/teams.yaml`) can be
891
+ served by a live coms peer of the same name instead of a freshly spawned native
892
+ subagent. With the default `backend: "auto"`,
893
+ `.pi/agents/dispatch-policy.yaml` decides that per member at dispatch time;
894
+ explicit `native` bypasses substitution, while explicit `coms` requires the
895
+ peer and never falls back. `.pi/agents/peers.yaml` decides *how* each peer runs.
896
+ A peer with `runner: claude-code` is an interactive Claude Code pane plus its
897
+ bridge — the one way Claude Code takes part in a fleet. See
898
+ [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
899
+
900
+ Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
901
+ is what gives a bridged pane exact turn text instead of scraped output.
902
+ The hook installs to `.pi/agent-fleet/hooks/coms-stop-hook.mjs` with the rest
903
+ of the fleet runtime. Registering it in `.claude/settings.json` stays the
904
+ user's step — the installer writes files, and another tool's settings file is
905
+ not its to merge. `setup` prints this snippet when the hook is applied:
906
+
907
+ ```json
908
+ { "hooks": { "Stop": [{ "hooks": [{ "type": "command",
909
+ "command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }] } }
910
+ ```
911
+
912
+ ## Templates
913
+
914
+ ### `.ai/agent-fleet-overrides.md`
915
+
916
+ Copy this in and delete the sections you don't need — anything absent falls
917
+ back to that reader's default.
918
+
919
+ ```markdown
920
+ # Agent Fleet — Project Overrides
921
+ #
922
+ # Each section is applied ON TOP of the skill's built-in defaults.
923
+ # Keys not listed keep the default. Absent file/section → pure defaults.
924
+
925
+ ## spec-driven-development
926
+ spec-dir: docs/prds/{area}
927
+ naming: PRD{n}-{topic}
928
+
929
+ ## planning-and-task-breakdown
930
+ plan-dir: docs/plans/{area}
931
+ naming: PLAN-{prd-name}-{phase}
932
+ todo: embedded
933
+
934
+ ## browser-testing-with-devtools
935
+ dev-server: <command to start the local dev server>
936
+ ready-check: <url or check that confirms the server is up>
937
+ base-url: <root url>
938
+ auth-flow: |
939
+ 1. Navigate to <login url>
940
+ 2. Submit credentials for the role needed by the screen under test
941
+ roles:
942
+ admin: env APP_TEST_ADMIN_USER / APP_TEST_ADMIN_PASS
943
+ player: env APP_TEST_PLAYER_USER / APP_TEST_PLAYER_PASS
944
+ notes: |
945
+ <anything else: self-signed certs, required seed data, ...>
946
+
947
+ ## git-workflow-and-versioning
948
+ branching: never
949
+
950
+ # Optional for pi agent-hub; omit this section to keep default English.
951
+ # (`## agent-team` is still accepted as a legacy alias for this section.)
952
+ ## agent-hub
953
+ language: <language name>
954
+ rules: <repo-relative rule folder>[, <another folder>]
955
+ docs: <repo-relative doc entry point>[, <another file or folder>]
956
+
957
+ # Optional; names (never values) of env vars the sections above reference.
958
+ # Only `agent-fleet doctor` reads this — it warns when one is unset.
959
+ ## env
960
+ required: <ENV_VAR_NAME>[, <ANOTHER_NAME>]
961
+ ```
962
+
963
+ ### `.ai/agent-fleet-setup.md`
964
+
965
+ Rendered from `.ai/agent-fleet-state.json` by every apply, for humans to read.
966
+ Edit the workspace, not this file — the next apply overwrites it.
967
+
968
+ ```markdown
969
+ # Agent Fleet — Workspace Setup
970
+ #
971
+ # Generated from .ai/agent-fleet-state.json by `agent-fleet setup`.
972
+ # Edit the workspace, not this file: it is rewritten on every apply.
973
+
974
+ ## workspace-summary
975
+ agent: pi
976
+ method: copy
977
+ version: 1.4.2
978
+ source: /home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet
979
+
980
+ ## install-status
981
+ skills: [spec-driven-development, test-driven-development, code-review-and-quality]
982
+ commands: [spec, plan, build]
983
+ personas: [code-reviewer]
984
+ extensions: []
985
+ harnesses: []
986
+ companions: [skills-internal-grilling]
987
+ external: []
988
+ updated: 2026-05-22
989
+
990
+ ## verification
991
+ - 21 item(s) recorded; run `agent-fleet doctor` for diagnostics.
992
+ - No secrets are stored in this file or in .ai/agent-fleet-state.json.
993
+ ```
994
+
995
+ ### `.ai/stt.json`
996
+
997
+ Optional. Present only when the `pi-voice-stt` extension is installed and configured. Read by
998
+ the extension on every pi session start, ahead of the global `~/.pi/agent/stt.json`. The
999
+ canonical format has a nested `provider` object. Runtime `provider.type` values are `openai`,
1000
+ `openai-compatible`, `azure` (Azure Speech), and `azure-openai` (Azure OpenAI Whisper):
1001
+
1002
+ ```json
1003
+ {
1004
+ "language": "bg-BG",
1005
+ "provider": {
1006
+ "type": "azure",
1007
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
1008
+ "locales": ["bg-BG", "en-US"]
1009
+ }
1010
+ }
1011
+ ```
1012
+
1013
+ The setup CLI accepts the aliases `openai`, `groq`, `azure`, and `azure-openai`. These are
1014
+ installer selections, not interchangeable runtime types: in particular, `groq` is not a
1015
+ `provider.type`, and `azure` means Azure Speech rather than Azure OpenAI. Setup can generate
1016
+ the OpenAI configuration from runtime defaults. For Groq, create a complete nested
1017
+ `.ai/stt.json` with runtime type `openai-compatible` and the actual Groq endpoint/model, then
1018
+ run setup without `--stt-provider groq`; the alias does not identify the prepared runtime type.
1019
+ Other OpenAI-compatible services are not Groq and use their own endpoint/model. For Azure
1020
+ Speech or Azure OpenAI in a workspace without STT settings, create complete nested JSON with
1021
+ the provider-specific endpoint/deployment settings before setup. Setup does not guess them.
1022
+
1023
+ Existing valid nested files are preserved. Supported legacy flat files are also preserved and
1024
+ produce a warning that runtime compatibility is not guaranteed; setup does not migrate them
1025
+ automatically. Provider migration or replacement requires a separate explicit action.
1026
+
1027
+ The JSON stores only environment-variable names, never credential values. Put values in the
1028
+ gitignored `.env` at the workspace root, which the managed justfile loads:
1029
+
1030
+ ```sh
1031
+ export AZURE_SPEECH_ENDPOINT=https://<resource>.cognitiveservices.azure.com
1032
+ export AZURE_SPEECH_KEY=<your-resource-key>
1033
+ ```
1034
+
1035
+ Setup preserves existing `.env` declarations and values, including `export NAME=...` syntax,
1036
+ and appends only missing empty placeholders. A direct `provider.endpoint` needs no endpoint
1037
+ environment variable. Setup validates JSON structure and environment-variable names, but it
1038
+ does not validate credentials or contact the provider. Full schema and provider examples:
1039
+ [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
1040
+
1041
+ ### Complete model profiles
1042
+
1043
+ `/af-models <name>` reads `.pi/agents/model-profiles.yaml`. Flat persona-to-model
1044
+ maps remain supported and keep their declared-candidate validation. A `version: 2`
1045
+ profile declares the whole execution model set independently of
1046
+ `.ai/agent-fleet-overrides.md`:
1047
+
1048
+ ```yaml
1049
+ local-full:
1050
+ version: 2
1051
+ defaults:
1052
+ model: &qwen36 omlx/Qwen3.8-Flash-Next-GSQ-RCO-Q2_0
1053
+ thinking: off
1054
+ allowed-models:
1055
+ - *qwen36
1056
+ fallback: none
1057
+ routing: native
1058
+ dispatcher: *qwen36
1059
+ agents:
1060
+ # Every shipped persona uses *qwen36 (see .pi/agents/model-profiles.yaml).
1061
+ subagents:
1062
+ # Every declared child role uses *qwen36.
1063
+ services:
1064
+ watchdog: *qwen36
1065
+ return-extractor: *qwen36
1066
+ panel:
1067
+ - { name: qwen-a, model: *qwen36 }
1068
+ - { name: qwen-b, model: *qwen36 }
1069
+ - { name: qwen-integrator, model: *qwen36, integrator: true }
1070
+ ```
1071
+
1072
+ - `defaults` supplies **every persona and every declared child**, including future
1073
+ personas, research helpers and team changes. `agents` and `subagents` contain
1074
+ exceptions. To preserve a persona's existing selection, omit it from `agents`;
1075
+ for example, `local-workers` leaves `orchestrator` out. Each selection accepts a
1076
+ model string or `{model, thinking}`.
1077
+ Unspecified thinking inherits defaults, then `off`. Tool caps and delegation
1078
+ depth remain unchanged. Unknown persona/child names are rejected.
1079
+ - `dispatcher` changes the current Pi session's model and thinking. When omitted,
1080
+ the live dispatcher keeps its current selection and may use any Pi model, even
1081
+ outside `allowed-models`; that list still applies to workers and peers. An
1082
+ `orchestrator` persona entry alone is not the live dispatcher.
1083
+ - `services` sets the watchdog and structured-return extractor independently;
1084
+ unspecified services use defaults. `panel` supplies 2–5 poll/debate voices and
1085
+ an optional single integrator. `/af-poll` and `/af-debate` select the active
1086
+ profile's panel automatically. Explicit other panel names are refused while
1087
+ the complete profile is active. Without `panel`, two default-model voices are used.
1088
+ - `routing: native` (default) keeps Hub-owned work on native Pi subprocesses.
1089
+ Without `allowed-models` it still refuses explicit coms dispatch, handoff,
1090
+ `coms_send` and peer spawning. With `allowed-models`, those peer actions are
1091
+ allowed only when the peer's advertised or planned model is on the list
1092
+ (exact `provider/model`, or a unique provider-less suffix match); a foreign,
1093
+ missing, or `unknown` model is refused, and `claude-code` peers are refused
1094
+ because their models cannot be allowlisted. Existing peer processes are not
1095
+ reconfigured or stopped. `routing: configured` opts into the existing dispatch
1096
+ policy and cannot be combined with `allowed-models`, since a peer's nested
1097
+ children cannot be verified by this hub.
1098
+ - `fallback: none` (default) disables automatic original-model fallback, including
1099
+ nested children and workflows. `declared` retains it. Optional `allowed-models`
1100
+ is an exact provider/model allowlist checked before actual child spawns and
1101
+ fallback attempts. Worker model pickers and session substitutions respect it;
1102
+ the live dispatcher is checked only when `dispatcher` is explicit.
1103
+ This governs Fleet model execution; it is not an OS/network sandbox for arbitrary
1104
+ shell commands or unrelated applications.
1105
+
1106
+ Activation validates the complete profile and Pi availability of its referenced
1107
+ models before changing settings. Missing models leave the previous configuration
1108
+ in place. Busy dispatchers, agents and poll/debate runs refuse switching: wait for
1109
+ completion first. On leaving a complete profile, the previous dispatcher, thinking
1110
+ and manual model/sub-role/substitution settings are restored before applying the
1111
+ next profile. A fresh Pi session clears the active profile; select it again there.
1112
+
1113
+ The profile is passed through the owned process tree. Workflow commands started
1114
+ from that session inherit its persona models, thinking, panel and fallback policy.
1115
+ Separately started fleet sessions/standing peers retain their own configuration.
1116
+ The bundled `local-full` profile explicitly covers all shipped child roles and needs
1117
+ no project model overrides. Every role, service and panel entry uses the single
1118
+ `omlx/Qwen3.8-Flash-Next-GSQ-RCO-Q2_0` model. The `local-workers` profile uses that same local
1119
+ model for agents, subagents, services and panel voices, while leaving `orchestrator`
1120
+ to inherit its current selection; its peer allowlist refuses non-local coms models.
1121
+ The model must be registered in Pi and served by the incoai provider. Selecting a profile
1122
+ does not download or register models.
1123
+
1124
+ ## System 1 dispatch advice and communication
1125
+
1126
+ Fleet `1` opens the session-only System 1 communication viewer; capture requires
1127
+ explicit opt-in. The orchestrator may call `dispatch_triage` when its separate
1128
+ human-owned configuration permits it. Both remain off by default; installation
1129
+ does not authorize live requests or calibrate the policy. See the
1130
+ [configuration, keys, privacy and evaluation guide](system1-dispatch-triage.md).
1131
+
1132
+ ### Fleet Dashboard thinking shortcut
1133
+
1134
+ In the Fleet Dashboard (**Alt+A**), select a native specialist or research persona
1135
+ with **↑/↓**, then use **←/→** to decrease/increase its thinking level
1136
+ (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`). The arrows stop at either end.
1137
+ Changes are session-only and apply on the next dispatch or `spawn_research`,
1138
+ not to an already-running request. External coms peers, delegates and anonymous
1139
+ research helpers do not support this shortcut.
1140
+
1141
+ ## Unified System 1 v2 configuration
1142
+
1143
+ 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.