@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
@@ -0,0 +1,104 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { closeSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
3
+ import { isAbsolute, join, relative, resolve, sep } from "node:path";
4
+ import type { FindingReview } from "./proactive-findings.ts";
5
+ import type { TaskContext, TurnSnapshot } from "./proactive-types.ts";
6
+
7
+ const hash = (value: string | Buffer) => createHash("sha256").update(value).digest("hex");
8
+ const hex = (value: unknown): value is string => typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
9
+ const safePath = (value: unknown): value is string => typeof value === "string" && value.length <= 256 && !isAbsolute(value) && !value.includes("\\") && !value.includes("\0") && value.split("/").every(s => /^[a-zA-Z0-9_@.-]+$/.test(s) && !s.startsWith(".")) && !/(^|\/)(?:node_modules|\.git|\.pi|dist|build|vendor)(\/|$)/i.test(value);
10
+ export interface FeedbackItem { id: string; revision: string; source: "deterministic" | "system1"; rule: string; ruleHash: string; path: string; sourceHash: string; fileHash?: string; locator: string }
11
+ export interface FeedbackInbox { schema: "agent-fleet.proactive-feedback/v1"; owner: string; attempt: string; taskHash: string; rulesHash: string; items: FeedbackItem[] }
12
+ const rulesHash = (context: TaskContext) => hash(JSON.stringify(context.rules.map(r => [r.path, r.hash]).sort()));
13
+ export const feedbackFile = (directory: string, owner: string, attempt: string) => join(directory, `${hash(JSON.stringify([owner, attempt]))}.json`);
14
+ function sourceFile(root: string, path: string): string | null {
15
+ if (!safePath(path)) return null;
16
+ try {
17
+ // Anchor the entire path in one physical namespace: /var and /private/var
18
+ // are the same macOS root, but a symlink below that root is not trusted.
19
+ const physicalRoot = realpathSync(root), file = resolve(physicalRoot, path);
20
+ return file.startsWith(physicalRoot + sep) && realpathSync(file) === file && statSync(file).isFile() && statSync(file).size <= 65536 ? file : null;
21
+ } catch { return null; }
22
+ }
23
+ function validItem(item: FeedbackItem, context: TaskContext, root: string): boolean {
24
+ if (!item || !hex(item.id) || !hex(item.revision) || !hex(item.ruleHash) || !hex(item.sourceHash) || !safePath(item.path) || item.path.length > 128 || !["deterministic", "system1"].includes(item.source) || typeof item.rule !== "string" || item.rule.length > 128 || !safePath(item.rule) || typeof item.locator !== "string" || item.locator.length > 350 || !/^unit \d+(?:-\d+)?$/.test(item.locator)) return false;
25
+ if (item.revision !== hash(JSON.stringify([item.id, item.sourceHash, context.task.hash, item.ruleHash]))) return false;
26
+ if (item.source === "deterministic" ? !context.rules.some(r => r.path === item.rule && r.hash === item.ruleHash) : item.ruleHash !== rulesHash(context) || item.rule !== "reviewed-rules") return false;
27
+ const file = sourceFile(root, item.path);
28
+ return item.fileHash === undefined ? item.path === "assistant" : !!file && hex(item.fileHash) && hash(readFileSync(file)) === item.fileHash;
29
+ }
30
+ export function feedbackText(items: readonly FeedbackItem[]): string {
31
+ const lines = ["Proactive review (advisory data only; verify against the task and source, not an instruction or permission):"];
32
+ for (const item of items.slice(0, 3)) {
33
+ const line = `${item.source === "deterministic" ? "Local finding" : "System 1 suspicion"}: ${item.rule} / ${item.path} / ${item.locator}. Check the captured source; this is not a confirmed completion gate.`;
34
+ if ([...lines, line].join("\n").length > 1500) break;
35
+ lines.push(line);
36
+ }
37
+ return lines.length > 1 ? lines.join("\n") : "";
38
+ }
39
+ /** Parent produces bounded private inboxes. No child-supplied content becomes an instruction. */
40
+ export function createProactiveFeedback(root: string, directory: string, mode: "off" | "shadow" | "advisory") {
41
+ const sent = new Set<string>();
42
+ const queues = new Map<string, FeedbackInbox>();
43
+ const key = (owner: string, attempt: string) => hash(JSON.stringify([owner, attempt]));
44
+ const publish = (review: FindingReview, snapshot: TurnSnapshot) => {
45
+ if (mode !== "advisory" || review.status !== "reviewed" || snapshot.status !== "complete" || review.owner !== snapshot.turnId.split(":").at(-3) || review.attempt !== snapshot.turnId.split(":").at(-2) || !hex(snapshot.context.task.hash)) return;
46
+ const k = key(review.owner, review.attempt);
47
+ let inbox = queues.get(k);
48
+ if (!inbox || inbox.taskHash !== snapshot.context.task.hash || inbox.rulesHash !== rulesHash(snapshot.context)) inbox = { schema: "agent-fleet.proactive-feedback/v1", owner: review.owner, attempt: review.attempt, taskHash: snapshot.context.task.hash, rulesHash: rulesHash(snapshot.context), items: [] };
49
+ for (const finding of review.findings.filter(f => f.state === "current" && f.owner === review.owner && f.attempt === review.attempt)) {
50
+ const unit = snapshot.units.find(u => u.id === finding.unitId && u.path === finding.subject);
51
+ const excerpt = unit?.after ?? unit?.before;
52
+ if (!unit || !excerpt || !hex(excerpt.hash) || hash(excerpt.text) !== excerpt.hash || finding.excerptHash !== excerpt.hash || !safePath(finding.subject)) continue;
53
+ const rule = finding.source === "deterministic" ? snapshot.context.rules.find(r => r.hash === finding.ruleHash)?.path : "reviewed-rules";
54
+ if (!rule || !safePath(rule) || (finding.source === "system1" && finding.ruleHash !== rulesHash(snapshot.context))) continue;
55
+ const file = unit.kind === "text" && unit.path === "assistant" ? null : sourceFile(root, unit.path);
56
+ if (!file && unit.kind !== "text") continue;
57
+ const fileHash = file ? hash(readFileSync(file)) : undefined;
58
+ // Retained excerpts can be redacted; in that case fail closed rather than call a changed file current.
59
+ if (file && !readFileSync(file).includes(Buffer.from(excerpt.text))) continue;
60
+ const item: FeedbackItem = { id: finding.id, revision: hash(JSON.stringify([finding.id, finding.excerptHash, snapshot.context.task.hash, finding.ruleHash])), source: finding.source, rule, ruleHash: finding.ruleHash, path: finding.subject, sourceHash: excerpt.hash, ...(fileHash ? { fileHash } : {}), locator: `unit ${excerpt.startLine}${excerpt.endLine !== excerpt.startLine ? `-${excerpt.endLine}` : ""}` };
61
+ if (!validItem(item, snapshot.context, root) || sent.has(item.revision) || inbox.items.some(i => i.revision === item.revision)) continue;
62
+ inbox.items.push(item);
63
+ }
64
+ inbox.items = inbox.items.slice(-3);
65
+ queues.set(k, inbox);
66
+ if (review.owner !== "hub" || review.attempt !== "direct") {
67
+ try { mkdirSync(directory, { recursive: true, mode: 0o700 }); const data = JSON.stringify(inbox); if (Buffer.byteLength(data) > 4096) return; const temp = join(directory, `.pending-${randomUUID()}`); const fd = openSync(temp, "wx", 0o600); try { writeFileSync(fd, data); } finally { closeSync(fd); } renameSync(temp, feedbackFile(directory, review.owner, review.attempt)); } catch { /* unavailable inbox is silent */ }
68
+ }
69
+ };
70
+ const take = (owner: string, attempt: string, context: TaskContext): string => {
71
+ if (mode !== "advisory" || !hex(context.task.hash)) return "";
72
+ const inbox = queues.get(key(owner, attempt));
73
+ if (!inbox || inbox.taskHash !== context.task.hash || inbox.rulesHash !== rulesHash(context)) return "";
74
+ const items = inbox.items.filter(i => !sent.has(i.revision) && validItem(i, context, root)).slice(0, 3);
75
+ const text = feedbackText(items);
76
+ if (text) for (const item of items) sent.add(item.revision);
77
+ return text;
78
+ };
79
+ return { publish, take, clear() { queues.clear(); sent.clear(); } };
80
+ }
81
+ /** Child inbox is untrusted protocol data; no free-form message is read from it. */
82
+ export function readProactiveInbox(root: string, directory: string, owner: string, attempt: string, context: TaskContext, seen: Set<string>): string {
83
+ try {
84
+ const rootPath = resolve(root), directoryPath = resolve(directory);
85
+ const below = relative(rootPath, directoryPath);
86
+ if (!below || below === ".." || below.startsWith(`..${sep}`) || isAbsolute(below)) return "";
87
+ let cursor = rootPath;
88
+ for (const part of below.split(sep)) {
89
+ cursor = join(cursor, part);
90
+ if (!lstatSync(cursor).isDirectory()) return "";
91
+ }
92
+ const physicalDirectory = realpathSync(directoryPath);
93
+ if (!physicalDirectory.startsWith(realpathSync(rootPath) + sep)) return "";
94
+ const file = feedbackFile(directoryPath, owner, attempt);
95
+ const info = lstatSync(file);
96
+ if (!info.isFile() || info.size > 4096) return "";
97
+ const inbox = JSON.parse(readFileSync(file, "utf8")) as FeedbackInbox;
98
+ if (inbox.schema !== "agent-fleet.proactive-feedback/v1" || inbox.owner !== owner || inbox.attempt !== attempt || inbox.taskHash !== context.task.hash || inbox.rulesHash !== rulesHash(context) || !Array.isArray(inbox.items) || inbox.items.length > 3) return "";
99
+ const items = inbox.items.filter(i => validItem(i, context, root) && !seen.has(i.revision));
100
+ const text = feedbackText(items);
101
+ if (text) for (const item of items) seen.add(item.revision);
102
+ return text;
103
+ } catch { return ""; }
104
+ }
@@ -0,0 +1,115 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import type { ProactiveAssessment } from "./proactive-evaluate.ts";
5
+ import type { LocalFinding } from "./proactive-local.ts";
6
+ import type { ReviewFinding, TurnSnapshot } from "./proactive-types.ts";
7
+
8
+ const hash = (value: string | Buffer) => createHash("sha256").update(value).digest("hex");
9
+ const LIMIT = 100;
10
+ export type FindingState = "current" | "stale" | "resolved";
11
+ export interface FindingEntry {
12
+ readonly id: string; readonly source: "deterministic" | "system1";
13
+ readonly claim: "violation" | "suspicion"; readonly state: FindingState;
14
+ readonly owner: string; readonly attempt: string; readonly ruleId: string; readonly ruleHash: string; readonly subject: string;
15
+ readonly snapshotHandle: string; readonly snapshotHash: string; readonly snapshotId: string;
16
+ readonly unitId: string; readonly excerptHash: string; readonly occurrences: number;
17
+ readonly capturedRange?: { readonly side: "before" | "after"; readonly offset: number; readonly endOffset: number; readonly startLine: number; readonly endLine: number };
18
+ readonly violationLine?: number;
19
+ }
20
+ export interface FindingCoverage { readonly status: string; readonly gaps: readonly string[]; readonly checked: readonly string[] }
21
+ export interface FindingReview { readonly owner: string; readonly attempt: string; readonly turnId: string; readonly status: string; readonly planStatus: "bound" | "task_only"; readonly drift?: { readonly task: string; readonly plan: string }; readonly coverage: FindingCoverage; readonly findings: readonly FindingEntry[] }
22
+ interface Stored { entry: FindingEntry; key: string }
23
+ /** Private session-scoped evidence, not an activity record. Disk readback never opens a source file. */
24
+ export function createProactiveFindings(options: { directory?: string } = {}) {
25
+ const snapshots = new Map<string, { bytes: Buffer; digest: string }>();
26
+ const current = new Map<string, Stored>();
27
+ const history: FindingReview[] = [];
28
+ const identity = randomUUID();
29
+ const snapshotFile = (handle: string) => options.directory && /^[a-f0-9]{64}$/.test(handle) ? join(options.directory, `${handle}.json`) : null;
30
+ const retain = (snapshot: TurnSnapshot) => {
31
+ const bytes = Buffer.from(JSON.stringify(snapshot));
32
+ const digest = hash(bytes), handle = hash(`${identity}:${snapshot.turnId}:${digest}`);
33
+ if (!snapshots.has(handle)) {
34
+ snapshots.set(handle, { bytes, digest });
35
+ if (options.directory) {
36
+ try { mkdirSync(options.directory, { recursive: true, mode: 0o700 }); writeFileSync(snapshotFile(handle)!, bytes, { flag: "wx", mode: 0o600 }); }
37
+ catch { snapshots.delete(handle); return null; }
38
+ }
39
+ }
40
+ return { handle, digest };
41
+ };
42
+ const readback = (handle: string, digest: string, snapshotId: string, unitId: string, excerptHash: string): string | null => {
43
+ if (!/^[a-f0-9]{64}$/.test(handle) || !/^[a-f0-9]{64}$/.test(digest)) return null;
44
+ try {
45
+ const file = snapshotFile(handle);
46
+ const bytes = file ? readFileSync(file) : snapshots.get(handle)?.bytes;
47
+ if (!bytes || hash(bytes) !== digest) return null;
48
+ const snapshot = JSON.parse(bytes.toString("utf8")) as TurnSnapshot;
49
+ if (snapshot.snapshotId !== snapshotId || !Array.isArray(snapshot.units)) return null;
50
+ const unit = snapshot.units.find(u => u.id === unitId);
51
+ const excerpt = [unit?.after, unit?.before].find(e => e?.hash === excerptHash);
52
+ return excerpt && hash(excerpt.text) === excerptHash ? excerpt.text : null;
53
+ } catch { return null; }
54
+ };
55
+ const observe = (owner: string, attempt: string, snapshot: TurnSnapshot, status: string, assessment?: ProactiveAssessment, checkedLocal: readonly { ruleId: string; subject: string }[] = []): FindingReview => {
56
+ const evidence = retain(snapshot);
57
+ const gaps = [...snapshot.gaps, ...(assessment?.gaps ?? []), ...(!evidence ? ["evidence_unavailable"] : [])].slice(0, 32).map(() => "coverage_gap");
58
+ const checked: string[] = [];
59
+ const fullyChecked = !!evidence && status === "reviewed" && snapshot.status === "complete" && gaps.length === 0 && assessment?.status === "reviewed";
60
+ if (fullyChecked) for (const rule of assessment.rules) if (rule.verdict === "no_observed_violation" || rule.verdict === "not_applicable") checked.push(`${rule.ruleId}:${rule.unitId}`);
61
+ const found = new Set<string>();
62
+ for (const finding of assessment?.findings ?? []) {
63
+ if (!evidence || finding.snapshotId !== snapshot.snapshotId || !["deterministic", "system1"].includes(finding.source)) continue;
64
+ const unit = snapshot.units.find(u => u.id === finding.unitId);
65
+ const local = finding as LocalFinding;
66
+ const side = unit?.after ? "after" : "before";
67
+ const excerpt = unit?.after ?? unit?.before;
68
+ if (!unit || !excerpt || hash(excerpt.text) !== excerpt.hash || (finding.source === "deterministic" && (!local.locator || local.locator.path !== unit.path || local.locator.excerptHash !== excerpt.hash))) continue;
69
+ const subject = unit.path;
70
+ const ruleId = finding.reference;
71
+ const ruleHash = finding.source === "deterministic" ? local.ruleHash : hash(JSON.stringify(snapshot.context.rules.map(r => [r.path, r.hash]).sort()));
72
+ if (!/^[a-f0-9]{64}$/.test(ruleHash)) continue;
73
+ // The normalized offending line is stable when unrelated lines move. Structural placement uses path.
74
+ const line = local.locator?.line;
75
+ const normalized = finding.source === "deterministic" && line !== undefined ? excerpt.text.split("\n")[line - 1]?.trim().replace(/\s+/g, " ") : finding.source === "deterministic" ? subject : excerpt.text.replace(/\s+/g, " ").trim();
76
+ if (!normalized) continue;
77
+ const key = hash(JSON.stringify([owner, attempt, finding.source, ruleId, ruleHash, subject, local.category ?? "", normalized]));
78
+ found.add(key);
79
+ const prior = current.get(key)?.entry;
80
+ const { offset, endOffset, startLine, endLine } = excerpt;
81
+ const validRange = [offset, endOffset, startLine, endLine].every(Number.isSafeInteger) && offset >= 0 && endOffset >= offset && startLine >= 1 && endLine >= startLine;
82
+ const capturedRange = validRange ? Object.freeze({ side, offset, endOffset, startLine, endLine }) : undefined;
83
+ // Local locators index the retained text; redaction can change its relation to source lines.
84
+ const violationLine = capturedRange && finding.source === "deterministic" && local.category === "relative-markdown-links" &&
85
+ Number.isSafeInteger(line) && line! >= 1 && line! <= excerpt.text.split("\n").length &&
86
+ !excerpt.text.includes("[REDACTED]") && Buffer.byteLength(excerpt.text) === endOffset - offset &&
87
+ startLine + line! - 1 <= endLine ? startLine + line! - 1 : undefined;
88
+ const entry: FindingEntry = Object.freeze({ id: key, source: finding.source, claim: finding.source === "deterministic" ? "violation" : "suspicion", state: "current", owner, attempt, ruleId, ruleHash, subject, snapshotHandle: evidence.handle, snapshotHash: evidence.digest, snapshotId: snapshot.snapshotId, unitId: unit.id, excerptHash: excerpt.hash, occurrences: (prior?.occurrences ?? 0) + 1, ...(capturedRange ? { capturedRange } : {}), ...(violationLine !== undefined ? { violationLine } : {}) });
89
+ current.set(key, { key, entry });
90
+ }
91
+ // Resolution requires an explicit successful same-rule/subject recheck, never an omission.
92
+ for (const [key, stored] of current) {
93
+ if (!evidence) break; // Failed private retention cannot justify changing prior findings.
94
+ const prior = stored.entry;
95
+ if (prior.owner !== owner || prior.attempt !== attempt || found.has(key) || prior.state === "resolved") continue;
96
+ const subjectPresent = snapshot.units.some(u => u.path === prior.subject);
97
+ const semanticChecked = fullyChecked && prior.source === "system1" && prior.ruleHash === hash(JSON.stringify(snapshot.context.rules.map(r => [r.path, r.hash]).sort())) && assessment!.rules.some(r => r.ruleId === prior.ruleId && snapshot.units.some(u => u.id === r.unitId && u.path === prior.subject && (r.verdict === "no_observed_violation" || r.verdict === "not_applicable")));
98
+ const deterministicChecked = snapshot.status === "complete" && gaps.length === 0 && status === "reviewed" && subjectPresent && checkedLocal.some(c => c.ruleId === prior.ruleId && c.subject === prior.subject && snapshot.context.rules.some(r => r.hash === prior.ruleHash));
99
+ const state = semanticChecked || deterministicChecked ? "resolved" : "stale";
100
+ current.set(key, { key, entry: Object.freeze({ ...prior, state }) });
101
+ }
102
+ const review: FindingReview = Object.freeze({ owner, attempt, turnId: snapshot.turnId, status, planStatus: snapshot.planStatus, ...(assessment?.drift ? { drift: Object.freeze({ task: assessment.drift.task, plan: assessment.drift.plan }) } : {}), coverage: Object.freeze({ status: fullyChecked ? "checked" : "partial", gaps: Object.freeze(gaps), checked: Object.freeze(checked) }), findings: Object.freeze([...current.values()].map(v => v.entry).filter(v => v.owner === owner && v.attempt === attempt).slice(-LIMIT)) });
103
+ history.push(review); if (history.length > LIMIT) history.shift();
104
+ while (current.size > LIMIT) current.delete(current.keys().next().value!);
105
+ // Retain at most LIMIT private snapshots, even when local-only jobs exceed semantic budget.
106
+ if (snapshots.size > LIMIT) {
107
+ const oldest = snapshots.keys().next().value!;
108
+ snapshots.delete(oldest);
109
+ const file = snapshotFile(oldest);
110
+ if (file) try { unlinkSync(file); } catch { /* readback reports unavailable */ }
111
+ }
112
+ return review;
113
+ };
114
+ return { observe, readback, get history() { return history.slice(); }, get current() { return [...current.values()].map(v => v.entry).slice(-LIMIT); }, dispose() { snapshots.clear(); current.clear(); history.length = 0; } };
115
+ }
@@ -0,0 +1,88 @@
1
+ import { createHash } from "node:crypto";
2
+ import { posix } from "node:path";
3
+ import type { CatalogSection } from "./proactive-rules.ts";
4
+ import type { ReviewFinding, TurnSnapshot } from "./proactive-types.ts";
5
+
6
+ /** Operator-reviewed data, not a grammar for interpreting rule prose. No real bindings ship. */
7
+ export interface ReviewedLocalBinding {
8
+ readonly version: 1;
9
+ readonly validator: "relative-markdown-links" | "new-file-placement";
10
+ readonly rule: { readonly path: string; readonly heading: string; readonly occurrence: number; readonly hash: string };
11
+ readonly applicability: { readonly paths: readonly string[]; readonly kinds: readonly ("added" | "modified")[]; readonly basename?: string };
12
+ readonly exceptions: { readonly paths: readonly string[]; readonly legacy: boolean };
13
+ readonly placement?: { readonly prefix: string };
14
+ }
15
+ export interface LocalFinding extends ReviewFinding {
16
+ readonly locator: { readonly path: string; readonly excerptHash: string; readonly line?: number; readonly column?: number; readonly byteOffset?: number }; // placement is path-only, never an invented line
17
+ readonly ruleHash: string;
18
+ readonly category: ReviewedLocalBinding["validator"];
19
+ }
20
+ export interface LocalAssessment { readonly findings: readonly LocalFinding[]; readonly gaps: readonly string[] }
21
+ const digest = (text: string) => createHash("sha256").update(text).digest("hex");
22
+ const safePath = (path: unknown): path is string => typeof path === "string" && path.length > 0 && path.length <= 256 && !path.includes("\\") && !path.includes("\0") && !path.startsWith("/") && path.split("/").every(s => !!s && s !== "." && s !== ".." && !s.startsWith("."));
23
+ const safeRulePath = (path: unknown): path is string => typeof path === "string" && path.startsWith(".ai/") ? safePath(path.slice(4)) : safePath(path);
24
+ const exact = (v: unknown, keys: readonly string[]): v is Record<string, unknown> => typeof v === "object" && v !== null && !Array.isArray(v) && Object.keys(v).every(k => keys.includes(k)) && keys.every(k => k in v);
25
+ const paths = (v: unknown): v is string[] => Array.isArray(v) && v.length <= 32 && v.every(safePath) && new Set(v).size === v.length;
26
+ const safeBasename = (v: unknown): v is string => typeof v === "string" && safePath(v) && !v.includes("/") && !v.includes("*") && !v.includes("?");
27
+ export function parseLocalBindings(value: unknown): readonly ReviewedLocalBinding[] {
28
+ if (!Array.isArray(value) || value.length > 16) throw new Error("Invalid local bindings");
29
+ return Object.freeze(value.map((item: unknown) => {
30
+ if (!exact(item, ["version", "validator", "rule", "applicability", "exceptions", "placement"]) && !exact(item, ["version", "validator", "rule", "applicability", "exceptions"])) throw new Error("Invalid local binding schema");
31
+ const b = item as unknown as ReviewedLocalBinding;
32
+ if (b.version !== 1 || !["relative-markdown-links", "new-file-placement"].includes(b.validator) ||
33
+ !exact(b.rule, ["path", "heading", "occurrence", "hash"]) || !safeRulePath(b.rule.path) || !b.rule.path.endsWith(".md") ||
34
+ typeof b.rule.heading !== "string" || !b.rule.heading.trim() || b.rule.heading.length > 200 || !Number.isSafeInteger(b.rule.occurrence) || b.rule.occurrence < 1 || !/^[a-f0-9]{64}$/.test(b.rule.hash) ||
35
+ (!exact(b.applicability, ["paths", "kinds"]) && !exact(b.applicability, ["paths", "kinds", "basename"])) || (b.applicability.basename !== undefined && (!safeBasename(b.applicability.basename) || !b.applicability.paths.includes(b.applicability.basename))) || !paths(b.applicability.paths) || !b.applicability.paths.length || !Array.isArray(b.applicability.kinds) || !b.applicability.kinds.length || new Set(b.applicability.kinds).size !== b.applicability.kinds.length || !b.applicability.kinds.every(k => k === "added" || k === "modified") ||
36
+ !exact(b.exceptions, ["paths", "legacy"]) || !paths(b.exceptions.paths) || typeof b.exceptions.legacy !== "boolean" ||
37
+ (b.validator === "new-file-placement" ? !exact(b.placement, ["prefix"]) || !safePath(b.placement.prefix) || b.applicability.kinds.some(k => k !== "added") : b.placement !== undefined)) throw new Error("Invalid local binding values");
38
+ return Object.freeze({ version: 1 as const, validator: b.validator, rule: Object.freeze({ ...b.rule }), applicability: Object.freeze({ paths: Object.freeze([...b.applicability.paths]), kinds: Object.freeze([...b.applicability.kinds]), ...(b.applicability.basename === undefined ? {} : { basename: b.applicability.basename }) }), exceptions: Object.freeze({ paths: Object.freeze([...b.exceptions.paths]), legacy: b.exceptions.legacy }), ...(b.placement ? { placement: Object.freeze({ ...b.placement }) } : {}) });
39
+ }));
40
+ }
41
+ const matches = (path: string, patterns: readonly string[]) => patterns.some(p => p.endsWith("/**") ? path.startsWith(p.slice(0, -3) + "/") : path === p);
42
+ // Only an explicitly named basename in the reviewed paths can match across captured include-authorized directories.
43
+ const appliesTo = (path: string, applicability: ReviewedLocalBinding["applicability"]) =>
44
+ (!applicability.basename || posix.basename(path) === applicability.basename) &&
45
+ (matches(path, applicability.paths) || (applicability.basename !== undefined && applicability.paths.includes(applicability.basename)));
46
+ /** Pure snapshot check: no filesystem lookup, test/build launch, scripts, or prose-derived regex. */
47
+ export function assessLocal(snapshot: TurnSnapshot, sections: readonly CatalogSection[], bindings: readonly ReviewedLocalBinding[], included?: readonly string[]): LocalAssessment {
48
+ const findings: LocalFinding[] = [], gaps: string[] = [];
49
+ for (const b of bindings) {
50
+ const section = sections.find(s => s.source.path === b.rule.path && s.heading === b.rule.heading && s.occurrence === b.rule.occurrence && s.source.hash === b.rule.hash);
51
+ if (!section || !snapshot.context.rules.some(r => r.path === b.rule.path && r.hash === b.rule.hash)) { gaps.push(`unverified_binding:${b.rule.path}#${b.rule.heading}@${b.rule.occurrence}`); continue; }
52
+ for (const unit of snapshot.units) {
53
+ if (!b.applicability.kinds.includes(unit.kind as "added" | "modified") || !safePath(unit.path) || (included && !matches(unit.path, included)) || !appliesTo(unit.path, b.applicability) || matches(unit.path, b.exceptions.paths) || (b.exceptions.legacy && unit.kind !== "added")) continue;
54
+ if (/\.(?:cs|vue)$/i.test(unit.path)) gaps.push(`needs_review:unsupported_semantics:${unit.id}`);
55
+ if (b.validator === "relative-markdown-links" && !unit.path.toLowerCase().endsWith(".md")) { gaps.push(`not_applicable:${unit.id}`); continue; }
56
+ const after = unit.after;
57
+ if (!after || after.truncated || after.offset !== 0 || digest(after.text) !== after.hash || after.endOffset !== Buffer.byteLength(after.text) || snapshot.status !== "complete") { gaps.push(`unverified_locator:${unit.id}`); continue; }
58
+ const emit = (index?: number) => {
59
+ const previous = index === undefined ? undefined : after.text.slice(0, index);
60
+ const position = previous === undefined ? {} : { line: previous.split("\n").length, column: [...previous.slice(previous.lastIndexOf("\n") + 1)].length + 1, byteOffset: Buffer.byteLength(previous) };
61
+ findings.push({ source: "deterministic", snapshotId: snapshot.snapshotId, unitId: unit.id, reference: section.id, ruleHash: b.rule.hash, category: b.validator, verdict: "potential_violation", evidenceStatus: snapshot.status, delivery: "not_applicable", locator: { path: unit.path, excerptHash: after.hash, ...position } });
62
+ };
63
+ if (b.validator === "new-file-placement") {
64
+ if (unit.kind === "added" && !unit.path.startsWith(b.placement!.prefix + "/")) emit();
65
+ continue;
66
+ }
67
+ let fenced = false, offset = 0, unchecked = false;
68
+ for (const line of after.text.match(/[^\n]*\n|[^\n]+$/g) ?? []) {
69
+ if (/^\s*(`{3,}|~{3,})/.test(line)) { fenced = !fenced; offset += line.length; continue; }
70
+ if (!fenced && !/^\s{4}/.test(line)) {
71
+ const withoutInline = line.replace(/`+[^`]*`+/g, m => " ".repeat(m.length));
72
+ for (const m of withoutInline.matchAll(/!?\[[^\]\n]*\]\(([^\s)]+)(?:\s+[^)]*)?\)/g)) {
73
+ const target = m[1]!;
74
+ if (target.startsWith("<")) { unchecked = true; continue; } // angle destination is not this inline-path check
75
+ if (/^(?:[a-z][\w+.-]*:|#|\/\/)/i.test(target)) continue; // external and in-document links are not local paths
76
+ const decoded = (() => { try { return decodeURIComponent(target.split("#")[0]!); } catch { return ""; } })();
77
+ if (!decoded || decoded.startsWith("/") || decoded.includes("\\") || posix.normalize(posix.join(posix.dirname(unit.path), decoded)).startsWith("../")) emit(offset + m.index!);
78
+ }
79
+ const remaining = withoutInline.replace(/!?\[[^\]\n]*\]\([^)\n]*\)/g, " ");
80
+ if (/\[[^\]\n]*\]\[/.test(remaining) || /^\s{0,3}\[[^\]\n]+\]:/.test(remaining) || /\[[^\]\n]+\]/.test(remaining)) unchecked = true;
81
+ }
82
+ offset += line.length;
83
+ }
84
+ if (unchecked) gaps.push(`unchecked_link:${unit.id}`);
85
+ }
86
+ }
87
+ return { findings, gaps };
88
+ }
@@ -0,0 +1,105 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { chmodSync, mkdirSync, openSync, renameSync, writeFileSync, closeSync } from "node:fs";
3
+ import { basename, join, resolve } from "node:path";
4
+ import type { ExtensionAPI, TurnEndEvent } from "@mariozechner/pi-coding-agent";
5
+ import { isCaptureEnabled } from "./proactive-config.ts";
6
+ import { beginTurn, finishTurn } from "./proactive-snapshot.ts";
7
+ import type { ProactiveConfig, TaskContext, TurnSnapshot } from "./proactive-types.ts";
8
+ import { readProactiveInbox } from "./proactive-feedback.ts";
9
+
10
+ export const PROACTIVE_OBSERVER_ENV = "AGENT_HUB_PROACTIVE_OBSERVER";
11
+ /** Only authored specialist turns; no researcher, review helper, judge or System 1 recursion. */
12
+ export function isProactiveSpecialist(persona: string): boolean {
13
+ return !!persona && !/(?:research|review|auditor|test-engineer|judge|system[-_]?1)/i.test(persona);
14
+ }
15
+ const sha = (value: string) => createHash("sha256").update(value).digest("hex");
16
+ export interface ObserverAssignment {
17
+ root: string;
18
+ directory: string;
19
+ session: string;
20
+ owner: string;
21
+ attempt: string;
22
+ config: ProactiveConfig;
23
+ context: TaskContext;
24
+ }
25
+ export interface ObserverManifest {
26
+ producer: "agent-fleet.proactive-observer/v1";
27
+ session: string; owner: string; attempt: string; turnIndex: number; turnId: string;
28
+ status: "captured" | "incomplete" | "not_checked";
29
+ reason?: "aborted" | "capture_timeout" | "capture_unavailable" | "missing_turn_start";
30
+ snapshot?: { path: string; hash: string; snapshotId: string; bytes: number };
31
+ }
32
+ /** Parent assigns a private attempt directory; only basename refs are published. */
33
+ function publish(dir: string, name: string, data: string): void {
34
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
35
+ const temp = join(dir, `.pending-${randomUUID()}`);
36
+ const fd = openSync(temp, "wx", 0o600);
37
+ try { writeFileSync(fd, data); } finally { closeSync(fd); }
38
+ chmodSync(temp, 0o600);
39
+ renameSync(temp, join(dir, name));
40
+ }
41
+ export function observerStatus(directory: string, manifestExists: boolean): "instrumented" | "not_instrumented" {
42
+ return directory && manifestExists ? "instrumented" : "not_instrumented";
43
+ }
44
+ export function createProactiveObserver(pi: Pick<ExtensionAPI, "on">, assignment: ObserverAssignment): void {
45
+ if (!isCaptureEnabled(assignment.config)) return;
46
+ if (!assignment.session || !assignment.owner || !assignment.attempt || !assignment.directory || !resolve(assignment.directory).startsWith(resolve(assignment.root) + "/")) throw new Error("Invalid proactive observer assignment");
47
+ // Serialize hooks: snapshot subprocesses finish before the next baseline is taken.
48
+ let queue: Promise<void> = Promise.resolve();
49
+ let active: { turnIndex: number; baseline: Awaited<ReturnType<typeof beginTurn>> } | undefined;
50
+ const seen = new Set<number>();
51
+ const identity = (i: number) => `${assignment.session}:${assignment.owner}:${assignment.attempt}:${i}`;
52
+ const delivered = new Set<string>();
53
+ if (assignment.config.mode === "advisory") pi.on("context", event => {
54
+ const text = readProactiveInbox(assignment.root, join(assignment.session, "artifacts", "proactive-inbox"), assignment.owner, assignment.attempt, assignment.context, delivered);
55
+ if (text) return { messages: [...event.messages, { role: "custom" as const, customType: "agent-fleet.proactive-advisory", content: text, display: false, timestamp: Date.now() }] };
56
+ });
57
+ const record = (i: number, status: ObserverManifest["status"], reason?: ObserverManifest["reason"], snapshot?: TurnSnapshot) => {
58
+ const turnId = identity(i);
59
+ const manifest: ObserverManifest = { producer: "agent-fleet.proactive-observer/v1", session: assignment.session, owner: assignment.owner, attempt: assignment.attempt, turnIndex: i, turnId, status, ...(reason ? { reason } : {}) };
60
+ if (snapshot) {
61
+ const path = `snapshot-${i}.json`, data = JSON.stringify(snapshot);
62
+ publish(assignment.directory, path, data);
63
+ manifest.snapshot = { path, hash: sha(data), snapshotId: snapshot.snapshotId, bytes: Buffer.byteLength(data) };
64
+ }
65
+ publish(assignment.directory, `turn-${i}.json`, JSON.stringify(manifest));
66
+ };
67
+ const enqueue = (fn: () => Promise<void>) => { queue = queue.then(fn, fn).catch(() => { /* an unavailable capture is recorded at its hook */ }); return queue; };
68
+ pi.on("turn_start", event => enqueue(async () => {
69
+ const i = event.turnIndex;
70
+ if (!Number.isSafeInteger(i) || i < 0 || seen.has(i) || active?.turnIndex === i) return;
71
+ if (active) { record(active.turnIndex, "incomplete", "aborted"); seen.add(active.turnIndex); }
72
+ active = { turnIndex: i, baseline: null };
73
+ try { active.baseline = await beginTurn({ root: assignment.root, config: assignment.config, turnId: identity(i), context: assignment.context }); }
74
+ catch { /* finish records not_checked, never claims a snapshot */ }
75
+ }));
76
+ pi.on("turn_end", (event: TurnEndEvent) => enqueue(async () => {
77
+ const i = event.turnIndex;
78
+ if (!Number.isSafeInteger(i) || i < 0 || seen.has(i)) return;
79
+ seen.add(i);
80
+ const baseline = active?.turnIndex === i ? active.baseline : null;
81
+ if (active?.turnIndex === i) active = undefined;
82
+ if (!baseline) { record(i, "not_checked", "missing_turn_start"); return; }
83
+ const aborted = event.message.role !== "assistant" || event.message.stopReason === "aborted" || event.message.stopReason === "error";
84
+ const assistantText = event.message.role === "assistant" ? event.message.content.filter(c => c.type === "text").map(c => c.text).join("") : "";
85
+ try {
86
+ const snapshot = await finishTurn(baseline, { assistantText });
87
+ if (!snapshot) { record(i, "not_checked", "capture_unavailable"); return; }
88
+ const timeout = snapshot.gaps.includes("capture_timeout");
89
+ record(i, timeout ? "not_checked" : aborted || snapshot.status !== "complete" ? "incomplete" : "captured", timeout ? "capture_timeout" : aborted ? "aborted" : undefined, snapshot);
90
+ } catch (error) { record(i, "not_checked", (error as Error).message === "capture_timeout" ? "capture_timeout" : "capture_unavailable"); }
91
+ }));
92
+ pi.on("agent_end", () => enqueue(async () => {
93
+ if (active && !seen.has(active.turnIndex)) { record(active.turnIndex, "incomplete", "aborted"); seen.add(active.turnIndex); active = undefined; }
94
+ }));
95
+ }
96
+ /** Native extension reads only its parent-provided assignment. No provider, key or inference in child. */
97
+ export default function proactiveObserver(pi: ExtensionAPI): void {
98
+ const raw = process.env[PROACTIVE_OBSERVER_ENV];
99
+ if (!raw || Buffer.byteLength(raw) > 16_384) return;
100
+ try {
101
+ const assignment = JSON.parse(raw) as ObserverAssignment;
102
+ if (!assignment || !isCaptureEnabled(assignment.config) || basename(assignment.directory) === "." || !assignment.context?.task) return;
103
+ createProactiveObserver(pi, assignment);
104
+ } catch { /* malformed assignment is not instrumentation */ }
105
+ }
@@ -0,0 +1,143 @@
1
+ import { createHash } from "node:crypto";
2
+ import { closeSync, fstatSync, openSync, opendirSync, readSync, realpathSync, statSync } from "node:fs";
3
+ import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
4
+ import type { BoundReference, RuleSection } from "./proactive-types.ts";
5
+
6
+ export const RULE_CATALOG_LIMITS = Object.freeze({ files: 64, bytes: 256 * 1024 });
7
+ const hash = (text: string) => createHash("sha256").update(text).digest("hex");
8
+ const denied = /^(?:\.git|\.pi|node_modules|vendor|dist|build|coverage|\.env(?:\..*)?|credentials?|secrets?)$/i;
9
+ export interface CatalogSection extends RuleSection {
10
+ readonly text: string; // complete subtree, with all nested exceptions and examples
11
+ readonly context: string; // complete ancestor introductions, outermost first
12
+ readonly kind: "default" | "shared" | "conditional" | "reference";
13
+ }
14
+ export interface RuleCatalog {
15
+ readonly sections: readonly CatalogSection[];
16
+ readonly files: readonly BoundReference[];
17
+ readonly gaps: readonly string[];
18
+ readonly status: "complete" | "partial";
19
+ readonly bytesRead: number;
20
+ readonly version: string;
21
+ }
22
+
23
+ /** Local catalog only. Never interprets Markdown as commands or authority. */
24
+ export function discoverRules(repo: string, roots: readonly string[]): RuleCatalog {
25
+ const sections: CatalogSection[] = [], files: BoundReference[] = [], gaps: string[] = [];
26
+ let bytesRead = 0;
27
+ const seen = new Set<string>(), queued = new Set<string>();
28
+ const repoReal = realpathSync(repo);
29
+ const inside = (base: string, target: string) => target === base || target.startsWith(base + sep);
30
+ const relativePath = (p: string) => relative(repoReal, p).split(sep).join("/");
31
+ for (const root of roots) {
32
+ if (!root || isAbsolute(root) || root.split(/[\\/]/).some(s => !s || s === ".." || s === "." || denied.test(s))) { gaps.push("invalid_root"); continue; }
33
+ let rootReal: string;
34
+ try { rootReal = realpathSync(resolve(repoReal, root)); } catch { gaps.push(`missing_root:${root}`); continue; }
35
+ if (!inside(repoReal, rootReal) || !statSync(rootReal).isDirectory()) { gaps.push(`unsafe_root:${root}`); continue; }
36
+ const queue: string[] = [];
37
+ const enqueue = (p: string) => { if (!queued.has(p)) { queued.add(p); queue.push(p); } };
38
+ const safe = (p: string): string | null => {
39
+ if (!inside(rootReal, p) || relative(rootReal, p).split(sep).some(s => denied.test(s))) return null;
40
+ try { const real = realpathSync(p); return inside(rootReal, real) && inside(repoReal, real) ? real : null; } catch { return null; }
41
+ };
42
+ const walk = (dir: string) => {
43
+ // Bound the directory traversal too; symlink cycles cannot grow the queue indefinitely.
44
+ const dirs = [dir], visited = new Set<string>();
45
+ while (dirs.length) {
46
+ const next = dirs.shift()!;
47
+ const real = safe(next);
48
+ if (!real || visited.has(real)) { if (!real) gaps.push(`unsafe_path:${relativePath(next)}`); continue; }
49
+ visited.add(real);
50
+ if (visited.size > RULE_CATALOG_LIMITS.files || queued.size > RULE_CATALOG_LIMITS.files * 4) { gaps.push("discovery_directory_budget"); break; }
51
+ const entries: import("node:fs").Dirent[] = [];
52
+ try {
53
+ const handle = opendirSync(next);
54
+ try {
55
+ let entry;
56
+ while ((entry = handle.readSync()) !== null) {
57
+ if (entries.length >= RULE_CATALOG_LIMITS.files * 4) { gaps.push("discovery_directory_budget"); break; }
58
+ entries.push(entry);
59
+ }
60
+ } finally { handle.closeSync(); }
61
+ entries.sort((a, b) => a.name.localeCompare(b.name));
62
+ } catch { gaps.push(`unreadable_directory:${relativePath(next)}`); continue; }
63
+ for (const e of entries) {
64
+ if (denied.test(e.name)) continue;
65
+ const p = join(next, e.name), checked = safe(p);
66
+ if (!checked) { if (e.isSymbolicLink()) gaps.push(`unsafe_path:${relativePath(p)}`); continue; }
67
+ let stat;
68
+ try { stat = statSync(p); } catch { gaps.push(`unreadable_path:${relativePath(p)}`); continue; }
69
+ if (stat.isDirectory()) dirs.push(p);
70
+ else if (stat.isFile() && e.name.toLowerCase().endsWith(".md")) enqueue(p);
71
+ }
72
+ if (dirs.length + queued.size > RULE_CATALOG_LIMITS.files * 4) { gaps.push("discovery_directory_budget"); break; }
73
+ }
74
+ };
75
+ const index = ["README.md", "index.md", "INDEX.md"].map(n => join(rootReal, n)).find(p => safe(p));
76
+ if (index) enqueue(index);
77
+ else { gaps.push(`missing_index:${root}`); walk(rootReal); }
78
+ let fallback = false;
79
+ while (queue.length || !fallback) {
80
+ if (!queue.length) { fallback = true; walk(rootReal); if (!queue.length) break; }
81
+ const p = queue.shift()!, real = safe(p);
82
+ if (!real) { gaps.push(`unresolved_reference:${relativePath(p)}`); continue; }
83
+ if (seen.has(real)) continue;
84
+ if (files.length >= RULE_CATALOG_LIMITS.files) { gaps.push("file_budget"); break; }
85
+ let text: string;
86
+ try {
87
+ const fd = openSync(p, "r");
88
+ try {
89
+ const size = fstatSync(fd).size;
90
+ if (size > RULE_CATALOG_LIMITS.bytes - bytesRead) { gaps.push(`byte_budget:${relativePath(p)}`); seen.add(real); continue; }
91
+ const buffer = Buffer.alloc(size + 1);
92
+ let count = 0, n: number;
93
+ while (count < buffer.length && (n = readSync(fd, buffer, count, buffer.length - count, count)) > 0) count += n;
94
+ if (count !== size) { gaps.push(`unstable_file:${relativePath(p)}`); seen.add(real); continue; }
95
+ text = buffer.subarray(0, count).toString("utf8");
96
+ if (!Buffer.from(text).equals(buffer.subarray(0, count))) { gaps.push(`invalid_encoding:${relativePath(p)}`); seen.add(real); continue; }
97
+ bytesRead += count;
98
+ } finally { closeSync(fd); }
99
+ } catch { gaps.push(`unreadable_file:${relativePath(p)}`); seen.add(real); continue; }
100
+ seen.add(real);
101
+ const path = relativePath(p), digest = hash(text);
102
+ const source: BoundReference = { path, hash: digest, revision: digest };
103
+ files.push(source);
104
+ const lines = text.split(/(?<=\n)/), starts: number[] = [], headings: { index: number; level: number; title: string; occurrence: number }[] = [];
105
+ const occurrences = new Map<string, number>();
106
+ let offset = 0, fence = false;
107
+ for (const line of lines) {
108
+ starts.push(offset); offset += line.length;
109
+ if (/^\s*(```|~~~)/.test(line)) { fence = !fence; continue; }
110
+ const match = !fence && /^(#{1,6})\s+(.+?)\s*#*\s*(?:\r?\n)?$/.exec(line);
111
+ if (match) {
112
+ const title = match[2]!.trim(), occurrence = (occurrences.get(title) ?? 0) + 1;
113
+ occurrences.set(title, occurrence);
114
+ headings.push({ index: starts.length - 1, level: match[1]!.length, title, occurrence });
115
+ }
116
+ }
117
+ if (!headings.length) headings.push({ index: 0, level: 0, title: "(document)", occurrence: 1 });
118
+ for (let i = 0; i < headings.length; i++) {
119
+ const h = headings[i]!;
120
+ const end = headings.slice(i + 1).find(x => x.level <= h.level);
121
+ const own = text.slice(starts[h.index], end ? starts[end.index] : text.length);
122
+ const parents = headings.slice(0, i).filter(x => x.level < h.level && !headings.slice(headings.indexOf(x) + 1, i).some(y => y.level <= x.level));
123
+ const context = parents.map(x => {
124
+ const next = headings.find(y => y.index > x.index && y.level > x.level);
125
+ return text.slice(starts[x.index], next ? starts[next.index] : text.length);
126
+ }).join("\n");
127
+ const label = `${path}#${h.title}@${h.occurrence}`;
128
+ const kind = /default/i.test(path + " " + h.title) ? "default" : /shared/i.test(path + " " + h.title) ? "shared" : /conditional|when|if\b/i.test(h.title) ? "conditional" : "reference";
129
+ sections.push({ id: `${label}:${hash(own)}`, source, heading: h.title, occurrence: h.occurrence, text: own, context, kind });
130
+ }
131
+ // Only explicit Markdown links or literal .md references; missing/unsafe paths stay visible.
132
+ const refs = [...text.matchAll(/(?:\]\(|(?:^|[\s`]))([^\s()<>'"`]+\.md)(?:#[^\s)]*)?\)?/gim)];
133
+ for (const match of refs) {
134
+ const target = match[1]!;
135
+ if (/^[a-z]+:/i.test(target) || target.startsWith("/") || target.includes("\\")) { gaps.push(`unresolved_reference:${path}`); continue; }
136
+ const next = resolve(dirname(p), target);
137
+ if (!safe(next)) { gaps.push(`unresolved_reference:${path}:${target}`); continue; }
138
+ enqueue(next);
139
+ }
140
+ }
141
+ }
142
+ return { sections, files, gaps, status: gaps.length ? "partial" : "complete", bytesRead, version: hash(JSON.stringify({ files, gaps, sections: sections.map(s => s.id) })) };
143
+ }