@chankov/agent-fleet 2.0.12 → 2.0.13

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 (616) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +5 -3
  2. package/.pi/agent-fleet/scripts/lib/flow-command.ts +9 -4
  3. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +3 -1
  4. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  5. package/.pi/agents/model-profiles.yaml +80 -29
  6. package/.pi/agents/peers.yaml +18 -18
  7. package/.pi/agents/voices.yaml +2 -2
  8. package/.pi/harnesses/agent-hub/README.md +55 -4
  9. package/.pi/harnesses/agent-hub/commands/audit.ts +1 -1
  10. package/.pi/harnesses/agent-hub/commands/context.ts +1 -1
  11. package/.pi/harnesses/agent-hub/config/model-profiles.ts +1 -0
  12. package/.pi/harnesses/agent-hub/delegate.ts +5 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +27 -2
  14. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +29 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +6 -0
  16. package/.pi/harnesses/agent-hub/index.ts +75 -40
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +2 -2
  19. package/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  20. package/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  21. package/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  22. package/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  23. package/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  24. package/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  25. package/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  26. package/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  27. package/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  28. package/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  29. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  30. package/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  31. package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
  32. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -0
  33. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  34. package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -1
  35. package/.pi/harnesses/agent-hub/return-extract.js +1 -1
  36. package/.pi/harnesses/agent-hub/session-audit.ts +6 -5
  37. package/.pi/harnesses/agent-hub/system1-activity.ts +67 -0
  38. package/.pi/harnesses/agent-hub/system1-report.ts +142 -1
  39. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -0
  40. package/.pi/harnesses/agent-hub/tools/run-flow.ts +16 -2
  41. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +26 -5
  42. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +30 -5
  43. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +7 -2
  44. package/.pi/harnesses/agent-hub/ui/grid.ts +12 -7
  45. package/.pi/harnesses/coms/package.json +1 -1
  46. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  47. package/.pi/harnesses/lib/context-budget-child-prompt.ts +41 -2
  48. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +4 -2
  49. package/.pi/harnesses/lib/fleet-dashboard-view.ts +14 -3
  50. package/.pi/harnesses/lib/fleet-detail-view.ts +68 -7
  51. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  52. package/.pi/harnesses/lib/fleet-strip-view.ts +44 -9
  53. package/.pi/prompts/af-setup-rules.md +20 -0
  54. package/.versions/2.0.13/.pi/agent-fleet/hermes/README.md +347 -0
  55. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  56. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  57. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  58. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  59. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  60. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  61. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  62. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  63. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  64. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  65. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  66. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  67. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  68. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  69. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  70. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  71. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  72. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  73. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  74. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  75. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  76. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  77. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  78. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  79. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  80. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  81. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  82. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  83. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  84. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  85. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  86. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  87. package/.versions/2.0.13/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  88. package/.versions/2.0.13/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  89. package/.versions/2.0.13/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  90. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  91. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  92. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  93. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  94. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  95. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet.ts +216 -0
  96. package/.versions/2.0.13/.pi/agent-fleet/scripts/flow.ts +157 -0
  97. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  98. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  99. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  100. package/.versions/2.0.13/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  101. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  102. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  103. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  104. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  105. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  106. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  107. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  108. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  109. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  110. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  111. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  112. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  113. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  114. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  115. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  116. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  117. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  118. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  119. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  120. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  121. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  122. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  123. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  124. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  125. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  126. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  127. package/.versions/2.0.13/.pi/agent-fleet/scripts/package-lock.json +35 -0
  128. package/.versions/2.0.13/.pi/agent-fleet/scripts/package.json +9 -0
  129. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  130. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  131. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  132. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-up.ts +378 -0
  133. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  134. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  135. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  136. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  137. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  138. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  139. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  140. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  141. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  142. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  143. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  144. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  145. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  146. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  147. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  148. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  149. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  150. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  151. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  152. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  153. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  154. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  155. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  156. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  157. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  158. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  159. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  160. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  161. package/.versions/2.0.13/.pi/agents/dispatch-policy.yaml +32 -0
  162. package/.versions/2.0.13/.pi/agents/model-profiles.yaml +134 -0
  163. package/.versions/2.0.13/.pi/agents/peers.yaml +147 -0
  164. package/.versions/2.0.13/.pi/agents/teams.yaml +41 -0
  165. package/.versions/2.0.13/.pi/agents/voices.yaml +13 -0
  166. package/.versions/2.0.13/.pi/damage-control-rules.yaml +297 -0
  167. package/.versions/2.0.13/.pi/extensions/btw/README.md +120 -0
  168. package/.versions/2.0.13/.pi/extensions/btw/index.ts +914 -0
  169. package/.versions/2.0.13/.pi/extensions/btw/package.json +6 -0
  170. package/.versions/2.0.13/.pi/extensions/btw/state.js +179 -0
  171. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  172. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  173. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  174. package/.versions/2.0.13/.pi/extensions/compact-and-continue/README.md +42 -0
  175. package/.versions/2.0.13/.pi/extensions/compact-and-continue/index.ts +120 -0
  176. package/.versions/2.0.13/.pi/extensions/compact-and-continue/package.json +6 -0
  177. package/.versions/2.0.13/.pi/extensions/mcp-bridge/README.md +46 -0
  178. package/.versions/2.0.13/.pi/extensions/mcp-bridge/index.ts +206 -0
  179. package/.versions/2.0.13/.pi/extensions/mcp-bridge/package.json +6 -0
  180. package/.versions/2.0.13/.pi/extensions/package-lock.json +1175 -0
  181. package/.versions/2.0.13/.pi/extensions/package.json +9 -0
  182. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/README.md +224 -0
  183. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/config.ts +198 -0
  184. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  185. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/index.ts +248 -0
  186. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/package.json +6 -0
  187. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  188. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  189. package/.versions/2.0.13/.pi/harnesses/agent-hub/README.md +1360 -0
  190. package/.versions/2.0.13/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  191. package/.versions/2.0.13/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  192. package/.versions/2.0.13/.pi/harnesses/agent-hub/artifacts.js +146 -0
  193. package/.versions/2.0.13/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  194. package/.versions/2.0.13/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  195. package/.versions/2.0.13/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  196. package/.versions/2.0.13/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  197. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  198. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  199. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  200. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  201. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  202. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  203. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  204. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  205. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  206. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  207. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  208. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  209. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  210. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  211. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  212. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  213. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  214. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  215. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  216. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  217. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  218. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  219. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  220. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  221. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  222. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  223. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  224. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  225. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  226. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  227. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  228. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  229. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  230. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  231. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  232. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  233. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  234. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  235. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  236. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  237. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  238. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-window.js +108 -0
  239. package/.versions/2.0.13/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  240. package/.versions/2.0.13/.pi/harnesses/agent-hub/delegate.ts +467 -0
  241. package/.versions/2.0.13/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  242. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  243. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  244. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  245. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  246. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  247. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  248. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  249. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  250. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  251. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  252. package/.versions/2.0.13/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  253. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  254. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  255. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  256. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  257. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  258. package/.versions/2.0.13/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  259. package/.versions/2.0.13/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  260. package/.versions/2.0.13/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  261. package/.versions/2.0.13/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  262. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
  263. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  264. package/.versions/2.0.13/.pi/harnesses/agent-hub/footer.ts +30 -0
  265. package/.versions/2.0.13/.pi/harnesses/agent-hub/helpers.ts +270 -0
  266. package/.versions/2.0.13/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  267. package/.versions/2.0.13/.pi/harnesses/agent-hub/index.ts +2336 -0
  268. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  269. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  270. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  271. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  272. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  273. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  274. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  275. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  276. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  277. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  278. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  279. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  280. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  281. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  282. package/.versions/2.0.13/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  283. package/.versions/2.0.13/.pi/harnesses/agent-hub/package.json +7 -0
  284. package/.versions/2.0.13/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  285. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  286. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  287. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  288. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  289. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  290. package/.versions/2.0.13/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  291. package/.versions/2.0.13/.pi/harnesses/agent-hub/presentation.ts +48 -0
  292. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  293. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  294. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  295. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  296. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  297. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  298. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  299. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  300. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  301. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  302. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  303. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  304. package/.versions/2.0.13/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  305. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/context.ts +53 -0
  306. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  307. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  308. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/system-prompt.ts +115 -0
  309. package/.versions/2.0.13/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  310. package/.versions/2.0.13/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  311. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  312. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  313. package/.versions/2.0.13/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  314. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  315. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  316. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  317. package/.versions/2.0.13/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  318. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-contract.js +327 -0
  319. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-extract.js +77 -0
  320. package/.versions/2.0.13/.pi/harnesses/agent-hub/review-findings.js +104 -0
  321. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-budget.js +542 -0
  322. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  323. package/.versions/2.0.13/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  324. package/.versions/2.0.13/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  325. package/.versions/2.0.13/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  326. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  327. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-health.js +110 -0
  328. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-start.ts +42 -0
  329. package/.versions/2.0.13/.pi/harnesses/agent-hub/spawn.ts +526 -0
  330. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  331. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  332. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-runtime.ts +276 -0
  333. package/.versions/2.0.13/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  334. package/.versions/2.0.13/.pi/harnesses/agent-hub/timeline.ts +72 -0
  335. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  336. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  337. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  338. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  339. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  340. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  341. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  342. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  343. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  344. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  345. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  346. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  347. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  348. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  349. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  350. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  351. package/.versions/2.0.13/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  352. package/.versions/2.0.13/.pi/harnesses/agent-hub/types.ts +66 -0
  353. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  354. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  355. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  356. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  357. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +124 -0
  358. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  359. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  360. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  361. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  362. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  363. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  364. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  365. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  366. package/.versions/2.0.13/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  367. package/.versions/2.0.13/.pi/harnesses/agent-hub/version.ts +42 -0
  368. package/.versions/2.0.13/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  369. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  370. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  371. package/.versions/2.0.13/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  372. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/README.md +59 -0
  373. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/index.ts +558 -0
  374. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  375. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  376. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  377. package/.versions/2.0.13/.pi/harnesses/coms/README.md +100 -0
  378. package/.versions/2.0.13/.pi/harnesses/coms/index.ts +282 -0
  379. package/.versions/2.0.13/.pi/harnesses/coms/package.json +7 -0
  380. package/.versions/2.0.13/.pi/harnesses/coms/version.ts +42 -0
  381. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/README.md +135 -0
  382. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/index.ts +550 -0
  383. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/package.json +7 -0
  384. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/version.ts +42 -0
  385. package/.versions/2.0.13/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  386. package/.versions/2.0.13/.pi/harnesses/lib/coms-core-io.ts +385 -0
  387. package/.versions/2.0.13/.pi/harnesses/lib/coms-core.ts +577 -0
  388. package/.versions/2.0.13/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  389. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  390. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  391. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-view.ts +107 -0
  392. package/.versions/2.0.13/.pi/harnesses/lib/context-budget.ts +114 -0
  393. package/.versions/2.0.13/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  394. package/.versions/2.0.13/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  395. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  396. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  397. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  398. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  399. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  400. package/.versions/2.0.13/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  401. package/.versions/2.0.13/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  402. package/.versions/2.0.13/.pi/harnesses/lib/fleet-panel.ts +34 -0
  403. package/.versions/2.0.13/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  404. package/.versions/2.0.13/.pi/harnesses/lib/fleet-selection.ts +24 -0
  405. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  406. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  407. package/.versions/2.0.13/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  408. package/.versions/2.0.13/.pi/harnesses/lib/herdr-client.ts +472 -0
  409. package/.versions/2.0.13/.pi/harnesses/lib/herdr-presence.ts +399 -0
  410. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  411. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  412. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  413. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  414. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  415. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  416. package/.versions/2.0.13/.pi/harnesses/lib/spawned-peers.js +191 -0
  417. package/.versions/2.0.13/.pi/harnesses/lib/system1/config.js +61 -0
  418. package/.versions/2.0.13/.pi/harnesses/lib/system1/contracts.ts +152 -0
  419. package/.versions/2.0.13/.pi/harnesses/lib/system1/demo.ts +106 -0
  420. package/.versions/2.0.13/.pi/harnesses/lib/system1/jev.ts +503 -0
  421. package/.versions/2.0.13/.pi/harnesses/lib/system1/service.ts +245 -0
  422. package/.versions/2.0.13/.pi/harnesses/lib/update-check.ts +222 -0
  423. package/.versions/2.0.13/.pi/harnesses/package-lock.json +2039 -0
  424. package/.versions/2.0.13/.pi/harnesses/package.json +10 -0
  425. package/.versions/2.0.13/.pi/prompts/af-build.md +24 -0
  426. package/.versions/2.0.13/.pi/prompts/af-code-simplify.md +22 -0
  427. package/.versions/2.0.13/.pi/prompts/af-constraints.md +31 -0
  428. package/.versions/2.0.13/.pi/prompts/af-plan.md +17 -0
  429. package/.versions/2.0.13/.pi/prompts/af-review.md +16 -0
  430. package/.versions/2.0.13/.pi/prompts/af-set-hermes-telegram.md +15 -0
  431. package/.versions/2.0.13/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  432. package/.versions/2.0.13/.pi/prompts/af-setup-rules.md +20 -0
  433. package/.versions/2.0.13/.pi/prompts/af-ship.md +17 -0
  434. package/.versions/2.0.13/.pi/prompts/af-spec.md +15 -0
  435. package/.versions/2.0.13/.pi/prompts/af-test.md +19 -0
  436. package/.versions/2.0.13/.pi/skills/bowser/SKILL.md +145 -0
  437. package/.versions/2.0.13/.version +1 -0
  438. package/.versions/2.0.13/agents/architect.md +24 -0
  439. package/.versions/2.0.13/agents/bowser.md +28 -0
  440. package/.versions/2.0.13/agents/builder.md +55 -0
  441. package/.versions/2.0.13/agents/code-reviewer.md +209 -0
  442. package/.versions/2.0.13/agents/deep-researcher.md +32 -0
  443. package/.versions/2.0.13/agents/documenter.md +22 -0
  444. package/.versions/2.0.13/agents/orchestrator.md +22 -0
  445. package/.versions/2.0.13/agents/plan-reviewer.md +83 -0
  446. package/.versions/2.0.13/agents/planner.md +105 -0
  447. package/.versions/2.0.13/agents/releaser.md +24 -0
  448. package/.versions/2.0.13/agents/researcher.md +30 -0
  449. package/.versions/2.0.13/agents/security-auditor.md +167 -0
  450. package/.versions/2.0.13/agents/test-engineer.md +153 -0
  451. package/.versions/2.0.13/agents/web-debugger.md +44 -0
  452. package/.versions/2.0.13/agents/web-performance-auditor.md +194 -0
  453. package/.versions/2.0.13/bin/catalog/harness-runtime-closure.json +73 -0
  454. package/.versions/2.0.13/codex/fleet-session-client/SKILL.md +34 -0
  455. package/.versions/2.0.13/codex/fleet-session-client.zip +0 -0
  456. package/.versions/2.0.13/docs/ARCHITECTURE.md +753 -0
  457. package/.versions/2.0.13/docs/agent-fleet-setup.md +900 -0
  458. package/.versions/2.0.13/docs/claude-code-coms-bridge.md +134 -0
  459. package/.versions/2.0.13/docs/codex-session-bridge.md +219 -0
  460. package/.versions/2.0.13/docs/coms-hermes-bridge.md +188 -0
  461. package/.versions/2.0.13/docs/getting-started.md +126 -0
  462. package/.versions/2.0.13/docs/npm-install.md +468 -0
  463. package/.versions/2.0.13/docs/pi-extensions.md +454 -0
  464. package/.versions/2.0.13/docs/pi-setup.md +92 -0
  465. package/.versions/2.0.13/docs/skill-anatomy.md +150 -0
  466. package/.versions/2.0.13/install-manifest.json +3175 -0
  467. package/.versions/2.0.13/justfile +247 -0
  468. package/.versions/2.0.13/manifest-meta.json +1057 -0
  469. package/.versions/2.0.13/references/accessibility-checklist.md +160 -0
  470. package/.versions/2.0.13/references/communication-contract.md +26 -0
  471. package/.versions/2.0.13/references/definition-of-done.md +67 -0
  472. package/.versions/2.0.13/references/fleet-coordination-patterns.md +171 -0
  473. package/.versions/2.0.13/references/observability-checklist.md +92 -0
  474. package/.versions/2.0.13/references/orchestration-patterns.md +370 -0
  475. package/.versions/2.0.13/references/performance-checklist.md +236 -0
  476. package/.versions/2.0.13/references/prompting-patterns.md +380 -0
  477. package/.versions/2.0.13/references/security-checklist.md +245 -0
  478. package/.versions/2.0.13/references/testing-patterns.md +235 -0
  479. package/.versions/2.0.13/references/workflow-authoring.md +304 -0
  480. package/.versions/2.0.13/skills/_internal/grilling.md +59 -0
  481. package/.versions/2.0.13/skills/browser-testing-with-devtools/SKILL.md +351 -0
  482. package/.versions/2.0.13/skills/code-review-and-quality/SKILL.md +396 -0
  483. package/.versions/2.0.13/skills/compound-learning/SKILL.md +137 -0
  484. package/.versions/2.0.13/skills/constraint-driven-development/SKILL.md +338 -0
  485. package/.versions/2.0.13/skills/constraint-driven-development/references/floor-guard.md +99 -0
  486. package/.versions/2.0.13/skills/context-engineering/SKILL.md +341 -0
  487. package/.versions/2.0.13/skills/deprecation-and-migration/SKILL.md +247 -0
  488. package/.versions/2.0.13/skills/designing-agents/SKILL.md +394 -0
  489. package/.versions/2.0.13/skills/designing-agents/pi-harness-authoring.md +222 -0
  490. package/.versions/2.0.13/skills/drafting-workflows/SKILL.md +143 -0
  491. package/.versions/2.0.13/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  492. package/.versions/2.0.13/skills/frontend-ui-engineering/SKILL.md +328 -0
  493. package/.versions/2.0.13/skills/git-workflow-and-versioning/SKILL.md +316 -0
  494. package/.versions/2.0.13/skills/idea-refine/SKILL.md +182 -0
  495. package/.versions/2.0.13/skills/idea-refine/examples.md +238 -0
  496. package/.versions/2.0.13/skills/idea-refine/frameworks.md +99 -0
  497. package/.versions/2.0.13/skills/idea-refine/refinement-criteria.md +113 -0
  498. package/.versions/2.0.13/skills/idea-refine/scripts/idea-refine.sh +15 -0
  499. package/.versions/2.0.13/skills/incremental-implementation/SKILL.md +302 -0
  500. package/.versions/2.0.13/skills/interview-me/SKILL.md +226 -0
  501. package/.versions/2.0.13/skills/orchestration-verification/SKILL.md +182 -0
  502. package/.versions/2.0.13/skills/peer-coms/SKILL.md +90 -0
  503. package/.versions/2.0.13/skills/performance-optimization/SKILL.md +496 -0
  504. package/.versions/2.0.13/skills/planning-and-task-breakdown/SKILL.md +289 -0
  505. package/.versions/2.0.13/skills/repository-ai-setup/SKILL.md +117 -0
  506. package/.versions/2.0.13/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  507. package/.versions/2.0.13/skills/repository-ai-setup/references/apply-contract.md +74 -0
  508. package/.versions/2.0.13/skills/repository-ai-setup/references/provenance-template.md +16 -0
  509. package/.versions/2.0.13/skills/repository-ai-setup/references/setup-flow.md +108 -0
  510. package/.versions/2.0.13/skills/repository-ai-setup/references/verify-setup.md +20 -0
  511. package/.versions/2.0.13/skills/security-and-hardening/SKILL.md +524 -0
  512. package/.versions/2.0.13/skills/spec-driven-development/SKILL.md +295 -0
  513. package/.versions/2.0.13/skills/using-agent-skills/SKILL.md +198 -0
  514. package/.versions/2.0.13/vendor/agent-skills-upstream/LICENSE +21 -0
  515. package/.versions/2.0.13/vendor/agent-skills-upstream/README.md +430 -0
  516. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  517. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  518. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  519. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  520. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  521. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  522. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  523. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  524. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  525. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  526. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  527. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  528. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  529. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  530. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  531. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  532. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  533. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  534. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  535. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  536. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  537. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  538. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  539. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  540. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  541. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  542. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  543. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  544. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  545. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  546. package/CHANGELOG.md +10 -0
  547. package/README.md +3 -3
  548. package/agents/architect.md +2 -3
  549. package/agents/bowser.md +2 -2
  550. package/agents/builder.md +2 -3
  551. package/agents/code-reviewer.md +7 -8
  552. package/agents/deep-researcher.md +3 -4
  553. package/agents/documenter.md +2 -3
  554. package/agents/orchestrator.md +2 -3
  555. package/agents/plan-reviewer.md +5 -6
  556. package/agents/planner.md +5 -6
  557. package/agents/releaser.md +2 -3
  558. package/agents/researcher.md +4 -5
  559. package/agents/security-auditor.md +6 -7
  560. package/agents/test-engineer.md +3 -4
  561. package/agents/web-debugger.md +3 -3
  562. package/agents/web-performance-auditor.md +3 -3
  563. package/bin/catalog/harness-runtime-closure.json +30 -18
  564. package/bin/cli.js +47 -1
  565. package/bin/lib/apply.js +16 -0
  566. package/bin/lib/overrides.js +37 -1
  567. package/bin/lib/project-provenance.js +119 -0
  568. package/bin/lib/scan.js +1 -1
  569. package/bin/lib/transaction.js +1 -1
  570. package/bin/lib/validate-overrides.js +37 -3
  571. package/catalog/agent-prompts/README.md +12 -0
  572. package/catalog/agent-prompts/architecture-decision-author.md +24 -0
  573. package/catalog/agent-prompts/requirements-author.md +21 -0
  574. package/catalog/commands/README.md +13 -0
  575. package/catalog/commands/assess-change-impact.md +19 -0
  576. package/catalog/commands/audit-documentation.md +19 -0
  577. package/catalog/rules/README.md +33 -0
  578. package/catalog/rules/ai/policy-authoring.md +22 -0
  579. package/catalog/rules/architecture/behavior-preserving-refactoring.md +25 -0
  580. package/catalog/rules/architecture/public-contracts.md +22 -0
  581. package/catalog/rules/architecture/repository-boundaries.md +21 -0
  582. package/catalog/rules/architecture/structural-change-registration.md +25 -0
  583. package/catalog/rules/backend/notification-date-time.md +25 -0
  584. package/catalog/rules/bundles/README.md +16 -0
  585. package/catalog/rules/data/enum-semantics.md +25 -0
  586. package/catalog/rules/data/mixed-ownership-data.md +22 -0
  587. package/catalog/rules/data/reporting-queries.md +34 -0
  588. package/catalog/rules/docs/docs-maintenance.md +25 -0
  589. package/catalog/rules/frameworks/vue.md +25 -0
  590. package/catalog/rules/frontend/async-ui-states.md +26 -0
  591. package/catalog/rules/frontend/established-ui-primitives.md +25 -0
  592. package/catalog/rules/frontend/form-validation.md +26 -0
  593. package/catalog/rules/frontend/navigation-contracts.md +25 -0
  594. package/catalog/rules/languages/csharp.md +25 -0
  595. package/catalog/rules/languages/javascript.md +25 -0
  596. package/catalog/rules/languages/sql.md +24 -0
  597. package/catalog/rules/security/authorization-before-effects.md +26 -0
  598. package/catalog/rules/security/diagnostic-data-safety.md +22 -0
  599. package/catalog/rules/security/response-data-minimization.md +25 -0
  600. package/catalog/rules/security/trusted-tenant-scope.md +26 -0
  601. package/catalog/rules/testing/shared-package-consumers.md +25 -0
  602. package/catalog/rules/testing/verification-conventions.md +24 -0
  603. package/docs/ARCHITECTURE.md +50 -2
  604. package/docs/agent-fleet-setup.md +246 -28
  605. package/docs/codex-session-bridge.md +1 -1
  606. package/docs/pi-extensions.md +10 -5
  607. package/docs/workflows.md +4 -3
  608. package/install-manifest.json +125 -3
  609. package/manifest-meta.json +77 -15
  610. package/package.json +5 -3
  611. package/skills/repository-ai-setup/SKILL.md +117 -0
  612. package/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  613. package/skills/repository-ai-setup/references/apply-contract.md +74 -0
  614. package/skills/repository-ai-setup/references/provenance-template.md +16 -0
  615. package/skills/repository-ai-setup/references/setup-flow.md +108 -0
  616. package/skills/repository-ai-setup/references/verify-setup.md +20 -0
@@ -47,7 +47,7 @@ not a session execution mode.
47
47
 
48
48
  All Hub-owned slash commands remain registered in both work modes. Capability packs are resolved automatically from explicit task intent, work mode, tier, pending work, and compaction state—there is no activation command. Runtime **readiness** (a coms or Herdr connection) is not model-visible capability: ready-but-unrequested peer/workspace packs remain inactive. Ambiguous fleet, peer, and workspace requests are provisionally visible but require one `ask_user` confirmation before their first side effect; a rejection removes the provisional pack. Task packs persist across follow-ups and reset only through `set_task_tier(new_task: true)`, while mandatory work mode and pending-operation leases remain.
49
49
 
50
- `/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. `/af-audit` is a separate read-only session audit over existing runtime-owned records: it reports allowlisted T1 recovery categories, T2 result states, T3 protocol failures, and T8 permission correlations while keeping root, child, compaction snapshot, and repeated-record identities distinct. It never copies prompts, model text, tool payloads, environment values, or transcript content, and unavailable evidence stays explicit rather than becoming a zero count. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
50
+ `/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. `/af-audit` is a separate read-only session audit over existing runtime-owned records: it reports allowlisted T1 recovery categories, T2 result states, T3 protocol failures, and T8 permission correlations while keeping root, child, compaction snapshot, and repeated-record identities distinct. It never copies prompts, model text, tool payloads, environment values, or transcript content, and unavailable evidence stays explicit rather than becoming a zero count. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Configured project rule and documentation pointers are rendered into the Hub prompt in both work modes and into native specialist, nested delegate, research, and coms handoffs. Files are read directly; folders are resolved index-first, with recursive rule discovery only when no index exists. The prompt carries pointers and selection instructions rather than bulk-injecting rule bodies, and the Hub ledger attributes that text as `hub/policy/project`. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
51
51
 
52
52
  T12 diagnostics have been withdrawn by user decision; there is no command, runner, or replacement entry point. Historical results and accounting remain unchanged. `diagnostic-series-budget.ts` retains the shared v2 ledger, stage/per-unit ceilings, conservative input preflight, migration refusal for ambiguous history, ownership locks, and cancellation fences used by benchmark consumers. `diagnostic-probe-extension.ts` is now a side-effect-free compatibility library exposing only provider/API output-cap mapping, its types, and the transport refusal exit constant. It preserves the reviewed 2048 cap and rejects unsupported payload semantics; it does not register an extension or tool. Existing sessions must be reloaded after updating. The installer retires unchanged managed command/runner files; user-modified obsolete files are preserved and reported for manual review, never deleted automatically. Such retained files are not imported by the current Hub.
53
53
 
@@ -489,6 +489,54 @@ are still required before calling this calibrated or expanding its authority. Of
489
489
  constitute a live pilot (G1) or active approval (G2). Roll back with
490
490
  `watchdog-system1: off` and restart Hub; cancel the current run if needed.
491
491
 
492
+ ### Proactive turn review (separate opt-in consumer)
493
+
494
+ The Hub's `proactive-*` modules compose a separate, off-by-default consumer of the
495
+ existing shared System 1 library and its provider/key; they do not create another
496
+ provider owner or change watchdog authority. A human-owned per-repository
497
+ `.ai/proactive-review.json` selects `off`, `shadow`, or `advisory` and exact
498
+ repository-relative include scope. Missing/off means **zero proactive capture,
499
+ inference, and feedback**. Enabled config with `remoteContext: "disabled"` is
500
+ local-only: bounded source/rule capture and reviewed local validators may run,
501
+ but no semantic provider assessment. `selected-excerpts` separately permits
502
+ bounded selected source/assistant excerpts to the shared System 1 service when
503
+ it is ready; shadow records findings without delivery, advisory may deliver
504
+ feedback at the next *already-occurring* context hook for the same owner,
505
+ attempt, task, and bound rule/source revision. It never creates a turn, fixes
506
+ code, terminates work, changes acceptance gates, or suppresses the watchdog.
507
+ No activation, outbound transmission, or remote repository authorization is
508
+ conferred by installing this code or reading this documentation.
509
+
510
+ At `turn_start`/`turn_end`, Hub and supported native Pi specialists bind the
511
+ explicit task/plan and session rule catalog, collect bounded immutable
512
+ before/after worktree and text evidence, and retain private snapshots separately
513
+ from metadata-only finding/report projections. Source-backed rules come from
514
+ `rules:` folders in `## agent-hub` (legacy `## agent-team`), with index-first
515
+ Markdown discovery, explicit linked sections, and bounded fallback; discovery
516
+ is read-only and never executes rule instructions. Rule identity includes path,
517
+ heading occurrence and hash. Incomplete discovery, unselected sections,
518
+ unsupported Markdown, missing plan (`task_only`), concurrent edits, and
519
+ changed source stays partial, unsupported, uncertain or stale—not
520
+ confirmed passes. Rule references use the session-bound revision: on-disk rule
521
+ edits do not themselves stale a finding, and a restart is required to adopt them. Only explicitly reviewed bindings support deterministic
522
+ local link-form and new-file-placement checks; model findings remain
523
+ suspicions, not validated bugs. Rules are **bound per session**: editing a rule
524
+ in a running session does not reload it; restart to adopt edits. Research
525
+ helpers, nested delegates, coms peers and Hermes are not instrumented by this
526
+ consumer. Native observer hooks/integration were checked with repo-local Pi
527
+ 0.84.2; Node 18 compatibility concerns the extracted installer CLI/doctor,
528
+ not running the TypeScript observer under Node 18.
529
+
530
+ Limits and exclusions, exact config, local report/labels usage, and consent
531
+ sequence are in [Project Files — Proactive turn review](agent-fleet-setup.md#proactive-turn-review-experimental).
532
+ Offline/installed tests and C5 operator visibility establish neither live-pilot
533
+ utility nor universal correctness. The finding-label source fix passed final independent source/docs review;
534
+ this establishes offline/package readiness, not human-labelled semantic acceptance. Only retained finding keys
535
+ are exposed for human labels: checked-clear units lack an operator-accessible
536
+ key, so miss/true-negative labeling and full recall evaluation are not operational.
537
+ C7 human acceptance and any release/deployment remain separate. Current caveats include
538
+ unknown native delivery without a receipt and a rare async-close error risk.
539
+
492
540
  ### Experimental System 1 foundation
493
541
 
494
542
  System 1 is a shared Fleet library for bounded structured judgments, not a Pi
@@ -620,7 +668,7 @@ packages/hermes-bridge/ # future Hermes integration package
620
668
 
621
669
  ## Design rules
622
670
 
623
- - **Workflow engine remains single-sourced.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one flow acceptance decision. It uses the clean spawn/context seams and keeps its existing clean-tree/branch defaults; normal traces live under `.pi/flow-sessions/`. Flow branches retain source/result metadata, while reserved `cleanup` and `merge` delegate safe removal and squash integration to Worktrunk. The initial Hub `run_flow` adapter calls the same exported dispatcher directly and permits only read-only `scout`: it runs in a stable detached snapshot with no flow branch, stores trace/manifest in the current Hub session, and has one Hub budget/cancellation owner. Snapshot overlay operations validate plain parents before mutation and never follow a HEAD symlink leaf. The native process and descendants use `confineNativeChild`, with only the session-owned phase directory writable; the actual `read`/`grep`/`find`/`ls` data paths are separately limited to the snapshot while damage-control remains loaded. Runtime/model libraries and provider configuration remain readable for Pi startup, so this is intentionally not a global no-read claim. Duplicate identity is idempotent; stale/busy calls are uncharged. All setup/result exceptions settle as structured failures, release active ownership, and preserve honest charged/started state. Flow acceptance never promotes parent assertions or closes T11 obligations. Writable/committing flows remain outside this adapter pending a separate review.
671
+ - **Workflow engine remains single-sourced.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one flow acceptance decision. It uses the clean spawn/context seams and keeps its clean-tree guard while staying on the current branch by default; creating a flow branch requires explicit `--branch`; normal traces live under `.pi/flow-sessions/`. Explicit flow branches retain source/result metadata, while reserved `cleanup` and `merge` delegate safe removal and squash integration to Worktrunk. The initial Hub `run_flow` adapter calls the same exported dispatcher directly and permits only read-only `scout`: it runs in a stable detached snapshot with no flow branch, stores trace/manifest in the current Hub session, and has one Hub budget/cancellation owner. Snapshot overlay operations validate plain parents before mutation and never follow a HEAD symlink leaf. The native process and descendants use `confineNativeChild`, with only the session-owned phase directory writable; the actual `read`/`grep`/`find`/`ls` data paths are separately limited to the snapshot while damage-control remains loaded. Runtime/model libraries and provider configuration remain readable for Pi startup, so this is intentionally not a global no-read claim. Duplicate identity is idempotent; stale/busy calls are uncharged. All setup/result exceptions settle as structured failures, release active ownership, and preserve honest charged/started state. Owned scout snapshots are cleaned on settlement, with visible cleanup status/errors; traces and explicit branches are retained. Flow acceptance never promotes parent assertions or closes T11 obligations. Writable/committing flows remain outside this adapter pending a separate review.
624
672
  - **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
625
673
  context if it can live on disk or in a one-line status. Research findings,
626
674
  the Verification Contract ledger, and team snapshots are all disk-first.
@@ -12,6 +12,7 @@ different readers and different lifetimes, so they are kept separate.
12
12
  | `.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 |
13
13
  | `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
14
14
  | `.ai/system1.json` *(optional)* | System 1 shared runtime and doctor | When the experimental `system1` feature is explicitly selected |
15
+ | `.ai/proactive-review.json` *(optional)* | Hub proactive turn review consumer | At Hub session start; missing means off |
15
16
 
16
17
  The `.ai/system1.json` file is human-owned, non-secret provider configuration.
17
18
  Setup prints its required shape but does not create or overwrite it. Its
@@ -217,6 +218,227 @@ requires independent human labels identifying the snapshot **and LLM attempt**,
217
218
  held-out session evaluation and an explicit maintainer-approved profile. Older
218
219
  labels without an LLM attempt ID cannot qualify. No gate is inferred from doctor readiness.
219
220
 
221
+ ## Proactive turn review (experimental)
222
+
223
+ This is a **separate per-repository opt-in**, not a new provider or an installer
224
+ feature flag. The Hub/native consumer uses the existing shared System 1 service
225
+ (`system1` feature, `.ai/system1.json`, caller-owned key) only when selected
226
+ excerpts are explicitly permitted and the service is ready. Its config is
227
+ human-owned `.ai/proactive-review.json`; setup/doctor do not create or activate
228
+ it. Missing config or valid `{"version":1,"mode":"off"}` causes **zero
229
+ proactive capture, inference, and feedback**. Invalid configuration fails closed.
230
+ Nothing here authorizes a live pilot, client repository, ringithub, provider
231
+ request, release, deployment or active configuration change.
232
+
233
+ Modes: `shadow` records bounded local evidence/findings without feedback;
234
+ `advisory` additionally offers bounded feedback at the next **natural** turn,
235
+ never starting a turn itself. With `remoteContext: "disabled"` (the default),
236
+ either enabled mode is **local-only**: source-bound deterministic checks may
237
+ run, but no semantic model review; no finding does not mean reviewed. With
238
+ `remoteContext: "selected-excerpts"`, permitted included source/assistant
239
+ excerpts may be transmitted to the already configured System 1 provider for
240
+ semantic assessment. This is not a blanket secrecy guarantee: source is
241
+ selected within approved scope and bounded/excluded, but automatic comprehensive
242
+ redaction of unknown secrets is not established. Review the *exact outbound
243
+ payload* and scope before any real opt-in. No auto-fix, kill, blocking,
244
+ acceptance authority, watchdog override, or autonomous continuation follows a
245
+ finding. Feedback is restricted to the same owner/attempt/task and current
246
+ source hashes and the session-bound rule revision, once per finding revision, at an already-occurring context
247
+ hook; changed evidence is refused.
248
+
249
+ **Schema illustration only — NOT executed, NOT authorization or a recommended
250
+ repository scope:** after separate human approval of the exact repository,
251
+ paths, outbound categories, budget and payload, a human may choose values in
252
+ this shape; do not copy these example paths into active configuration:
253
+
254
+ ```json
255
+ {
256
+ "version": 1,
257
+ "mode": "shadow",
258
+ "remoteContext": "selected-excerpts",
259
+ "include": ["src/**", "docs/**"],
260
+ "maxEvaluationsPerSession": 100
261
+ }
262
+ ```
263
+
264
+ Only `version`, `mode`, `remoteContext`, `include`,
265
+ `maxEvaluationsPerSession`, `localBindings` are accepted. Version is `1`;
266
+ mode is `off|shadow|advisory`; remote context is
267
+ `disabled|selected-excerpts`. Enabled modes require a nonempty explicit
268
+ repository-relative `include` (≤32 distinct entries, ≤256 characters each;
269
+ no absolute/dot/traversal paths, hidden segments, backslashes, special
270
+ bracket/negation patterns or dependency/build/runtime directories). The
271
+ session evaluation budget is an integer 0–100, default 100 in enabled modes.
272
+ The optional `localBindings` (≤16) require reviewed source-bound Markdown
273
+ `rule` path/heading/positive occurrence/lowercase SHA-256 hash,
274
+ `applicability` paths and added/modified kinds, and explicit paths/legacy
275
+ exceptions; `new-file-placement` also needs an added-only prefix, while
276
+ `relative-markdown-links` checks link form/escape, **not target existence**.
277
+ These are not prose-rule compilation or a general Markdown/AST validator.
278
+ Off must not retain active includes, remote permission, bindings or explicit
279
+ nonzero budget: rollback uses the complete minimal off JSON above, then a
280
+ **new Hub session**. Cancel current work if immediate interruption is needed;
281
+ do not delete session evidence or user config as cleanup.
282
+
283
+ Rules come read-only from `rules:` roots in `## agent-hub` (legacy
284
+ `## agent-team`): index-first, literal Markdown links/references and bounded
285
+ recursive fallback. The catalog binds file/path, heading occurrence and hash
286
+ for the **session**; edits do not reload in-session, and a restart adopts them.
287
+ It cannot execute instructions in rules. Discovery has a 64-file/256 KiB
288
+ budget; selection at most 20 sections/32 KiB, with coverage gaps for missing,
289
+ unsafe, partial, unselected or unsupported sources. Only the explicit task
290
+ and explicitly supplied plan bind the review; absent plan is `task_only`, not
291
+ a search for the newest plan. Incomplete work, exceptions, parallel authorship
292
+ and same-turn rule edits can remain uncertain. No silence or skipped check is
293
+ proof of compliance. Hub and supported native specialists are covered;
294
+ research helpers, nested delegates, coms peers and Hermes are not.
295
+
296
+ Per turn: at most 20 source units, 256 KiB retained excerpts (64 KiB/file),
297
+ 32 KiB evaluation state, 16 questions/batch, two calls/turn, one active
298
+ job/session, one pending/owner with backlog ≤8 and 5 s queue wait. Capture
299
+ phase has a 1 s deadline; evaluation job has a 2 s deadline. Feedback is
300
+ ≤3 findings/1,500 characters; finding history/private snapshots are bounded
301
+ at 100, so readback/retention is **not** a complete session record. Captures
302
+ bind pre/post worktree bytes, hashes and offsets; private evidence can be
303
+ locally reopened with validated references, whereas trace/report summaries
304
+ contain metadata only. Exclude `.env`, credentials, `.git`, dependencies,
305
+ build/runtime/session/transcript trees, binaries and realpath escapes; never
306
+ assume redaction catches every secret. Review coverage can be `partial`, `not_checked`, `unsupported`, `stale`,
307
+ `unavailable` or `unknown` rather than a confirmed pass. Operator TUI/history retain a completed row briefly (10 s); metadata
308
+ readback persists within the bounded session record.
309
+
310
+ ### Release readiness and evaluation limits
311
+
312
+ The opt-in runtime, native observer, local validators, advisory delivery, Fleet
313
+ history/evidence, reports and package installation are implemented and
314
+ independently reviewed. Offline integration uses repo-local Pi **0.84.2**;
315
+ Node 18 compatibility applies separately to the installed CLI/doctor, not the
316
+ Pi harness. Review history and evidence retain the dashboard's fixed-height
317
+ frame, including blank rows, rather than exposing dispatcher chat underneath.
318
+
319
+ A maintainer-authorized synthetic Jev smoke has verified real provider
320
+ communication and the evaluator path. It is **not** the planned 30-case
321
+ human-labelled semantic evaluation, nor evidence of general accuracy or recall.
322
+ That evaluation and final semantic acceptance remain outstanding; findings-only
323
+ label-key access also limits operational miss/true-negative evaluation.
324
+
325
+ A release installs the capability, **not its activation**. Setup does not create
326
+ `.ai/proactive-review.json`, and preserves an existing human-owned file. The
327
+ maintainer's active config and repo-specific rule catalog are not release
328
+ artifacts. Each target repository needs its own explicit scope, rules and
329
+ outbound-data consent. Configuration/rules are loaded at session start; start a
330
+ fresh Fleet session after changing them. When testing file placement, verify
331
+ that the file is really inside the configured repository include path, not a
332
+ session `artifacts/` directory with a similar relative suffix.
333
+
334
+ ### Read-only reports and explicit human labels
335
+
336
+ `/af-hub-report` and `/af-audit` separate proactive and watchdog totals.
337
+ For measured comparison only, add `--labels /absolute/path/to/CURRENT_SESSION/artifacts/labels.json`
338
+ to **either** command. No default, file discovery, provider request or
339
+ automatic label inference occurs. The actual path must be an absolute regular
340
+ `.json` file below the *current* session's `artifacts/`, without symlink escape;
341
+ maximum 64 KiB and 320 labels. Only retained findings currently expose operator-readable label keys. In Fleet
342
+ Dashboard (**Alt+A**), open review history with **`p`**, select a finding with
343
+ **`n`**, then press **`e`** for its local captured evidence; alternatively open
344
+ the specialist detail, select a finding with **`n`**, and press **`e`**. Scroll
345
+ with ↑/↓ (or j/k), PgUp/PgDn, Home/End; Esc returns to the previous review-history or detail view. The evidence
346
+ view displays a JSON record with the exact `snapshotId`, slash-bearing catalog
347
+ `ruleId` (`path#heading@occurrence:hash`), session-bound `ruleHash`, and
348
+ `subject` for that finding. At narrow widths the JSON is wrapped into visual
349
+ chunks: remove one indentation column from each chunk and concatenate the
350
+ chunks to reconstruct the record. Unavailable evidence shows no template;
351
+ do not guess a key. Copy the reconstructed record into an explicit local
352
+ current-session artifacts `.json` array, leaving `expected` as `unknown` until
353
+ a human judges that finding (`violation` or `clean`). Never use raw
354
+ source/prompt payloads as label keys. This illustrative shape is not a
355
+ substitute for the evidence-view values:
356
+
357
+ ```json
358
+ [
359
+ {
360
+ "snapshotId": "<actual lowercase 64-hex snapshot ID>",
361
+ "ruleId": "<actual evidence-view catalog rule ID, including path/slashes>",
362
+ "ruleHash": "<actual bound lowercase 64-hex rule hash>",
363
+ "subject": "src/example.ts",
364
+ "expected": "unknown"
365
+ }
366
+ ]
367
+ ```
368
+
369
+ Each object has **exactly** these five keys; `expected` is
370
+ `violation|clean|unknown`. Match snapshot, rule ID, session-bound rule hash and subject to retained
371
+ finding evidence; a valid unmatched label is `unchecked`, not a false
372
+ pass/miss. Report comparison can join checked-clear verdicts, but the operator
373
+ UI exposes keys only for retained findings, not checked-clear units. Human
374
+ miss/true-negative labels cannot currently be authored from this UI; absent
375
+ human labels remain `unknown`. This is a partial finding-backed workflow, not
376
+ fully operational misses or recall evaluation. Missing/invalid labels yield `unavailable` with null
377
+ measurement counts; empty valid array is not a precision/recall score.
378
+ Counts distinguish reviewed/partial/coverage-unknown/skipped, uncovered rules,
379
+ deterministic findings versus System 1 suspicions, unknown usage and unknown
380
+ native delivery (no receipt). Trace-only readback does not reconstruct missing
381
+ coverage or invent zeroes. Any precision or miss count describes only *labelled checked* evidence, not
382
+ unlabelled clear units or universal correctness.
383
+
384
+ ### Offline installed-package runbook (not executed by this documentation change)
385
+
386
+ Use a fresh **temporary** directory/workspace, with Node supporting native
387
+ TypeScript for the observer, repo-local Pi 0.84.2, and existing dependencies;
388
+ Node 18 is checked separately for the extracted CLI. These are test-backed
389
+ instructions, **not** commands run by this documentation patch. From this
390
+ repository's root, the safest reproducible run is:
391
+
392
+ ```sh
393
+ node --test .pi/agent-fleet/scripts/docs-links.test.mjs
394
+ # Supply an actual installed Node 18 executable; the test fails if unavailable.
395
+ AF_NODE18=/absolute/path/to/node18 node --test bin/test/proactive-installed.test.js
396
+ node --test --test-name-pattern='isolated tarball supports' bin/test/package-surfaces.test.js
397
+ ```
398
+
399
+ The installed test packs with `npm pack --json --pack-destination <temp>`,
400
+ extracts with `tar -xzf <tarball> --strip-components=1 -C <temp>/package`,
401
+ and runs `node <temp>/package/bin/cli.js setup --workspace <temp>/installed
402
+ --preset default --features none --yes` under a scrubbed offline environment.
403
+ It checks the installed 12-file runtime closure and an offline fake-provider Pi
404
+ observer/capture, no auto `.ai/proactive-review.json` or proactive desired-state
405
+ key, preservation of a **test-only HUMAN fixture** across repeat setup and
406
+ `doctor`/`doctor --fix`, and extracted-CLI version/help/readonly doctor under
407
+ Node 18. Doctor may return 0 or findings exit 2. The smoke reuses existing
408
+ repository dependencies, not a fresh dependency install; its network guard is
409
+ limited and does not prove every step physically network-isolated. Do not
410
+ create the illustrative active config above in a real workspace while testing.
411
+ The operator must run the link test and installed test on the final changed
412
+ state; this document alone is not verification.
413
+
414
+ ### Separate live pilot and acceptance
415
+
416
+ C5 operator visibility was human accepted, and the final post-fix source/docs
417
+ review accepted the C6 offline/package work. The later review-history overlay
418
+ fix is covered by fixed-frame and real Pi compositor regression tests; its
419
+ human visual retest is separate. Implemented/offline/installed evidence is not
420
+ live semantic accuracy. Explicit advisory activation in the maintainer's
421
+ repository and a synthetic Jev transport/evaluator smoke have occurred; neither
422
+ completes the planned human-labelled pilot or C7 semantic acceptance. For a new
423
+ repository, first review synthetic/offline evidence, then require **explicit
424
+ repo-specific shadow consent**, including exact include/exclusion paths,
425
+ reviewed bindings, session budget, outbound categories and representative
426
+ exact payload review; separate explicit consent is required for advisory.
427
+ There is no implied ringithub/customer repo authorization. A subsequent pilot
428
+ requires ≥30 **human-labelled** code/text assessments including ≥10 known
429
+ violations/deviations, BG/EN, legacy/new code, interim work, exceptions,
430
+ text-only and no-plan cases; manually review selector omissions and uncertain
431
+ cases. Measure finding-backed labelled precision and false alarms alongside coverage,
432
+ capture overhead, model p50/p95 latency, queue drops and known/unknown usage.
433
+ Miss/true-negative human-label keys for checked-clear units are not exposed;
434
+ report miss joins from synthetic/offline tests do not establish operational
435
+ miss/recall measurement. Record that gap explicitly in any pilot assessment
436
+ rather than treating unknown labels as negatives. Synthetic/offline success is not semantic or live
437
+ proof; no automatic mode promotion or invented accuracy threshold. C7 asks
438
+ the maintainer to accept limitations/evidence and explicitly choose each
439
+ repository's off/shadow/advisory state. No release or deployment follows from
440
+ these docs or C6.
441
+
220
442
  ## The overrides file — `.ai/agent-fleet-overrides.md`
221
443
 
222
444
  Some skills and pi harnesses need facts specific to each project — where specs
@@ -236,6 +458,7 @@ it here, and the reader picks it up.
236
458
  `.env`.
237
459
  - If the file is absent, or a reader has no section in it, that reader uses its
238
460
  built-in default.
461
+ - **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.
239
462
  - **Validation.** Because an unknown section or key silently falls back to the
240
463
  default, typos are invisible at runtime. `agent-fleet doctor` (and the
241
464
  runtime's Agent Fleet doctor command) validates the file — unknown sections,
@@ -601,45 +824,40 @@ profile declares the whole execution model set independently of
601
824
  `.ai/agent-fleet-overrides.md`:
602
825
 
603
826
  ```yaml
604
- local-duo:
827
+ local-full:
605
828
  version: 2
606
829
  defaults:
607
830
  model: &qwen36 omlx/Qwen3.6-35B-A3B-4bit
608
831
  thinking: off
609
832
  allowed-models:
610
833
  - *qwen36
611
- - &qwen omlx/Qwen3.8-9B-heretic-uncensored-5bit-MLX
612
834
  fallback: none
613
835
  routing: native
614
836
  dispatcher: *qwen36
615
837
  agents:
616
- documenter: *qwen
617
- # all other shipped personas inherit *qwen36 (see .pi/agents/model-profiles.yaml)
838
+ # Every shipped persona uses *qwen36 (see .pi/agents/model-profiles.yaml).
618
839
  subagents:
619
- code-reviewer:
620
- docs: *qwen
621
- plan-reviewer:
622
- deps: *qwen
623
- planner:
624
- voice-2: *qwen
625
- test-engineer:
626
- conventions: *qwen
627
- # recon, preflight, feasibility, scout, rules, sweeps, coverage stay on *qwen36
840
+ # Every declared child role uses *qwen36.
628
841
  services:
629
842
  watchdog: *qwen36
630
- return-extractor: *qwen
843
+ return-extractor: *qwen36
631
844
  panel:
632
- - { name: qwen36, model: *qwen36, integrator: true }
633
- - { name: qwen, model: *qwen }
845
+ - { name: qwen-a, model: *qwen36 }
846
+ - { name: qwen-b, model: *qwen36 }
847
+ - { name: qwen-integrator, model: *qwen36, integrator: true }
634
848
  ```
635
849
 
636
850
  - `defaults` supplies **every persona and every declared child**, including future
637
851
  personas, research helpers and team changes. `agents` and `subagents` contain
638
- exceptions. Each selection accepts a model string or `{model, thinking}`.
852
+ exceptions. To preserve a persona's existing selection, omit it from `agents`;
853
+ for example, `local-workers` leaves `orchestrator` out. Each selection accepts a
854
+ model string or `{model, thinking}`.
639
855
  Unspecified thinking inherits defaults, then `off`. Tool caps and delegation
640
856
  depth remain unchanged. Unknown persona/child names are rejected.
641
- - `dispatcher` changes the current Pi session's model and thinking. It defaults
642
- to `defaults`; an `orchestrator` persona entry alone is not the live dispatcher.
857
+ - `dispatcher` changes the current Pi session's model and thinking. When omitted,
858
+ the live dispatcher keeps its current selection and may use any Pi model, even
859
+ outside `allowed-models`; that list still applies to workers and peers. An
860
+ `orchestrator` persona entry alone is not the live dispatcher.
643
861
  - `services` sets the watchdog and structured-return extractor independently;
644
862
  unspecified services use defaults. `panel` supplies 2–5 poll/debate voices and
645
863
  an optional single integrator. `/af-poll` and `/af-debate` select the active
@@ -658,7 +876,8 @@ local-duo:
658
876
  - `fallback: none` (default) disables automatic original-model fallback, including
659
877
  nested children and workflows. `declared` retains it. Optional `allowed-models`
660
878
  is an exact provider/model allowlist checked before actual child spawns and
661
- fallback attempts. Manual model pickers and session substitutions respect it.
879
+ fallback attempts. Worker model pickers and session substitutions respect it;
880
+ the live dispatcher is checked only when `dispatcher` is explicit.
662
881
  This governs Fleet model execution; it is not an OS/network sandbox for arbitrary
663
882
  shell commands or unrelated applications.
664
883
 
@@ -672,11 +891,10 @@ next profile. A fresh Pi session clears the active profile; select it again ther
672
891
  The profile is passed through the owned process tree. Workflow commands started
673
892
  from that session inherit its persona models, thinking, panel and fallback policy.
674
893
  Separately started fleet sessions/standing peers retain their own configuration.
675
- The bundled `local-duo` profile explicitly covers all shipped child roles and needs
676
- no project model overrides. The 35B Qwen is the default (dispatcher, specialists,
677
- recon/sweeps, watchdog). The 9B Qwen is reserved for narrow helpers: `documenter`,
678
- `code-reviewer.docs`, `plan-reviewer.deps`, `test-engineer.conventions`,
679
- `planner.voice-2`, and `return-extractor`. Both exact model IDs must be registered
680
- in Pi and served locally by oMLX. Selecting a profile does not download or register
681
- models. The `omlx` provider has a default concurrency limit of two per Pi process;
682
- `AGENT_HUB_PROVIDER_LIMITS` can override it if both weights should run in parallel.
894
+ The bundled `local-full` profile explicitly covers all shipped child roles and needs
895
+ no project model overrides. Every role, service and panel entry uses the single
896
+ `omlx/Qwen3.6-35B-A3B-4bit` model. The `local-workers` profile uses that same local
897
+ model for agents, subagents, services and panel voices, while leaving `orchestrator`
898
+ to inherit its current selection; its peer allowlist refuses non-local coms models.
899
+ The model must be registered in Pi and served locally by oMLX. Selecting a profile
900
+ does not download or register models.
@@ -181,7 +181,7 @@ The live process predated the T5 JavaScript race changes. Pi's independent jiti
181
181
 
182
182
  For Android testing, keep the question/options in a normal final chat message and accept an ordinary chat reply. A transient widget/commentary alone is not evidence of durable delivery. T6's local implementation/tests are complete, but live human acceptance remains incomplete.
183
183
 
184
- Authorized restart/retest: the human approved restarting Pi and repeating acceptance. PID 82128 was stopped, and PID 92987 resumed the exact saved Pi transcript `2026-09-08T12-58-39-500Z_01a08119-620a-70e7-8e41-60e68f700187.jsonl` in the same `w1:p24` pane with the same harnesses and grok-4.6 model. New coms owner `01M20PCBPK0GGQDB36C5E2F6Z1`, started 14:22:32.661 UTC, was explicitly selected. At 14:23:24.241 UTC its question channel was available with no pending/old questions. A separately identified repeat instruction `t6-android-retest-0908` was submitted; the old selection is not automatically reused.
184
+ Authorized restart/retest: the human approved restarting Pi and repeating acceptance. PID 82128 was stopped, and PID 92987 resumed the exact saved Pi transcript `2026-09-08T12-58-39-500Z_01a08119-620a-70e7-8e41-60e68f700187.jsonl` in the same `w1:p24` pane with the same harnesses and grok-4.7 model. New coms owner `01M20PCBPK0GGQDB36C5E2F6Z1`, started 14:22:32.661 UTC, was explicitly selected. At 14:23:24.241 UTC its question channel was available with no pending/old questions. A separately identified repeat instruction `t6-android-retest-0908` was submitted; the old selection is not automatically reused.
185
185
 
186
186
  Repeat pending evidence: instruction wire `01M20PEC3EDDJRA57QYW7FQGAK`; question `19bf2e5b-4e86-47a0-9539-167a850bc1d7`, originating toolCallId `call-16ee291a-daa8-4096-9d12-d853e0e9291c-45|fc_43819906-6f3d-97f4-8983-97a6dc414ed9_0`, created 14:23:43.101 UTC and discovered automatically by status at 14:24:10.614 UTC. Question: “T6 повторен тест след рестарт: кой цвят избираш?” — Син / Зелен, single selection. Awaiting the human reply in ordinary chat text.
187
187
 
@@ -48,10 +48,15 @@ so an unconfigured session is a no-op. `/af-stt doctor`
48
48
  checks the setup. A simplified port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt);
49
49
  see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
50
50
 
51
- > **macOS terminal note:** Option-to-Alt behavior belongs to the outer terminal, not macOS or Pi.
52
- > If an Option shortcut inserts a composed character such as `ß`, configure the terminal to send
53
- > Option as Meta. In Zed, set `terminal.option_as_meta` to `true`. This enables the existing Alt
54
- > shortcuts; it is not an OS-wide keybinding change.
51
+ > **macOS terminal note:** Option-to-Alt behavior belongs to the outer terminal, not macOS, Pi, or
52
+ > Herdr. If Option+M inserts `µ` (or another shortcut inserts a character) instead of activating the
53
+ > shortcut, the terminal is sending the keyboard-layout character rather than a Meta/Alt key event.
54
+ > In Terminal.app, open **Settings → Profiles → Keyboard** for the profile used by the window and
55
+ > enable **Use Option as Meta key**. In Zed, set `terminal.option_as_meta` to `true`. Then verify
56
+ > Option+M opens the Fleet work-mode picker; the terminal should send Meta/Alt chords as an Escape
57
+ > prefix (for example, ESC followed by `m`). This enables the existing shortcuts; it is not an
58
+ > OS-wide keybinding change. Command+M is separate: Terminal.app handles it as **Minimize**, so it
59
+ > does not reach Pi or Herdr as a Fleet shortcut.
55
60
 
56
61
  The documented harnesses below are different: each is a **session harness**. They
57
62
  reshape the whole pi session — some set orchestration/UI surfaces and some gate every
@@ -312,7 +317,7 @@ what you already have:
312
317
  ```bash
313
318
  just fleet peer code-reviewer --project af # peers.yaml decides the runner
314
319
  just fleet peer scratch-reviewer --runner claude-code --model opus --project af
315
- just fleet peer researcher --model openai-codex/gpt-5.6-luna --project af
320
+ just fleet peer researcher --model openai-codex/gpt-6-luna --project af
316
321
  just fleet peer web-debugger --browser --project af # persona peer + devtools MCP
317
322
  just fleet peer nick --here --project af # this terminal, not a pane
318
323
  just fleet peer anything --runner claude-code --dry-run # print the plan, touch nothing
package/docs/workflows.md CHANGED
@@ -23,6 +23,7 @@ Options:
23
23
 
24
24
  - `--dry-run` executes the full graph with valid stub agent envelopes and no model calls.
25
25
  - `--run-id <id>` assigns a trace id.
26
+ - `--branch` explicitly creates and switches to `flow/<name>-<runId>`; without it the flow stays on the current branch and creates no worktree. Writes and workflow commits therefore apply to the current branch.
26
27
  - `--allow-dirty` explicitly bypasses the normal clean-tree refusal.
27
28
  - `--panel <name>` selects a model panel from `.pi/agents/voices.yaml` (required for `poll` and `debate`).
28
29
  - `--rounds <n>` sets debate rounds (default 3, minimum 2, maximum 5).
@@ -32,7 +33,7 @@ Exit codes are `0` accepted, `1` failed/unaccepted, `2` invalid arguments or unk
32
33
 
33
34
  ## Clean up and merge flow branches
34
35
 
35
- Every run records its source branch and commit before creating `flow/<name>-<runId>`, then records whether the run was accepted or rejected. The reserved `cleanup` and `merge` subcommands use that metadata and [Worktrunk](https://worktrunk.dev) to manage completed branches.
36
+ Only runs explicitly started with `--branch` record their source branch and commit before creating `flow/<name>-<runId>`, then record whether the run was accepted or rejected. Current-branch runs create no flow branch or branch metadata. Explicit branches and their commits/dirty work are retained after success, failure or interruption; no automatic branch deletion is attempted. The reserved `cleanup` and `merge` subcommands use that metadata and [Worktrunk](https://worktrunk.dev) to manage completed branches.
36
37
 
37
38
  List branches and open the numbered prompt in a terminal:
38
39
 
@@ -113,7 +114,7 @@ The runtime currently uses its 1,800-second default timeout; `timeout-seconds:`
113
114
 
114
115
  ## Safety and evidence
115
116
 
116
- Normal runs require a clean tree and create `flow/<name>-<runId>`. The branch stores its source branch, source commit, flow name, run id, and final acceptance as local Git metadata so maintenance can merge back without guessing. Every agent phase must receive an explicit writes policy from persona frontmatter or its call site; a missing policy is refused before spawn rather than silently treated as unrestricted. `writes: []` is repository read-only, and a non-empty list is an allowlist. Agent writes are checked after each phase against that policy and workflow `protectedGlobs`. `protectedGlobs` reject a path only when no `writes` glob matches it, so `writes: ["**"]` also permits a protected path. `*` stays within one path segment; `**` crosses directories. Out-of-policy changes introduced by the agent are rolled back and terminate the phase. Runtime reports remain writable even for repository-read-only agents. This enforcement exists only in flows; hub behavior is unchanged.
117
+ Normal runs require a clean tree and stay on the current branch. Only `--branch` creates `flow/<name>-<runId>`. An explicitly requested branch stores its source branch, source commit, flow name, run id, and final acceptance as local Git metadata so maintenance can merge back without guessing. Every agent phase must receive an explicit writes policy from persona frontmatter or its call site; a missing policy is refused before spawn rather than silently treated as unrestricted. `writes: []` is repository read-only, and a non-empty list is an allowlist. Agent writes are checked after each phase against that policy and workflow `protectedGlobs`. `protectedGlobs` reject a path only when no `writes` glob matches it, so `writes: ["**"]` also permits a protected path. `*` stays within one path segment; `**` crosses directories. Out-of-policy changes introduced by the agent are rolled back and terminate the phase. Runtime reports remain writable even for repository-read-only agents. This enforcement exists only in flows; hub behavior is unchanged.
117
118
 
118
119
  Every run writes JSONL under `.pi/flow-sessions/<runId>/trace.jsonl`; this directory is gitignored and separate from hub sessions. Phase success and work acceptance are separate. `run.finish()` produces the exit code, final trace status, and banner from one decision so they cannot disagree.
119
120
 
@@ -148,6 +149,6 @@ The Hub registers a typed `run_flow` surface for exactly one procedure: read-onl
148
149
 
149
150
  Before the Hub charges one research operation, code validates the effective researcher model/profile/allowlist, fallback and exact `read,grep,find,ls`-only tool set, then builds a stable detached snapshot of the current working tree. The snapshot overlay excludes credential-shaped files and session/flow artifact recursion; validates plain source and destination parents before every create/copy/unlink; unlinks a HEAD symlink leaf rather than following it; rejects traversal, symlink parents/sources, and non-plain files; and records a read-only manifest bound to HEAD plus content hashes. A second source scan must match the first, so a concurrent source change refuses startup rather than producing a falsely coherent snapshot.
150
151
 
151
- The scout's native process and descendants run through `confineNativeChild`: the snapshot is read-only at the OS layer, and only its session-owned phase directory is writable for Pi session/runtime support. A second, non-exemptible extension validates the actual declared `read`, `grep`, `find`, and `ls` data paths and patterns against the snapshot, denying original-worktree absolute paths, traversal, and symlink escape. Damage-control remains loaded and applies its `zeroAccessPaths` rules independently. The OS sandbox intentionally retains read access to model/runtime libraries and provider configuration required to start Pi; the DATA-read claim is limited to those four filesystem tools, not a global no-read claim. The flow runs in detached-HEAD, no-branch mode; trace and manifest live under the current Hub session, and the owned temporary workspace is removed after every settlement or setup failure. It never restores, deletes, checks out, branches, or commits in the original worktree.
152
+ The scout's native process and descendants run through `confineNativeChild`: the snapshot is read-only at the OS layer, and only its session-owned phase directory is writable for Pi session/runtime support. A second, non-exemptible extension validates the actual declared `read`, `grep`, `find`, and `ls` data paths and patterns against the snapshot, denying original-worktree absolute paths, traversal, and symlink escape. Damage-control remains loaded and applies its `zeroAccessPaths` rules independently. The OS sandbox intentionally retains read access to model/runtime libraries and provider configuration required to start Pi; the DATA-read claim is limited to those four filesystem tools, not a global no-read claim. The flow runs in detached-HEAD, no-branch mode; trace and manifest live under the current Hub session, and cleanup of the owned temporary workspace is attempted after every settlement or setup failure. `snapshotCleanup.status` reports `removed`, `not-created` or `failed`; a failure returns a visible warning and retained path rather than silently claiming cleanup. Trace and manifest artifacts are kept. Abrupt process termination (for example SIGKILL or power loss) cannot guarantee cleanup; no startup sweep deletes unknown or active directories. It never restores, deletes, checks out, branches, or commits in the original worktree.
152
153
 
153
154
  The Hub owns cancellation and the single budget charge. A duplicate `invocation_id` with identical inputs returns the existing promise/result; changed inputs under that id are stale and refused, and a distinct invocation while one is active is busy without charge. Flow acceptance is nested evidence only: `run_flow` returns parent acceptance as `not_accepted`, promotes no assertions, and retains open T11 obligations. Writable procedures—including `build-test` and its commit semantics—remain unavailable pending a separate reviewed slice.