@chankov/agent-fleet 2.0.20 → 2.0.21

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 (626) hide show
  1. package/.pi/harnesses/agent-hub/README.md +3 -2
  2. package/.pi/harnesses/agent-hub/index.ts +7 -5
  3. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +26 -10
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/coms/index.ts +13 -10
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/coms-core-io.ts +29 -2
  9. package/.pi/harnesses/lib/coms-core.ts +144 -42
  10. package/.versions/2.0.21/.pi/agent-fleet/hermes/README.md +347 -0
  11. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  12. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  13. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  14. package/.versions/2.0.21/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  15. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  16. package/.versions/2.0.21/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  17. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  18. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  19. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  20. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  21. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  22. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  23. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  24. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  25. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  26. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  27. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  28. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  29. package/.versions/2.0.21/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  30. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  31. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  32. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  33. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  34. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  35. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  36. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  37. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  38. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  39. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  40. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  41. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  42. package/.versions/2.0.21/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  43. package/.versions/2.0.21/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  44. package/.versions/2.0.21/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  45. package/.versions/2.0.21/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  46. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  47. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  48. package/.versions/2.0.21/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  49. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  50. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  51. package/.versions/2.0.21/.pi/agent-fleet/scripts/fleet.ts +217 -0
  52. package/.versions/2.0.21/.pi/agent-fleet/scripts/flow.ts +157 -0
  53. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  54. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  55. package/.versions/2.0.21/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  56. package/.versions/2.0.21/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  57. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  58. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  59. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  60. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  61. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  62. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  63. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  64. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  65. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  66. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  67. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  68. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  69. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  70. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  71. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  72. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  73. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  74. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  75. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  76. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  77. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  78. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  79. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  80. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  81. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  82. package/.versions/2.0.21/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  83. package/.versions/2.0.21/.pi/agent-fleet/scripts/package-lock.json +35 -0
  84. package/.versions/2.0.21/.pi/agent-fleet/scripts/package.json +9 -0
  85. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  86. package/.versions/2.0.21/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  87. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  88. package/.versions/2.0.21/.pi/agent-fleet/scripts/team-up.ts +378 -0
  89. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  90. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  91. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  92. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  93. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  94. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  95. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  96. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  97. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  98. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  99. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  100. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  101. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  102. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  103. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  104. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  105. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  106. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  107. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  108. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  109. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  110. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  111. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  112. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  113. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  114. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  115. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  116. package/.versions/2.0.21/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  117. package/.versions/2.0.21/.pi/agents/dispatch-policy.yaml +32 -0
  118. package/.versions/2.0.21/.pi/agents/model-profiles.yaml +134 -0
  119. package/.versions/2.0.21/.pi/agents/peers.yaml +147 -0
  120. package/.versions/2.0.21/.pi/agents/teams.yaml +41 -0
  121. package/.versions/2.0.21/.pi/agents/voices.yaml +13 -0
  122. package/.versions/2.0.21/.pi/damage-control-rules.yaml +297 -0
  123. package/.versions/2.0.21/.pi/extensions/btw/README.md +120 -0
  124. package/.versions/2.0.21/.pi/extensions/btw/index.ts +914 -0
  125. package/.versions/2.0.21/.pi/extensions/btw/package.json +6 -0
  126. package/.versions/2.0.21/.pi/extensions/btw/state.js +179 -0
  127. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  128. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  129. package/.versions/2.0.21/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  130. package/.versions/2.0.21/.pi/extensions/compact-and-continue/README.md +42 -0
  131. package/.versions/2.0.21/.pi/extensions/compact-and-continue/index.ts +136 -0
  132. package/.versions/2.0.21/.pi/extensions/compact-and-continue/package.json +6 -0
  133. package/.versions/2.0.21/.pi/extensions/mcp-bridge/README.md +46 -0
  134. package/.versions/2.0.21/.pi/extensions/mcp-bridge/index.ts +206 -0
  135. package/.versions/2.0.21/.pi/extensions/mcp-bridge/package.json +6 -0
  136. package/.versions/2.0.21/.pi/extensions/package-lock.json +1175 -0
  137. package/.versions/2.0.21/.pi/extensions/package.json +9 -0
  138. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/README.md +224 -0
  139. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/config.ts +198 -0
  140. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  141. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/index.ts +248 -0
  142. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/package.json +6 -0
  143. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  144. package/.versions/2.0.21/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  145. package/.versions/2.0.21/.pi/harnesses/agent-hub/README.md +1517 -0
  146. package/.versions/2.0.21/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  147. package/.versions/2.0.21/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  148. package/.versions/2.0.21/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  149. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  150. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  151. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  152. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  153. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  154. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  155. package/.versions/2.0.21/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  156. package/.versions/2.0.21/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  157. package/.versions/2.0.21/.pi/harnesses/agent-hub/artifacts.js +146 -0
  158. package/.versions/2.0.21/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  159. package/.versions/2.0.21/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  160. package/.versions/2.0.21/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  161. package/.versions/2.0.21/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  162. package/.versions/2.0.21/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  163. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  164. package/.versions/2.0.21/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  165. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  166. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  167. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  168. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  169. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  170. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  171. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  172. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  173. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  174. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  175. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  176. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  177. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  178. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  179. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  180. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  181. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  182. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  183. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  184. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  185. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  186. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  187. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  188. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  189. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  190. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  191. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  192. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  193. package/.versions/2.0.21/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  194. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  195. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  196. package/.versions/2.0.21/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  197. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  198. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  199. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  200. package/.versions/2.0.21/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  201. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  202. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  203. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  204. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  205. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  206. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  207. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  208. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  209. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  210. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  211. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  212. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  213. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  214. package/.versions/2.0.21/.pi/harnesses/agent-hub/context-window.js +108 -0
  215. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  216. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  217. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  218. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  219. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  220. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  221. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  222. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  223. package/.versions/2.0.21/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  224. package/.versions/2.0.21/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  225. package/.versions/2.0.21/.pi/harnesses/agent-hub/delegate.ts +478 -0
  226. package/.versions/2.0.21/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  227. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  228. package/.versions/2.0.21/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  229. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  230. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  231. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  232. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  233. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +253 -0
  234. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  235. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  236. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  237. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  238. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  239. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  240. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  241. package/.versions/2.0.21/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  242. package/.versions/2.0.21/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  243. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  244. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  245. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  246. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  247. package/.versions/2.0.21/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  248. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  249. package/.versions/2.0.21/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  250. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  251. package/.versions/2.0.21/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  252. package/.versions/2.0.21/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  253. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  254. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  255. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  256. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  257. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  258. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  259. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  260. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  261. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  262. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  263. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  264. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  265. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  266. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  267. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  268. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  269. package/.versions/2.0.21/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  270. package/.versions/2.0.21/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  271. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  272. package/.versions/2.0.21/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  273. package/.versions/2.0.21/.pi/harnesses/agent-hub/footer.ts +30 -0
  274. package/.versions/2.0.21/.pi/harnesses/agent-hub/helpers.ts +270 -0
  275. package/.versions/2.0.21/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  276. package/.versions/2.0.21/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  277. package/.versions/2.0.21/.pi/harnesses/agent-hub/index.ts +2616 -0
  278. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  279. package/.versions/2.0.21/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  280. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  281. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  282. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  283. package/.versions/2.0.21/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  284. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  285. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  286. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  287. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  288. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  289. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  290. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  291. package/.versions/2.0.21/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  292. package/.versions/2.0.21/.pi/harnesses/agent-hub/no-progress.ts +620 -0
  293. package/.versions/2.0.21/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  294. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  295. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  296. package/.versions/2.0.21/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  297. package/.versions/2.0.21/.pi/harnesses/agent-hub/package.json +7 -0
  298. package/.versions/2.0.21/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  299. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  300. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  301. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  302. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  303. package/.versions/2.0.21/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  304. package/.versions/2.0.21/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  305. package/.versions/2.0.21/.pi/harnesses/agent-hub/presentation.ts +48 -0
  306. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  307. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  308. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  309. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  310. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  311. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  312. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  313. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  314. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  315. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  316. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  317. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  318. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  319. package/.versions/2.0.21/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  320. package/.versions/2.0.21/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  321. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  322. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  323. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  324. package/.versions/2.0.21/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  325. package/.versions/2.0.21/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  326. package/.versions/2.0.21/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  327. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  328. package/.versions/2.0.21/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  329. package/.versions/2.0.21/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  330. package/.versions/2.0.21/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  331. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  332. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  333. package/.versions/2.0.21/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  334. package/.versions/2.0.21/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  335. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-contract.js +349 -0
  336. package/.versions/2.0.21/.pi/harnesses/agent-hub/return-extract.js +77 -0
  337. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  338. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  339. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-findings.js +96 -0
  340. package/.versions/2.0.21/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  341. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  342. package/.versions/2.0.21/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  343. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-budget.js +342 -0
  344. package/.versions/2.0.21/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  345. package/.versions/2.0.21/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  346. package/.versions/2.0.21/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  347. package/.versions/2.0.21/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  348. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  349. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-health.js +110 -0
  350. package/.versions/2.0.21/.pi/harnesses/agent-hub/session-start.ts +42 -0
  351. package/.versions/2.0.21/.pi/harnesses/agent-hub/spawn.ts +639 -0
  352. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  353. package/.versions/2.0.21/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  354. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  355. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  356. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  357. package/.versions/2.0.21/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  358. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  359. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  360. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  361. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  362. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  363. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  364. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  365. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  366. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  367. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  368. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  369. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  370. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  371. package/.versions/2.0.21/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  372. package/.versions/2.0.21/.pi/harnesses/agent-hub/timeline.ts +72 -0
  373. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  374. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  375. package/.versions/2.0.21/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  376. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  377. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  378. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  379. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  380. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  381. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  382. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +640 -0
  383. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  384. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  385. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  386. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  387. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  388. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  389. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  390. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  391. package/.versions/2.0.21/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  392. package/.versions/2.0.21/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  393. package/.versions/2.0.21/.pi/harnesses/agent-hub/types.ts +66 -0
  394. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  395. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  396. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  397. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  398. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  399. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  400. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  401. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  402. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  403. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  404. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  405. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  406. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  407. package/.versions/2.0.21/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  408. package/.versions/2.0.21/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  409. package/.versions/2.0.21/.pi/harnesses/agent-hub/version.ts +42 -0
  410. package/.versions/2.0.21/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  411. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  412. package/.versions/2.0.21/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  413. package/.versions/2.0.21/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  414. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/README.md +59 -0
  415. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/index.ts +569 -0
  416. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  417. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  418. package/.versions/2.0.21/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  419. package/.versions/2.0.21/.pi/harnesses/coms/README.md +100 -0
  420. package/.versions/2.0.21/.pi/harnesses/coms/index.ts +285 -0
  421. package/.versions/2.0.21/.pi/harnesses/coms/package.json +7 -0
  422. package/.versions/2.0.21/.pi/harnesses/coms/version.ts +42 -0
  423. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/README.md +161 -0
  424. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/index.ts +600 -0
  425. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/package.json +7 -0
  426. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  427. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  428. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  429. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  430. package/.versions/2.0.21/.pi/harnesses/damage-control-continue/version.ts +42 -0
  431. package/.versions/2.0.21/.pi/harnesses/lib/approval-wait.ts +17 -0
  432. package/.versions/2.0.21/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  433. package/.versions/2.0.21/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  434. package/.versions/2.0.21/.pi/harnesses/lib/clarification-policy.ts +9 -0
  435. package/.versions/2.0.21/.pi/harnesses/lib/coms-core-io.ts +413 -0
  436. package/.versions/2.0.21/.pi/harnesses/lib/coms-core.ts +680 -0
  437. package/.versions/2.0.21/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  438. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  439. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  440. package/.versions/2.0.21/.pi/harnesses/lib/context-budget-view.ts +112 -0
  441. package/.versions/2.0.21/.pi/harnesses/lib/context-budget.ts +114 -0
  442. package/.versions/2.0.21/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  443. package/.versions/2.0.21/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  444. package/.versions/2.0.21/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  445. package/.versions/2.0.21/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  446. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  447. package/.versions/2.0.21/.pi/harnesses/lib/damage-result-view.ts +16 -0
  448. package/.versions/2.0.21/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  449. package/.versions/2.0.21/.pi/harnesses/lib/execution-trace.ts +45 -0
  450. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  451. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  452. package/.versions/2.0.21/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  453. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  454. package/.versions/2.0.21/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  455. package/.versions/2.0.21/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  456. package/.versions/2.0.21/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  457. package/.versions/2.0.21/.pi/harnesses/lib/fleet-panel.ts +34 -0
  458. package/.versions/2.0.21/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  459. package/.versions/2.0.21/.pi/harnesses/lib/fleet-selection.ts +24 -0
  460. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  461. package/.versions/2.0.21/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  462. package/.versions/2.0.21/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  463. package/.versions/2.0.21/.pi/harnesses/lib/herdr-client.ts +472 -0
  464. package/.versions/2.0.21/.pi/harnesses/lib/herdr-presence.ts +399 -0
  465. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  466. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  467. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  468. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  469. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  470. package/.versions/2.0.21/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  471. package/.versions/2.0.21/.pi/harnesses/lib/identical-dialog.ts +27 -0
  472. package/.versions/2.0.21/.pi/harnesses/lib/installation-state.js +62 -0
  473. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.js +106 -0
  474. package/.versions/2.0.21/.pi/harnesses/lib/policy-roots.ts +31 -0
  475. package/.versions/2.0.21/.pi/harnesses/lib/process-shared.ts +9 -0
  476. package/.versions/2.0.21/.pi/harnesses/lib/safe-source-read.js +29 -0
  477. package/.versions/2.0.21/.pi/harnesses/lib/semantic-approval.ts +80 -0
  478. package/.versions/2.0.21/.pi/harnesses/lib/spawned-peers.js +191 -0
  479. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  480. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  481. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  482. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  483. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-json.js +37 -0
  484. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-loader.js +44 -0
  485. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  486. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-triage.js +42 -0
  487. package/.versions/2.0.21/.pi/harnesses/lib/system1/config-v2.js +112 -0
  488. package/.versions/2.0.21/.pi/harnesses/lib/system1/config.js +50 -0
  489. package/.versions/2.0.21/.pi/harnesses/lib/system1/contracts.ts +154 -0
  490. package/.versions/2.0.21/.pi/harnesses/lib/system1/demo.ts +95 -0
  491. package/.versions/2.0.21/.pi/harnesses/lib/system1/jev.ts +503 -0
  492. package/.versions/2.0.21/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  493. package/.versions/2.0.21/.pi/harnesses/lib/system1/selection.js +11 -0
  494. package/.versions/2.0.21/.pi/harnesses/lib/system1/service.ts +245 -0
  495. package/.versions/2.0.21/.pi/harnesses/lib/update-check.ts +222 -0
  496. package/.versions/2.0.21/.pi/harnesses/package-lock.json +2121 -0
  497. package/.versions/2.0.21/.pi/harnesses/package.json +13 -0
  498. package/.versions/2.0.21/.pi/prompts/af-build.md +27 -0
  499. package/.versions/2.0.21/.pi/prompts/af-code-simplify.md +22 -0
  500. package/.versions/2.0.21/.pi/prompts/af-constraints.md +31 -0
  501. package/.versions/2.0.21/.pi/prompts/af-plan.md +17 -0
  502. package/.versions/2.0.21/.pi/prompts/af-review.md +16 -0
  503. package/.versions/2.0.21/.pi/prompts/af-set-hermes-telegram.md +15 -0
  504. package/.versions/2.0.21/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  505. package/.versions/2.0.21/.pi/prompts/af-setup-rules.md +20 -0
  506. package/.versions/2.0.21/.pi/prompts/af-ship.md +17 -0
  507. package/.versions/2.0.21/.pi/prompts/af-spec.md +15 -0
  508. package/.versions/2.0.21/.pi/prompts/af-test.md +19 -0
  509. package/.versions/2.0.21/.pi/skills/bowser/SKILL.md +145 -0
  510. package/.versions/2.0.21/.version +1 -0
  511. package/.versions/2.0.21/agents/architect.md +24 -0
  512. package/.versions/2.0.21/agents/bowser.md +28 -0
  513. package/.versions/2.0.21/agents/builder.md +55 -0
  514. package/.versions/2.0.21/agents/code-reviewer.md +209 -0
  515. package/.versions/2.0.21/agents/deep-researcher.md +32 -0
  516. package/.versions/2.0.21/agents/documenter.md +22 -0
  517. package/.versions/2.0.21/agents/orchestrator.md +22 -0
  518. package/.versions/2.0.21/agents/plan-reviewer.md +83 -0
  519. package/.versions/2.0.21/agents/planner.md +107 -0
  520. package/.versions/2.0.21/agents/releaser.md +24 -0
  521. package/.versions/2.0.21/agents/researcher.md +30 -0
  522. package/.versions/2.0.21/agents/security-auditor.md +167 -0
  523. package/.versions/2.0.21/agents/test-engineer.md +153 -0
  524. package/.versions/2.0.21/agents/web-debugger.md +44 -0
  525. package/.versions/2.0.21/agents/web-performance-auditor.md +194 -0
  526. package/.versions/2.0.21/bin/catalog/harness-runtime-closure.json +73 -0
  527. package/.versions/2.0.21/codex/fleet-session-client/SKILL.md +34 -0
  528. package/.versions/2.0.21/codex/fleet-session-client.zip +0 -0
  529. package/.versions/2.0.21/docs/ARCHITECTURE.md +979 -0
  530. package/.versions/2.0.21/docs/agent-fleet-setup.md +1103 -0
  531. package/.versions/2.0.21/docs/claude-code-coms-bridge.md +147 -0
  532. package/.versions/2.0.21/docs/codex-session-bridge.md +219 -0
  533. package/.versions/2.0.21/docs/coms-hermes-bridge.md +188 -0
  534. package/.versions/2.0.21/docs/getting-started.md +126 -0
  535. package/.versions/2.0.21/docs/npm-install.md +535 -0
  536. package/.versions/2.0.21/docs/pi-extensions.md +455 -0
  537. package/.versions/2.0.21/docs/pi-setup.md +92 -0
  538. package/.versions/2.0.21/docs/skill-anatomy.md +150 -0
  539. package/.versions/2.0.21/install-manifest.json +3210 -0
  540. package/.versions/2.0.21/justfile +247 -0
  541. package/.versions/2.0.21/manifest-meta.json +1088 -0
  542. package/.versions/2.0.21/references/accessibility-checklist.md +160 -0
  543. package/.versions/2.0.21/references/communication-contract.md +26 -0
  544. package/.versions/2.0.21/references/definition-of-done.md +67 -0
  545. package/.versions/2.0.21/references/fleet-coordination-patterns.md +171 -0
  546. package/.versions/2.0.21/references/observability-checklist.md +92 -0
  547. package/.versions/2.0.21/references/orchestration-patterns.md +370 -0
  548. package/.versions/2.0.21/references/performance-checklist.md +236 -0
  549. package/.versions/2.0.21/references/prompting-patterns.md +380 -0
  550. package/.versions/2.0.21/references/security-checklist.md +245 -0
  551. package/.versions/2.0.21/references/testing-patterns.md +235 -0
  552. package/.versions/2.0.21/references/workflow-authoring.md +304 -0
  553. package/.versions/2.0.21/skills/_internal/grilling.md +59 -0
  554. package/.versions/2.0.21/skills/browser-testing-with-devtools/SKILL.md +351 -0
  555. package/.versions/2.0.21/skills/code-review-and-quality/SKILL.md +396 -0
  556. package/.versions/2.0.21/skills/compound-learning/SKILL.md +137 -0
  557. package/.versions/2.0.21/skills/constraint-driven-development/SKILL.md +338 -0
  558. package/.versions/2.0.21/skills/constraint-driven-development/references/floor-guard.md +99 -0
  559. package/.versions/2.0.21/skills/context-engineering/SKILL.md +341 -0
  560. package/.versions/2.0.21/skills/deprecation-and-migration/SKILL.md +247 -0
  561. package/.versions/2.0.21/skills/designing-agents/SKILL.md +394 -0
  562. package/.versions/2.0.21/skills/designing-agents/pi-harness-authoring.md +222 -0
  563. package/.versions/2.0.21/skills/drafting-workflows/SKILL.md +143 -0
  564. package/.versions/2.0.21/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  565. package/.versions/2.0.21/skills/frontend-ui-engineering/SKILL.md +328 -0
  566. package/.versions/2.0.21/skills/git-workflow-and-versioning/SKILL.md +316 -0
  567. package/.versions/2.0.21/skills/idea-refine/SKILL.md +182 -0
  568. package/.versions/2.0.21/skills/idea-refine/examples.md +238 -0
  569. package/.versions/2.0.21/skills/idea-refine/frameworks.md +99 -0
  570. package/.versions/2.0.21/skills/idea-refine/refinement-criteria.md +113 -0
  571. package/.versions/2.0.21/skills/idea-refine/scripts/idea-refine.sh +15 -0
  572. package/.versions/2.0.21/skills/incremental-implementation/SKILL.md +353 -0
  573. package/.versions/2.0.21/skills/incremental-implementation.zip +0 -0
  574. package/.versions/2.0.21/skills/interview-me/SKILL.md +226 -0
  575. package/.versions/2.0.21/skills/orchestration-verification/SKILL.md +182 -0
  576. package/.versions/2.0.21/skills/peer-coms/SKILL.md +90 -0
  577. package/.versions/2.0.21/skills/performance-optimization/SKILL.md +496 -0
  578. package/.versions/2.0.21/skills/planning-and-task-breakdown/SKILL.md +318 -0
  579. package/.versions/2.0.21/skills/planning-and-task-breakdown.zip +0 -0
  580. package/.versions/2.0.21/skills/repository-ai-setup/SKILL.md +135 -0
  581. package/.versions/2.0.21/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  582. package/.versions/2.0.21/skills/repository-ai-setup/references/apply-contract.md +74 -0
  583. package/.versions/2.0.21/skills/repository-ai-setup/references/provenance-template.md +16 -0
  584. package/.versions/2.0.21/skills/repository-ai-setup/references/setup-flow.md +108 -0
  585. package/.versions/2.0.21/skills/repository-ai-setup/references/verify-setup.md +20 -0
  586. package/.versions/2.0.21/skills/repository-ai-setup.zip +0 -0
  587. package/.versions/2.0.21/skills/security-and-hardening/SKILL.md +524 -0
  588. package/.versions/2.0.21/skills/spec-driven-development/SKILL.md +295 -0
  589. package/.versions/2.0.21/skills/spec-driven-development.zip +0 -0
  590. package/.versions/2.0.21/skills/using-agent-skills/SKILL.md +198 -0
  591. package/.versions/2.0.21/vendor/agent-skills-upstream/LICENSE +21 -0
  592. package/.versions/2.0.21/vendor/agent-skills-upstream/README.md +430 -0
  593. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  594. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  595. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  596. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  597. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  598. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  599. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  600. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  601. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  602. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  603. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  604. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  605. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  606. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  607. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  608. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  609. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  610. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  611. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  612. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  613. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  614. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  615. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  616. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  617. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  618. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  619. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  620. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  621. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  622. package/.versions/2.0.21/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  623. package/CHANGELOG.md +6 -0
  624. package/docs/ARCHITECTURE.md +4 -2
  625. package/install-manifest.json +1 -1
  626. package/package.json +1 -1
@@ -0,0 +1,642 @@
1
+ import { spawn } from "node:child_process";
2
+ import { createHash, randomUUID } from "node:crypto";
3
+ import {
4
+ closeSync,
5
+ existsSync,
6
+ mkdirSync,
7
+ openSync,
8
+ readFileSync,
9
+ realpathSync,
10
+ unlinkSync,
11
+ } from "node:fs";
12
+ import { tmpdir } from "node:os";
13
+ import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
14
+ import { pathToFileURL } from "node:url";
15
+ import { execFileSync } from "node:child_process";
16
+
17
+ export const DEFAULT_PROJECT_TIMEOUT_MS = 10_000;
18
+ export const DEFAULT_TOTAL_TIMEOUT_MS = 30_000;
19
+ export const DEFAULT_KILL_GRACE_MS = 250;
20
+ export const DEFAULT_ADVISORY_CHANGED_LIMIT = 10;
21
+ export const DEFAULT_ADVISORY_ELSEWHERE_LIMIT = 10;
22
+ export const DEFAULT_ADVISORY_PROJECT_LIMIT = 10;
23
+ export const DEFAULT_ADVISORY_MESSAGE_CHARS = 500;
24
+
25
+ export interface Diagnostic {
26
+ file?: string;
27
+ line?: number;
28
+ column?: number;
29
+ code: number;
30
+ message: string;
31
+ }
32
+
33
+ export interface ProjectDiagnostics {
34
+ project: string;
35
+ status: "passed" | "errors" | "unavailable";
36
+ exitCode: number | null;
37
+ reason?: string;
38
+ diagnostics: Diagnostic[];
39
+ /** Complete process evidence. Callers persist this outside compact tool output. */
40
+ argv: string[];
41
+ stdout: string;
42
+ stderr: string;
43
+ durationMs?: number;
44
+ compilerVersion?: string;
45
+ changedFiles?: string[];
46
+ }
47
+
48
+ export interface DiagnosticsResult {
49
+ status: "skipped" | "completed" | "incomplete";
50
+ reason?: string;
51
+ changedFiles: string[];
52
+ attribution: "no_observed_overlap" | "uncertain";
53
+ projects: ProjectDiagnostics[];
54
+ uncoveredFiles?: string[];
55
+ }
56
+
57
+ export interface BuildInfoCacheLease {
58
+ file: string;
59
+ contended: boolean;
60
+ release(): void;
61
+ }
62
+
63
+ export interface ResolvedTypeScriptProject {
64
+ project: string;
65
+ changedFiles: string[];
66
+ compilerPath: string;
67
+ compilerVersion: string;
68
+ }
69
+
70
+ export interface ProjectResolution {
71
+ gitRoot?: string;
72
+ changedFiles: string[];
73
+ projects: ResolvedTypeScriptProject[];
74
+ unavailableProjects: ProjectDiagnostics[];
75
+ uncoveredFiles: string[];
76
+ hadProjectCandidates: boolean;
77
+ reason?: string;
78
+ }
79
+
80
+ export interface ProcessResult {
81
+ exitCode: number | null;
82
+ stdout: string;
83
+ stderr: string;
84
+ durationMs: number;
85
+ timedOut?: boolean;
86
+ spawnError?: string;
87
+ }
88
+
89
+ export type ProcessRunner = (
90
+ file: string,
91
+ args: string[],
92
+ options: { cwd: string; timeoutMs: number },
93
+ ) => Promise<ProcessResult>;
94
+
95
+ type TypeScriptConfigDiagnostic = {
96
+ code: number;
97
+ messageText: unknown;
98
+ file?: {
99
+ fileName: string;
100
+ getLineAndCharacterOfPosition(position: number): { line: number; character: number };
101
+ };
102
+ start?: number;
103
+ };
104
+
105
+ type TypeScriptApi = {
106
+ sys: {
107
+ useCaseSensitiveFileNames: boolean;
108
+ readFile(path: string): string | undefined;
109
+ readDirectory(path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
110
+ };
111
+ readConfigFile(path: string, readFile: (path: string) => string | undefined): { config?: Record<string, unknown>; error?: TypeScriptConfigDiagnostic };
112
+ parseJsonConfigFileContent(config: Record<string, unknown>, host: Record<string, unknown>, basePath: string, existingOptions?: unknown, configFileName?: string): { fileNames: string[]; errors: TypeScriptConfigDiagnostic[] };
113
+ getFileMatcherPatterns(path: string, excludes: readonly string[] | undefined, includes: readonly string[] | undefined, caseSensitive: boolean, currentDirectory: string): { includeFilePattern?: string; excludePattern?: string };
114
+ flattenDiagnosticMessageText(message: unknown, newLine: string): string;
115
+ };
116
+
117
+ export interface DiagnosticsDependencies {
118
+ findGitRoot?: (cwd: string) => string;
119
+ exists?: (path: string) => boolean;
120
+ readFile?: (path: string, encoding: "utf8") => string;
121
+ loadTypeScript?: (compilerPath: string) => Promise<TypeScriptApi>;
122
+ runProcess?: ProcessRunner;
123
+ now?: () => number;
124
+ acquireCache?: typeof acquireBuildInfoCache;
125
+ }
126
+
127
+ export interface DiagnosticsOptions {
128
+ cwd?: string;
129
+ attribution?: DiagnosticsResult["attribution"];
130
+ cacheRoot?: string;
131
+ cacheLane?: string;
132
+ runId?: string;
133
+ projectTimeoutMs?: number;
134
+ totalTimeoutMs?: number;
135
+ nodeExecutable?: string;
136
+ }
137
+
138
+ function shortHash(value: string): string {
139
+ return createHash("sha256").update(value).digest("hex").slice(0, 16);
140
+ }
141
+
142
+ function safeSegment(value: string): string {
143
+ return value.replace(/[^a-zA-Z0-9._-]+/g, "-").slice(0, 48) || "default";
144
+ }
145
+
146
+ /**
147
+ * Reserve a cache lane outside the worktree. The stable lane retains warm data;
148
+ * an overlapping run receives a unique fallback and never shares a writer.
149
+ */
150
+ export function acquireBuildInfoCache(input: {
151
+ worktree: string;
152
+ project: string;
153
+ compilerVersion: string;
154
+ lane?: string;
155
+ runId?: string;
156
+ cacheRoot?: string;
157
+ }): BuildInfoCacheLease {
158
+ const directory = join(
159
+ input.cacheRoot ?? join(tmpdir(), "agent-fleet-diagnostics"),
160
+ shortHash(resolve(input.worktree)),
161
+ shortHash(resolve(input.project)),
162
+ `typescript-${safeSegment(input.compilerVersion)}`,
163
+ );
164
+ mkdirSync(directory, { recursive: true });
165
+ const lane = safeSegment(input.lane ?? "default");
166
+ const stableFile = join(directory, `${lane}.tsbuildinfo`);
167
+ const lockFile = `${stableFile}.lock`;
168
+ let descriptor: number | undefined;
169
+ try {
170
+ descriptor = openSync(lockFile, "wx");
171
+ } catch (error) {
172
+ if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
173
+ }
174
+ if (descriptor === undefined) {
175
+ return {
176
+ file: join(directory, `${lane}-${shortHash(input.runId ?? randomUUID())}.tsbuildinfo`),
177
+ contended: true,
178
+ release() {},
179
+ };
180
+ }
181
+ let released = false;
182
+ return {
183
+ file: stableFile,
184
+ contended: false,
185
+ release() {
186
+ if (released) return;
187
+ released = true;
188
+ try { closeSync(descriptor); } catch {}
189
+ try { unlinkSync(lockFile); } catch {}
190
+ },
191
+ };
192
+ }
193
+
194
+ /** Parse every standard `--pretty false` TypeScript error, including globals. */
195
+ export function parseCompilerOutput(output: string, cwd = process.cwd()): Diagnostic[] {
196
+ const diagnostics: Diagnostic[] = [];
197
+ for (const line of String(output || "").split(/\r?\n/)) {
198
+ const positioned = line.match(/^(.*)\((\d+),(\d+)\):\s+error\s+TS(\d+):\s?(.*)$/);
199
+ const global = positioned ? null : line.match(/^error\s+TS(\d+):\s?(.*)$/);
200
+ if (positioned) {
201
+ const rawFile = positioned[1];
202
+ const file = normalizeEvidencePath(rawFile, cwd);
203
+ diagnostics.push({ file, line: Number(positioned[2]), column: Number(positioned[3]), code: Number(positioned[4]), message: positioned[5] });
204
+ } else if (global) {
205
+ diagnostics.push({ code: Number(global[1]), message: global[2] });
206
+ } else if (line && diagnostics.length) {
207
+ diagnostics[diagnostics.length - 1].message += `\n${line}`;
208
+ }
209
+ }
210
+ return diagnostics;
211
+ }
212
+
213
+ function canonicalPath(path: string): string {
214
+ try { return realpathSync(path); } catch { return resolve(path); }
215
+ }
216
+
217
+ function normalizeEvidencePath(file: string, cwd: string): string {
218
+ // A child process observes the physical cwd, even when the supplied worktree
219
+ // uses a symlink (macOS /var -> /private/var). tsc may print ../alias/src/a.ts.
220
+ // Resolve both spellings before grouping, otherwise changed errors become
221
+ // incorrectly classified as downstream errors and evade contract correction.
222
+ const root = canonicalPath(cwd);
223
+ const absolute = canonicalPath(resolve(root, file));
224
+ const rel = relative(root, absolute).replace(/\\/g, "/");
225
+ if (rel !== ".." && !rel.startsWith("../") && !isAbsolute(rel)) return rel;
226
+ return file.replace(/\\/g, "/").replace(/^\.\//, "");
227
+ }
228
+
229
+ /** Group for display without discarding downstream or global diagnostics. */
230
+ export function groupDiagnostics(raw: Diagnostic[], changed: readonly string[]): {
231
+ inChangedFiles: Diagnostic[];
232
+ elsewhere: Diagnostic[];
233
+ } {
234
+ const changedSet = new Set(changed.map((file) => file.replace(/\\/g, "/").replace(/^\.\//, "")));
235
+ const inChangedFiles: Diagnostic[] = [];
236
+ const elsewhere: Diagnostic[] = [];
237
+ for (const diagnostic of raw) {
238
+ const file = diagnostic.file?.replace(/\\/g, "/").replace(/^\.\//, "");
239
+ (file && changedSet.has(file) ? inChangedFiles : elsewhere).push(diagnostic);
240
+ }
241
+ return { inChangedFiles, elsewhere };
242
+ }
243
+
244
+ function formatDiagnostic(diagnostic: Diagnostic): string {
245
+ const position = diagnostic.file
246
+ ? `${diagnostic.file}${diagnostic.line == null ? "" : `:${diagnostic.line}${diagnostic.column == null ? "" : `:${diagnostic.column}`}`}`
247
+ : "global";
248
+ const compact = diagnostic.message.replace(/\s+/g, " ").trim();
249
+ const message = compact.length > DEFAULT_ADVISORY_MESSAGE_CHARS
250
+ ? `${compact.slice(0, DEFAULT_ADVISORY_MESSAGE_CHARS - 1)}…`
251
+ : compact;
252
+ return `${position} — TS${diagnostic.code}: ${message}`;
253
+ }
254
+
255
+ /** Compact, deterministic presentation; raw evidence and diagnostics remain untouched. */
256
+ export function formatAdvisory(result: DiagnosticsResult): string {
257
+ if (result.status === "skipped") return "";
258
+ const lines: string[] = [];
259
+ let changedBudget = DEFAULT_ADVISORY_CHANGED_LIMIT;
260
+ let elsewhereBudget = DEFAULT_ADVISORY_ELSEWHERE_LIMIT;
261
+ for (const project of result.projects.slice(0, DEFAULT_ADVISORY_PROJECT_LIMIT)) {
262
+ if (project.status === "passed") continue;
263
+ if (project.status === "unavailable") {
264
+ lines.push(`⚠ Compiler unavailable for ${basename(project.project)}: ${project.reason ?? "unknown reason"}`);
265
+ continue;
266
+ }
267
+ if (!lines.length) lines.push("⚠ Compiler errors (agent run completed):");
268
+ lines.push(`Project: ${project.project}`);
269
+ const grouped = groupDiagnostics(project.diagnostics, result.changedFiles);
270
+ const shownChanged = grouped.inChangedFiles.slice(0, Math.max(0, changedBudget));
271
+ const shownElsewhere = grouped.elsewhere.slice(0, Math.max(0, elsewhereBudget));
272
+ if (shownChanged.length) lines.push("Observed changed files:", ...shownChanged.map((item) => ` ${formatDiagnostic(item)}`));
273
+ if (grouped.inChangedFiles.length > shownChanged.length) lines.push(` … ${grouped.inChangedFiles.length - shownChanged.length} more diagnostics omitted`);
274
+ if (shownElsewhere.length) lines.push("Elsewhere:", ...shownElsewhere.map((item) => ` ${formatDiagnostic(item)}`));
275
+ if (grouped.elsewhere.length > shownElsewhere.length) lines.push(` … ${grouped.elsewhere.length - shownElsewhere.length} more diagnostics omitted`);
276
+ changedBudget -= shownChanged.length;
277
+ elsewhereBudget -= shownElsewhere.length;
278
+ lines.push(`Compiler exit: ${project.exitCode ?? "unavailable"}.`);
279
+ }
280
+ if (result.projects.length > DEFAULT_ADVISORY_PROJECT_LIMIT) lines.push(`… ${result.projects.length - DEFAULT_ADVISORY_PROJECT_LIMIT} more projects omitted`);
281
+ if (result.uncoveredFiles?.length) lines.push(`Uncovered TypeScript paths: ${result.uncoveredFiles.length}.`);
282
+ if (!lines.length && result.status === "incomplete") lines.push(`⚠ Compiler diagnostics incomplete: ${result.reason ?? "verification did not complete"}`);
283
+ if (lines.length) lines.push(result.attribution === "uncertain"
284
+ ? "Concurrent worktree activity observed; attribution is uncertain."
285
+ : "This result does not establish who introduced the errors.");
286
+ return lines.join("\n");
287
+ }
288
+
289
+ const TS_EXTENSION = /\.(?:ts|tsx|mts|cts)$/i;
290
+
291
+ function uniqueSorted(values: readonly string[]): string[] {
292
+ return [...new Set(values)].sort((a, b) => a.localeCompare(b));
293
+ }
294
+
295
+ function isWithin(root: string, candidate: string): boolean {
296
+ const rel = relative(root, candidate);
297
+ return rel === "" || (!rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute(rel));
298
+ }
299
+
300
+ function defaultGitRoot(cwd: string): string {
301
+ return execFileSync("git", ["-C", cwd, "rev-parse", "--show-toplevel"], {
302
+ encoding: "utf8",
303
+ stdio: ["ignore", "pipe", "pipe"],
304
+ }).trim();
305
+ }
306
+
307
+ function nearestConfig(file: string, gitRoot: string, exists: (path: string) => boolean): string | undefined {
308
+ let directory = dirname(file);
309
+ while (isWithin(gitRoot, directory)) {
310
+ const candidate = join(directory, "tsconfig.json");
311
+ if (exists(candidate)) return candidate;
312
+ if (directory === gitRoot) break;
313
+ directory = dirname(directory);
314
+ }
315
+ return undefined;
316
+ }
317
+
318
+ function findLocalCompiler(project: string, gitRoot: string, exists: (path: string) => boolean): string | undefined {
319
+ let directory = dirname(project);
320
+ while (isWithin(gitRoot, directory)) {
321
+ const candidate = join(directory, "node_modules", "typescript", "bin", "tsc");
322
+ if (exists(candidate)) return candidate;
323
+ if (directory === gitRoot) break;
324
+ directory = dirname(directory);
325
+ }
326
+ return undefined;
327
+ }
328
+
329
+ function compilerVersion(compilerPath: string, readFile: (path: string, encoding: "utf8") => string): string {
330
+ const packageJson = join(dirname(dirname(compilerPath)), "package.json");
331
+ const parsed = JSON.parse(readFile(packageJson, "utf8"));
332
+ if (typeof parsed.version !== "string" || !parsed.version) throw new Error("local TypeScript package has no version");
333
+ return parsed.version;
334
+ }
335
+
336
+ async function defaultLoadTypeScript(compilerPath: string): Promise<TypeScriptApi> {
337
+ const modulePath = join(dirname(dirname(compilerPath)), "lib", "typescript.js");
338
+ const loaded = await import(pathToFileURL(modulePath).href);
339
+ return (loaded.default ?? loaded) as TypeScriptApi;
340
+ }
341
+
342
+ function unsupportedConfig(config: Record<string, unknown>): string | undefined {
343
+ if (Array.isArray(config.references) && config.references.length) return "project references require a build-mode compiler and are unsupported";
344
+ for (const key of ["angularCompilerOptions", "vueCompilerOptions", "svelteOptions"]) {
345
+ if (key in config) return `${key} requires a framework-specific compiler and is unsupported`;
346
+ }
347
+ const compilerOptions = config.compilerOptions as { plugins?: Array<{ name?: string }> } | undefined;
348
+ const frameworkPlugin = compilerOptions?.plugins?.find((plugin) => /(?:angular|vue|svelte)/i.test(plugin?.name ?? ""));
349
+ if (frameworkPlugin) return `compiler plugin ${frameworkPlugin.name ?? "unknown"} requires framework-specific coverage`;
350
+ return undefined;
351
+ }
352
+
353
+ function unavailableProject(project: string, changedFiles: string[], reason: string, diagnostics: Diagnostic[] = []): ProjectDiagnostics {
354
+ return { project, status: "unavailable", exitCode: null, reason, diagnostics, argv: [], stdout: "", stderr: "", changedFiles };
355
+ }
356
+
357
+ function configDiagnostics(ts: TypeScriptApi, raw: readonly TypeScriptConfigDiagnostic[], cwd: string): Diagnostic[] {
358
+ return raw.map((item) => {
359
+ const diagnostic: Diagnostic = {
360
+ code: item.code,
361
+ message: ts.flattenDiagnosticMessageText(item.messageText, "\n"),
362
+ };
363
+ if (item.file) diagnostic.file = normalizeEvidencePath(item.file.fileName, cwd);
364
+ if (item.file && item.start != null) {
365
+ const position = item.file.getLineAndCharacterOfPosition(item.start);
366
+ diagnostic.line = position.line + 1;
367
+ diagnostic.column = position.character + 1;
368
+ }
369
+ return diagnostic;
370
+ });
371
+ }
372
+
373
+ const EMPTY_INPUT_CONFIG_DIAGNOSTICS = new Set([18002, 18003]);
374
+
375
+ function virtualReadDirectory(
376
+ ts: TypeScriptApi,
377
+ virtualFiles: readonly string[],
378
+ currentDirectory: string,
379
+ ): TypeScriptApi["sys"]["readDirectory"] {
380
+ return (path, extensions, excludes, includes, depth) => {
381
+ const actual = ts.sys.readDirectory(path, extensions, excludes, includes, depth);
382
+ const patterns = ts.getFileMatcherPatterns(path, excludes, includes, ts.sys.useCaseSensitiveFileNames, currentDirectory);
383
+ const include = patterns.includeFilePattern ? new RegExp(patterns.includeFilePattern, ts.sys.useCaseSensitiveFileNames ? "" : "i") : undefined;
384
+ const exclude = patterns.excludePattern ? new RegExp(patterns.excludePattern, ts.sys.useCaseSensitiveFileNames ? "" : "i") : undefined;
385
+ const extensionSet = new Set((extensions ?? []).map((extension) => extension.toLowerCase()));
386
+ const added = virtualFiles.filter((file) => {
387
+ const normalized = resolve(file).replace(/\\/g, "/");
388
+ if (!isWithin(resolve(path), resolve(file))) return false;
389
+ if (extensionSet.size && ![...extensionSet].some((extension) => normalized.toLowerCase().endsWith(extension))) return false;
390
+ return (!include || include.test(normalized)) && (!exclude || !exclude.test(normalized));
391
+ });
392
+ return uniqueSorted([...actual.map((file) => resolve(file)), ...added.map((file) => resolve(file))]);
393
+ };
394
+ }
395
+
396
+ /** Resolve nearest standard projects and prove changed-file membership with the local TS parser. */
397
+ export async function resolveChangedFileProjects(
398
+ changedFiles: readonly string[],
399
+ options: { cwd?: string } = {},
400
+ deps: DiagnosticsDependencies = {},
401
+ ): Promise<ProjectResolution> {
402
+ const cwd = resolve(options.cwd ?? process.cwd());
403
+ const tsFiles = uniqueSorted(changedFiles.filter((file) => TS_EXTENSION.test(file)).map((file) => file.replace(/\\/g, "/").replace(/^\.\//, "")));
404
+ if (!tsFiles.length) return { changedFiles: [], projects: [], unavailableProjects: [], uncoveredFiles: [], hadProjectCandidates: false, reason: "no TypeScript files changed" };
405
+ let gitRoot: string;
406
+ try {
407
+ gitRoot = resolve((deps.findGitRoot ?? defaultGitRoot)(cwd));
408
+ } catch (error) {
409
+ return { changedFiles: tsFiles, projects: [], unavailableProjects: [], uncoveredFiles: tsFiles, hadProjectCandidates: false, reason: `git root unavailable: ${String(error)}` };
410
+ }
411
+ const exists = deps.exists ?? existsSync;
412
+ const readFile = deps.readFile ?? readFileSync;
413
+ const byProject = new Map<string, string[]>();
414
+ const uncovered = new Set<string>();
415
+ for (const changed of tsFiles) {
416
+ const absolute = isAbsolute(changed) ? resolve(changed) : resolve(gitRoot, changed);
417
+ if (!isWithin(gitRoot, absolute)) { uncovered.add(changed); continue; }
418
+ const project = nearestConfig(absolute, gitRoot, exists);
419
+ if (!project) { uncovered.add(changed); continue; }
420
+ const files = byProject.get(project) ?? [];
421
+ files.push(changed);
422
+ byProject.set(project, files);
423
+ }
424
+ const projects: ResolvedTypeScriptProject[] = [];
425
+ const unavailableProjects: ProjectDiagnostics[] = [];
426
+ for (const [project, candidates] of [...byProject].sort(([a], [b]) => a.localeCompare(b))) {
427
+ const compilerPath = findLocalCompiler(project, gitRoot, exists);
428
+ if (!compilerPath) {
429
+ unavailableProjects.push(unavailableProject(project, candidates, "local TypeScript compiler not found between project and git root"));
430
+ candidates.forEach((file) => uncovered.add(file));
431
+ continue;
432
+ }
433
+ let version: string;
434
+ let ts: TypeScriptApi;
435
+ try {
436
+ version = compilerVersion(compilerPath, readFile);
437
+ ts = await (deps.loadTypeScript ?? defaultLoadTypeScript)(compilerPath);
438
+ } catch (error) {
439
+ unavailableProjects.push(unavailableProject(project, candidates, `local TypeScript compiler unavailable: ${String(error)}`));
440
+ candidates.forEach((file) => uncovered.add(file));
441
+ continue;
442
+ }
443
+ const read = ts.readConfigFile(project, ts.sys.readFile);
444
+ if (read.error || !read.config) {
445
+ const diagnostics = read.error ? configDiagnostics(ts, [read.error], gitRoot) : [];
446
+ const reason = diagnostics[0]?.message ?? "config parse failed";
447
+ unavailableProjects.push(unavailableProject(project, candidates, `unsupported config: ${reason}`, diagnostics));
448
+ candidates.forEach((file) => uncovered.add(file));
449
+ continue;
450
+ }
451
+ const unsupported = unsupportedConfig(read.config);
452
+ if (unsupported) {
453
+ unavailableProjects.push(unavailableProject(project, candidates, unsupported));
454
+ candidates.forEach((file) => uncovered.add(file));
455
+ continue;
456
+ }
457
+ const candidateAbsolute = candidates.map((file) => isAbsolute(file) ? resolve(file) : resolve(gitRoot, file));
458
+ const host = { ...ts.sys, readDirectory: virtualReadDirectory(ts, candidateAbsolute, dirname(project)), onUnRecoverableConfigFileDiagnostic() {} };
459
+ const parsed = ts.parseJsonConfigFileContent(read.config, host, dirname(project), undefined, project);
460
+ const diagnostics = configDiagnostics(ts, parsed.errors, gitRoot);
461
+ if (parsed.errors.some((error) => !EMPTY_INPUT_CONFIG_DIAGNOSTICS.has(error.code))) {
462
+ const reason = diagnostics.map((diagnostic) => `TS${diagnostic.code}: ${diagnostic.message}`).join("\n");
463
+ unavailableProjects.push(unavailableProject(project, candidates, `unsupported config: ${reason}`, diagnostics));
464
+ candidates.forEach((file) => uncovered.add(file));
465
+ continue;
466
+ }
467
+ const included = new Set(parsed.fileNames.map((file) => resolve(file)));
468
+ const covered = candidates.filter((file) => included.has(isAbsolute(file) ? resolve(file) : resolve(gitRoot, file)));
469
+ candidates.filter((file) => !covered.includes(file)).forEach((file) => uncovered.add(file));
470
+ if (covered.length) projects.push({ project, changedFiles: uniqueSorted(covered), compilerPath, compilerVersion: version });
471
+ }
472
+ return {
473
+ gitRoot,
474
+ changedFiles: tsFiles,
475
+ projects,
476
+ unavailableProjects,
477
+ uncoveredFiles: uniqueSorted([...uncovered]),
478
+ hadProjectCandidates: byProject.size > 0,
479
+ reason: !projects.length && !unavailableProjects.length
480
+ ? (byProject.size ? "nearest tsconfig.json excludes the changed TypeScript files" : "no nearest tsconfig.json covers the changed TypeScript files")
481
+ : undefined,
482
+ };
483
+ }
484
+
485
+ /** The exact compiler argv used by execution and exposed as evidence. */
486
+ export function compilerArgv(project: ResolvedTypeScriptProject, cacheFile: string, nodeExecutable = process.execPath): string[] {
487
+ return [
488
+ nodeExecutable,
489
+ project.compilerPath,
490
+ "--project", project.project,
491
+ "--noEmit",
492
+ "--pretty", "false",
493
+ "--incremental",
494
+ "--tsBuildInfoFile", cacheFile,
495
+ ];
496
+ }
497
+
498
+ export const runProcess: ProcessRunner = (file, args, options) => new Promise((finish) => {
499
+ const started = Date.now();
500
+ let stdout = "";
501
+ let stderr = "";
502
+ let settled = false;
503
+ let timedOut = false;
504
+ let killTimer: NodeJS.Timeout | undefined;
505
+ let settlementTimer: NodeJS.Timeout | undefined;
506
+ const child = spawn(file, args, { cwd: options.cwd, env: process.env, shell: false, stdio: ["ignore", "pipe", "pipe"] });
507
+ const done = (result: Omit<ProcessResult, "stdout" | "stderr" | "durationMs">) => {
508
+ if (settled) return;
509
+ settled = true;
510
+ clearTimeout(timer);
511
+ if (killTimer) clearTimeout(killTimer);
512
+ if (settlementTimer) clearTimeout(settlementTimer);
513
+ finish({ ...result, stdout, stderr, durationMs: Date.now() - started });
514
+ };
515
+ child.stdout?.on("data", (chunk) => { stdout += chunk; });
516
+ child.stderr?.on("data", (chunk) => { stderr += chunk; });
517
+ child.on("error", (error) => done({ exitCode: null, spawnError: error.message, timedOut }));
518
+ child.on("close", (code) => done({ exitCode: code, timedOut }));
519
+ const timer = setTimeout(() => {
520
+ timedOut = true;
521
+ stderr += `\nTimed out after ${options.timeoutMs}ms`;
522
+ child.kill("SIGTERM");
523
+ killTimer = setTimeout(() => child.kill("SIGKILL"), DEFAULT_KILL_GRACE_MS);
524
+ settlementTimer = setTimeout(() => done({ exitCode: null, timedOut: true }), DEFAULT_KILL_GRACE_MS * 2);
525
+ }, Math.max(1, options.timeoutMs));
526
+ });
527
+
528
+ /** Execute one resolved project; spawn, output parsing, and display grouping stay separate. */
529
+ export async function runProjectDiagnostics(
530
+ project: ResolvedTypeScriptProject,
531
+ options: DiagnosticsOptions & { gitRoot: string; timeoutMs?: number } = { gitRoot: process.cwd() },
532
+ deps: DiagnosticsDependencies = {},
533
+ ): Promise<ProjectDiagnostics> {
534
+ let cache: BuildInfoCacheLease;
535
+ try {
536
+ cache = (deps.acquireCache ?? acquireBuildInfoCache)({
537
+ worktree: options.gitRoot,
538
+ project: project.project,
539
+ compilerVersion: project.compilerVersion,
540
+ lane: options.cacheLane,
541
+ runId: options.runId,
542
+ cacheRoot: options.cacheRoot,
543
+ });
544
+ } catch (error) {
545
+ return unavailableProject(project.project, project.changedFiles, `build-info cache unavailable: ${String(error)}`);
546
+ }
547
+ const argv = compilerArgv(project, cache.file, options.nodeExecutable);
548
+ try {
549
+ const execution = await (deps.runProcess ?? runProcess)(argv[0], argv.slice(1), {
550
+ cwd: options.gitRoot,
551
+ timeoutMs: options.timeoutMs ?? options.projectTimeoutMs ?? DEFAULT_PROJECT_TIMEOUT_MS,
552
+ });
553
+ const diagnostics = [
554
+ ...parseCompilerOutput(execution.stdout, options.gitRoot),
555
+ ...parseCompilerOutput(execution.stderr, options.gitRoot),
556
+ ];
557
+ if (execution.timedOut) return {
558
+ project: project.project, status: "unavailable", exitCode: execution.exitCode,
559
+ reason: `compiler timed out after ${options.timeoutMs ?? options.projectTimeoutMs ?? DEFAULT_PROJECT_TIMEOUT_MS}ms`,
560
+ diagnostics, argv, stdout: execution.stdout, stderr: execution.stderr, durationMs: execution.durationMs,
561
+ compilerVersion: project.compilerVersion, changedFiles: project.changedFiles,
562
+ };
563
+ if (execution.spawnError) return {
564
+ project: project.project, status: "unavailable", exitCode: execution.exitCode,
565
+ reason: `compiler spawn failed: ${execution.spawnError}`, diagnostics, argv,
566
+ stdout: execution.stdout, stderr: execution.stderr, durationMs: execution.durationMs,
567
+ compilerVersion: project.compilerVersion, changedFiles: project.changedFiles,
568
+ };
569
+ return {
570
+ project: project.project,
571
+ status: execution.exitCode === 0 ? "passed" : "errors",
572
+ exitCode: execution.exitCode,
573
+ reason: execution.exitCode !== 0 && diagnostics.length === 0 ? "compiler exited nonzero without parseable diagnostics" : undefined,
574
+ diagnostics,
575
+ argv,
576
+ stdout: execution.stdout,
577
+ stderr: execution.stderr,
578
+ durationMs: execution.durationMs,
579
+ compilerVersion: project.compilerVersion,
580
+ changedFiles: project.changedFiles,
581
+ };
582
+ } catch (error) {
583
+ return {
584
+ ...unavailableProject(project.project, project.changedFiles, `compiler execution failed: ${String(error)}`),
585
+ argv,
586
+ compilerVersion: project.compilerVersion,
587
+ };
588
+ } finally {
589
+ cache.release();
590
+ }
591
+ }
592
+
593
+ /** Standalone Step 1 entry point. It is intentionally not wired into dispatch yet. */
594
+ export async function diagnoseChangedTypeScript(
595
+ changedFiles: readonly string[],
596
+ options: DiagnosticsOptions = {},
597
+ deps: DiagnosticsDependencies = {},
598
+ ): Promise<DiagnosticsResult> {
599
+ const resolution = await resolveChangedFileProjects(changedFiles, { cwd: options.cwd }, deps);
600
+ const attribution = options.attribution ?? "no_observed_overlap";
601
+ if (!resolution.gitRoot) return {
602
+ status: resolution.changedFiles.length ? "incomplete" : "skipped",
603
+ reason: resolution.reason,
604
+ changedFiles: resolution.changedFiles,
605
+ attribution,
606
+ projects: resolution.unavailableProjects,
607
+ uncoveredFiles: resolution.uncoveredFiles,
608
+ };
609
+ if (!resolution.projects.length && !resolution.unavailableProjects.length) return {
610
+ status: resolution.hadProjectCandidates ? "incomplete" : "skipped",
611
+ reason: resolution.reason,
612
+ changedFiles: resolution.changedFiles,
613
+ attribution,
614
+ projects: [],
615
+ uncoveredFiles: resolution.uncoveredFiles,
616
+ };
617
+ const now = deps.now ?? Date.now;
618
+ const started = now();
619
+ const totalTimeout = options.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT_MS;
620
+ const projects = [...resolution.unavailableProjects];
621
+ for (const project of resolution.projects) {
622
+ const remaining = totalTimeout - (now() - started);
623
+ if (remaining <= 0) {
624
+ projects.push(unavailableProject(project.project, project.changedFiles, `total compiler timeout exceeded after ${totalTimeout}ms`));
625
+ continue;
626
+ }
627
+ projects.push(await runProjectDiagnostics(project, {
628
+ ...options,
629
+ gitRoot: resolution.gitRoot,
630
+ timeoutMs: Math.min(options.projectTimeoutMs ?? DEFAULT_PROJECT_TIMEOUT_MS, remaining),
631
+ }, deps));
632
+ }
633
+ const incomplete = resolution.uncoveredFiles.length > 0 || projects.some((project) => project.status === "unavailable");
634
+ return {
635
+ status: incomplete ? "incomplete" : "completed",
636
+ reason: incomplete ? "one or more changed TypeScript paths or projects could not be verified" : undefined,
637
+ changedFiles: resolution.changedFiles,
638
+ attribution,
639
+ projects,
640
+ uncoveredFiles: resolution.uncoveredFiles,
641
+ };
642
+ }
@@ -0,0 +1,9 @@
1
+ /** Shared decision boundary for Hub, native specialists and connected peers. */
2
+ export const DECISION_ROUTING = `Use settled instructions and approved decisions without re-asking. Investigate discoverable facts with available tools or focused research. Resolve routine technical choices independently within the approved scope and record the choice and reason: local helper names, equivalent existing patterns, test fixtures, and reversible implementation details do not require human preference. Multiple valid approaches alone are not a reason to ask.
3
+ Ask only for an unresolved material decision: changed requirements or acceptance criteria, a public compatibility contract, consequential product/architecture trade-offs, new cost or external exposure, destructive effects needing new permission, or conflicting authoritative instructions that research cannot resolve. Respect explicit user boundaries even for small changes. Never invent user intent or treat silence, model consensus, or a specialist report as permission.`;
4
+
5
+ export const SPECIALIST_CLARIFICATION = `${DECISION_ROUTING}
6
+ If you cannot resolve a question within your authority, pause dependent work and return ASK_USER: <one clear English question>, with the evidence checked, options and recommendation. This marker goes to the orchestrator first; it is not an instruction to contact the human automatically. The orchestrator resolves settled/factual/routine questions itself and escalates only remaining material decisions or questions it cannot answer. An ORCHESTRATOR_ANSWER is a model clarification, not human consent; preserve all permission gates.`;
7
+
8
+ export const ORCHESTRATOR_CLARIFICATION = `Triage every ASK_USER/details.questions item before escalating: inspect existing decisions and facts, then resolve routine technical choices yourself. If still unresolved or material, ask the human and wait for the answer before dependent work. Never fabricate a human answer.
9
+ For a parent-resolved round, re-dispatch with one line ORCHESTRATOR_ANSWER: {"dispatchId":"<dispatchId>","answers":[{"question":"<exact returned question>","answer":"<answer>","basis":"routine_technical","evidence":"<source or reasoning>"}]}. Include every returned question exactly once; basis is existing_decision, repository_fact, or routine_technical. For actual human answers use USER_ANSWER: <dispatchId> :: <question> and include the actual answers and their source in the task (including any parent-resolved questions). Both paths resume clarification only, never grant new permissions or override cancellation.`;