cool-workflow 0.1.98 → 0.2.1

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 (315) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/README.md +18 -7
  4. package/apps/architecture-review/app.json +2 -2
  5. package/apps/architecture-review/workflow.js +12 -12
  6. package/apps/architecture-review-fast/app.json +1 -1
  7. package/apps/end-to-end-golden-path/app.json +1 -1
  8. package/apps/pr-review-fix-ci/app.json +1 -1
  9. package/apps/release-cut/app.json +1 -1
  10. package/apps/research-synthesis/app.json +1 -1
  11. package/dist/cli/dispatch.js +236 -0
  12. package/dist/cli/entry.js +120 -0
  13. package/dist/cli/io.js +21 -4
  14. package/dist/cli/parseargv.js +157 -0
  15. package/dist/cli.js +6 -33
  16. package/dist/core/capability-table.js +3518 -0
  17. package/dist/core/format/help.js +314 -0
  18. package/dist/{state-explosion/format.js → core/format/state-explosion-text.js} +10 -1
  19. package/dist/core/hash.js +137 -0
  20. package/dist/core/multi-agent/candidate-scoring.js +219 -0
  21. package/dist/core/multi-agent/collaboration.js +481 -0
  22. package/dist/core/multi-agent/coordinator.js +515 -0
  23. package/dist/core/multi-agent/eval-replay.js +306 -0
  24. package/dist/core/multi-agent/runtime.js +929 -0
  25. package/dist/core/multi-agent/topology.js +298 -0
  26. package/dist/core/multi-agent/trust-policy.js +197 -0
  27. package/dist/core/pipeline/commit-gate.js +320 -0
  28. package/dist/{pipeline-contract.js → core/pipeline/contract.js} +24 -37
  29. package/dist/core/pipeline/dispatch.js +103 -0
  30. package/dist/core/pipeline/drive-decide.js +227 -0
  31. package/dist/core/pipeline/error-feedback.js +161 -0
  32. package/dist/core/pipeline/loop-expansion.js +124 -0
  33. package/dist/{result-normalize.js → core/pipeline/result-normalize.js} +14 -37
  34. package/dist/core/pipeline/runner.js +230 -0
  35. package/dist/{contract-migration.js → core/state/contract-migration.js} +68 -92
  36. package/dist/{state-migrations.js → core/state/migrations.js} +103 -96
  37. package/dist/core/state/node-projection.js +95 -0
  38. package/dist/core/state/node-snapshot.js +230 -0
  39. package/dist/core/state/run-paths.js +93 -0
  40. package/dist/{schema-validate.js → core/state/schema-validate.js} +35 -28
  41. package/dist/core/state/schema.js +50 -0
  42. package/dist/core/state/state-explosion/digest.js +243 -0
  43. package/dist/core/state/state-explosion/graph.js +527 -0
  44. package/dist/{state-explosion → core/state/state-explosion}/helpers.js +34 -3
  45. package/dist/core/state/state-explosion/report.js +187 -0
  46. package/dist/{state-explosion → core/state/state-explosion}/size.js +25 -7
  47. package/dist/{state-node.js → core/state/state-node.js} +90 -113
  48. package/dist/core/state/types.js +19 -0
  49. package/dist/{validation.js → core/state/validation.js} +64 -131
  50. package/dist/core/trust/evidence-grounding.js +134 -0
  51. package/dist/core/trust/ledger.js +199 -0
  52. package/dist/{telemetry-attestation.js → core/trust/telemetry-attestation.js} +94 -68
  53. package/dist/core/trust/telemetry-ledger.js +127 -0
  54. package/dist/core/types.js +20 -0
  55. package/dist/core/version.js +16 -0
  56. package/dist/{workflow-app-framework.js → core/workflow-apps/app-schema.js} +337 -426
  57. package/dist/mcp/dispatch.js +104 -0
  58. package/dist/mcp/server.js +144 -0
  59. package/dist/mcp-server.js +6 -84
  60. package/dist/{agent-config.js → shell/agent-config.js} +118 -71
  61. package/dist/shell/app-run-cli.js +88 -0
  62. package/dist/shell/audit-cli.js +259 -0
  63. package/dist/shell/audit-provenance.js +83 -0
  64. package/dist/shell/candidate-scoring-io.js +459 -0
  65. package/dist/shell/collaboration-io.js +264 -0
  66. package/dist/shell/commit-summary.js +104 -0
  67. package/dist/shell/commit.js +290 -0
  68. package/dist/shell/coordinator-io.js +476 -0
  69. package/dist/shell/demo-cli.js +19 -0
  70. package/dist/shell/dispatch.js +162 -0
  71. package/dist/shell/doctor.js +292 -0
  72. package/dist/shell/drive.js +885 -0
  73. package/dist/shell/error-feedback-io.js +305 -0
  74. package/dist/shell/eval-io.js +473 -0
  75. package/dist/{multi-agent-eval/format.js → shell/eval-text.js} +78 -49
  76. package/dist/{evidence-reasoning.js → shell/evidence-reasoning.js} +124 -255
  77. package/dist/shell/exec-backend-cli.js +88 -0
  78. package/dist/shell/execution-backend/agent.js +507 -0
  79. package/dist/shell/execution-backend/ci.js +15 -0
  80. package/dist/shell/execution-backend/container.js +69 -0
  81. package/dist/shell/execution-backend/envelopes.js +55 -0
  82. package/dist/shell/execution-backend/local.js +113 -0
  83. package/dist/shell/execution-backend/probes.js +175 -0
  84. package/dist/shell/execution-backend/registry.js +402 -0
  85. package/dist/shell/execution-backend/remote.js +128 -0
  86. package/dist/shell/execution-backend/types.js +11 -0
  87. package/dist/shell/feedback-cli.js +81 -0
  88. package/dist/shell/feedback-operations.js +48 -0
  89. package/dist/shell/fs-atomic.js +276 -0
  90. package/dist/shell/harness.js +98 -0
  91. package/dist/shell/ledger-cli.js +212 -0
  92. package/dist/shell/ledger-io.js +169 -0
  93. package/dist/shell/man-cli.js +89 -0
  94. package/dist/shell/metrics-cli.js +100 -0
  95. package/dist/shell/multi-agent-cli.js +1002 -0
  96. package/dist/shell/multi-agent-host.js +563 -0
  97. package/dist/shell/multi-agent-io.js +387 -0
  98. package/dist/{multi-agent-operator-ux.js → shell/multi-agent-operator-ux.js} +234 -191
  99. package/dist/shell/node-store.js +124 -0
  100. package/dist/{observability/format.js → shell/observability-format.js} +7 -1
  101. package/dist/{observability/intake.js → shell/observability-intake.js} +79 -56
  102. package/dist/{observability.js → shell/observability.js} +159 -332
  103. package/dist/{onramp.js → shell/onramp.js} +11 -0
  104. package/dist/{operator-ux/format.js → shell/operator-ux-text.js} +250 -239
  105. package/dist/shell/operator-ux.js +431 -0
  106. package/dist/shell/orchestrator.js +231 -0
  107. package/dist/shell/pipeline-cli.js +667 -0
  108. package/dist/shell/pipeline.js +217 -0
  109. package/dist/shell/reclamation-io.js +1366 -0
  110. package/dist/shell/registry-cli.js +344 -0
  111. package/dist/{remote-source.js → shell/remote-source.js} +2 -2
  112. package/dist/shell/report-cli.js +101 -0
  113. package/dist/shell/report-view-cli.js +117 -0
  114. package/dist/{orchestrator → shell}/report.js +289 -282
  115. package/dist/shell/reporter.js +62 -0
  116. package/dist/shell/run-export-cli.js +106 -0
  117. package/dist/shell/run-export.js +680 -0
  118. package/dist/shell/run-registry-io.js +1014 -0
  119. package/dist/shell/run-store.js +164 -0
  120. package/dist/{sandbox-profile.js → shell/sandbox-profile.js} +134 -95
  121. package/dist/{scheduler.js → shell/scheduler-io.js} +257 -48
  122. package/dist/shell/scheduling-io.js +321 -0
  123. package/dist/shell/state-cli.js +181 -0
  124. package/dist/shell/state-explosion-cli.js +197 -0
  125. package/dist/shell/telemetry-cli.js +85 -0
  126. package/dist/{telemetry-demo.js → shell/telemetry-demo.js} +149 -119
  127. package/dist/shell/telemetry-ledger-io.js +132 -0
  128. package/dist/{term.js → shell/term.js} +36 -46
  129. package/dist/shell/topology-io.js +361 -0
  130. package/dist/shell/trust-audit.js +472 -0
  131. package/dist/{multi-agent-trust.js → shell/trust-policy-io.js} +67 -205
  132. package/dist/shell/verifier.js +48 -0
  133. package/dist/shell/workbench-host.js +258 -0
  134. package/dist/shell/workbench-text.js +18 -0
  135. package/dist/shell/workbench.js +170 -0
  136. package/dist/shell/worker-cli.js +124 -0
  137. package/dist/shell/worker-isolation.js +852 -0
  138. package/dist/shell/workflow-app-loader.js +650 -0
  139. package/docs/agent-delegation-drive.7.md +4 -0
  140. package/docs/cli-mcp-parity.7.md +282 -219
  141. package/docs/contract-migration-tooling.7.md +4 -0
  142. package/docs/control-plane-scheduling.7.md +4 -0
  143. package/docs/durable-state-and-locking.7.md +4 -0
  144. package/docs/evidence-adoption-reasoning-chain.7.md +4 -0
  145. package/docs/execution-backends.7.md +4 -0
  146. package/docs/multi-agent-cli-mcp-surface.7.md +4 -0
  147. package/docs/multi-agent-eval-replay-harness.7.md +4 -0
  148. package/docs/multi-agent-operator-ux.7.md +4 -0
  149. package/docs/node-snapshot-diff-replay.7.md +4 -0
  150. package/docs/observability-cost-accounting.7.md +6 -1
  151. package/docs/project-index.md +137 -71
  152. package/docs/real-execution-backends.7.md +4 -0
  153. package/docs/release-and-migration.7.md +4 -0
  154. package/docs/release-tooling.7.md +4 -0
  155. package/docs/remote-source-review.7.md +4 -4
  156. package/docs/report-verifiable-bundle.7.md +1 -1
  157. package/docs/run-registry-control-plane.7.md +4 -0
  158. package/docs/run-retention-reclamation.7.md +25 -0
  159. package/docs/security-trust-hardening.7.md +3 -1
  160. package/docs/state-explosion-management.7.md +4 -0
  161. package/docs/team-collaboration.7.md +4 -0
  162. package/docs/web-desktop-workbench.7.md +15 -1
  163. package/manifest/plugin.manifest.json +1 -1
  164. package/manifest/source-context-profiles.json +9 -13
  165. package/package.json +1 -1
  166. package/scripts/agents/agent-adapter-core.js +22 -2
  167. package/scripts/agents/claude-p-agent.js +8 -3
  168. package/scripts/agents/cw-attest-wrap.js +2 -2
  169. package/scripts/agents/gemini-agent.js +5 -1
  170. package/scripts/agents/opencode-agent.js +5 -1
  171. package/scripts/bump-version.js +4 -3
  172. package/scripts/canonical-apps.js +4 -4
  173. package/scripts/dogfood-architecture-review.js +2 -3
  174. package/scripts/dogfood-release.js +3 -3
  175. package/scripts/gen-parity-doc.js +15 -2
  176. package/scripts/golden-path.js +4 -4
  177. package/scripts/onramp-check.js +1 -1
  178. package/scripts/parity-check.js +38 -21
  179. package/scripts/release-flow.js +2 -2
  180. package/scripts/sync-project-index.js +51 -27
  181. package/scripts/validate-run-state-schema.js +2 -2
  182. package/scripts/version-sync-check.js +30 -30
  183. package/dist/candidate-scoring.js +0 -729
  184. package/dist/capability-core.js +0 -1189
  185. package/dist/capability-registry.js +0 -885
  186. package/dist/cli/command-surface.js +0 -494
  187. package/dist/cli/format.js +0 -56
  188. package/dist/cli/handlers/audit.js +0 -82
  189. package/dist/cli/handlers/blackboard.js +0 -81
  190. package/dist/cli/handlers/candidate.js +0 -40
  191. package/dist/cli/handlers/clones.js +0 -34
  192. package/dist/cli/handlers/collaboration.js +0 -61
  193. package/dist/cli/handlers/eval.js +0 -40
  194. package/dist/cli/handlers/ledger.js +0 -169
  195. package/dist/cli/handlers/maintenance.js +0 -107
  196. package/dist/cli/handlers/multi-agent.js +0 -165
  197. package/dist/cli/handlers/node.js +0 -41
  198. package/dist/cli/handlers/operational.js +0 -155
  199. package/dist/cli/handlers/operator.js +0 -146
  200. package/dist/cli/handlers/registry.js +0 -68
  201. package/dist/cli/handlers/run.js +0 -153
  202. package/dist/cli/handlers/scheduling.js +0 -132
  203. package/dist/cli/handlers/workbench.js +0 -41
  204. package/dist/cli/handlers/worker.js +0 -45
  205. package/dist/cli/run-summary.js +0 -45
  206. package/dist/clones.js +0 -162
  207. package/dist/collaboration.js +0 -726
  208. package/dist/commit.js +0 -592
  209. package/dist/compare.js +0 -18
  210. package/dist/coordinator/classify.js +0 -45
  211. package/dist/coordinator/paths.js +0 -42
  212. package/dist/coordinator/util.js +0 -126
  213. package/dist/coordinator.js +0 -990
  214. package/dist/daemon.js +0 -44
  215. package/dist/dispatch.js +0 -250
  216. package/dist/doctor.js +0 -212
  217. package/dist/drive.js +0 -864
  218. package/dist/error-feedback.js +0 -419
  219. package/dist/evidence-grounding.js +0 -184
  220. package/dist/execution-backend/agent.js +0 -354
  221. package/dist/execution-backend/probes.js +0 -112
  222. package/dist/execution-backend/util.js +0 -47
  223. package/dist/execution-backend.js +0 -961
  224. package/dist/gates.js +0 -48
  225. package/dist/harness.js +0 -61
  226. package/dist/ledger.js +0 -313
  227. package/dist/loop-expansion.js +0 -60
  228. package/dist/mcp/tool-call.js +0 -470
  229. package/dist/mcp/tool-definitions.js +0 -1066
  230. package/dist/mcp-surface.js +0 -30
  231. package/dist/multi-agent/graph.js +0 -84
  232. package/dist/multi-agent/helpers.js +0 -141
  233. package/dist/multi-agent/ids.js +0 -20
  234. package/dist/multi-agent/paths.js +0 -22
  235. package/dist/multi-agent-eval/normalize.js +0 -51
  236. package/dist/multi-agent-eval.js +0 -678
  237. package/dist/multi-agent-host.js +0 -777
  238. package/dist/multi-agent.js +0 -984
  239. package/dist/node-projection.js +0 -59
  240. package/dist/node-snapshot.js +0 -260
  241. package/dist/operator-ux.js +0 -631
  242. package/dist/orchestrator/app-operations.js +0 -211
  243. package/dist/orchestrator/audit-operations.js +0 -182
  244. package/dist/orchestrator/candidate-operations.js +0 -117
  245. package/dist/orchestrator/cli-options.js +0 -294
  246. package/dist/orchestrator/collaboration-operations.js +0 -86
  247. package/dist/orchestrator/feedback-operations.js +0 -81
  248. package/dist/orchestrator/host-operations.js +0 -78
  249. package/dist/orchestrator/lifecycle-operations.js +0 -650
  250. package/dist/orchestrator/migration-operations.js +0 -44
  251. package/dist/orchestrator/multi-agent-operations.js +0 -362
  252. package/dist/orchestrator/topology-operations.js +0 -84
  253. package/dist/orchestrator.js +0 -925
  254. package/dist/pipeline-runner.js +0 -285
  255. package/dist/reclamation/hash.js +0 -72
  256. package/dist/reclamation.js +0 -812
  257. package/dist/reporter.js +0 -67
  258. package/dist/run-export.js +0 -815
  259. package/dist/run-registry/derive.js +0 -175
  260. package/dist/run-registry/format.js +0 -124
  261. package/dist/run-registry/gc.js +0 -251
  262. package/dist/run-registry/policy.js +0 -16
  263. package/dist/run-registry/queue.js +0 -115
  264. package/dist/run-registry.js +0 -850
  265. package/dist/run-state-schema.js +0 -68
  266. package/dist/scheduling.js +0 -184
  267. package/dist/state-explosion.js +0 -1014
  268. package/dist/state.js +0 -367
  269. package/dist/telemetry-ledger.js +0 -196
  270. package/dist/topology.js +0 -565
  271. package/dist/triggers.js +0 -184
  272. package/dist/trust-audit.js +0 -644
  273. package/dist/types/blackboard.js +0 -2
  274. package/dist/types/candidate.js +0 -2
  275. package/dist/types/collaboration.js +0 -2
  276. package/dist/types/core.js +0 -2
  277. package/dist/types/drive.js +0 -10
  278. package/dist/types/error-feedback.js +0 -2
  279. package/dist/types/evidence-reasoning.js +0 -2
  280. package/dist/types/execution-backend.js +0 -2
  281. package/dist/types/multi-agent.js +0 -2
  282. package/dist/types/observability.js +0 -2
  283. package/dist/types/pipeline.js +0 -2
  284. package/dist/types/reclamation.js +0 -8
  285. package/dist/types/report-bundle.js +0 -6
  286. package/dist/types/result.js +0 -2
  287. package/dist/types/run-registry.js +0 -2
  288. package/dist/types/run.js +0 -2
  289. package/dist/types/sandbox.js +0 -2
  290. package/dist/types/schedule.js +0 -2
  291. package/dist/types/state-node.js +0 -2
  292. package/dist/types/topology.js +0 -2
  293. package/dist/types/trust.js +0 -2
  294. package/dist/types/workbench.js +0 -2
  295. package/dist/types/worker.js +0 -2
  296. package/dist/types/workflow-app.js +0 -2
  297. package/dist/types.js +0 -44
  298. package/dist/util/fingerprint.js +0 -19
  299. package/dist/util/fingerprint.test.js +0 -27
  300. package/dist/verifier.js +0 -78
  301. package/dist/version.js +0 -8
  302. package/dist/workbench-host.js +0 -192
  303. package/dist/workbench.js +0 -192
  304. package/dist/worker-accept/acceptance.js +0 -114
  305. package/dist/worker-accept/blackboard-fanout.js +0 -80
  306. package/dist/worker-accept/blackboard-linkage.js +0 -19
  307. package/dist/worker-accept/context.js +0 -2
  308. package/dist/worker-accept/telemetry-ledger.js +0 -126
  309. package/dist/worker-accept/validation.js +0 -77
  310. package/dist/worker-accept/verifier-completion.js +0 -73
  311. package/dist/worker-isolation/helpers.js +0 -51
  312. package/dist/worker-isolation/paths.js +0 -46
  313. package/dist/worker-isolation.js +0 -656
  314. package/dist/workflow-api.js +0 -131
  315. /package/dist/{types → core/types}/boundary.js +0 -0
@@ -1,678 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.formatMultiAgentEval = exports.replayStableStringify = exports.normalizeValue = exports.lines = void 0;
7
- exports.createMultiAgentReplaySnapshot = createMultiAgentReplaySnapshot;
8
- exports.replayMultiAgentSnapshot = replayMultiAgentSnapshot;
9
- exports.compareMultiAgentReplay = compareMultiAgentReplay;
10
- exports.scoreMultiAgentReplay = scoreMultiAgentReplay;
11
- exports.gateMultiAgentEval = gateMultiAgentEval;
12
- exports.reportMultiAgentEval = reportMultiAgentEval;
13
- const node_fs_1 = __importDefault(require("node:fs"));
14
- const node_path_1 = __importDefault(require("node:path"));
15
- const multi_agent_1 = require("./multi-agent");
16
- const multi_agent_operator_ux_1 = require("./multi-agent-operator-ux");
17
- const multi_agent_trust_1 = require("./multi-agent-trust");
18
- const operator_ux_1 = require("./operator-ux");
19
- const topology_1 = require("./topology");
20
- const trust_audit_1 = require("./trust-audit");
21
- const state_explosion_1 = require("./state-explosion");
22
- const evidence_reasoning_1 = require("./evidence-reasoning");
23
- const state_1 = require("./state");
24
- const normalize_1 = require("./multi-agent-eval/normalize");
25
- // Pure normalization primitives carved into ./multi-agent-eval/normalize.ts;
26
- // re-exported verbatim so every external importer stays byte-unchanged.
27
- var normalize_2 = require("./multi-agent-eval/normalize");
28
- Object.defineProperty(exports, "lines", { enumerable: true, get: function () { return normalize_2.lines; } });
29
- Object.defineProperty(exports, "normalizeValue", { enumerable: true, get: function () { return normalize_2.normalizeValue; } });
30
- Object.defineProperty(exports, "replayStableStringify", { enumerable: true, get: function () { return normalize_2.replayStableStringify; } });
31
- // Human formatter (CLI-only renderer) carved into ./multi-agent-eval/format.ts.
32
- var format_1 = require("./multi-agent-eval/format");
33
- Object.defineProperty(exports, "formatMultiAgentEval", { enumerable: true, get: function () { return format_1.formatMultiAgentEval; } });
34
- const METRIC_SECTIONS = [
35
- { metric: "replay_completed", section: "workflow", title: "Replay completed" },
36
- { metric: "graph_parity", section: "topologyShape", title: "Topology graph parity" },
37
- { metric: "role_parity", section: "roles", title: "Role parity" },
38
- { metric: "group_parity", section: "groups", title: "Group parity" },
39
- { metric: "membership_parity", section: "memberships", title: "Membership parity" },
40
- { metric: "fanout_parity", section: "fanouts", title: "Fanout parity" },
41
- { metric: "fanin_parity", section: "fanins", title: "Fanin parity" },
42
- { metric: "dependency_parity", section: "dependencyEdges", title: "Dependency parity" },
43
- { metric: "failure_parity", section: "failures", title: "Failure row parity" },
44
- { metric: "blackboard_record_parity", section: "blackboardRecords", title: "Blackboard record parity" },
45
- { metric: "evidence_adoption_parity", section: "evidenceAdoption", title: "Evidence adoption parity" },
46
- { metric: "trust_audit_parity", section: "blackboardWriteAudit", title: "Trust/audit parity" },
47
- { metric: "role_policy_parity", section: "rolePolicies", title: "Role policy parity" },
48
- { metric: "permission_decision_parity", section: "permissionDecisions", title: "Permission decision parity" },
49
- { metric: "policy_violation_parity", section: "policyViolations", title: "Policy violation parity" },
50
- { metric: "blackboard_provenance_parity", section: "messageProvenance", title: "Blackboard provenance parity" },
51
- { metric: "judge_rationale_parity", section: "judgeRationales", title: "Judge rationale parity" },
52
- { metric: "panel_decision_parity", section: "panelDecisions", title: "Panel decision parity" },
53
- { metric: "candidate_score_parity", section: "candidateScores", title: "Candidate score parity" },
54
- { metric: "selection_parity", section: "selectedCandidates", title: "Selection parity" },
55
- { metric: "verifier_commit_gate_parity", section: "verifierCommitGate", title: "Verifier commit gate parity" },
56
- { metric: "report_parity", section: "reportSections", title: "Report parity" }
57
- ];
58
- // v0.1.25 State Explosion Management metrics. Kept separate from METRIC_SECTIONS
59
- // so assertNormalizedShape (which requires every METRIC_SECTIONS array) stays
60
- // backward compatible with pre-0.1.25 snapshots that lack these sections.
61
- const SUMMARY_METRIC_SECTIONS = [
62
- { metric: "summary_freshness", section: "summaryFreshness", title: "Summary freshness" },
63
- { metric: "compact_graph_parity", section: "compactGraphShape", title: "Compact graph parity" },
64
- { metric: "blackboard_digest_parity", section: "blackboardDigest", title: "Blackboard digest parity" },
65
- { metric: "critical_path_parity", section: "criticalPath", title: "Critical path parity" },
66
- { metric: "evidence_digest_parity", section: "evidenceDigest", title: "Evidence digest parity" },
67
- { metric: "expansion_ref_integrity", section: "expansionRefs", title: "Expansion ref integrity" }
68
- ];
69
- // v0.1.26 Evidence Adoption Reasoning Chain metrics. Kept separate (like the
70
- // v0.1.25 summary metrics) so assertNormalizedShape stays backward compatible
71
- // with pre-0.1.26 snapshots that lack these sections.
72
- const REASONING_METRIC_SECTIONS = [
73
- { metric: "reasoning_freshness", section: "reasoningFreshness", title: "Reasoning chain freshness" },
74
- { metric: "reasoning_chain_parity", section: "reasoningChains", title: "Reasoning chain parity" },
75
- { metric: "reasoning_unexplained_parity", section: "reasoningUnexplained", title: "Fail-closed unexplained parity" }
76
- ];
77
- const ALL_METRIC_SECTIONS = [...METRIC_SECTIONS, ...SUMMARY_METRIC_SECTIONS, ...REASONING_METRIC_SECTIONS];
78
- function createMultiAgentReplaySnapshot(run, options = {}) {
79
- const id = (0, state_1.safeFileName)(String(options.id || options.snapshot || `${run.id}-snapshot`));
80
- const suiteDir = evalSuiteDir(run.cwd, id);
81
- const snapshotPath = node_path_1.default.join(suiteDir, "snapshot.json");
82
- const snapshot = {
83
- schemaVersion: 1,
84
- kind: "multi-agent-replay-snapshot",
85
- id,
86
- createdAt: now(),
87
- runId: run.id,
88
- workflow: {
89
- id: run.workflow.id,
90
- appId: run.workflow.app?.id,
91
- appVersion: run.workflow.app?.version,
92
- title: run.workflow.title
93
- },
94
- inputs: (0, normalize_1.normalizeValue)(run.inputs),
95
- paths: {
96
- suiteDir,
97
- snapshotPath,
98
- baselineStatePath: run.paths.state,
99
- reportPath: run.paths.report
100
- },
101
- capture: captureRun(run),
102
- normalized: normalizeRun(run)
103
- };
104
- (0, state_1.writeJson)(snapshotPath, snapshot);
105
- writeSuite({
106
- schemaVersion: 1,
107
- id,
108
- title: `Multi-Agent Eval Suite ${id}`,
109
- createdAt: snapshot.createdAt,
110
- cases: [{
111
- id: `${id}-case`,
112
- snapshotId: id,
113
- baselinePath: snapshotPath,
114
- expectedVerdict: "pass"
115
- }],
116
- paths: { suiteDir, snapshotPath }
117
- });
118
- return snapshot;
119
- }
120
- function replayMultiAgentSnapshot(target, options = {}) {
121
- const snapshot = loadSnapshot(target);
122
- const replayId = (0, state_1.safeFileName)(String(options.id || options.replay || `${snapshot.id}-replay`));
123
- const suiteDir = snapshot.paths.suiteDir;
124
- const replayDir = node_path_1.default.join(suiteDir, "replay");
125
- const replayRunPath = node_path_1.default.join(suiteDir, "replay-run.json");
126
- node_fs_1.default.mkdirSync(replayDir, { recursive: true });
127
- // RE-DERIVE the projection from the raw captured state instead of copying
128
- // snapshot.normalized. Copying the baseline would make compareMultiAgentReplay
129
- // diff the baseline against a byte-copy of itself, so a projection-determinism
130
- // regression in normalizeRun could never be caught (the determinism moat would
131
- // be false-green). We reconstruct the run from the captured raw state and run
132
- // the SAME normalizeRun pipeline used at capture time, producing an INDEPENDENT
133
- // re-projection the comparison can pit against the baseline.
134
- const replayed = rederiveNormalizedFromSnapshot(snapshot);
135
- const replay = {
136
- schemaVersion: 1,
137
- kind: "multi-agent-replay-run",
138
- id: replayId,
139
- snapshotId: snapshot.id,
140
- baselineRunId: snapshot.runId,
141
- replayedAt: now(),
142
- status: "completed",
143
- isolatedWorkspace: replayDir,
144
- paths: {
145
- suiteDir,
146
- replayDir,
147
- replayRunPath,
148
- snapshotPath: snapshot.paths.snapshotPath
149
- },
150
- replay: replayed,
151
- errors: []
152
- };
153
- (0, state_1.writeJson)(replayRunPath, replay);
154
- const suite = loadSuiteFromDir(suiteDir);
155
- suite.paths.replayRunPath = replayRunPath;
156
- suite.cases = suite.cases.map((entry) => entry.snapshotId === snapshot.id ? { ...entry, replayRunId: replayId, replayPath: replayRunPath } : entry);
157
- writeSuite(suite);
158
- return replay;
159
- }
160
- function compareMultiAgentReplay(baselineTarget, replayTarget) {
161
- const baseline = loadBaselineNormalized(baselineTarget);
162
- const replay = loadReplay(replayTarget);
163
- const suiteDir = replay.paths.suiteDir;
164
- const comparisonPath = node_path_1.default.join(suiteDir, "comparison.json");
165
- const findingsPath = node_path_1.default.join(suiteDir, "findings.json");
166
- const sections = {};
167
- const findings = [];
168
- for (const spec of ALL_METRIC_SECTIONS) {
169
- const { baselineValue, replayValue } = comparisonValues(spec.metric, spec.section, baseline.normalized, replay);
170
- const equal = (0, normalize_1.replayStableStringify)(baselineValue) === (0, normalize_1.replayStableStringify)(replayValue);
171
- const id = String(spec.section);
172
- sections[id] = {
173
- id,
174
- status: equal ? "pass" : "fail",
175
- baselineRef: `${baseline.path}#/normalized/${id}`,
176
- replayRef: `${replay.paths.replayRunPath}#/replay/${id}`,
177
- reason: equal ? `${spec.title} matches.` : `${spec.title} changed.`
178
- };
179
- if (!equal) {
180
- findings.push({
181
- id: `regression-${id}`,
182
- severity: "error",
183
- category: id,
184
- reason: `${spec.title} changed between baseline and replay.`,
185
- baselineRef: sections[id].baselineRef,
186
- replayRef: sections[id].replayRef
187
- });
188
- }
189
- }
190
- const comparison = {
191
- schemaVersion: 1,
192
- baselineId: baseline.id,
193
- replayId: replay.id,
194
- comparedAt: now(),
195
- status: findings.some((entry) => entry.severity === "error") ? "fail" : "pass",
196
- paths: {
197
- suiteDir,
198
- baselinePath: baseline.path,
199
- replayPath: replay.paths.replayRunPath,
200
- comparisonPath,
201
- findingsPath
202
- },
203
- sections,
204
- findings
205
- };
206
- (0, state_1.writeJson)(comparisonPath, comparison);
207
- (0, state_1.writeJson)(findingsPath, findings);
208
- const suite = loadSuiteFromDir(suiteDir);
209
- suite.paths.comparisonPath = comparisonPath;
210
- suite.paths.findingsPath = findingsPath;
211
- writeSuite(suite);
212
- return comparison;
213
- }
214
- function comparisonValues(metric, section, baseline, replay) {
215
- if (metric === "replay_completed") {
216
- return {
217
- baselineValue: {
218
- status: "completed",
219
- errorCount: 0,
220
- workflow: baseline.workflow
221
- },
222
- replayValue: {
223
- status: replay.status,
224
- errorCount: replay.errors.length,
225
- workflow: replay.replay.workflow
226
- }
227
- };
228
- }
229
- return {
230
- baselineValue: baseline[section] ?? [],
231
- replayValue: replay.replay[section] ?? []
232
- };
233
- }
234
- function scoreMultiAgentReplay(target) {
235
- const comparison = loadOrCompareForTarget(target);
236
- const scorePath = node_path_1.default.join(comparison.paths.suiteDir, "score.json");
237
- const metrics = ALL_METRIC_SECTIONS.map((spec) => {
238
- const section = comparison.sections[String(spec.section)];
239
- const passed = section?.status === "pass";
240
- return {
241
- id: spec.metric,
242
- status: passed ? "pass" : "fail",
243
- score: passed ? 1 : 0,
244
- maxScore: 1,
245
- reason: section?.reason || `${spec.title} missing.`,
246
- evidenceRefs: [section?.baselineRef, section?.replayRef].filter(Boolean),
247
- baselineRefs: section?.baselineRef ? [section.baselineRef] : [],
248
- replayRefs: section?.replayRef ? [section.replayRef] : []
249
- };
250
- });
251
- const score = {
252
- schemaVersion: 1,
253
- replayId: comparison.replayId,
254
- scoredAt: now(),
255
- status: metrics.every((entry) => entry.status !== "fail") ? "pass" : "fail",
256
- score: metrics.reduce((total, entry) => total + entry.score, 0),
257
- maxScore: metrics.reduce((total, entry) => total + entry.maxScore, 0),
258
- metrics,
259
- findings: comparison.findings,
260
- paths: {
261
- suiteDir: comparison.paths.suiteDir,
262
- comparisonPath: comparison.paths.comparisonPath,
263
- scorePath
264
- }
265
- };
266
- (0, state_1.writeJson)(scorePath, score);
267
- const suite = loadSuiteFromDir(comparison.paths.suiteDir);
268
- suite.paths.scorePath = scorePath;
269
- writeSuite(suite);
270
- return score;
271
- }
272
- function gateMultiAgentEval(target) {
273
- const suiteDir = resolveSuiteDir(target);
274
- const snapshotPath = node_path_1.default.join(suiteDir, "snapshot.json");
275
- const replayRunPath = node_path_1.default.join(suiteDir, "replay-run.json");
276
- const comparisonPath = node_path_1.default.join(suiteDir, "comparison.json");
277
- const scorePath = node_path_1.default.join(suiteDir, "score.json");
278
- const missing = [snapshotPath, replayRunPath, comparisonPath, scorePath].filter((file) => !node_fs_1.default.existsSync(file));
279
- if (missing.length)
280
- throw new Error(`Eval gate missing required artifact(s): ${missing.join(", ")}`);
281
- const comparison = (0, state_1.readJson)(comparisonPath);
282
- const score = (0, state_1.readJson)(scorePath);
283
- if (comparison.paths.baselinePath !== snapshotPath) {
284
- throw new Error(`Eval gate found stale comparison artifact for ${comparison.paths.baselinePath}; rerun eval compare ${snapshotPath} ${comparison.paths.replayPath}`);
285
- }
286
- if (score.replayId !== comparison.replayId || score.paths.comparisonPath !== comparisonPath) {
287
- throw new Error(`Eval gate found stale score artifact for ${score.replayId}; rerun eval score ${comparison.paths.replayPath}`);
288
- }
289
- const report = reportMultiAgentEval(comparison.paths.replayPath);
290
- const failed = score.findings.filter((entry) => entry.severity === "error");
291
- const gate = {
292
- schemaVersion: 1,
293
- suiteId: node_path_1.default.basename(suiteDir),
294
- checkedAt: now(),
295
- status: score.status === "pass" && failed.length === 0 ? "pass" : "fail",
296
- verdict: score.status === "pass" && failed.length === 0 ? "ship" : "hold",
297
- score: score.score,
298
- maxScore: score.maxScore,
299
- requiredArtifacts: [snapshotPath, comparison.paths.replayPath, comparisonPath, scorePath, report.reportPath],
300
- findings: score.findings,
301
- paths: {
302
- suiteDir,
303
- snapshotPath,
304
- replayRunPath: comparison.paths.replayPath,
305
- comparisonPath,
306
- scorePath,
307
- reportPath: report.reportPath
308
- },
309
- nextAction: failed.length ? "Review regression findings, update replay rationale if the change is intentional, then rerun eval gate." : "Eval replay gate passed; include artifacts in release evidence."
310
- };
311
- (0, state_1.writeJson)(node_path_1.default.join(suiteDir, "gate.json"), gate);
312
- return gate;
313
- }
314
- function reportMultiAgentEval(target) {
315
- const suiteDir = resolveSuiteDir(target);
316
- const scorePath = node_path_1.default.join(suiteDir, "score.json");
317
- const score = loadScoreForTarget(target, scorePath);
318
- const reportPath = node_path_1.default.join(suiteDir, "report.md");
319
- const lines = [
320
- "# Multi-Agent Eval Replay Report",
321
- "",
322
- "## Eval Suite",
323
- `- Suite: ${node_path_1.default.basename(suiteDir)}`,
324
- `- Replay: ${score.replayId}`,
325
- "",
326
- "## Replay Status",
327
- `- Status: ${score.status}`,
328
- `- Score: ${score.score}/${score.maxScore}`,
329
- "",
330
- "## Graph Comparison",
331
- metricLine(score, "replay_completed"),
332
- metricLine(score, "graph_parity"),
333
- metricLine(score, "role_parity"),
334
- metricLine(score, "group_parity"),
335
- metricLine(score, "membership_parity"),
336
- metricLine(score, "fanout_parity"),
337
- metricLine(score, "fanin_parity"),
338
- metricLine(score, "dependency_parity"),
339
- metricLine(score, "failure_parity"),
340
- "",
341
- "## Evidence Comparison",
342
- metricLine(score, "blackboard_record_parity"),
343
- metricLine(score, "evidence_adoption_parity"),
344
- metricLine(score, "blackboard_provenance_parity"),
345
- "",
346
- "## Trust / Policy / Audit Comparison",
347
- metricLine(score, "trust_audit_parity"),
348
- metricLine(score, "role_policy_parity"),
349
- metricLine(score, "permission_decision_parity"),
350
- metricLine(score, "policy_violation_parity"),
351
- metricLine(score, "judge_rationale_parity"),
352
- metricLine(score, "panel_decision_parity"),
353
- "",
354
- "## Candidate Score Comparison",
355
- metricLine(score, "candidate_score_parity"),
356
- "",
357
- "## Selection / Commit Gate",
358
- metricLine(score, "selection_parity"),
359
- metricLine(score, "verifier_commit_gate_parity"),
360
- "",
361
- "## State Explosion Summaries",
362
- metricLine(score, "summary_freshness"),
363
- metricLine(score, "compact_graph_parity"),
364
- metricLine(score, "blackboard_digest_parity"),
365
- metricLine(score, "critical_path_parity"),
366
- metricLine(score, "evidence_digest_parity"),
367
- metricLine(score, "expansion_ref_integrity"),
368
- "",
369
- "## Evidence Adoption Reasoning Chain",
370
- metricLine(score, "reasoning_freshness"),
371
- metricLine(score, "reasoning_chain_parity"),
372
- metricLine(score, "reasoning_unexplained_parity"),
373
- "",
374
- "## Regression Findings",
375
- ...(score.findings.length ? score.findings.map((entry) => `- ${entry.severity.toUpperCase()} ${entry.category}: ${entry.reason}`) : ["- none"]),
376
- "",
377
- "## Final Verdict",
378
- score.status === "pass" ? "PASS" : "FAIL",
379
- "",
380
- "## Next Action",
381
- score.status === "pass" ? "Use this replay as release-gate evidence." : "Fix or explicitly classify the changed behavior before release."
382
- ];
383
- node_fs_1.default.writeFileSync(reportPath, `${lines.join("\n")}\n`, "utf8");
384
- const suite = loadSuiteFromDir(suiteDir);
385
- suite.paths.reportPath = reportPath;
386
- writeSuite(suite);
387
- return {
388
- schemaVersion: 1,
389
- replayId: score.replayId,
390
- status: score.status,
391
- reportPath,
392
- score: score.score,
393
- maxScore: score.maxScore,
394
- findings: score.findings
395
- };
396
- }
397
- function loadScoreForTarget(target, scorePath) {
398
- const replayPath = resolveReplayPath(target);
399
- if (node_fs_1.default.existsSync(scorePath)) {
400
- const score = (0, state_1.readJson)(scorePath);
401
- if (node_fs_1.default.existsSync(score.paths.comparisonPath)) {
402
- const comparison = (0, state_1.readJson)(score.paths.comparisonPath);
403
- if (comparison.replayId === score.replayId && comparison.paths.replayPath === replayPath)
404
- return score;
405
- }
406
- }
407
- return scoreMultiAgentReplay(target);
408
- }
409
- // Re-derive snapshot.normalized INDEPENDENTLY at replay time. The raw captured
410
- // state is the baseline run state file (snapshot.paths.baselineStatePath) — the
411
- // same WorkflowRun captureRun/normalizeRun projected at capture time. We re-load
412
- // it and re-run the IDENTICAL normalizeRun pipeline, so the result is a genuine
413
- // re-projection rather than a copy of the baseline. Fail-closed: if the raw
414
- // state cannot be reconstructed we throw (never silently fall back to the
415
- // baseline copy — that is exactly the false-green this guards against).
416
- function rederiveNormalizedFromSnapshot(snapshot) {
417
- const statePath = snapshot.paths.baselineStatePath;
418
- if (!statePath || !node_fs_1.default.existsSync(statePath)) {
419
- throw new Error(`Cannot re-derive replay projection: baseline run state missing at ${statePath || "<unset>"}; re-snapshot from a live run before replaying.`);
420
- }
421
- const result = (0, state_1.loadRunStateFile)(statePath, { dryRun: true });
422
- if (result.report.status === "unsupported") {
423
- throw new Error(`Cannot re-derive replay projection: baseline run state at ${statePath} is unsupported: ${result.report.errors.join("; ")}`);
424
- }
425
- return normalizeRun(result.run);
426
- }
427
- function captureRun(run) {
428
- return {
429
- topology: run.topologies || { schemaVersion: 1, runs: [] },
430
- multiAgent: run.multiAgent || { schemaVersion: 1, runs: [], roles: [], groups: [], memberships: [], fanouts: [], fanins: [] },
431
- blackboard: run.blackboard || { schemaVersion: 1, boards: [], topics: [], messages: [], contexts: [], artifacts: [], snapshots: [], decisions: [] },
432
- workers: run.workers || [],
433
- workerOutputs: (run.workers || []).map((worker) => worker.output).filter(Boolean),
434
- candidates: run.candidates || [],
435
- candidateSelections: run.candidateSelections || [],
436
- candidateScoreInputs: collectCandidateScores(run),
437
- commits: run.commits || [],
438
- trustAudit: (0, trust_audit_1.summarizeTrustAudit)(run),
439
- multiAgentTrust: (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run),
440
- operator: (0, operator_ux_1.summarizeOperatorRun)(run)
441
- };
442
- }
443
- function normalizeRun(run) {
444
- const operator = (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(run);
445
- const trust = (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run);
446
- const blackboard = run.blackboard || { boards: [], topics: [], messages: [], contexts: [], artifacts: [], snapshots: [], decisions: [] };
447
- const topologies = (0, topology_1.summarizeTopologies)(run);
448
- const multiAgent = (0, multi_agent_1.summarizeMultiAgent)(run);
449
- return {
450
- workflow: (0, normalize_1.normalizeValue)({
451
- id: run.workflow.id,
452
- appId: run.workflow.app?.id,
453
- appVersion: run.workflow.app?.version,
454
- taskCount: run.tasks.length
455
- }),
456
- topologyShape: (0, normalize_1.lines)([
457
- topologies.active.map((entry) => ({
458
- topologyId: entry.topologyId,
459
- status: entry.status,
460
- roleCount: entry.roles.length,
461
- groupCount: entry.groups.length,
462
- fanoutCount: entry.fanouts.length,
463
- faninCount: entry.fanins.length
464
- })),
465
- multiAgent.groupsDetail
466
- ]),
467
- roles: (0, normalize_1.lines)(run.multiAgent?.roles || []),
468
- groups: (0, normalize_1.lines)(run.multiAgent?.groups || []),
469
- memberships: (0, normalize_1.lines)(run.multiAgent?.memberships || []),
470
- fanouts: (0, normalize_1.lines)(run.multiAgent?.fanouts || []),
471
- fanins: (0, normalize_1.lines)(run.multiAgent?.fanins || []),
472
- dependencyEdges: (0, normalize_1.lines)(operator.dependencies.map((entry) => ({ from: entry.from, to: entry.to, label: entry.label, status: entry.status }))),
473
- failures: (0, normalize_1.lines)(operator.failures.map((entry) => ({ kind: entry.kind, status: entry.status, owner: entry.owner, reason: entry.reason }))),
474
- blackboardRecords: (0, normalize_1.lines)([blackboard.boards, blackboard.topics, blackboard.messages, blackboard.contexts, blackboard.artifacts, blackboard.snapshots, blackboard.decisions]),
475
- messageProvenance: (0, normalize_1.lines)(trust.messageProvenance || []),
476
- rolePolicies: (0, normalize_1.lines)(trust.rolePolicies || []),
477
- permissionDecisions: (0, normalize_1.lines)(trust.permissionDecisions || []),
478
- blackboardWriteAudit: (0, normalize_1.lines)(trust.blackboardWrites || []),
479
- judgeRationales: (0, normalize_1.lines)(trust.judgeRationales || []),
480
- panelDecisions: (0, normalize_1.lines)(trust.panelDecisions || []),
481
- policyViolations: (0, normalize_1.lines)(trust.policyViolations || []),
482
- evidenceAdoption: (0, normalize_1.lines)(operator.evidence.map((entry) => ({
483
- ref: entry.ref || entry.id,
484
- status: entry.status,
485
- adoptedBy: entry.adoptedBy,
486
- candidateIds: entry.candidateIds,
487
- selectionIds: entry.selectionIds,
488
- commitIds: entry.commitIds
489
- }))),
490
- candidateScores: (0, normalize_1.lines)(collectCandidateScores(run)),
491
- selectedCandidates: (0, normalize_1.lines)((run.candidateSelections || []).map((entry) => ({
492
- candidateId: entry.candidateId,
493
- scoreId: entry.scoreId,
494
- verifierNodeId: entry.verifierNodeId,
495
- reason: entry.reason,
496
- evidenceCount: entry.evidence.length
497
- }))),
498
- verifierCommitGate: (0, normalize_1.lines)((run.commits || []).map((entry) => ({
499
- verifierGated: Boolean(entry.verifierGated),
500
- checkpoint: Boolean(entry.checkpoint),
501
- candidateId: entry.candidateId,
502
- selectionId: entry.selectionId,
503
- verifierNodeId: entry.verifierNodeId,
504
- evidenceCount: (entry.evidence || []).length
505
- }))),
506
- reportSections: reportSections(run),
507
- ...(0, state_explosion_1.normalizeStateExplosionForEval)(run),
508
- ...(0, evidence_reasoning_1.normalizeEvidenceReasoningForEval)(run)
509
- };
510
- }
511
- function collectCandidateScores(run) {
512
- const scores = [];
513
- for (const candidate of run.candidates || []) {
514
- for (const scoreId of candidate.scores || []) {
515
- // Canonical nested score path — MUST match the writers (candidate-scoring.ts
516
- // persistScore, commit.ts): candidates/<candidateId>/scores/<scoreId>.json.
517
- // The old flat `<id>.<scoreId>.score.json` path was written by nobody, so the
518
- // candidate_score_parity eval metric silently scored empty placeholders.
519
- const scorePath = node_path_1.default.join(run.paths.candidatesDir || node_path_1.default.join(run.paths.runDir, "candidates"), (0, state_1.safeFileName)(candidate.id), "scores", `${(0, state_1.safeFileName)(scoreId)}.json`);
520
- if (node_fs_1.default.existsSync(scorePath)) {
521
- const score = (0, state_1.readJson)(scorePath);
522
- scores.push({
523
- candidateId: candidate.id,
524
- scoreId,
525
- criteria: score.criteria,
526
- total: score.total,
527
- maxTotal: score.maxTotal,
528
- normalized: score.normalized,
529
- verdict: score.verdict,
530
- evidenceCount: Array.isArray(score.evidence) ? score.evidence.length : 0,
531
- notes: score.notes
532
- });
533
- }
534
- else {
535
- scores.push({ candidateId: candidate.id, scoreId, missing: true });
536
- }
537
- }
538
- }
539
- return scores;
540
- }
541
- function reportSections(run) {
542
- if (!node_fs_1.default.existsSync(run.paths.report))
543
- return [];
544
- const text = node_fs_1.default.readFileSync(run.paths.report, "utf8");
545
- return text.split("\n").filter((line) => /^#+\s+/.test(line)).map((line) => line.replace(/^#+\s+/, "").trim()).sort();
546
- }
547
- function loadSnapshot(target) {
548
- const resolved = resolveSnapshotPath(target);
549
- const snapshot = (0, state_1.readJson)(resolved);
550
- if (snapshot.kind !== "multi-agent-replay-snapshot")
551
- throw new Error(`Not a replay snapshot: ${resolved}`);
552
- assertSnapshotShape(snapshot, resolved);
553
- return snapshot;
554
- }
555
- function loadReplay(target) {
556
- const resolved = resolveReplayPath(target);
557
- const replay = (0, state_1.readJson)(resolved);
558
- if (replay.kind !== "multi-agent-replay-run")
559
- throw new Error(`Not a replay run: ${resolved}`);
560
- assertReplayShape(replay, resolved);
561
- return replay;
562
- }
563
- function loadBaselineNormalized(target) {
564
- const snapshotPath = resolveSnapshotPath(target);
565
- const snapshot = (0, state_1.readJson)(snapshotPath);
566
- if (snapshot.kind !== "multi-agent-replay-snapshot")
567
- throw new Error(`Not a replay snapshot: ${snapshotPath}`);
568
- assertSnapshotShape(snapshot, snapshotPath);
569
- return { id: snapshot.id, path: snapshotPath, normalized: snapshot.normalized };
570
- }
571
- function assertSnapshotShape(snapshot, file) {
572
- if (!snapshot.id)
573
- throw new Error(`Replay snapshot missing id: ${file}`);
574
- if (!snapshot.runId)
575
- throw new Error(`Replay snapshot missing runId: ${file}`);
576
- if (!snapshot.paths || !snapshot.paths.suiteDir || !snapshot.paths.snapshotPath) {
577
- throw new Error(`Replay snapshot missing paths.suiteDir or paths.snapshotPath: ${file}`);
578
- }
579
- assertNormalizedShape(snapshot.normalized, `Replay snapshot missing normalized section: ${file}`);
580
- }
581
- function assertReplayShape(replay, file) {
582
- if (!replay.id)
583
- throw new Error(`Replay run missing id: ${file}`);
584
- if (!replay.snapshotId)
585
- throw new Error(`Replay run missing snapshotId: ${file}`);
586
- if (replay.status !== "completed" && replay.status !== "failed") {
587
- throw new Error(`Replay run has unsupported status ${String(replay.status)}: ${file}`);
588
- }
589
- if (!replay.paths || !replay.paths.suiteDir || !replay.paths.replayRunPath || !replay.paths.snapshotPath) {
590
- throw new Error(`Replay run missing paths.suiteDir, paths.replayRunPath, or paths.snapshotPath: ${file}`);
591
- }
592
- if (!Array.isArray(replay.errors))
593
- throw new Error(`Replay run errors must be an array: ${file}`);
594
- assertNormalizedShape(replay.replay, `Replay run missing replay section: ${file}`);
595
- }
596
- function assertNormalizedShape(value, message) {
597
- if (!value || typeof value !== "object" || Array.isArray(value))
598
- throw new Error(message);
599
- for (const key of METRIC_SECTIONS.map((entry) => entry.section)) {
600
- if (key === "workflow") {
601
- if (!value.workflow || typeof value.workflow !== "object" || Array.isArray(value.workflow))
602
- throw new Error(`${message}; workflow must be an object`);
603
- }
604
- else if (!Array.isArray(value[key])) {
605
- throw new Error(`${message}; ${String(key)} must be an array`);
606
- }
607
- }
608
- }
609
- function loadOrCompareForTarget(target) {
610
- const suiteDir = resolveSuiteDir(target);
611
- const comparisonPath = node_path_1.default.join(suiteDir, "comparison.json");
612
- const replayPath = resolveReplayPath(target);
613
- if (node_fs_1.default.existsSync(comparisonPath)) {
614
- const comparison = (0, state_1.readJson)(comparisonPath);
615
- if (comparison.paths.replayPath === replayPath)
616
- return comparison;
617
- }
618
- return compareMultiAgentReplay(node_path_1.default.join(suiteDir, "snapshot.json"), replayPath);
619
- }
620
- function resolveSnapshotPath(target) {
621
- const resolved = resolveTargetPath(target);
622
- if (node_fs_1.default.existsSync(resolved) && node_fs_1.default.statSync(resolved).isDirectory())
623
- return node_path_1.default.join(resolved, "snapshot.json");
624
- if (node_fs_1.default.existsSync(resolved))
625
- return resolved;
626
- return node_path_1.default.join(process.cwd(), ".cw", "evals", (0, state_1.safeFileName)(target), "snapshot.json");
627
- }
628
- function resolveReplayPath(target) {
629
- const resolved = resolveTargetPath(target);
630
- if (node_fs_1.default.existsSync(resolved) && node_fs_1.default.statSync(resolved).isDirectory())
631
- return node_path_1.default.join(resolved, "replay-run.json");
632
- if (node_fs_1.default.existsSync(resolved))
633
- return resolved;
634
- return node_path_1.default.join(process.cwd(), ".cw", "evals", (0, state_1.safeFileName)(target), "replay-run.json");
635
- }
636
- function resolveSuiteDir(target) {
637
- const resolved = resolveTargetPath(target);
638
- if (node_fs_1.default.existsSync(resolved)) {
639
- if (node_fs_1.default.statSync(resolved).isDirectory())
640
- return resolved;
641
- const value = (0, state_1.readJson)(resolved);
642
- if (value.paths?.suiteDir)
643
- return value.paths.suiteDir;
644
- return node_path_1.default.dirname(resolved);
645
- }
646
- return node_path_1.default.join(process.cwd(), ".cw", "evals", (0, state_1.safeFileName)(target));
647
- }
648
- function resolveTargetPath(target) {
649
- if (!target)
650
- throw new Error("Missing eval target");
651
- return node_path_1.default.isAbsolute(target) ? target : node_path_1.default.resolve(target);
652
- }
653
- function evalSuiteDir(cwd, suiteId) {
654
- return node_path_1.default.join(cwd, ".cw", "evals", (0, state_1.safeFileName)(suiteId));
655
- }
656
- function writeSuite(suite) {
657
- (0, state_1.writeJson)(node_path_1.default.join(suite.paths.suiteDir, "suite.json"), suite);
658
- }
659
- function loadSuiteFromDir(suiteDir) {
660
- const suitePath = node_path_1.default.join(suiteDir, "suite.json");
661
- if (node_fs_1.default.existsSync(suitePath))
662
- return (0, state_1.readJson)(suitePath);
663
- return {
664
- schemaVersion: 1,
665
- id: node_path_1.default.basename(suiteDir),
666
- title: `Multi-Agent Eval Suite ${node_path_1.default.basename(suiteDir)}`,
667
- createdAt: now(),
668
- cases: [],
669
- paths: { suiteDir, snapshotPath: node_path_1.default.join(suiteDir, "snapshot.json") }
670
- };
671
- }
672
- function now() {
673
- return new Date().toISOString();
674
- }
675
- function metricLine(score, id) {
676
- const metric = score.metrics.find((entry) => entry.id === id);
677
- return `- ${id}: ${metric?.status || "missing"} - ${metric?.reason || "metric missing"}`;
678
- }