@chankov/agent-fleet 2.0.2 → 2.0.3

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 (438) hide show
  1. package/.pi/harnesses/agent-hub/README.md +26 -31
  2. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +1 -1
  3. package/.pi/harnesses/agent-hub/config/overrides.ts +2 -7
  4. package/.pi/harnesses/agent-hub/index.ts +14 -25
  5. package/.pi/harnesses/agent-hub/input/completions.ts +2 -2
  6. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +0 -2
  7. package/.pi/harnesses/agent-hub/package.json +1 -1
  8. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  9. package/.pi/harnesses/agent-hub/research/controls.ts +15 -16
  10. package/.pi/harnesses/agent-hub/research/runtime.ts +30 -39
  11. package/.pi/harnesses/agent-hub/research/spawn-run.ts +108 -111
  12. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +2 -3
  13. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +3 -3
  14. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +0 -7
  15. package/.pi/harnesses/agent-hub/ui/grid.ts +21 -183
  16. package/.pi/harnesses/coms/package.json +1 -1
  17. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  18. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +23 -12
  19. package/.versions/2.0.3/.pi/agents/dispatch-policy.yaml +32 -0
  20. package/.versions/2.0.3/.pi/agents/model-profiles.yaml +27 -0
  21. package/.versions/2.0.3/.pi/agents/peers.yaml +142 -0
  22. package/.versions/2.0.3/.pi/agents/teams.yaml +41 -0
  23. package/.versions/2.0.3/.pi/agents/voices.yaml +13 -0
  24. package/.versions/2.0.3/.pi/damage-control-rules.yaml +297 -0
  25. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  26. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  27. package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  28. package/.versions/2.0.3/.pi/extensions/btw/README.md +120 -0
  29. package/.versions/2.0.3/.pi/extensions/btw/index.ts +914 -0
  30. package/.versions/2.0.3/.pi/extensions/btw/package.json +6 -0
  31. package/.versions/2.0.3/.pi/extensions/btw/state.js +179 -0
  32. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  33. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  34. package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  35. package/.versions/2.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
  36. package/.versions/2.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
  37. package/.versions/2.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
  38. package/.versions/2.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
  39. package/.versions/2.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  40. package/.versions/2.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
  41. package/.versions/2.0.3/.pi/extensions/package-lock.json +1175 -0
  42. package/.versions/2.0.3/.pi/extensions/package.json +9 -0
  43. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
  44. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
  45. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  46. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  47. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  48. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  49. package/.versions/2.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  50. package/.versions/2.0.3/.pi/harnesses/agent-hub/README.md +1158 -0
  51. package/.versions/2.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  52. package/.versions/2.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  53. package/.versions/2.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  54. package/.versions/2.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  55. package/.versions/2.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  56. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  57. package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  58. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  59. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  60. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  61. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  62. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  63. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  64. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  65. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  66. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  67. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  68. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  69. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  70. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  71. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  72. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context.ts +41 -0
  73. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  74. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  75. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  76. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  77. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  78. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  79. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  80. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  81. package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  82. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/agents.ts +180 -0
  83. package/.versions/2.0.3/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  84. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  85. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  86. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  87. package/.versions/2.0.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  88. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  89. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  90. package/.versions/2.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
  91. package/.versions/2.0.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  92. package/.versions/2.0.3/.pi/harnesses/agent-hub/delegate.ts +446 -0
  93. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  94. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  95. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  96. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  97. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  98. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  99. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  100. package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  101. package/.versions/2.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  102. package/.versions/2.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  103. package/.versions/2.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  104. package/.versions/2.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  105. package/.versions/2.0.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
  106. package/.versions/2.0.3/.pi/harnesses/agent-hub/footer.ts +30 -0
  107. package/.versions/2.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
  108. package/.versions/2.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  109. package/.versions/2.0.3/.pi/harnesses/agent-hub/index.ts +2036 -0
  110. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  111. package/.versions/2.0.3/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  112. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  113. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  114. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
  115. package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  116. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  117. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  118. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  119. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  120. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  121. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  122. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  123. package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  124. package/.versions/2.0.3/.pi/harnesses/agent-hub/package.json +7 -0
  125. package/.versions/2.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  126. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  127. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  128. package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  129. package/.versions/2.0.3/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  130. package/.versions/2.0.3/.pi/harnesses/agent-hub/presentation.ts +48 -0
  131. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  132. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  133. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  134. package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  135. package/.versions/2.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  136. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  137. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
  138. package/.versions/2.0.3/.pi/harnesses/agent-hub/research/spawn-run.ts +143 -0
  139. package/.versions/2.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  140. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
  141. package/.versions/2.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
  142. package/.versions/2.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
  143. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
  144. package/.versions/2.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  145. package/.versions/2.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  146. package/.versions/2.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  147. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  148. package/.versions/2.0.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
  149. package/.versions/2.0.3/.pi/harnesses/agent-hub/spawn.ts +388 -0
  150. package/.versions/2.0.3/.pi/harnesses/agent-hub/timeline.ts +54 -0
  151. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  152. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  153. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  154. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  155. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
  156. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  157. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  158. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  159. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  160. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  161. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  162. package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  163. package/.versions/2.0.3/.pi/harnesses/agent-hub/types.ts +61 -0
  164. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  165. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  166. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
  167. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
  168. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  169. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  170. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  171. package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  172. package/.versions/2.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
  173. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  174. package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  175. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
  176. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
  177. package/.versions/2.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  178. package/.versions/2.0.3/.pi/harnesses/coms/README.md +100 -0
  179. package/.versions/2.0.3/.pi/harnesses/coms/index.ts +276 -0
  180. package/.versions/2.0.3/.pi/harnesses/coms/package.json +7 -0
  181. package/.versions/2.0.3/.pi/harnesses/coms/version.ts +42 -0
  182. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
  183. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
  184. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  185. package/.versions/2.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  186. package/.versions/2.0.3/.pi/harnesses/lib/coms-core-io.ts +385 -0
  187. package/.versions/2.0.3/.pi/harnesses/lib/coms-core.ts +577 -0
  188. package/.versions/2.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  189. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  190. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  191. package/.versions/2.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
  192. package/.versions/2.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
  193. package/.versions/2.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  194. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  195. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  196. package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  197. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
  198. package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  199. package/.versions/2.0.3/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  200. package/.versions/2.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  201. package/.versions/2.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  202. package/.versions/2.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  203. package/.versions/2.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  204. package/.versions/2.0.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  205. package/.versions/2.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  206. package/.versions/2.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  207. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  208. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  209. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  210. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  211. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  212. package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  213. package/.versions/2.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
  214. package/.versions/2.0.3/.pi/harnesses/package-lock.json +2039 -0
  215. package/.versions/2.0.3/.pi/harnesses/package.json +10 -0
  216. package/.versions/2.0.3/.pi/prompts/af-build.md +24 -0
  217. package/.versions/2.0.3/.pi/prompts/af-code-simplify.md +22 -0
  218. package/.versions/2.0.3/.pi/prompts/af-plan.md +17 -0
  219. package/.versions/2.0.3/.pi/prompts/af-review.md +16 -0
  220. package/.versions/2.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  221. package/.versions/2.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  222. package/.versions/2.0.3/.pi/prompts/af-ship.md +17 -0
  223. package/.versions/2.0.3/.pi/prompts/af-spec.md +15 -0
  224. package/.versions/2.0.3/.pi/prompts/af-test.md +19 -0
  225. package/.versions/2.0.3/.pi/skills/bowser/SKILL.md +145 -0
  226. package/.versions/2.0.3/.version +1 -0
  227. package/.versions/2.0.3/agents/architect.md +25 -0
  228. package/.versions/2.0.3/agents/bowser.md +28 -0
  229. package/.versions/2.0.3/agents/builder.md +56 -0
  230. package/.versions/2.0.3/agents/code-reviewer.md +210 -0
  231. package/.versions/2.0.3/agents/deep-researcher.md +33 -0
  232. package/.versions/2.0.3/agents/documenter.md +22 -0
  233. package/.versions/2.0.3/agents/orchestrator.md +23 -0
  234. package/.versions/2.0.3/agents/plan-reviewer.md +84 -0
  235. package/.versions/2.0.3/agents/planner.md +105 -0
  236. package/.versions/2.0.3/agents/releaser.md +25 -0
  237. package/.versions/2.0.3/agents/researcher.md +31 -0
  238. package/.versions/2.0.3/agents/security-auditor.md +168 -0
  239. package/.versions/2.0.3/agents/test-engineer.md +154 -0
  240. package/.versions/2.0.3/agents/web-debugger.md +44 -0
  241. package/.versions/2.0.3/agents/web-performance-auditor.md +194 -0
  242. package/.versions/2.0.3/bin/catalog/harness-runtime-closure.json +34 -0
  243. package/.versions/2.0.3/codex/CONDUCTOR.md +148 -0
  244. package/.versions/2.0.3/docs/ARCHITECTURE.md +407 -0
  245. package/.versions/2.0.3/docs/agent-fleet-setup.md +473 -0
  246. package/.versions/2.0.3/docs/claude-code-coms-bridge.md +128 -0
  247. package/.versions/2.0.3/docs/codex-remote-conductor.md +170 -0
  248. package/.versions/2.0.3/docs/coms-hermes-bridge.md +189 -0
  249. package/.versions/2.0.3/docs/getting-started.md +119 -0
  250. package/.versions/2.0.3/docs/npm-install.md +292 -0
  251. package/.versions/2.0.3/docs/pi-extensions.md +447 -0
  252. package/.versions/2.0.3/docs/pi-setup.md +74 -0
  253. package/.versions/2.0.3/docs/skill-anatomy.md +150 -0
  254. package/.versions/2.0.3/hermes/README.md +347 -0
  255. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  256. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  257. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  258. package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  259. package/.versions/2.0.3/hermes/gates/gate-o-capability.md +8 -0
  260. package/.versions/2.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
  261. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  262. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  263. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  264. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  265. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  266. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  267. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  268. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  269. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  270. package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  271. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  272. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  273. package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  274. package/.versions/2.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
  275. package/.versions/2.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
  276. package/.versions/2.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
  277. package/.versions/2.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
  278. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  279. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  280. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  281. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  282. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  283. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  284. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  285. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  286. package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  287. package/.versions/2.0.3/hermes/watchdog-tests/__init__.py +0 -0
  288. package/.versions/2.0.3/hooks/coms-stop-hook.mjs +84 -0
  289. package/.versions/2.0.3/install-manifest.json +2940 -0
  290. package/.versions/2.0.3/justfile +289 -0
  291. package/.versions/2.0.3/manifest-meta.json +969 -0
  292. package/.versions/2.0.3/references/accessibility-checklist.md +160 -0
  293. package/.versions/2.0.3/references/communication-contract.md +26 -0
  294. package/.versions/2.0.3/references/definition-of-done.md +67 -0
  295. package/.versions/2.0.3/references/fleet-coordination-patterns.md +171 -0
  296. package/.versions/2.0.3/references/observability-checklist.md +91 -0
  297. package/.versions/2.0.3/references/orchestration-patterns.md +370 -0
  298. package/.versions/2.0.3/references/performance-checklist.md +153 -0
  299. package/.versions/2.0.3/references/prompting-patterns.md +380 -0
  300. package/.versions/2.0.3/references/security-checklist.md +179 -0
  301. package/.versions/2.0.3/references/testing-patterns.md +236 -0
  302. package/.versions/2.0.3/references/workflow-authoring.md +304 -0
  303. package/.versions/2.0.3/scripts/codex-conductor.ts +41 -0
  304. package/.versions/2.0.3/scripts/codex-remote-control.ts +167 -0
  305. package/.versions/2.0.3/scripts/coms-claude-bridge.ts +411 -0
  306. package/.versions/2.0.3/scripts/coms-cli.ts +484 -0
  307. package/.versions/2.0.3/scripts/coms-hermes-bridge.ts +413 -0
  308. package/.versions/2.0.3/scripts/fleet.ts +199 -0
  309. package/.versions/2.0.3/scripts/flow.ts +137 -0
  310. package/.versions/2.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
  311. package/.versions/2.0.3/scripts/hermes-monitor-scenario.ts +474 -0
  312. package/.versions/2.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
  313. package/.versions/2.0.3/scripts/install-hermes-plugin.sh +180 -0
  314. package/.versions/2.0.3/scripts/lib/claude-bridge-core.ts +210 -0
  315. package/.versions/2.0.3/scripts/lib/codex-conductor.ts +88 -0
  316. package/.versions/2.0.3/scripts/lib/codex-remote-control.ts +482 -0
  317. package/.versions/2.0.3/scripts/lib/coms-envelope.ts +582 -0
  318. package/.versions/2.0.3/scripts/lib/fake-herdr-server.ts +88 -0
  319. package/.versions/2.0.3/scripts/lib/fleet-command.ts +270 -0
  320. package/.versions/2.0.3/scripts/lib/flow-command.ts +93 -0
  321. package/.versions/2.0.3/scripts/lib/flow-maintenance.ts +230 -0
  322. package/.versions/2.0.3/scripts/lib/herdr-layout.ts +281 -0
  323. package/.versions/2.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
  324. package/.versions/2.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
  325. package/.versions/2.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
  326. package/.versions/2.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
  327. package/.versions/2.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
  328. package/.versions/2.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
  329. package/.versions/2.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
  330. package/.versions/2.0.3/scripts/lib/monitor-env.ts +146 -0
  331. package/.versions/2.0.3/scripts/lib/peer-launch.ts +318 -0
  332. package/.versions/2.0.3/scripts/lib/persona-banner.ts +62 -0
  333. package/.versions/2.0.3/scripts/lib/spawn-stagger.ts +101 -0
  334. package/.versions/2.0.3/scripts/lib/team-project.ts +213 -0
  335. package/.versions/2.0.3/scripts/lib/team-snapshot.ts +147 -0
  336. package/.versions/2.0.3/scripts/package-lock.json +35 -0
  337. package/.versions/2.0.3/scripts/package.json +9 -0
  338. package/.versions/2.0.3/scripts/peer-banner.ts +40 -0
  339. package/.versions/2.0.3/scripts/peer-launch.ts +259 -0
  340. package/.versions/2.0.3/scripts/team-snapshot.ts +237 -0
  341. package/.versions/2.0.3/scripts/team-up.ts +406 -0
  342. package/.versions/2.0.3/scripts/workflows/lib/agent-phase.ts +132 -0
  343. package/.versions/2.0.3/scripts/workflows/lib/changes.ts +61 -0
  344. package/.versions/2.0.3/scripts/workflows/lib/debate.ts +149 -0
  345. package/.versions/2.0.3/scripts/workflows/lib/env.ts +34 -0
  346. package/.versions/2.0.3/scripts/workflows/lib/envelopes.ts +169 -0
  347. package/.versions/2.0.3/scripts/workflows/lib/gates.ts +81 -0
  348. package/.versions/2.0.3/scripts/workflows/lib/git.ts +96 -0
  349. package/.versions/2.0.3/scripts/workflows/lib/merge.ts +95 -0
  350. package/.versions/2.0.3/scripts/workflows/lib/model-visibility.ts +92 -0
  351. package/.versions/2.0.3/scripts/workflows/lib/permissions.ts +130 -0
  352. package/.versions/2.0.3/scripts/workflows/lib/personas.ts +54 -0
  353. package/.versions/2.0.3/scripts/workflows/lib/poll.ts +86 -0
  354. package/.versions/2.0.3/scripts/workflows/lib/quality.ts +64 -0
  355. package/.versions/2.0.3/scripts/workflows/lib/run.ts +108 -0
  356. package/.versions/2.0.3/scripts/workflows/lib/trace.ts +34 -0
  357. package/.versions/2.0.3/scripts/workflows/lib/voices.ts +125 -0
  358. package/.versions/2.0.3/scripts/workflows/lib/writer-lease.ts +112 -0
  359. package/.versions/2.0.3/scripts/workflows/tsconfig.json +22 -0
  360. package/.versions/2.0.3/scripts/workflows/wf-build-test.ts +61 -0
  361. package/.versions/2.0.3/scripts/workflows/wf-debate.ts +87 -0
  362. package/.versions/2.0.3/scripts/workflows/wf-document.ts +50 -0
  363. package/.versions/2.0.3/scripts/workflows/wf-poll.ts +95 -0
  364. package/.versions/2.0.3/scripts/workflows/wf-quality.ts +20 -0
  365. package/.versions/2.0.3/scripts/workflows/wf-scout.ts +38 -0
  366. package/.versions/2.0.3/skills/_internal/grilling.md +59 -0
  367. package/.versions/2.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  368. package/.versions/2.0.3/skills/code-review-and-quality/SKILL.md +381 -0
  369. package/.versions/2.0.3/skills/compound-learning/SKILL.md +137 -0
  370. package/.versions/2.0.3/skills/context-engineering/SKILL.md +291 -0
  371. package/.versions/2.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
  372. package/.versions/2.0.3/skills/designing-agents/SKILL.md +394 -0
  373. package/.versions/2.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  374. package/.versions/2.0.3/skills/drafting-workflows/SKILL.md +143 -0
  375. package/.versions/2.0.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  376. package/.versions/2.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  377. package/.versions/2.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  378. package/.versions/2.0.3/skills/idea-refine/SKILL.md +182 -0
  379. package/.versions/2.0.3/skills/idea-refine/examples.md +238 -0
  380. package/.versions/2.0.3/skills/idea-refine/frameworks.md +99 -0
  381. package/.versions/2.0.3/skills/idea-refine/refinement-criteria.md +113 -0
  382. package/.versions/2.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  383. package/.versions/2.0.3/skills/incremental-implementation/SKILL.md +298 -0
  384. package/.versions/2.0.3/skills/interview-me/SKILL.md +226 -0
  385. package/.versions/2.0.3/skills/orchestration-verification/SKILL.md +181 -0
  386. package/.versions/2.0.3/skills/peer-coms/SKILL.md +90 -0
  387. package/.versions/2.0.3/skills/performance-optimization/SKILL.md +350 -0
  388. package/.versions/2.0.3/skills/planning-and-task-breakdown/SKILL.md +265 -0
  389. package/.versions/2.0.3/skills/security-and-hardening/SKILL.md +461 -0
  390. package/.versions/2.0.3/skills/spec-driven-development/SKILL.md +256 -0
  391. package/.versions/2.0.3/skills/using-agent-skills/SKILL.md +197 -0
  392. package/.versions/2.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  393. package/.versions/2.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
  394. package/.versions/2.0.3/vendor/agent-skills-upstream/README.md +11 -0
  395. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  396. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  397. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  398. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  399. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  400. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  401. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  402. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  403. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  404. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  405. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  406. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  407. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  408. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  409. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  410. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  411. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  412. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  413. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  414. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  415. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  416. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  417. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  418. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  419. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  420. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  421. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  422. package/.versions/2.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  423. package/CHANGELOG.md +7 -0
  424. package/README.md +2 -2
  425. package/bin/lib/doctor.js +1 -1
  426. package/bin/lib/model-visibility.js +64 -0
  427. package/docs/agent-fleet-setup.md +1 -1
  428. package/docs/getting-started.md +2 -2
  429. package/docs/npm-install.md +1 -1
  430. package/docs/pi-extensions.md +13 -10
  431. package/install-manifest.json +36 -1
  432. package/justfile +1 -0
  433. package/manifest-meta.json +25 -1
  434. package/package.json +4 -2
  435. package/scripts/fleet.ts +1 -1
  436. package/scripts/package-lock.json +35 -0
  437. package/scripts/package.json +9 -0
  438. package/.pi/harnesses/agent-hub/research-retention.js +0 -34
@@ -0,0 +1,175 @@
1
+ import type { ChildProcess } from "child_process";
2
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
3
+ import type { Termination, spawnPiAgentWithModelFallback } from "../spawn.ts";
4
+ import type { TimelineEntry } from "../ui/zoom.ts";
5
+ import type { FleetTranscriptStore } from "../../lib/fleet-transcript-store.ts";
6
+ import type { HistoryEntry, ExecutionHistoryStore } from "../ui/history-store.ts";
7
+ import type { HubStateContext } from "../context/hub-state.ts";
8
+ import type { BudgetContext } from "../context/budgets.ts";
9
+ import type { InputArtifactPreview, AssertionsArtifactsContext } from "../context/assertions-artifacts.ts";
10
+ import type { createProviderSemaphore } from "../provider-semaphore.js";
11
+ import { safePathWithin } from "../helpers.ts";
12
+ import { runResearchSpawn, type ResearchSpawnPorts } from "./spawn-run.ts";
13
+
14
+ export const RESEARCH_TOOLS = "read,grep,find,ls";
15
+ export const MAX_AUTO_RESEARCH_ROUNDS = 2;
16
+ export const MAX_AUTO_RESEARCH_QUESTIONS = 4;
17
+
18
+ export const ANON_RESEARCH_PROMPT = `# Research Helper
19
+
20
+ You are an ad-hoc read-only research helper assisting a team of specialist agents.
21
+ Locate the relevant code or docs, read the surrounding context, and report concise,
22
+ well-cited findings the rest of the team can act on.`;
23
+
24
+ export interface ResearchAgentDef {
25
+ name: string;
26
+ description: string;
27
+ tools: string;
28
+ model?: string;
29
+ fallbackModel?: string;
30
+ thinking?: string;
31
+ systemPrompt: string;
32
+ file: string;
33
+ }
34
+
35
+ export interface ResearchState<TDef extends ResearchAgentDef = ResearchAgentDef> {
36
+ id: number;
37
+ def: TDef;
38
+ persona: boolean;
39
+ model: string;
40
+ status: "idle" | "running" | "done" | "error";
41
+ task: string;
42
+ toolCount: number;
43
+ elapsed: number;
44
+ lastWork: string;
45
+ contextPct: number;
46
+ contextTokens: number;
47
+ timer?: ReturnType<typeof setInterval>;
48
+ proc?: ChildProcess;
49
+ killedByOperator?: boolean;
50
+ timeline: TimelineEntry[];
51
+ transcriptStore?: FleetTranscriptStore;
52
+ zoomRender?: (force?: boolean) => void;
53
+ histEntry?: HistoryEntry;
54
+ }
55
+
56
+ export interface ResearchResult {
57
+ output: string;
58
+ exitCode: number;
59
+ elapsed: number;
60
+ termination?: Termination;
61
+ }
62
+
63
+ export interface ResearchFinalizeOutcome {
64
+ status: "idle" | "done" | "error";
65
+ historyStatus: "idle" | "done" | "error";
66
+ lastWork: string;
67
+ }
68
+
69
+ export interface ResearchRuntimeStatePorts<TDef extends ResearchAgentDef> {
70
+ getResearchStates(): Map<number, ResearchState<TDef>>;
71
+ setResearchStates(value: Map<number, ResearchState<TDef>>): void;
72
+ getNextResearchId(): number;
73
+ setNextResearchId(value: number): void;
74
+ }
75
+
76
+ export interface ResearchRuntimeDeps<TDef extends ResearchAgentDef> extends ResearchRuntimeStatePorts<TDef> {
77
+ hubState: Pick<HubStateContext, "getSessionDir">;
78
+ budget: Pick<BudgetContext, "currentBudget">;
79
+ artifacts: Pick<AssertionsArtifactsContext, "appendInputArtifacts">;
80
+ executionHistory: ExecutionHistoryStore;
81
+ providerSemaphore: ReturnType<typeof createProviderSemaphore>;
82
+ getSafetyHarnessPath(): string | null;
83
+ getReconSearchTimeoutMs(): number | null;
84
+ getContextWindow(): number;
85
+ resolvedModel(def: TDef): string | undefined;
86
+ resolvedThinking(def: TDef): string | undefined;
87
+ resolveThinkingLevel(value: string | undefined): string;
88
+ fallbackModelFor(def: TDef, model: string): string | undefined;
89
+ substitutedModel(model: string | undefined): string | undefined;
90
+ modelWindowLookup(ctx: ExtensionContext): (provider: string, modelId: string) => unknown;
91
+ guardrailEnv(agentId: string): Record<string, string>;
92
+ notifyProviderQueue(model: string, label: string, ctx: ExtensionContext): void;
93
+ spawnPiAgentWithModelFallback: typeof spawnPiAgentWithModelFallback;
94
+ nativeResearchSystemPrompt(input: { personaName?: string; personaPath?: string; cwd: string }): string;
95
+ requireSafetyHarness(path: string | null): { ok: true; extensions: string[] } | { ok: false; error: string };
96
+ shortModel(model: string): string;
97
+ displayName(name: string): string;
98
+ flushTimelineStore(state: ResearchState<TDef>): void;
99
+ appendTimelineText(state: ResearchState<TDef>, kind: "text" | "thinking", content: string): void;
100
+ appendTimelineEvent(state: ResearchState<TDef>, event: TimelineEntry): void;
101
+ createTranscriptStore(path: string): FleetTranscriptStore;
102
+ }
103
+
104
+ export interface ResearchRuntime<TDef extends ResearchAgentDef = ResearchAgentDef> {
105
+ states(): Map<number, ResearchState<TDef>>;
106
+ reset(): void;
107
+ sessionPath(id: number): string;
108
+ anonymousDef(): TDef;
109
+ resolveModel(def: TDef, explicit: string | undefined, ctx: ExtensionContext): string;
110
+ createState(def: TDef, persona: boolean, model: string): ResearchState<TDef>;
111
+ finalize(state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome): void;
112
+ spawn(state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext, inputArtifacts?: InputArtifactPreview[], signal?: AbortSignal): Promise<ResearchResult>;
113
+ }
114
+
115
+ export function parseResearchHandle(arg: string): number | null {
116
+ const match = arg.trim().match(/^#?r?(\d+)$/i);
117
+ return match ? parseInt(match[1], 10) : null;
118
+ }
119
+
120
+ export function createResearchRuntime<TDef extends ResearchAgentDef>(deps: ResearchRuntimeDeps<TDef>): ResearchRuntime<TDef> {
121
+ const sessionPath = (id: number) => safePathWithin(deps.hubState.getSessionDir(), `research-${id}.json`);
122
+ const finalized = new WeakSet<ResearchState<TDef>>();
123
+ const finalize = (state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome) => {
124
+ if (finalized.has(state)) return;
125
+ finalized.add(state);
126
+ if (state.timer) {
127
+ clearInterval(state.timer);
128
+ state.timer = undefined;
129
+ }
130
+ state.proc = undefined;
131
+ state.status = outcome.status;
132
+ state.lastWork = outcome.lastWork;
133
+ state.zoomRender?.(true);
134
+ if (state.histEntry) {
135
+ deps.executionHistory.end(state.histEntry, outcome.historyStatus);
136
+ state.histEntry = undefined;
137
+ }
138
+ const states = deps.getResearchStates();
139
+ if (states.get(state.id) === state) states.delete(state.id);
140
+ };
141
+ const spawnPorts: ResearchSpawnPorts<TDef> = { ...deps, researchTools: RESEARCH_TOOLS, sessionPath, finalize };
142
+
143
+ return {
144
+ states: deps.getResearchStates,
145
+ reset() {
146
+ deps.setResearchStates(new Map());
147
+ deps.setNextResearchId(1);
148
+ },
149
+ sessionPath,
150
+ anonymousDef() {
151
+ return {
152
+ name: "research", description: "Ad-hoc read-only research helper.", tools: RESEARCH_TOOLS,
153
+ systemPrompt: ANON_RESEARCH_PROMPT, file: "",
154
+ } as TDef;
155
+ },
156
+ resolveModel(def, explicit, ctx) {
157
+ if (explicit) return explicit;
158
+ return deps.resolvedModel(def) || (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
159
+ },
160
+ createState(def, persona, model) {
161
+ const id = deps.getNextResearchId();
162
+ deps.setNextResearchId(id + 1);
163
+ const state: ResearchState<TDef> = {
164
+ id, def, persona, model, status: "running", task: "", toolCount: 0,
165
+ elapsed: 0, lastWork: "", contextPct: 0, contextTokens: 0, timeline: [],
166
+ };
167
+ deps.getResearchStates().set(id, state);
168
+ return state;
169
+ },
170
+ finalize,
171
+ spawn(state, prompt, ctx, inputArtifacts = [], signal) {
172
+ return runResearchSpawn(spawnPorts, state, prompt, ctx, inputArtifacts, signal);
173
+ },
174
+ };
175
+ }
@@ -0,0 +1,143 @@
1
+ import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+ import { contextPct, resolveContextWindow } from "../context-window.js";
3
+ import { isReadOnlyToolList, safePathWithin } from "../helpers.ts";
4
+ import { researchTerminationOutcome, researchWatchdogSpawnOptions } from "../research-watchdog.ts";
5
+ import type { InputArtifactPreview } from "../context/assertions-artifacts.ts";
6
+ import type { ResearchAgentDef, ResearchFinalizeOutcome, ResearchResult, ResearchRuntimeDeps, ResearchState } from "./runtime.ts";
7
+
8
+ export interface ResearchSpawnPorts<TDef extends ResearchAgentDef> extends ResearchRuntimeDeps<TDef> {
9
+ researchTools: string;
10
+ sessionPath(id: number): string;
11
+ finalize(state: ResearchState<TDef>, outcome: ResearchFinalizeOutcome): void;
12
+ }
13
+
14
+ function completeOutput<TDef extends ResearchAgentDef>(state: ResearchState<TDef>, res: any): string {
15
+ let output = String(res.output ?? "");
16
+ if (res.modelFallback) {
17
+ output = `(ℹ model fallback: ${res.modelFallback.from} failed before work began; retried once with original persona model ${res.modelFallback.to}.)\n\n${output}`;
18
+ }
19
+ if (res.exitCode !== 0) {
20
+ const errText = String(res.stderr ?? "").trim();
21
+ const tail = errText.length > 1500 ? `...\n${errText.slice(-1500)}` : errText;
22
+ const errBlock = tail ? `\n\n[stderr]\n${tail}` : "";
23
+ output = output ? `${output}${errBlock}` : `Research helper r${state.id} exited with code ${res.exitCode} and produced no output.${errBlock}`;
24
+ }
25
+ return output;
26
+ }
27
+
28
+ export async function runResearchSpawn<TDef extends ResearchAgentDef>(
29
+ deps: ResearchSpawnPorts<TDef>, state: ResearchState<TDef>, prompt: string, ctx: ExtensionContext,
30
+ inputArtifacts: InputArtifactPreview[] = [], signal?: AbortSignal,
31
+ ): Promise<ResearchResult> {
32
+ const startTime = Date.now();
33
+ let result: ResearchResult | undefined;
34
+ const settle = (status: ResearchFinalizeOutcome["status"], historyStatus: ResearchFinalizeOutcome["historyStatus"], lastWork: string, settled: ResearchResult): ResearchResult => {
35
+ state.elapsed = settled.elapsed;
36
+ deps.finalize(state, { status, historyStatus, lastWork });
37
+ result = settled;
38
+ return settled;
39
+ };
40
+
41
+ try {
42
+ if (!state.histEntry) state.histEntry = deps.executionHistory.start("research", `Research r${state.id}`);
43
+
44
+ const safety = deps.requireSafetyHarness(deps.getSafetyHarnessPath());
45
+ if (!safety.ok) return settle("error", "error", safety.error, { output: safety.error, exitCode: 1, elapsed: 0 });
46
+
47
+ state.status = "running";
48
+ state.task = prompt;
49
+ state.toolCount = 0;
50
+ state.elapsed = 0;
51
+ state.lastWork = "";
52
+ state.killedByOperator = false;
53
+ deps.flushTimelineStore(state);
54
+ state.timeline = [];
55
+ state.transcriptStore = deps.createTranscriptStore(safePathWithin(deps.hubState.getSessionDir(), "transcripts", `research-r${state.id}.jsonl`));
56
+
57
+ state.timer = setInterval(() => {
58
+ state.elapsed = Date.now() - startTime;
59
+ }, 1000);
60
+ const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
61
+ const wantThinking = thinkingLevel !== "off";
62
+ const sessionPath = deps.sessionPath(state.id);
63
+ const researchWindow = resolveContextWindow(state.model, { lookup: deps.modelWindowLookup(ctx), fallbackWindow: deps.getContextWindow() });
64
+ const fallbackCandidate = deps.substitutedModel(deps.fallbackModelFor(state.def, state.model));
65
+ const fallback = fallbackCandidate === state.model ? undefined : fallbackCandidate;
66
+ let fullText = "";
67
+ deps.notifyProviderQueue(state.model, `Research r${state.id}`, ctx);
68
+
69
+ const res = await deps.providerSemaphore.run(state.model, () => deps.spawnPiAgentWithModelFallback({
70
+ model: state.model, tools: deps.researchTools, thinking: thinkingLevel,
71
+ systemPrompt: deps.nativeResearchSystemPrompt({
72
+ ...(state.persona ? { personaName: state.def.name, personaPath: state.def.file } : {}),
73
+ cwd: ctx.cwd || process.cwd(),
74
+ }),
75
+ noSkills: true, noContextFiles: true, sessionFile: sessionPath, resume: false,
76
+ prompt: deps.artifacts.appendInputArtifacts(prompt, inputArtifacts), cwd: ctx.cwd || process.cwd(),
77
+ extensions: safety.extensions, env: deps.guardrailEnv(`research-r${state.id}`),
78
+ ...researchWatchdogSpawnOptions(deps.getReconSearchTimeoutMs(), signal),
79
+ turnDeadlineMs: deps.budget.currentBudget().agentTurnMs,
80
+ }, fallback, {
81
+ onProcess: process => { state.proc = process; },
82
+ onModelFallback: ({ from, to, reason }) => {
83
+ state.lastWork = `model fallback: ${deps.shortModel(from)} → ${deps.shortModel(to)}`;
84
+ ctx.ui.notify(`Research r${state.id}: overridden model ${from} failed before work began; retrying with persona model ${to} (${reason})`, "warning");
85
+ },
86
+ onTextDelta: delta => {
87
+ fullText += delta;
88
+ state.lastWork = fullText.split("\n").filter(line => line.trim()).pop() || "";
89
+ deps.appendTimelineText(state, "text", delta);
90
+ state.zoomRender?.();
91
+ },
92
+ onThinkingDelta: delta => {
93
+ if (!wantThinking) return;
94
+ deps.appendTimelineText(state, "thinking", delta);
95
+ state.zoomRender?.();
96
+ },
97
+ onToolStart: (toolName, argStr, callId) => {
98
+ state.toolCount++;
99
+ deps.appendTimelineEvent(state, { kind: "tool-start", title: `Tool: ${toolName}`, content: argStr, timestamp: Date.now(), ...(callId ? { callId } : {}) });
100
+ state.zoomRender?.();
101
+ },
102
+ onToolEnd: (toolName, callId, isError, resultText, durationMs) => {
103
+ deps.appendTimelineEvent(state, { kind: "tool-result", title: `Result: ${toolName}`, content: resultText ?? "", timestamp: Date.now(), ...(callId ? { callId } : {}), status: isError ? "error" : "success", ...(durationMs == null ? {} : { durationMs }) });
104
+ state.zoomRender?.();
105
+ },
106
+ onUsage: usage => {
107
+ state.contextTokens = (usage.input || 0) + (usage.cacheRead || 0) + (usage.cacheWrite || 0);
108
+ if (researchWindow.window > 0) {
109
+ state.contextPct = contextPct(usage, researchWindow.window);
110
+ }
111
+ },
112
+ }, { midRun: isReadOnlyToolList(deps.researchTools) }));
113
+
114
+ state.elapsed = Date.now() - startTime;
115
+ state.proc = undefined;
116
+ if (res.spawnError) {
117
+ return settle("error", "error", `Error: ${res.spawnError}`, { output: `Error spawning research helper: ${res.spawnError}`, exitCode: 1, elapsed: state.elapsed });
118
+ }
119
+ if (res.termination) {
120
+ const outcome = researchTerminationOutcome(state.id, res.termination);
121
+ return settle("error", "error", outcome.lastWork, { output: outcome.output, exitCode: outcome.exitCode, elapsed: state.elapsed, termination: res.termination });
122
+ }
123
+ if (state.killedByOperator) {
124
+ state.killedByOperator = false;
125
+ return settle("idle", "idle", "(killed by operator)", { output: `Research helper r${state.id} was killed by the operator before it finished.`, exitCode: res.exitCode ?? 143, elapsed: state.elapsed });
126
+ }
127
+
128
+ const status = res.exitCode === 0 ? "done" : "error";
129
+ const lastWork = String(res.output ?? "").split("\n").filter((line: string) => line.trim()).pop() || "";
130
+ const settled = settle(status, status, lastWork, { output: completeOutput(state, res), exitCode: res.exitCode ?? 1, elapsed: state.elapsed });
131
+ ctx.ui.notify(`Research r${state.id} ${status} in ${Math.round(state.elapsed / 1000)}s`, status === "done" ? "success" : "error");
132
+ return settled;
133
+ } catch (err: unknown) {
134
+ const message = err instanceof Error ? err.message : String(err);
135
+ state.elapsed = Date.now() - startTime;
136
+ return settle("error", "error", `Error: ${message}`, { output: `Error spawning research helper: ${message}`, exitCode: 1, elapsed: state.elapsed });
137
+ } finally {
138
+ if (!result) {
139
+ state.elapsed = Date.now() - startTime;
140
+ deps.finalize(state, { status: "error", historyStatus: "error", lastWork: "terminated unexpectedly" });
141
+ }
142
+ }
143
+ }
@@ -0,0 +1,40 @@
1
+ import type { Termination } from "./spawn.ts";
2
+
3
+ /** Spawn policy shared by every native read-only research-helper path. */
4
+ export function researchWatchdogSpawnOptions(timeoutMs: number | null, signal?: AbortSignal) {
5
+ return {
6
+ detached: true,
7
+ signal,
8
+ toolWatchdog: { timeoutMs },
9
+ };
10
+ }
11
+
12
+ /** Stable terminal result used by research lifecycle code after parent cleanup. */
13
+ export function researchTerminationOutcome(id: number, termination: Termination) {
14
+ const reason = termination.reason;
15
+ const tool = termination.tool;
16
+ const status = reason; // "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled"
17
+ const lastWork = reason === "tool_timeout"
18
+ ? `tool_timeout: ${tool?.toolName || "tool"} (${tool?.toolCallId || "unknown"})`
19
+ : reason === "turn_timeout"
20
+ ? "turn_timeout: per-run deadline exceeded"
21
+ : reason === "drift_stop"
22
+ ? "drift_stop: stopped by the drift watchdog"
23
+ : "cancelled by caller";
24
+ const metadata = reason === "tool_timeout"
25
+ ? `toolCallId=${tool?.toolCallId || "unknown"}, tool=${tool?.toolName || "unknown"}, deadline=${tool?.deadlineAt || "unknown"}, terminationConfirmed=${termination.confirmed}`
26
+ : `terminationConfirmed=${termination.confirmed}`;
27
+ const explanation = reason === "tool_timeout"
28
+ ? "exceeded its per-tool watchdog"
29
+ : reason === "turn_timeout"
30
+ ? "exceeded the per-run deadline (agent-turn-timeout-s / mode budget) — narrow the question or raise the deadline"
31
+ : reason === "drift_stop"
32
+ ? "was stopped by the drift watchdog"
33
+ : "was cancelled by its caller";
34
+ return {
35
+ status,
36
+ lastWork,
37
+ output: `${status}: research helper r${id} ${explanation} (${metadata}).`,
38
+ exitCode: reason === "cancelled" ? 130 : reason === "drift_stop" ? 125 : 124,
39
+ };
40
+ }
@@ -0,0 +1,293 @@
1
+ const STRUCTURED_KEYS = [
2
+ "changed_files",
3
+ "assertions_proven",
4
+ "assertions_unproven",
5
+ "assertions_failed",
6
+ "tests_run",
7
+ "open_risks",
8
+ "requires_user_decision",
9
+ ];
10
+
11
+ const ASSERTION_KEYS = new Set(["assertions_proven", "assertions_unproven", "assertions_failed"]);
12
+
13
+ // Line-form verdicts. Specialists routinely report
14
+ // ASSERTION A1: PASS — Conventional Hermes plan path ... are present
15
+ // - **A2: FAIL** — the gate never fires
16
+ // instead of the declared schema, and the parser used to see none of it: 16 of 46
17
+ // dispatches in one session were scored "no structured return" and every assertion
18
+ // treated as unproven, including runs that had reported a complete verdict.
19
+ //
20
+ // The status must be the whole token right after the id, and any explanation must
21
+ // be introduced by a separator — so ordinary prose mentioning an id never matches.
22
+ const LINE_FORM_STATUS = {
23
+ pass: "assertions_proven",
24
+ passed: "assertions_proven",
25
+ proven: "assertions_proven",
26
+ fail: "assertions_failed",
27
+ failed: "assertions_failed",
28
+ blocked: "assertions_failed",
29
+ unproven: "assertions_unproven",
30
+ unverified: "assertions_unproven",
31
+ };
32
+
33
+ const LINE_FORM_RE =
34
+ /^\s*(?:[-*]\s+|\d+[.)]\s+)?\**(?:ASSERTION\s+)?(A\d+)\**\s*[:\-–—]\s*\**(PASS|PASSED|PROVEN|FAIL|FAILED|BLOCKED|UNPROVEN|UNVERIFIED)\**\s*(?:[:\-–—]\s*(.*))?$/i;
35
+
36
+ export function extractAssertionIds(taskText) {
37
+ const ids = [];
38
+ const seen = new Set();
39
+ for (const match of String(taskText || "").matchAll(/\bA\d+\b/g)) {
40
+ const id = match[0];
41
+ if (!seen.has(id)) {
42
+ seen.add(id);
43
+ ids.push(id);
44
+ }
45
+ }
46
+ return ids;
47
+ }
48
+
49
+ export function parseStructuredReturn(finalText) {
50
+ const text = String(finalText || "");
51
+ const candidates = fencedBlocks(text);
52
+ candidates.push(text);
53
+
54
+ let best = null;
55
+ for (const candidate of candidates) {
56
+ const parsed = parseCandidate(candidate);
57
+ if (parsed && (!best || parsed.__score > best.__score)) best = parsed;
58
+ }
59
+ if (!best) return null;
60
+ delete best.__score;
61
+ return best;
62
+ }
63
+
64
+ /** Decide whether output is a return, a failure diagnostic, or still pending. */
65
+ export function deliveryDisposition(exitCode, pending = false) {
66
+ if (pending) return { delivered: false, pending: true, status: "pending", artifactKind: null };
67
+ if (exitCode === 0) return { delivered: true, pending: false, status: "done", artifactKind: "returns" };
68
+ return { delivered: false, pending: false, status: "error", artifactKind: "failures" };
69
+ }
70
+
71
+ /**
72
+ * Parse only a successfully delivered specialist result. A failed process may
73
+ * have emitted a partial structured block before crashing, but that output is
74
+ * diagnostic data, never assertion evidence.
75
+ */
76
+ export function parseDeliveredReturn(finalText, dispatchedIds, delivered) {
77
+ const parsed = delivered ? parseStructuredReturn(finalText) : null;
78
+ return { parsed, notices: crossCheck(parsed, dispatchedIds) };
79
+ }
80
+
81
+ export function crossCheck(parsed, dispatchedIds) {
82
+ const ids = Array.from(new Set(dispatchedIds || []));
83
+ if (!parsed) {
84
+ return ids.length > 0 ? [{ type: "no_structured_return", ids }] : [];
85
+ }
86
+
87
+ const notices = [];
88
+ const present = new Set();
89
+ for (const key of ["assertions_proven", "assertions_unproven", "assertions_failed"]) {
90
+ for (const entry of parsed[key] || []) {
91
+ if (entry && entry.id) present.add(entry.id);
92
+ }
93
+ }
94
+ for (const id of ids) {
95
+ if (!present.has(id)) notices.push({ type: "missing", id });
96
+ }
97
+ for (const entry of parsed.assertions_proven || []) {
98
+ if (entry && entry.id && !entry.evidence) {
99
+ notices.push({ type: "proven_without_evidence", id: entry.id, note: entry.note || "" });
100
+ }
101
+ }
102
+ return notices;
103
+ }
104
+
105
+ function fencedBlocks(text) {
106
+ const blocks = [];
107
+ const re = /```[^\n]*\n([\s\S]*?)```/g;
108
+ let match;
109
+ while ((match = re.exec(text))) blocks.push(match[1]);
110
+ return blocks;
111
+ }
112
+
113
+ function parseCandidate(text) {
114
+ const result = Object.fromEntries(STRUCTURED_KEYS.map((key) => [key, []]));
115
+ let score = 0;
116
+
117
+ const keyBlocks = collectKeyBlocks(text);
118
+ for (const [key, block] of keyBlocks) {
119
+ result[key] = parseEntries(key, block);
120
+ score += 2 + result[key].length;
121
+ }
122
+
123
+ const sectionBlocks = collectMarkdownSections(text);
124
+ for (const [key, block] of sectionBlocks) {
125
+ if (!keyBlocks.has(key)) {
126
+ result[key] = parseEntries(key, block);
127
+ score += 1 + result[key].length;
128
+ }
129
+ }
130
+
131
+ // Lowest-precedence source: a specialist that follows the schema is never
132
+ // second-guessed. A declared bucket wins outright, and an id the schema already
133
+ // classified is never re-stated from a loose line — otherwise a stale summary
134
+ // line could land the same id in two buckets at once.
135
+ const declaredIds = new Set();
136
+ for (const key of ASSERTION_KEYS) {
137
+ for (const entry of result[key] || []) {
138
+ if (entry && entry.id) declaredIds.add(entry.id);
139
+ }
140
+ }
141
+ for (const [key, entries] of collectLineFormAssertions(text)) {
142
+ if (keyBlocks.has(key) || sectionBlocks.has(key)) continue;
143
+ const fresh = entries.filter((entry) => !declaredIds.has(entry.id));
144
+ if (fresh.length === 0) continue;
145
+ result[key] = fresh;
146
+ score += fresh.length;
147
+ }
148
+
149
+ if (score === 0) return null;
150
+ result.__score = score;
151
+ return result;
152
+ }
153
+
154
+ function collectKeyBlocks(text) {
155
+ const found = new Map();
156
+ const lines = text.split(/\r?\n/);
157
+ for (let i = 0; i < lines.length; i++) {
158
+ const match = lines[i].match(/^\s*([A-Za-z][A-Za-z0-9_ -]*)\s*:\s*(.*)$/);
159
+ if (!match) continue;
160
+ const key = normalizeKey(match[1]);
161
+ if (!STRUCTURED_KEYS.includes(key)) continue;
162
+
163
+ const block = [match[2] || ""];
164
+ let bracketBalance = balanceBrackets(match[2] || "");
165
+ let j = i + 1;
166
+ for (; j < lines.length; j++) {
167
+ const next = lines[j];
168
+ const nextKey = next.match(/^\s*([A-Za-z][A-Za-z0-9_ -]*)\s*:\s*/);
169
+ const isKnownNextKey = nextKey && STRUCTURED_KEYS.includes(normalizeKey(nextKey[1]));
170
+ const isHeading = /^\s*#{1,6}\s+/.test(next);
171
+ if (bracketBalance <= 0 && (isKnownNextKey || isHeading)) break;
172
+ if (next.trim() === "" && bracketBalance <= 0) break;
173
+ block.push(next);
174
+ bracketBalance += balanceBrackets(next);
175
+ }
176
+ found.set(key, block.join("\n"));
177
+ }
178
+ return found;
179
+ }
180
+
181
+ function collectMarkdownSections(text) {
182
+ const found = new Map();
183
+ const lines = text.split(/\r?\n/);
184
+ for (let i = 0; i < lines.length; i++) {
185
+ const match = lines[i].match(/^\s*#{1,6}\s+(.+?)\s*#*\s*$/);
186
+ if (!match) continue;
187
+ const key = normalizeKey(match[1]);
188
+ if (!STRUCTURED_KEYS.includes(key)) continue;
189
+ const block = [];
190
+ for (let j = i + 1; j < lines.length; j++) {
191
+ if (/^\s*#{1,6}\s+/.test(lines[j])) break;
192
+ block.push(lines[j]);
193
+ }
194
+ found.set(key, block.join("\n"));
195
+ }
196
+ return found;
197
+ }
198
+
199
+ function collectLineFormAssertions(text) {
200
+ const found = new Map();
201
+ const seen = new Set();
202
+ for (const line of String(text || "").split(/\r?\n/)) {
203
+ const match = line.match(LINE_FORM_RE);
204
+ if (!match) continue;
205
+ const id = match[1].toUpperCase();
206
+ const key = LINE_FORM_STATUS[match[2].toLowerCase()];
207
+ // First verdict per id wins: a later restatement is a summary, not a change.
208
+ if (!key || seen.has(id)) continue;
209
+ seen.add(id);
210
+ // The text after the separator IS the named evidence in this form. Left null
211
+ // for a bare verdict, so crossCheck still demotes it to unproven.
212
+ const evidence = String(match[3] || "").trim().replace(/\*+$/, "").trim() || null;
213
+ if (!found.has(key)) found.set(key, []);
214
+ found.get(key).push({ id, note: "", evidence });
215
+ }
216
+ return found;
217
+ }
218
+
219
+ function parseEntries(key, rawBlock) {
220
+ if (ASSERTION_KEYS.has(key)) {
221
+ return splitAssertionEntries(rawBlock).map(parseAssertionEntry).filter(Boolean);
222
+ }
223
+ return splitListEntries(rawBlock);
224
+ }
225
+
226
+ function normalizeListBlock(rawBlock) {
227
+ let block = String(rawBlock || "").trim();
228
+ if (!block || block === "[]") return "";
229
+ if (block.startsWith("[") && block.endsWith("]")) block = block.slice(1, -1);
230
+ return block;
231
+ }
232
+
233
+ function strippedLines(block) {
234
+ return block.split(/\r?\n/)
235
+ .map((line) => line.trim())
236
+ .filter(Boolean)
237
+ .map((line) => line.replace(/^[-*]\s+/, "").replace(/^\d+[.)]\s+/, "").replace(/,$/, "").trim())
238
+ .filter(Boolean);
239
+ }
240
+
241
+ function splitListEntries(rawBlock) {
242
+ const block = normalizeListBlock(rawBlock);
243
+ if (!block) return [];
244
+ const rawLines = block.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
245
+ const hasBulletLines = rawLines.some((line) => /^([-*]|\d+[.)])\s+/.test(line));
246
+ if (hasBulletLines) return strippedLines(block);
247
+ return [block.trim()];
248
+ }
249
+
250
+ function splitAssertionEntries(rawBlock) {
251
+ const block = normalizeListBlock(rawBlock);
252
+ if (!block) return [];
253
+ const rawLines = block.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
254
+ const hasBoundaryLines = rawLines.some((line) => /^([-*]|\d+[.)])\s+\bA\d+\b/.test(line));
255
+ if (hasBoundaryLines) return strippedLines(block).filter((line) => /^\bA\d+\b/.test(line));
256
+ return block
257
+ .split(/,(?=\s*A\d+\s*[:\-–—])/g)
258
+ .map((part) => part.trim().replace(/^,+\s*/, "").replace(/,+\s*$/, ""))
259
+ .filter(Boolean);
260
+ }
261
+
262
+ function parseAssertionEntry(entry) {
263
+ const text = String(entry || "").trim();
264
+ const idMatch = text.match(/\bA\d+\b/);
265
+ if (!idMatch) return null;
266
+ const id = idMatch[0];
267
+ let rest = text.slice((idMatch.index || 0) + id.length).trim();
268
+ rest = rest.replace(/^[:\-–—]\s*/, "");
269
+
270
+ let evidence = null;
271
+ const evidenceMatch = rest.match(/(?:^|\s+[—–-]\s*|\s+)evidence\s*:\s*([\s\S]*)$/i);
272
+ if (evidenceMatch) {
273
+ evidence = evidenceMatch[1].trim() || null;
274
+ rest = rest.slice(0, evidenceMatch.index).trim();
275
+ }
276
+ const note = rest.replace(/[✓✔]\s*$/u, "").trim();
277
+ return { id, note, evidence };
278
+ }
279
+
280
+ function normalizeKey(value) {
281
+ return String(value || "")
282
+ .trim()
283
+ .toLowerCase()
284
+ .replace(/[`*]/g, "")
285
+ .replace(/[^a-z0-9]+/g, "_")
286
+ .replace(/^_+|_+$/g, "");
287
+ }
288
+
289
+ function balanceBrackets(value) {
290
+ const opens = (String(value).match(/\[/g) || []).length;
291
+ const closes = (String(value).match(/\]/g) || []).length;
292
+ return opens - closes;
293
+ }