@chankov/agent-fleet 2.0.13 → 2.0.14

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 (530) hide show
  1. package/.pi/harnesses/agent-hub/README.md +9 -0
  2. package/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  3. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +75 -0
  4. package/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  5. package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +53 -0
  6. package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +15 -0
  7. package/.pi/harnesses/agent-hub/index.ts +40 -6
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  10. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +8 -1
  11. package/.pi/harnesses/agent-hub/system1-communication-store.ts +95 -0
  12. package/.pi/harnesses/agent-hub/system1-runtime.ts +5 -2
  13. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  14. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +9 -3
  15. package/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  16. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +29 -1
  17. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  18. package/.pi/harnesses/agent-hub/work-mode.ts +2 -1
  19. package/.pi/harnesses/coms/package.json +1 -1
  20. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  21. package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
  22. package/.pi/harnesses/lib/fleet-strip-controller.ts +2 -1
  23. package/.pi/harnesses/lib/fleet-strip-view.ts +1 -1
  24. package/.versions/2.0.14/.pi/agent-fleet/hermes/README.md +347 -0
  25. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  26. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  27. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  28. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  29. package/.versions/2.0.14/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  30. package/.versions/2.0.14/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  31. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  32. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  33. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  34. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  35. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  36. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  37. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  38. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  39. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  40. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  41. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  42. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  43. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  44. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  45. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  46. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  47. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  48. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  49. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  50. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  51. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  52. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  53. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  54. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  55. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  56. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  57. package/.versions/2.0.14/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  58. package/.versions/2.0.14/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  59. package/.versions/2.0.14/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  60. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  61. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  62. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  63. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  64. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  65. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet.ts +216 -0
  66. package/.versions/2.0.14/.pi/agent-fleet/scripts/flow.ts +157 -0
  67. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  68. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  69. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  70. package/.versions/2.0.14/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  71. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  72. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  73. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  74. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  75. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  76. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  77. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  78. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  79. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  80. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  81. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  82. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  83. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  84. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  85. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  86. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  87. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  88. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  89. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  90. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  91. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  92. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  93. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  94. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  95. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  96. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  97. package/.versions/2.0.14/.pi/agent-fleet/scripts/package-lock.json +35 -0
  98. package/.versions/2.0.14/.pi/agent-fleet/scripts/package.json +9 -0
  99. package/.versions/2.0.14/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  100. package/.versions/2.0.14/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  101. package/.versions/2.0.14/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  102. package/.versions/2.0.14/.pi/agent-fleet/scripts/team-up.ts +378 -0
  103. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  104. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  105. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  106. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  107. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  108. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  109. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  110. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  111. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  112. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  113. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  114. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  115. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  116. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  117. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  118. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  119. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  120. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  121. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  122. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  123. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  124. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  125. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  126. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  127. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  128. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  129. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  130. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  131. package/.versions/2.0.14/.pi/agents/dispatch-policy.yaml +32 -0
  132. package/.versions/2.0.14/.pi/agents/model-profiles.yaml +134 -0
  133. package/.versions/2.0.14/.pi/agents/peers.yaml +147 -0
  134. package/.versions/2.0.14/.pi/agents/teams.yaml +41 -0
  135. package/.versions/2.0.14/.pi/agents/voices.yaml +13 -0
  136. package/.versions/2.0.14/.pi/damage-control-rules.yaml +297 -0
  137. package/.versions/2.0.14/.pi/extensions/btw/README.md +120 -0
  138. package/.versions/2.0.14/.pi/extensions/btw/index.ts +914 -0
  139. package/.versions/2.0.14/.pi/extensions/btw/package.json +6 -0
  140. package/.versions/2.0.14/.pi/extensions/btw/state.js +179 -0
  141. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  142. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  143. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  144. package/.versions/2.0.14/.pi/extensions/compact-and-continue/README.md +42 -0
  145. package/.versions/2.0.14/.pi/extensions/compact-and-continue/index.ts +120 -0
  146. package/.versions/2.0.14/.pi/extensions/compact-and-continue/package.json +6 -0
  147. package/.versions/2.0.14/.pi/extensions/mcp-bridge/README.md +46 -0
  148. package/.versions/2.0.14/.pi/extensions/mcp-bridge/index.ts +206 -0
  149. package/.versions/2.0.14/.pi/extensions/mcp-bridge/package.json +6 -0
  150. package/.versions/2.0.14/.pi/extensions/package-lock.json +1175 -0
  151. package/.versions/2.0.14/.pi/extensions/package.json +9 -0
  152. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/README.md +224 -0
  153. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/config.ts +198 -0
  154. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  155. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/index.ts +248 -0
  156. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/package.json +6 -0
  157. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  158. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  159. package/.versions/2.0.14/.pi/harnesses/agent-hub/README.md +1369 -0
  160. package/.versions/2.0.14/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  161. package/.versions/2.0.14/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  162. package/.versions/2.0.14/.pi/harnesses/agent-hub/artifacts.js +146 -0
  163. package/.versions/2.0.14/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  164. package/.versions/2.0.14/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  165. package/.versions/2.0.14/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  166. package/.versions/2.0.14/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  167. package/.versions/2.0.14/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  168. package/.versions/2.0.14/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  169. package/.versions/2.0.14/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  170. package/.versions/2.0.14/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  171. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  172. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  173. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  174. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  175. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  176. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  177. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  178. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  179. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  180. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  181. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  182. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  183. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  184. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  185. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  186. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  187. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  188. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  189. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  190. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  191. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  192. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  193. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  194. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  195. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  196. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  197. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  198. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  199. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  200. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  201. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  202. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  203. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  204. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  205. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  206. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  207. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  208. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-window.js +108 -0
  209. package/.versions/2.0.14/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  210. package/.versions/2.0.14/.pi/harnesses/agent-hub/delegate.ts +467 -0
  211. package/.versions/2.0.14/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  212. package/.versions/2.0.14/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  213. package/.versions/2.0.14/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  214. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  215. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  216. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  217. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  218. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  219. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  220. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  221. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  222. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  223. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +75 -0
  224. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  225. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +53 -0
  226. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-state.ts +15 -0
  227. package/.versions/2.0.14/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  228. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  229. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  230. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  231. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  232. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  233. package/.versions/2.0.14/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  234. package/.versions/2.0.14/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  235. package/.versions/2.0.14/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  236. package/.versions/2.0.14/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  237. package/.versions/2.0.14/.pi/harnesses/agent-hub/fixtures/registration-surface.json +62 -0
  238. package/.versions/2.0.14/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  239. package/.versions/2.0.14/.pi/harnesses/agent-hub/footer.ts +30 -0
  240. package/.versions/2.0.14/.pi/harnesses/agent-hub/helpers.ts +270 -0
  241. package/.versions/2.0.14/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  242. package/.versions/2.0.14/.pi/harnesses/agent-hub/index.ts +2370 -0
  243. package/.versions/2.0.14/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  244. package/.versions/2.0.14/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  245. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  246. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  247. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  248. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  249. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  250. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  251. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  252. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  253. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  254. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  255. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  256. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  257. package/.versions/2.0.14/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  258. package/.versions/2.0.14/.pi/harnesses/agent-hub/package.json +7 -0
  259. package/.versions/2.0.14/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  260. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  261. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  262. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  263. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  264. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  265. package/.versions/2.0.14/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  266. package/.versions/2.0.14/.pi/harnesses/agent-hub/presentation.ts +48 -0
  267. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  268. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  269. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  270. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  271. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  272. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  273. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  274. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  275. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  276. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  277. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  278. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  279. package/.versions/2.0.14/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  280. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  281. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  282. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  283. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  284. package/.versions/2.0.14/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  285. package/.versions/2.0.14/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  286. package/.versions/2.0.14/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  287. package/.versions/2.0.14/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  288. package/.versions/2.0.14/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  289. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  290. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  291. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  292. package/.versions/2.0.14/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  293. package/.versions/2.0.14/.pi/harnesses/agent-hub/return-contract.js +327 -0
  294. package/.versions/2.0.14/.pi/harnesses/agent-hub/return-extract.js +77 -0
  295. package/.versions/2.0.14/.pi/harnesses/agent-hub/review-findings.js +104 -0
  296. package/.versions/2.0.14/.pi/harnesses/agent-hub/run-budget.js +542 -0
  297. package/.versions/2.0.14/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  298. package/.versions/2.0.14/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  299. package/.versions/2.0.14/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  300. package/.versions/2.0.14/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  301. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  302. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-health.js +110 -0
  303. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-start.ts +42 -0
  304. package/.versions/2.0.14/.pi/harnesses/agent-hub/spawn.ts +526 -0
  305. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  306. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-communication-store.ts +95 -0
  307. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  308. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-runtime.ts +279 -0
  309. package/.versions/2.0.14/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  310. package/.versions/2.0.14/.pi/harnesses/agent-hub/timeline.ts +72 -0
  311. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  312. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  313. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  314. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  315. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  316. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  317. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  318. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  319. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  320. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  321. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  322. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  323. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  324. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  325. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  326. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  327. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  328. package/.versions/2.0.14/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  329. package/.versions/2.0.14/.pi/harnesses/agent-hub/types.ts +66 -0
  330. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  331. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  332. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  333. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  334. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +152 -0
  335. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  336. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  337. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  338. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  339. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  340. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  341. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  342. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  343. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  344. package/.versions/2.0.14/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  345. package/.versions/2.0.14/.pi/harnesses/agent-hub/version.ts +42 -0
  346. package/.versions/2.0.14/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  347. package/.versions/2.0.14/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  348. package/.versions/2.0.14/.pi/harnesses/agent-hub/work-mode.ts +174 -0
  349. package/.versions/2.0.14/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  350. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/README.md +59 -0
  351. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/index.ts +558 -0
  352. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  353. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  354. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  355. package/.versions/2.0.14/.pi/harnesses/coms/README.md +100 -0
  356. package/.versions/2.0.14/.pi/harnesses/coms/index.ts +282 -0
  357. package/.versions/2.0.14/.pi/harnesses/coms/package.json +7 -0
  358. package/.versions/2.0.14/.pi/harnesses/coms/version.ts +42 -0
  359. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/README.md +135 -0
  360. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/index.ts +550 -0
  361. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/package.json +7 -0
  362. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/version.ts +42 -0
  363. package/.versions/2.0.14/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  364. package/.versions/2.0.14/.pi/harnesses/lib/coms-core-io.ts +385 -0
  365. package/.versions/2.0.14/.pi/harnesses/lib/coms-core.ts +577 -0
  366. package/.versions/2.0.14/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  367. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  368. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  369. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-view.ts +107 -0
  370. package/.versions/2.0.14/.pi/harnesses/lib/context-budget.ts +114 -0
  371. package/.versions/2.0.14/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  372. package/.versions/2.0.14/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  373. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  374. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  375. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  376. package/.versions/2.0.14/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  377. package/.versions/2.0.14/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  378. package/.versions/2.0.14/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  379. package/.versions/2.0.14/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  380. package/.versions/2.0.14/.pi/harnesses/lib/fleet-panel.ts +34 -0
  381. package/.versions/2.0.14/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  382. package/.versions/2.0.14/.pi/harnesses/lib/fleet-selection.ts +24 -0
  383. package/.versions/2.0.14/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  384. package/.versions/2.0.14/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  385. package/.versions/2.0.14/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  386. package/.versions/2.0.14/.pi/harnesses/lib/herdr-client.ts +472 -0
  387. package/.versions/2.0.14/.pi/harnesses/lib/herdr-presence.ts +399 -0
  388. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  389. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  390. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  391. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  392. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  393. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  394. package/.versions/2.0.14/.pi/harnesses/lib/spawned-peers.js +191 -0
  395. package/.versions/2.0.14/.pi/harnesses/lib/system1/config.js +61 -0
  396. package/.versions/2.0.14/.pi/harnesses/lib/system1/contracts.ts +152 -0
  397. package/.versions/2.0.14/.pi/harnesses/lib/system1/demo.ts +106 -0
  398. package/.versions/2.0.14/.pi/harnesses/lib/system1/jev.ts +503 -0
  399. package/.versions/2.0.14/.pi/harnesses/lib/system1/service.ts +245 -0
  400. package/.versions/2.0.14/.pi/harnesses/lib/update-check.ts +222 -0
  401. package/.versions/2.0.14/.pi/harnesses/package-lock.json +2039 -0
  402. package/.versions/2.0.14/.pi/harnesses/package.json +10 -0
  403. package/.versions/2.0.14/.pi/prompts/af-build.md +24 -0
  404. package/.versions/2.0.14/.pi/prompts/af-code-simplify.md +22 -0
  405. package/.versions/2.0.14/.pi/prompts/af-constraints.md +31 -0
  406. package/.versions/2.0.14/.pi/prompts/af-plan.md +17 -0
  407. package/.versions/2.0.14/.pi/prompts/af-review.md +16 -0
  408. package/.versions/2.0.14/.pi/prompts/af-set-hermes-telegram.md +15 -0
  409. package/.versions/2.0.14/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  410. package/.versions/2.0.14/.pi/prompts/af-setup-rules.md +20 -0
  411. package/.versions/2.0.14/.pi/prompts/af-ship.md +17 -0
  412. package/.versions/2.0.14/.pi/prompts/af-spec.md +15 -0
  413. package/.versions/2.0.14/.pi/prompts/af-test.md +19 -0
  414. package/.versions/2.0.14/.pi/skills/bowser/SKILL.md +145 -0
  415. package/.versions/2.0.14/.version +1 -0
  416. package/.versions/2.0.14/agents/architect.md +24 -0
  417. package/.versions/2.0.14/agents/bowser.md +28 -0
  418. package/.versions/2.0.14/agents/builder.md +55 -0
  419. package/.versions/2.0.14/agents/code-reviewer.md +209 -0
  420. package/.versions/2.0.14/agents/deep-researcher.md +32 -0
  421. package/.versions/2.0.14/agents/documenter.md +22 -0
  422. package/.versions/2.0.14/agents/orchestrator.md +22 -0
  423. package/.versions/2.0.14/agents/plan-reviewer.md +83 -0
  424. package/.versions/2.0.14/agents/planner.md +105 -0
  425. package/.versions/2.0.14/agents/releaser.md +24 -0
  426. package/.versions/2.0.14/agents/researcher.md +30 -0
  427. package/.versions/2.0.14/agents/security-auditor.md +167 -0
  428. package/.versions/2.0.14/agents/test-engineer.md +153 -0
  429. package/.versions/2.0.14/agents/web-debugger.md +44 -0
  430. package/.versions/2.0.14/agents/web-performance-auditor.md +194 -0
  431. package/.versions/2.0.14/bin/catalog/harness-runtime-closure.json +73 -0
  432. package/.versions/2.0.14/codex/fleet-session-client/SKILL.md +34 -0
  433. package/.versions/2.0.14/codex/fleet-session-client.zip +0 -0
  434. package/.versions/2.0.14/docs/ARCHITECTURE.md +754 -0
  435. package/.versions/2.0.14/docs/agent-fleet-setup.md +917 -0
  436. package/.versions/2.0.14/docs/claude-code-coms-bridge.md +134 -0
  437. package/.versions/2.0.14/docs/codex-session-bridge.md +219 -0
  438. package/.versions/2.0.14/docs/coms-hermes-bridge.md +188 -0
  439. package/.versions/2.0.14/docs/getting-started.md +126 -0
  440. package/.versions/2.0.14/docs/npm-install.md +476 -0
  441. package/.versions/2.0.14/docs/pi-extensions.md +454 -0
  442. package/.versions/2.0.14/docs/pi-setup.md +92 -0
  443. package/.versions/2.0.14/docs/skill-anatomy.md +150 -0
  444. package/.versions/2.0.14/install-manifest.json +3183 -0
  445. package/.versions/2.0.14/justfile +247 -0
  446. package/.versions/2.0.14/manifest-meta.json +1065 -0
  447. package/.versions/2.0.14/references/accessibility-checklist.md +160 -0
  448. package/.versions/2.0.14/references/communication-contract.md +26 -0
  449. package/.versions/2.0.14/references/definition-of-done.md +67 -0
  450. package/.versions/2.0.14/references/fleet-coordination-patterns.md +171 -0
  451. package/.versions/2.0.14/references/observability-checklist.md +92 -0
  452. package/.versions/2.0.14/references/orchestration-patterns.md +370 -0
  453. package/.versions/2.0.14/references/performance-checklist.md +236 -0
  454. package/.versions/2.0.14/references/prompting-patterns.md +380 -0
  455. package/.versions/2.0.14/references/security-checklist.md +245 -0
  456. package/.versions/2.0.14/references/testing-patterns.md +235 -0
  457. package/.versions/2.0.14/references/workflow-authoring.md +304 -0
  458. package/.versions/2.0.14/skills/_internal/grilling.md +59 -0
  459. package/.versions/2.0.14/skills/browser-testing-with-devtools/SKILL.md +351 -0
  460. package/.versions/2.0.14/skills/code-review-and-quality/SKILL.md +396 -0
  461. package/.versions/2.0.14/skills/compound-learning/SKILL.md +137 -0
  462. package/.versions/2.0.14/skills/constraint-driven-development/SKILL.md +338 -0
  463. package/.versions/2.0.14/skills/constraint-driven-development/references/floor-guard.md +99 -0
  464. package/.versions/2.0.14/skills/context-engineering/SKILL.md +341 -0
  465. package/.versions/2.0.14/skills/deprecation-and-migration/SKILL.md +247 -0
  466. package/.versions/2.0.14/skills/designing-agents/SKILL.md +394 -0
  467. package/.versions/2.0.14/skills/designing-agents/pi-harness-authoring.md +222 -0
  468. package/.versions/2.0.14/skills/drafting-workflows/SKILL.md +143 -0
  469. package/.versions/2.0.14/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  470. package/.versions/2.0.14/skills/frontend-ui-engineering/SKILL.md +328 -0
  471. package/.versions/2.0.14/skills/git-workflow-and-versioning/SKILL.md +316 -0
  472. package/.versions/2.0.14/skills/idea-refine/SKILL.md +182 -0
  473. package/.versions/2.0.14/skills/idea-refine/examples.md +238 -0
  474. package/.versions/2.0.14/skills/idea-refine/frameworks.md +99 -0
  475. package/.versions/2.0.14/skills/idea-refine/refinement-criteria.md +113 -0
  476. package/.versions/2.0.14/skills/idea-refine/scripts/idea-refine.sh +15 -0
  477. package/.versions/2.0.14/skills/incremental-implementation/SKILL.md +302 -0
  478. package/.versions/2.0.14/skills/interview-me/SKILL.md +226 -0
  479. package/.versions/2.0.14/skills/orchestration-verification/SKILL.md +182 -0
  480. package/.versions/2.0.14/skills/peer-coms/SKILL.md +90 -0
  481. package/.versions/2.0.14/skills/performance-optimization/SKILL.md +496 -0
  482. package/.versions/2.0.14/skills/planning-and-task-breakdown/SKILL.md +289 -0
  483. package/.versions/2.0.14/skills/repository-ai-setup/SKILL.md +117 -0
  484. package/.versions/2.0.14/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  485. package/.versions/2.0.14/skills/repository-ai-setup/references/apply-contract.md +74 -0
  486. package/.versions/2.0.14/skills/repository-ai-setup/references/provenance-template.md +16 -0
  487. package/.versions/2.0.14/skills/repository-ai-setup/references/setup-flow.md +108 -0
  488. package/.versions/2.0.14/skills/repository-ai-setup/references/verify-setup.md +20 -0
  489. package/.versions/2.0.14/skills/security-and-hardening/SKILL.md +524 -0
  490. package/.versions/2.0.14/skills/spec-driven-development/SKILL.md +295 -0
  491. package/.versions/2.0.14/skills/using-agent-skills/SKILL.md +198 -0
  492. package/.versions/2.0.14/vendor/agent-skills-upstream/LICENSE +21 -0
  493. package/.versions/2.0.14/vendor/agent-skills-upstream/README.md +430 -0
  494. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  495. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  496. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  497. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  498. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  499. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  500. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  501. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  502. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  503. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  504. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  505. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  506. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  507. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  508. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  509. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  510. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  511. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  512. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  513. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  514. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  515. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  516. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  517. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  518. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  519. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  520. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  521. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  522. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  523. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  524. package/CHANGELOG.md +6 -0
  525. package/docs/ARCHITECTURE.md +1 -0
  526. package/docs/agent-fleet-setup.md +17 -0
  527. package/docs/npm-install.md +8 -0
  528. package/install-manifest.json +9 -1
  529. package/manifest-meta.json +8 -0
  530. package/package.json +3 -2
@@ -0,0 +1,510 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { closeSync, constants, fchmodSync, lstatSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+ import type { ShadowTrace, ShadowTraceEvent } from "./drift-judge.ts";
5
+
6
+ export const WATCHDOG_TRACE_SCHEMA = "watchdog-trace/v1";
7
+ export const WATCHDOG_TRACE_FILE = "events.jsonl";
8
+ const COMPLETED_LIMIT = 100;
9
+ const STATUSES = new Set(["ok", "skipped", "unavailable", "unsupported", "cancelled", "interrupted", "unknown", "verdict"]);
10
+ const REASONS = new Set(["consumer_off", "feature_unselected", "watchdog_disarmed", "state_too_large", "invalid_state", "disposed", "disabled", "missing_config", "missing_key", "timeout", "network", "auth", "rate_limit", "overloaded", "invalid_response", "invalid_config", "invalid_request", "cancelled", "interrupted", "observer_error", "unsupported", "unknown"]);
11
+ const VERDICTS = new Set(["on_track", "drifting", "stuck", "insufficient_evidence"]);
12
+ const OUTCOMES = new Set(["continue", "discard", "drift_stop", "advisory", "judge_unavailable", "unknown"]);
13
+
14
+ export interface WatchdogTraceRecord {
15
+ schema: typeof WATCHDOG_TRACE_SCHEMA;
16
+ type: "evaluation_started" | "evaluation_finished" | "llm_started" | "llm_finished" | "decision";
17
+ sessionId: string;
18
+ dispatchId: string;
19
+ attemptId: string;
20
+ checkId: string;
21
+ snapshotId: string;
22
+ sequence: number;
23
+ at: number;
24
+ consumer: "watchdog";
25
+ llmAttemptId?: string;
26
+ rule?: string;
27
+ configuredMode?: "off" | "shadow" | "active";
28
+ effectiveMode?: "off" | "shadow" | "active";
29
+ stateVersion?: string;
30
+ questionsVersion?: string;
31
+ policyVersion: "none" | "watchdog-policy/v1";
32
+ status?: string;
33
+ reason?: string;
34
+ elapsedMs?: number | null;
35
+ unused?: boolean;
36
+ verdict?: string;
37
+ returnedModel?: string | null;
38
+ attempts?: number | null;
39
+ usage?: { inputTokens: number; outputTokens: number } | null;
40
+ numerical?: Record<string, number>;
41
+ source?: "llm" | "none" | "system1";
42
+ applied?: "yes" | "no" | "unknown";
43
+ outcome?: string;
44
+ statusChoice?: "on_track" | "drifting" | "stuck" | "insufficient_evidence";
45
+ requestedModel?: string;
46
+ provider?: "typesafe";
47
+ statusProvenance?: "provider" | "self_reported" | "derived";
48
+ stateComplete?: boolean;
49
+ predicatesProvider?: boolean;
50
+ }
51
+
52
+ export interface WatchdogCheckProjection {
53
+ dispatchId: string;
54
+ attemptId: string;
55
+ checkId: string;
56
+ snapshotId: string;
57
+ evaluation: "evaluating" | "finished" | "interrupted" | "unknown";
58
+ llm: "running" | "finished" | "interrupted" | "unknown" | "none";
59
+ llmStatus?: string;
60
+ status: string;
61
+ reason: string;
62
+ elapsedMs: number | null;
63
+ usage: { inputTokens: number; outputTokens: number } | "unknown";
64
+ returnedModel: string | "unknown";
65
+ attempts: number | "unknown";
66
+ applied: "yes" | "no" | "unknown";
67
+ source: "llm" | "none" | "system1" | "unknown";
68
+ outcome: string;
69
+ unused: boolean;
70
+ rule?: string;
71
+ configuredMode?: "off" | "shadow" | "active";
72
+ effectiveMode?: "off" | "shadow" | "active";
73
+ stateVersion?: string;
74
+ questionsVersion?: string;
75
+ numerical?: Record<string, number>;
76
+ statusChoice?: "on_track" | "drifting" | "stuck" | "insufficient_evidence";
77
+ requestedModel?: string;
78
+ provider?: "typesafe";
79
+ statusProvenance?: "provider" | "self_reported" | "derived";
80
+ stateComplete?: boolean;
81
+ predicatesProvider?: boolean;
82
+ llmVerdict?: string;
83
+ finishedAt?: number;
84
+ }
85
+
86
+ export interface WatchdogActivity extends ShadowTrace {
87
+ readonly degraded: boolean;
88
+ readonly path: string | null;
89
+ live(): { active: WatchdogCheckProjection[]; completed: WatchdogCheckProjection[]; degraded: boolean };
90
+ dispose(): void;
91
+ }
92
+
93
+ function isRecord(value: unknown): value is Record<string, unknown> {
94
+ return typeof value === "object" && value !== null && !Array.isArray(value);
95
+ }
96
+
97
+ function enumValue<T extends string>(value: unknown, allowed: Set<string>, fallback: T): T {
98
+ return typeof value === "string" && allowed.has(value) ? value as T : fallback;
99
+ }
100
+
101
+ function model(value: unknown): string | null {
102
+ if (typeof value !== "string" || value.length === 0 || value.length > 128) return null;
103
+ if (value.startsWith("/") || value.includes("\\") || value.split("/").includes("..")) return null;
104
+ return value;
105
+ }
106
+
107
+ function usage(value: unknown): { inputTokens: number; outputTokens: number } | null {
108
+ if (!isRecord(value)) return null;
109
+ if (typeof value.inputTokens !== "number" || typeof value.outputTokens !== "number") return null;
110
+ if (!Number.isFinite(value.inputTokens) || !Number.isFinite(value.outputTokens) || value.inputTokens < 0 || value.outputTokens < 0) return null;
111
+ return { inputTokens: value.inputTokens, outputTokens: value.outputTokens };
112
+ }
113
+
114
+ function numerical(value: unknown): Record<string, number> | undefined {
115
+ if (!isRecord(value)) return undefined;
116
+ const out: Record<string, number> = {};
117
+ for (const [key, item] of Object.entries(value)) {
118
+ if (!/^[a-z0-9_]{1,64}$/.test(key)) continue;
119
+ if (typeof item !== "number" || !Number.isFinite(item)) continue;
120
+ out[key] = item;
121
+ }
122
+ return Object.keys(out).length > 0 ? out : undefined;
123
+ }
124
+
125
+ function keyOf(event: { dispatchId?: string; attemptId?: string; checkId?: string; snapshotId?: string }): string {
126
+ return JSON.stringify([event.dispatchId ?? "", event.attemptId ?? "", event.checkId ?? "", event.snapshotId ?? ""]);
127
+ }
128
+
129
+ function secureAppend(path: string, text: string): void {
130
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
131
+ try { if (lstatSync(path).isSymbolicLink()) throw new Error("refused watchdog trace symlink"); } catch (error: unknown) {
132
+ if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
133
+ }
134
+ const noFollow = (constants as { O_NOFOLLOW?: number }).O_NOFOLLOW ?? 0;
135
+ const fd = openSync(path, constants.O_APPEND | constants.O_CREAT | constants.O_WRONLY | noFollow, 0o600);
136
+ try {
137
+ try { fchmodSync(fd, 0o600); } catch (error) { if (process.platform !== "win32") throw error; }
138
+ writeSync(fd, text, undefined, "utf8");
139
+ } finally {
140
+ closeSync(fd);
141
+ }
142
+ }
143
+
144
+ interface CheckState {
145
+ record: WatchdogCheckProjection;
146
+ llmAttemptId?: string;
147
+ evaluationOpen: boolean;
148
+ llmOpen: boolean;
149
+ evaluationDone: boolean;
150
+ llmDone: boolean;
151
+ decisionDone: boolean;
152
+ archived: boolean;
153
+ }
154
+
155
+ function blank(event: ShadowTraceEvent): WatchdogCheckProjection {
156
+ return {
157
+ dispatchId: event.dispatchId,
158
+ attemptId: event.attemptId,
159
+ checkId: event.checkId,
160
+ snapshotId: event.snapshotId,
161
+ evaluation: "unknown",
162
+ llm: "none",
163
+ status: "unknown",
164
+ reason: "unknown",
165
+ elapsedMs: null,
166
+ usage: "unknown",
167
+ returnedModel: "unknown",
168
+ attempts: "unknown",
169
+ applied: "unknown",
170
+ source: "unknown",
171
+ outcome: "unknown",
172
+ unused: false,
173
+ };
174
+ }
175
+
176
+ export function createWatchdogActivity(options: { directory?: string; sessionId?: string; now?: () => number; write?: (line: string) => void } = {}): WatchdogActivity {
177
+ const now = options.now ?? Date.now;
178
+ const sessionId = options.sessionId ?? randomUUID();
179
+ const path = options.directory ? join(options.directory, WATCHDOG_TRACE_FILE) : null;
180
+ const active = new Map<string, CheckState>();
181
+ const known = new Map<string, CheckState>();
182
+ const completed: WatchdogCheckProjection[] = [];
183
+ let sequence = 0;
184
+ let degraded = false;
185
+ const append = (event: ShadowTraceEvent, type: WatchdogTraceRecord["type"], extra: Partial<WatchdogTraceRecord> = {}) => {
186
+ const record: WatchdogTraceRecord = {
187
+ schema: WATCHDOG_TRACE_SCHEMA,
188
+ type,
189
+ sessionId,
190
+ dispatchId: event.dispatchId,
191
+ attemptId: event.attemptId,
192
+ checkId: event.checkId,
193
+ snapshotId: event.snapshotId,
194
+ sequence: ++sequence,
195
+ at: now(),
196
+ consumer: "watchdog",
197
+ policyVersion: event.effectiveMode === "active" ? "watchdog-policy/v1" : "none",
198
+ ...(event.llmAttemptId ? { llmAttemptId: event.llmAttemptId } : {}),
199
+ ...(event.rule ? { rule: event.rule.slice(0, 64) } : {}),
200
+ ...extra,
201
+ };
202
+ const line = `${JSON.stringify(record)}\n`;
203
+ try {
204
+ if (options.write) options.write(line);
205
+ else if (path) secureAppend(path, line);
206
+ } catch {
207
+ degraded = true;
208
+ }
209
+ };
210
+ const ensure = (event: ShadowTraceEvent): CheckState | null => {
211
+ if (!event.dispatchId || !event.attemptId || !event.checkId || !event.snapshotId) return null;
212
+ const key = keyOf(event);
213
+ let state = known.get(key);
214
+ if (!state) {
215
+ state = { record: blank(event), llmAttemptId: event.llmAttemptId, evaluationOpen: false, llmOpen: false, evaluationDone: false, llmDone: false, decisionDone: false, archived: false };
216
+ known.set(key, state);
217
+ active.set(key, state);
218
+ }
219
+ if (event.llmAttemptId && !state.llmAttemptId) state.llmAttemptId = event.llmAttemptId;
220
+ return state;
221
+ };
222
+ const finishSlot = (state: CheckState) => {
223
+ if (state.archived || state.evaluationOpen || state.llmOpen) return;
224
+ if (!state.evaluationDone && !state.llmDone) return;
225
+ state.archived = true;
226
+ active.delete(keyOf(state.record));
227
+ completed.push(state.record);
228
+ while (completed.length > COMPLETED_LIMIT) {
229
+ const dropped = completed.shift();
230
+ if (dropped) known.delete(keyOf(dropped));
231
+ }
232
+ };
233
+ let activity: WatchdogActivity;
234
+ const finishOpen = (state: CheckState) => {
235
+ const identity = { dispatchId: state.record.dispatchId, attemptId: state.record.attemptId, checkId: state.record.checkId, snapshotId: state.record.snapshotId, llmAttemptId: state.llmAttemptId };
236
+ if (state.evaluationOpen && !state.evaluationDone) {
237
+ activity.evaluationFinished({ ...identity, status: "cancelled", reason: "disposed", elapsedMs: state.record.elapsedMs, unused: true });
238
+ }
239
+ if (state.llmOpen && !state.llmDone) {
240
+ activity.llmFinished({ ...identity, status: "cancelled" });
241
+ }
242
+ };
243
+ activity = {
244
+ get degraded() { return degraded; },
245
+ get path() { return path; },
246
+ evaluationStarted(event) {
247
+ const state = ensure(event);
248
+ if (!state || state.evaluationOpen || state.evaluationDone) return;
249
+ state.evaluationOpen = true;
250
+ state.record.evaluation = "evaluating";
251
+ if (event.rule) state.record.rule = event.rule;
252
+ if (event.configuredMode) state.record.configuredMode = event.configuredMode;
253
+ if (event.effectiveMode) state.record.effectiveMode = event.effectiveMode;
254
+ if (event.stateVersion) state.record.stateVersion = event.stateVersion;
255
+ if (event.questionsVersion) state.record.questionsVersion = event.questionsVersion;
256
+ append(event, "evaluation_started", {
257
+ configuredMode: event.configuredMode,
258
+ effectiveMode: event.effectiveMode,
259
+ stateVersion: event.stateVersion,
260
+ questionsVersion: event.questionsVersion,
261
+ });
262
+ },
263
+ evaluationFinished(event) {
264
+ const state = known.get(keyOf(event));
265
+ if (!state || state.evaluationDone) return;
266
+ state.evaluationDone = true;
267
+ state.evaluationOpen = false;
268
+ state.record.evaluation = "finished";
269
+ state.record.status = enumValue(event.status, STATUSES, "unknown");
270
+ state.record.reason = enumValue(event.reason, REASONS, "unknown");
271
+ state.record.elapsedMs = typeof event.elapsedMs === "number" && Number.isFinite(event.elapsedMs) ? event.elapsedMs : null;
272
+ state.record.usage = usage(event.usage) ?? "unknown";
273
+ state.record.returnedModel = model(event.returnedModel) ?? "unknown";
274
+ state.record.attempts = typeof event.attempts === "number" && Number.isFinite(event.attempts) ? event.attempts : "unknown";
275
+ state.record.unused = event.unused === true;
276
+ state.record.finishedAt = now();
277
+ const choice = event.statusChoice;
278
+ if (choice === "on_track" || choice === "drifting" || choice === "stuck" || choice === "insufficient_evidence") state.record.statusChoice = choice;
279
+ const numbers = numerical(event.numerical);
280
+ if (numbers) state.record.numerical = numbers;
281
+ state.record.requestedModel = model(event.requestedModel) ?? undefined;
282
+ state.record.provider = event.provider === "typesafe" ? "typesafe" : undefined;
283
+ state.record.statusProvenance = event.statusProvenance === "provider" || event.statusProvenance === "self_reported" || event.statusProvenance === "derived" ? event.statusProvenance : undefined;
284
+ state.record.stateComplete = event.stateComplete === true;
285
+ state.record.predicatesProvider = event.predicatesProvider === true;
286
+ append(event, "evaluation_finished", {
287
+ policyVersion: state.record.effectiveMode === "active" ? "watchdog-policy/v1" : "none",
288
+ status: state.record.status,
289
+ reason: state.record.reason,
290
+ elapsedMs: state.record.elapsedMs,
291
+ unused: state.record.unused,
292
+ returnedModel: state.record.returnedModel === "unknown" ? null : state.record.returnedModel,
293
+ attempts: state.record.attempts === "unknown" ? null : state.record.attempts,
294
+ usage: state.record.usage === "unknown" ? null : state.record.usage,
295
+ numerical: numbers,
296
+ ...(state.record.statusChoice ? { statusChoice: state.record.statusChoice } : {}),
297
+ requestedModel: state.record.requestedModel,
298
+ provider: state.record.provider,
299
+ statusProvenance: state.record.statusProvenance,
300
+ stateComplete: state.record.stateComplete,
301
+ predicatesProvider: state.record.predicatesProvider,
302
+ });
303
+ finishSlot(state);
304
+ },
305
+ llmStarted(event) {
306
+ const state = ensure(event);
307
+ if (!state || state.llmOpen || state.llmDone) return;
308
+ if (state.archived) {
309
+ state.archived = false;
310
+ const index = completed.indexOf(state.record);
311
+ if (index >= 0) completed.splice(index, 1);
312
+ active.set(keyOf(event), state);
313
+ }
314
+ state.llmOpen = true;
315
+ state.record.llm = "running";
316
+ append(event, "llm_started");
317
+ },
318
+ llmFinished(event) {
319
+ const state = known.get(keyOf(event));
320
+ if (!state || state.llmDone) return;
321
+ state.llmDone = true;
322
+ state.llmOpen = false;
323
+ state.record.llm = "finished";
324
+ state.record.llmStatus = enumValue(event.status, STATUSES, "unknown");
325
+ const verdict = typeof event.verdict === "string" && VERDICTS.has(event.verdict) ? event.verdict : undefined;
326
+ if (verdict) state.record.llmVerdict = verdict;
327
+ append(event, "llm_finished", { status: enumValue(event.status, STATUSES, "unknown"), ...(verdict ? { verdict } : {}) });
328
+ finishSlot(state);
329
+ },
330
+ decision(event) {
331
+ const state = known.get(keyOf(event));
332
+ if (!state || state.decisionDone) return;
333
+ state.decisionDone = true;
334
+ state.record.source = event.source === "llm" || event.source === "none" || event.source === "system1" ? event.source : "unknown";
335
+ state.record.applied = event.applied === "yes" || event.applied === "no" ? event.applied : "unknown";
336
+ state.record.outcome = enumValue(event.outcome, OUTCOMES, "unknown");
337
+ append(event, "decision", { policyVersion: state.record.effectiveMode === "active" ? "watchdog-policy/v1" : "none", source: state.record.source === "unknown" ? "none" : state.record.source, applied: state.record.applied, outcome: state.record.outcome });
338
+ },
339
+ live() {
340
+ return { active: [...active.values()].map((item) => item.record), completed: completed.slice(), degraded };
341
+ },
342
+ endDispatch(dispatchId) {
343
+ if (!dispatchId) return;
344
+ for (const state of [...active.values()]) {
345
+ if (state.record.dispatchId !== dispatchId) continue;
346
+ finishOpen(state);
347
+ }
348
+ },
349
+ dispose() {
350
+ for (const state of [...active.values()]) finishOpen(state);
351
+ },
352
+ };
353
+ return activity;
354
+ }
355
+
356
+ export function readWatchdogTrace(path: string, options: { after?: number; limit?: number } = {}): { events: WatchdogTraceRecord[]; nextOffset: number; invalidRecords: number; partialTail: boolean; readError: boolean } {
357
+ const after = Math.max(0, options.after ?? 0);
358
+ const limit = Math.max(1, options.limit ?? 100);
359
+ let text = "";
360
+ try { text = readFileSync(path, "utf8"); } catch (error: unknown) {
361
+ return { events: [], nextOffset: after, invalidRecords: 0, partialTail: false, readError: (error as NodeJS.ErrnoException)?.code !== "ENOENT" };
362
+ }
363
+ // Never treat a complete-looking JSON object without a newline as a durable record.
364
+ const incomplete = text.length > 0 && !text.endsWith("\n");
365
+ const lines = text.split("\n").slice(0, -1).filter(line => line.length > 0);
366
+ const page = lines.slice(after, after + limit);
367
+ const events: WatchdogTraceRecord[] = [];
368
+ let invalidRecords = 0;
369
+ for (const line of page) {
370
+ try {
371
+ const parsed: unknown = JSON.parse(line);
372
+ const record = parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Partial<WatchdogTraceRecord> : null;
373
+ if (record?.schema === WATCHDOG_TRACE_SCHEMA && record.consumer === "watchdog"
374
+ && record.type != null && ["evaluation_started", "evaluation_finished", "llm_started", "llm_finished", "decision"].includes(record.type)
375
+ && [record.sessionId, record.dispatchId, record.attemptId, record.checkId, record.snapshotId]
376
+ .every(v => typeof v === "string" && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/.test(v))
377
+ && typeof record.sequence === "number" && Number.isFinite(record.sequence)
378
+ && typeof record.at === "number" && Number.isFinite(record.at)) events.push(record as WatchdogTraceRecord);
379
+ else invalidRecords++;
380
+ } catch { invalidRecords++; }
381
+ }
382
+ return { events, nextOffset: after + page.length, invalidRecords, partialTail: incomplete && after + page.length >= lines.length, readError: false };
383
+ }
384
+
385
+ /** Crash readback. An unfinished span is interrupted/unknown, never still evaluating and never success. */
386
+ export function projectWatchdogReadback(events: readonly WatchdogTraceRecord[]): WatchdogCheckProjection[] {
387
+ const checks = new Map<string, WatchdogCheckProjection>();
388
+ for (const event of events) {
389
+ const key = keyOf(event);
390
+ const current = checks.get(key) ?? {
391
+ ...blank(event),
392
+ evaluation: "unknown" as const,
393
+ };
394
+ if (event.type === "evaluation_started") {
395
+ current.evaluation = "evaluating";
396
+ if (event.rule) current.rule = event.rule;
397
+ if (event.configuredMode) current.configuredMode = event.configuredMode;
398
+ if (event.effectiveMode) current.effectiveMode = event.effectiveMode;
399
+ if (event.stateVersion) current.stateVersion = event.stateVersion;
400
+ if (event.questionsVersion) current.questionsVersion = event.questionsVersion;
401
+ }
402
+ if (event.type === "evaluation_finished") {
403
+ current.evaluation = "finished";
404
+ current.status = event.status ?? "unknown";
405
+ current.reason = event.reason ?? "unknown";
406
+ current.elapsedMs = event.elapsedMs ?? null;
407
+ current.usage = event.usage ?? "unknown";
408
+ current.returnedModel = event.returnedModel ?? "unknown";
409
+ current.attempts = event.attempts ?? "unknown";
410
+ current.unused = event.unused === true;
411
+ current.finishedAt = event.at;
412
+ if (event.statusChoice) current.statusChoice = event.statusChoice;
413
+ if (event.numerical) current.numerical = event.numerical;
414
+ if (event.requestedModel) current.requestedModel = model(event.requestedModel) ?? undefined;
415
+ if (event.provider === "typesafe") current.provider = "typesafe";
416
+ if (event.statusProvenance === "provider" || event.statusProvenance === "self_reported" || event.statusProvenance === "derived") current.statusProvenance = event.statusProvenance;
417
+ current.stateComplete = event.stateComplete === true;
418
+ current.predicatesProvider = event.predicatesProvider === true;
419
+ }
420
+ if (event.type === "llm_started") current.llm = "running";
421
+ if (event.type === "llm_finished") {
422
+ current.llm = "finished";
423
+ current.llmStatus = enumValue(event.status, STATUSES, "unknown");
424
+ if (event.verdict === "on_track" || event.verdict === "drifting" || event.verdict === "stuck" || event.verdict === "insufficient_evidence") current.llmVerdict = event.verdict;
425
+ }
426
+ if (event.type === "decision") {
427
+ current.source = event.source ?? "unknown";
428
+ current.applied = event.applied ?? "unknown";
429
+ current.outcome = event.outcome ?? "unknown";
430
+ }
431
+ checks.set(key, current);
432
+ }
433
+ for (const check of checks.values()) {
434
+ if (check.evaluation === "evaluating") {
435
+ check.evaluation = "interrupted";
436
+ check.status = "unknown";
437
+ check.reason = "interrupted";
438
+ }
439
+ if (check.llm === "running") check.llm = "interrupted";
440
+ if (check.usage == null) check.usage = "unknown";
441
+ }
442
+ return [...checks.values()];
443
+ }
444
+
445
+ /** Separate proactive consumer in the existing session activity store; never stores evidence payloads. */
446
+ export const PROACTIVE_TRACE_SCHEMA = "proactive-review-trace/v1";
447
+ export interface ProactiveTraceRecord {
448
+ readonly schema: typeof PROACTIVE_TRACE_SCHEMA;
449
+ readonly consumer: "proactive-review";
450
+ readonly type: "job_started" | "job_finished" | "evaluation_started" | "evaluation_finished";
451
+ readonly sessionId: string; readonly jobId: string; readonly evaluationId?: string;
452
+ readonly sequence: number; readonly at: number;
453
+ readonly status?: "reviewed" | "not_checked" | "superseded" | "queue_timeout" | "backlog_full" | "session_budget" | "cancelled" | "unavailable" | "no_new_evidence" | "not_instrumented" | "ok";
454
+ }
455
+ export function createProactiveActivity(options: { directory?: string; sessionId?: string; now?: () => number; write?: (line: string) => void } = {}) {
456
+ const path = options.directory ? join(options.directory, "proactive-events.jsonl") : null;
457
+ const sessionId = randomUUID(); // Never copy a caller-supplied session/task string into metadata.
458
+ const jobs = new Map<string, boolean>();
459
+ const evaluations = new Map<string, boolean>();
460
+ const events: ProactiveTraceRecord[] = [];
461
+ let sequence = 0, degraded = false;
462
+ const append = (type: ProactiveTraceRecord["type"], jobId: string, evaluationId?: string, status?: ProactiveTraceRecord["status"]) => {
463
+ const safe = new Set(["reviewed", "not_checked", "superseded", "queue_timeout", "backlog_full", "session_budget", "cancelled", "unavailable", "no_new_evidence", "not_instrumented", "ok"]);
464
+ const record: ProactiveTraceRecord = { schema: PROACTIVE_TRACE_SCHEMA, consumer: "proactive-review", type, sessionId, jobId, ...(evaluationId ? { evaluationId } : {}), sequence: ++sequence, at: (options.now ?? Date.now)(), ...(status ? { status: safe.has(status) ? status : "unavailable" } : {}) };
465
+ events.push(record); if (events.length > COMPLETED_LIMIT * 4) events.shift();
466
+ try { if (options.write) options.write(`${JSON.stringify(record)}\n`); else if (path) secureAppend(path, `${JSON.stringify(record)}\n`); } catch { degraded = true; }
467
+ };
468
+ const valid = (id: string) => /^[a-f0-9]{64}$/.test(id);
469
+ return {
470
+ get path() { return path; }, get degraded() { return degraded; },
471
+ live() { return events.slice(); },
472
+ jobStarted(id: string) { if (!valid(id) || jobs.has(id)) return; jobs.set(id, false); append("job_started", id); },
473
+ jobFinished(id: string, status: ProactiveTraceRecord["status"]) { if (!jobs.has(id) || jobs.get(id)) return; jobs.set(id, true); append("job_finished", id, undefined, status); },
474
+ evaluationStarted(jobId: string, id: string) { if (!jobs.has(jobId) || jobs.get(jobId) || !valid(id) || evaluations.has(id)) return; evaluations.set(id, false); append("evaluation_started", jobId, id); },
475
+ evaluationFinished(jobId: string, id: string, status: ProactiveTraceRecord["status"]) { if (!evaluations.has(id) || evaluations.get(id)) return; evaluations.set(id, true); append("evaluation_finished", jobId, id, status); },
476
+ dispose() { for (const [id, done] of evaluations) if (!done) { const job = events.find(e => e.evaluationId === id)?.jobId; if (job) this.evaluationFinished(job, id, "cancelled"); } for (const [id, done] of jobs) if (!done) this.jobFinished(id, "cancelled"); jobs.clear(); evaluations.clear(); },
477
+ };
478
+ }
479
+ /** Crash readback treats open spans as unavailable, never as a passed review. */
480
+ export function projectProactiveReadback(events: readonly ProactiveTraceRecord[]) {
481
+ const jobs = new Map<string, { jobId: string; status: string; evaluations: { id: string; status: string }[] }>();
482
+ for (const event of events) {
483
+ if (event.schema !== PROACTIVE_TRACE_SCHEMA || event.consumer !== "proactive-review" || !/^[a-f0-9]{64}$/.test(event.jobId)) continue;
484
+ const job = jobs.get(event.jobId) ?? { jobId: event.jobId, status: "unavailable", evaluations: [] };
485
+ if (event.type === "job_finished") job.status = event.status ?? "unavailable";
486
+ if (event.type === "evaluation_started" && event.evaluationId) job.evaluations.push({ id: event.evaluationId, status: "unavailable" });
487
+ if (event.type === "evaluation_finished" && event.evaluationId) { const slot = job.evaluations.find(e => e.id === event.evaluationId); if (slot) slot.status = event.status ?? "unavailable"; }
488
+ jobs.set(event.jobId, job);
489
+ }
490
+ return [...jobs.values()].slice(-COMPLETED_LIMIT);
491
+ }
492
+
493
+ /** Durable metadata only; incomplete tail and malformed records cannot manufacture completion. */
494
+ export function readProactiveTrace(path: string, options: { after?: number; limit?: number } = {}) {
495
+ let text = "";
496
+ try { text = readFileSync(path, "utf8"); } catch { return { events: [] as ProactiveTraceRecord[], nextOffset: options.after ?? 0, invalidRecords: 0, partialTail: false, readError: true }; }
497
+ const lines = text.split("\n").slice(0, -1);
498
+ const after = Math.max(0, options.after ?? 0), page = lines.slice(after, after + Math.min(100, Math.max(1, options.limit ?? 100)));
499
+ const events: ProactiveTraceRecord[] = []; let invalidRecords = 0;
500
+ const types = new Set(["job_started", "job_finished", "evaluation_started", "evaluation_finished"]);
501
+ const statuses = new Set(["reviewed", "not_checked", "superseded", "queue_timeout", "backlog_full", "session_budget", "cancelled", "unavailable", "no_new_evidence", "not_instrumented", "ok"]);
502
+ for (const line of page) {
503
+ try {
504
+ const v: unknown = JSON.parse(line);
505
+ if (!isRecord(v) || Object.keys(v).some(k => !["schema", "consumer", "type", "sessionId", "jobId", "evaluationId", "sequence", "at", "status"].includes(k)) || v.schema !== PROACTIVE_TRACE_SCHEMA || v.consumer !== "proactive-review" || !types.has(v.type as string) || typeof v.sessionId !== "string" || !/^[a-f0-9-]{36}$/.test(v.sessionId) || typeof v.jobId !== "string" || !/^[a-f0-9]{64}$/.test(v.jobId) || (v.evaluationId !== undefined && (typeof v.evaluationId !== "string" || !/^[a-f0-9]{64}$/.test(v.evaluationId))) || !Number.isSafeInteger(v.sequence) || typeof v.at !== "number" || !Number.isFinite(v.at) || (v.status !== undefined && !statuses.has(v.status as string))) { invalidRecords++; continue; }
506
+ events.push(v as unknown as ProactiveTraceRecord);
507
+ } catch { invalidRecords++; }
508
+ }
509
+ return { events, nextOffset: after + page.length, invalidRecords, partialTail: text.length > 0 && !text.endsWith("\n"), readError: false };
510
+ }
@@ -0,0 +1,95 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import type { EvaluateRequest, System1Result, System1Service } from "../lib/system1/contracts.ts";
3
+
4
+ export const COMMUNICATION_LIMITS = Object.freeze({ pairs: 200, bytes: 4 * 1024 * 1024, payloadBytes: 32 * 1024 });
5
+ export interface CommunicationPair {
6
+ id: string; consumer: string; owner: string; provider: string; model: string;
7
+ started: number; ended?: number; request: string | null; response: string | null;
8
+ status: string; requestOmitted?: string; responseOmitted?: string;
9
+ }
10
+ const secretKey = /authorization|api.?key|password|passwd|secret|credential|cookie|access.?token|refresh.?token|private.?key/i;
11
+ /** Conservative diagnostic copy, never an HTTP capture. Unknown consumer schemas are withheld. */
12
+ export function redactCommunication(value: unknown): unknown {
13
+ const seen = new WeakSet<object>();
14
+ const walk = (v: unknown, depth: number): unknown => {
15
+ if (depth > 30) return "[withheld: depth]";
16
+ if (typeof v === "string") return v
17
+ .replace(/-----BEGIN [^-]*PRIVATE KEY-----[\s\S]*?(?:-----END [^-]*PRIVATE KEY-----|$)/g, "[REDACTED]")
18
+ .replace(/\b(?:Bearer|Basic)\s+\S+/gi, "[REDACTED]")
19
+ .replace(/\b(?:sk-|gh[pousr]_|github_pat_|AKIA)[A-Za-z0-9_\-]+/g, "[REDACTED]")
20
+ .replace(/((?:api[_ -]?key|password|passwd|secret|token|credential)\s*[=:]\s*)[^\s,;]+/gi, "$1[REDACTED]")
21
+ .replace(/(?:\/[A-Za-z0-9._-]+){2,}|[A-Za-z]:\\[^\s]+/g, "[PATH]")
22
+ .replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/g, "");
23
+ if (v === null || typeof v === "boolean" || typeof v === "number") return v;
24
+ if (!v || typeof v !== "object" || seen.has(v)) return "[withheld]";
25
+ seen.add(v);
26
+ if (Array.isArray(v)) return v.map(x => walk(x, depth + 1));
27
+ return Object.fromEntries(Object.entries(v).map(([k,x]) => [String(walk(k, depth + 1)), secretKey.test(k) ? "[REDACTED]" : walk(x, depth + 1)]));
28
+ };
29
+ return walk(value, 0);
30
+ }
31
+ function consumerFor(request: EvaluateRequest): string {
32
+ const version = request.questionSetVersion;
33
+ if (version === "dispatch-triage/v1") return "dispatch-triage";
34
+ if (version === "watchdog-questions/v1") return "watchdog";
35
+ if (["proactive-assessment/v1", "proactive-selection/v1"].includes(version)) return "proactive";
36
+ return "not instrumented";
37
+ }
38
+ export function createCommunicationStore(limits = COMMUNICATION_LIMITS, now = Date.now) {
39
+ let enabled = false, generation = 0, sessionEpoch = 0, evicted = 0;
40
+ const pairs = new Map<string, CommunicationPair>();
41
+ const listeners = new Set<() => void>();
42
+ const emit = () => { for (const listener of listeners) { try { listener(); } catch { /* observer cannot affect inference */ } } };
43
+ const bytes = () => Buffer.byteLength(JSON.stringify([...pairs.values()]));
44
+ const trim = () => { while (pairs.size > limits.pairs || (pairs.size && bytes() > limits.bytes)) { pairs.delete(pairs.keys().next().value!); evicted++; } };
45
+ const payload = (value: unknown): string | null => {
46
+ const raw = JSON.stringify(value);
47
+ if (Buffer.byteLength(raw) > limits.payloadBytes) return null;
48
+ const text = JSON.stringify(redactCommunication(value), null, 2);
49
+ return Buffer.byteLength(text) <= limits.payloadBytes ? text : null;
50
+ };
51
+ return {
52
+ get enabled() { return enabled; }, get evicted() { return evicted; },
53
+ snapshot(): CommunicationPair[] { return [...pairs.values()].map(p => ({ ...p })); },
54
+ subscribe(fn: () => void) { listeners.add(fn); return () => { listeners.delete(fn); }; },
55
+ setEnabled(value: boolean) { generation++; enabled = value; pairs.clear(); evicted = 0; emit(); },
56
+ dispose() { sessionEpoch++; generation++; enabled = false; pairs.clear(); evicted = 0; emit(); listeners.clear(); },
57
+ wrap(service: System1Service, identity: { provider: string; model: string }): System1Service {
58
+ const ownerEpoch = sessionEpoch;
59
+ return { async evaluate(request) {
60
+ const epoch = generation; let id: string | undefined;
61
+ try {
62
+ if (enabled && ownerEpoch === sessionEpoch) {
63
+ id = randomUUID(); const consumer = consumerFor(request);
64
+ const state = request.state as Record<string, unknown>;
65
+ const owner = typeof state?.owner === "string" ? String(redactCommunication(state.owner)) : consumer === "dispatch-triage" ? "hub" : "owner unavailable";
66
+ const keys = consumer === "watchdog" ? ["schema","task","scope","hub_owned_paths","tool_events","signal","counters","coverage"] : consumer === "proactive" ? ["schema","candidates","task","paths","plan","planStatus","snapshotId","status","gaps","units","pairs"] : ["schema","task","scope","language","domain","constraints","candidates"];
67
+ const projected = state && typeof state === "object" && !Array.isArray(state) ? Object.fromEntries(keys.filter(k => Object.hasOwn(state,k)).map(k => [k,state[k]])) : null;
68
+ const questions = request.questions.map(q => ({ id:q.id,type:q.type,instructions:q.instructions,...(q.type === "choice" ? {options:q.options} : q.type === "ordinal" ? {levels:q.levels} : {criteria:q.criteria}) }));
69
+ const text = consumer === "not instrumented" || projected === null ? null : payload({ state: projected, questions, questionSetVersion: request.questionSetVersion, timeoutMs: request.timeoutMs, requiredCapabilities: request.requiredCapabilities });
70
+ pairs.set(id, { id, consumer, owner, provider: String(redactCommunication(identity.provider)), model: String(redactCommunication(identity.model)), started: now(), status: "pending", request: text, response: null, ...(text === null ? { requestOmitted: "payload withheld or too large" } : {}) }); trim(); emit();
71
+ }
72
+ } catch { id = undefined; }
73
+ let result: System1Result;
74
+ try { result = await service.evaluate(request); }
75
+ catch (error) {
76
+ if (id && epoch === generation && pairs.has(id)) { Object.assign(pairs.get(id)!, { status: "observer: evaluation threw", ended: now(), responseOmitted: "payload withheld" }); emit(); }
77
+ throw error;
78
+ }
79
+ try {
80
+ if (id && enabled && epoch === generation && pairs.has(id)) {
81
+ const pair = pairs.get(id)!;
82
+ // Reconstruct the result allowlist; never preserve unvalidated provider extras.
83
+ const safe = result.status === "ok" ? { status: result.status, evaluation: { answers: result.evaluation.answers.map(a => ({ questionId: a.questionId, type: a.type, ...(a.type === "predicate" ? { probabilityTrue: a.probabilityTrue } : { value: a.value, ...(a.type === "ordinal" ? { levels: a.levels } : {}) }), uncertainty: { provenance: a.uncertainty.provenance, confidence: a.uncertainty.confidence, distribution: a.uncertainty.distribution } })), metadata: { provider: result.evaluation.metadata.provider, requestedModel: result.evaluation.metadata.requestedModel, returnedModel: result.evaluation.metadata.returnedModel, questionSetVersion: result.evaluation.metadata.questionSetVersion, latencyMs: result.evaluation.metadata.latencyMs, attempts: result.evaluation.metadata.attempts, usage: result.evaluation.metadata.usage } } } : { status: result.status, reason: "reason" in result ? result.reason : undefined, missingCapabilities: "missingCapabilities" in result ? result.missingCapabilities : undefined };
84
+ pair.response = pair.consumer === "not instrumented" ? null : payload(safe);
85
+ pair.status = result.status; pair.ended = now();
86
+ if (pair.response === null) pair.responseOmitted = "payload withheld or too large";
87
+ trim(); emit();
88
+ }
89
+ } catch { /* observational only */ }
90
+ return result;
91
+ } };
92
+ },
93
+ };
94
+ }
95
+ export type CommunicationStore = ReturnType<typeof createCommunicationStore>;