cool-workflow 0.1.97 → 0.2.0

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 (309) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/README.md +11 -2
  4. package/apps/architecture-review/app.json +1 -1
  5. package/apps/architecture-review-fast/app.json +1 -1
  6. package/apps/end-to-end-golden-path/app.json +1 -1
  7. package/apps/pr-review-fix-ci/app.json +1 -1
  8. package/apps/release-cut/app.json +1 -1
  9. package/apps/research-synthesis/app.json +1 -1
  10. package/dist/cli/dispatch.js +236 -0
  11. package/dist/cli/entry.js +120 -0
  12. package/dist/cli/io.js +21 -4
  13. package/dist/cli/parseargv.js +157 -0
  14. package/dist/cli.js +6 -33
  15. package/dist/core/capability-table.js +3534 -0
  16. package/dist/core/format/help.js +314 -0
  17. package/dist/{state-explosion/format.js → core/format/state-explosion-text.js} +10 -1
  18. package/dist/core/hash.js +137 -0
  19. package/dist/core/multi-agent/candidate-scoring.js +219 -0
  20. package/dist/core/multi-agent/collaboration.js +481 -0
  21. package/dist/core/multi-agent/coordinator.js +515 -0
  22. package/dist/core/multi-agent/eval-replay.js +306 -0
  23. package/dist/core/multi-agent/runtime.js +929 -0
  24. package/dist/core/multi-agent/topology.js +298 -0
  25. package/dist/core/multi-agent/trust-policy.js +197 -0
  26. package/dist/core/pipeline/commit-gate.js +320 -0
  27. package/dist/{pipeline-contract.js → core/pipeline/contract.js} +24 -37
  28. package/dist/core/pipeline/dispatch.js +103 -0
  29. package/dist/core/pipeline/drive-decide.js +227 -0
  30. package/dist/core/pipeline/error-feedback.js +161 -0
  31. package/dist/core/pipeline/loop-expansion.js +124 -0
  32. package/dist/{result-normalize.js → core/pipeline/result-normalize.js} +14 -37
  33. package/dist/core/pipeline/runner.js +230 -0
  34. package/dist/{contract-migration.js → core/state/contract-migration.js} +68 -92
  35. package/dist/{state-migrations.js → core/state/migrations.js} +103 -96
  36. package/dist/core/state/node-projection.js +95 -0
  37. package/dist/core/state/node-snapshot.js +230 -0
  38. package/dist/core/state/run-paths.js +93 -0
  39. package/dist/{schema-validate.js → core/state/schema-validate.js} +35 -28
  40. package/dist/core/state/schema.js +50 -0
  41. package/dist/core/state/state-explosion/digest.js +243 -0
  42. package/dist/core/state/state-explosion/graph.js +527 -0
  43. package/dist/{state-explosion → core/state/state-explosion}/helpers.js +34 -3
  44. package/dist/core/state/state-explosion/report.js +187 -0
  45. package/dist/{state-explosion → core/state/state-explosion}/size.js +25 -7
  46. package/dist/{state-node.js → core/state/state-node.js} +90 -113
  47. package/dist/core/state/types.js +19 -0
  48. package/dist/{validation.js → core/state/validation.js} +64 -131
  49. package/dist/core/trust/evidence-grounding.js +134 -0
  50. package/dist/core/trust/ledger.js +199 -0
  51. package/dist/{telemetry-attestation.js → core/trust/telemetry-attestation.js} +94 -68
  52. package/dist/core/trust/telemetry-ledger.js +127 -0
  53. package/dist/core/types.js +20 -0
  54. package/dist/core/version.js +16 -0
  55. package/dist/{workflow-app-framework.js → core/workflow-apps/app-schema.js} +337 -426
  56. package/dist/mcp/dispatch.js +104 -0
  57. package/dist/mcp/server.js +144 -0
  58. package/dist/mcp-server.js +6 -84
  59. package/dist/{agent-config.js → shell/agent-config.js} +118 -71
  60. package/dist/shell/app-run-cli.js +88 -0
  61. package/dist/shell/audit-cli.js +259 -0
  62. package/dist/shell/audit-provenance.js +83 -0
  63. package/dist/shell/candidate-scoring-io.js +459 -0
  64. package/dist/shell/collaboration-io.js +264 -0
  65. package/dist/shell/commit-summary.js +104 -0
  66. package/dist/shell/commit.js +290 -0
  67. package/dist/shell/coordinator-io.js +476 -0
  68. package/dist/shell/demo-cli.js +19 -0
  69. package/dist/shell/dispatch.js +162 -0
  70. package/dist/{doctor.js → shell/doctor.js} +123 -56
  71. package/dist/shell/drive.js +873 -0
  72. package/dist/shell/error-feedback-io.js +305 -0
  73. package/dist/shell/eval-io.js +473 -0
  74. package/dist/{multi-agent-eval/format.js → shell/eval-text.js} +78 -49
  75. package/dist/{evidence-reasoning.js → shell/evidence-reasoning.js} +124 -255
  76. package/dist/shell/exec-backend-cli.js +88 -0
  77. package/dist/shell/execution-backend/agent.js +475 -0
  78. package/dist/shell/execution-backend/ci.js +15 -0
  79. package/dist/shell/execution-backend/container.js +69 -0
  80. package/dist/shell/execution-backend/envelopes.js +55 -0
  81. package/dist/shell/execution-backend/local.js +113 -0
  82. package/dist/shell/execution-backend/probes.js +175 -0
  83. package/dist/shell/execution-backend/registry.js +402 -0
  84. package/dist/shell/execution-backend/remote.js +128 -0
  85. package/dist/shell/execution-backend/types.js +11 -0
  86. package/dist/shell/feedback-cli.js +81 -0
  87. package/dist/shell/feedback-operations.js +48 -0
  88. package/dist/shell/fs-atomic.js +276 -0
  89. package/dist/shell/harness.js +98 -0
  90. package/dist/shell/ledger-cli.js +212 -0
  91. package/dist/shell/ledger-io.js +169 -0
  92. package/dist/shell/man-cli.js +89 -0
  93. package/dist/shell/metrics-cli.js +98 -0
  94. package/dist/shell/multi-agent-cli.js +1002 -0
  95. package/dist/shell/multi-agent-host.js +563 -0
  96. package/dist/shell/multi-agent-io.js +387 -0
  97. package/dist/{multi-agent-operator-ux.js → shell/multi-agent-operator-ux.js} +234 -191
  98. package/dist/shell/node-store.js +124 -0
  99. package/dist/{observability/format.js → shell/observability-format.js} +7 -1
  100. package/dist/{observability/intake.js → shell/observability-intake.js} +79 -56
  101. package/dist/{observability.js → shell/observability.js} +159 -332
  102. package/dist/{onramp.js → shell/onramp.js} +11 -0
  103. package/dist/{operator-ux/format.js → shell/operator-ux-text.js} +250 -239
  104. package/dist/shell/operator-ux.js +431 -0
  105. package/dist/shell/orchestrator.js +231 -0
  106. package/dist/shell/pipeline-cli.js +667 -0
  107. package/dist/shell/pipeline.js +217 -0
  108. package/dist/shell/reclamation-io.js +1366 -0
  109. package/dist/shell/registry-cli.js +329 -0
  110. package/dist/{remote-source.js → shell/remote-source.js} +12 -5
  111. package/dist/shell/report-cli.js +101 -0
  112. package/dist/shell/report-view-cli.js +117 -0
  113. package/dist/{orchestrator → shell}/report.js +289 -282
  114. package/dist/shell/reporter.js +62 -0
  115. package/dist/shell/run-export-cli.js +106 -0
  116. package/dist/shell/run-export.js +680 -0
  117. package/dist/shell/run-registry-io.js +1014 -0
  118. package/dist/shell/run-store.js +164 -0
  119. package/dist/{sandbox-profile.js → shell/sandbox-profile.js} +134 -95
  120. package/dist/{scheduler.js → shell/scheduler-io.js} +248 -48
  121. package/dist/shell/scheduling-io.js +311 -0
  122. package/dist/shell/state-cli.js +181 -0
  123. package/dist/shell/state-explosion-cli.js +197 -0
  124. package/dist/shell/telemetry-cli.js +85 -0
  125. package/dist/{telemetry-demo.js → shell/telemetry-demo.js} +149 -119
  126. package/dist/shell/telemetry-ledger-io.js +132 -0
  127. package/dist/{term.js → shell/term.js} +36 -46
  128. package/dist/shell/topology-io.js +361 -0
  129. package/dist/shell/trust-audit.js +471 -0
  130. package/dist/{multi-agent-trust.js → shell/trust-policy-io.js} +67 -205
  131. package/dist/shell/verifier.js +48 -0
  132. package/dist/shell/workbench-host.js +250 -0
  133. package/dist/shell/workbench-text.js +18 -0
  134. package/dist/shell/workbench.js +175 -0
  135. package/dist/shell/worker-cli.js +124 -0
  136. package/dist/shell/worker-isolation.js +852 -0
  137. package/dist/shell/workflow-app-loader.js +650 -0
  138. package/docs/agent-delegation-drive.7.md +4 -0
  139. package/docs/cli-mcp-parity.7.md +284 -211
  140. package/docs/contract-migration-tooling.7.md +4 -0
  141. package/docs/control-plane-scheduling.7.md +4 -0
  142. package/docs/cross-agent-ledger.7.md +217 -0
  143. package/docs/designs/handoff-ledger.md +145 -0
  144. package/docs/durable-state-and-locking.7.md +4 -0
  145. package/docs/evidence-adoption-reasoning-chain.7.md +4 -0
  146. package/docs/execution-backends.7.md +4 -0
  147. package/docs/handoff-setup.md +120 -0
  148. package/docs/multi-agent-cli-mcp-surface.7.md +4 -0
  149. package/docs/multi-agent-eval-replay-harness.7.md +4 -0
  150. package/docs/multi-agent-operator-ux.7.md +4 -0
  151. package/docs/node-snapshot-diff-replay.7.md +4 -0
  152. package/docs/observability-cost-accounting.7.md +4 -0
  153. package/docs/project-index.md +143 -71
  154. package/docs/real-execution-backends.7.md +4 -0
  155. package/docs/release-and-migration.7.md +4 -0
  156. package/docs/release-tooling.7.md +4 -0
  157. package/docs/run-registry-control-plane.7.md +4 -0
  158. package/docs/run-retention-reclamation.7.md +25 -0
  159. package/docs/state-explosion-management.7.md +4 -0
  160. package/docs/team-collaboration.7.md +4 -0
  161. package/docs/web-desktop-workbench.7.md +4 -0
  162. package/manifest/plugin.manifest.json +1 -1
  163. package/manifest/source-context-profiles.json +9 -13
  164. package/package.json +1 -1
  165. package/scripts/agents/codex-agent.js +34 -4
  166. package/scripts/agents/cw-attest-wrap.js +2 -2
  167. package/scripts/bump-version.js +4 -3
  168. package/scripts/canonical-apps.js +4 -4
  169. package/scripts/children/batch-delegate-child.js +30 -10
  170. package/scripts/dogfood-architecture-review.js +2 -3
  171. package/scripts/dogfood-release.js +3 -3
  172. package/scripts/gen-parity-doc.js +15 -2
  173. package/scripts/golden-path.js +4 -4
  174. package/scripts/onramp-check.js +1 -1
  175. package/scripts/parity-check.js +38 -21
  176. package/scripts/release-flow.js +9 -3
  177. package/scripts/sync-project-index.js +51 -27
  178. package/scripts/validate-run-state-schema.js +2 -2
  179. package/scripts/version-sync-check.js +30 -30
  180. package/dist/candidate-scoring.js +0 -729
  181. package/dist/capability-core.js +0 -1186
  182. package/dist/capability-registry.js +0 -879
  183. package/dist/cli/command-surface.js +0 -490
  184. package/dist/cli/format.js +0 -56
  185. package/dist/cli/handlers/audit.js +0 -82
  186. package/dist/cli/handlers/blackboard.js +0 -81
  187. package/dist/cli/handlers/candidate.js +0 -40
  188. package/dist/cli/handlers/clones.js +0 -34
  189. package/dist/cli/handlers/collaboration.js +0 -61
  190. package/dist/cli/handlers/eval.js +0 -40
  191. package/dist/cli/handlers/maintenance.js +0 -107
  192. package/dist/cli/handlers/multi-agent.js +0 -165
  193. package/dist/cli/handlers/node.js +0 -41
  194. package/dist/cli/handlers/operational.js +0 -155
  195. package/dist/cli/handlers/operator.js +0 -146
  196. package/dist/cli/handlers/registry.js +0 -68
  197. package/dist/cli/handlers/run.js +0 -153
  198. package/dist/cli/handlers/scheduling.js +0 -132
  199. package/dist/cli/handlers/workbench.js +0 -41
  200. package/dist/cli/handlers/worker.js +0 -45
  201. package/dist/cli/run-summary.js +0 -45
  202. package/dist/clones.js +0 -162
  203. package/dist/collaboration.js +0 -726
  204. package/dist/commit.js +0 -592
  205. package/dist/compare.js +0 -18
  206. package/dist/coordinator/classify.js +0 -45
  207. package/dist/coordinator/paths.js +0 -42
  208. package/dist/coordinator/util.js +0 -126
  209. package/dist/coordinator.js +0 -990
  210. package/dist/daemon.js +0 -44
  211. package/dist/dispatch.js +0 -250
  212. package/dist/drive.js +0 -827
  213. package/dist/error-feedback.js +0 -419
  214. package/dist/evidence-grounding.js +0 -184
  215. package/dist/execution-backend/agent.js +0 -294
  216. package/dist/execution-backend/probes.js +0 -112
  217. package/dist/execution-backend/util.js +0 -47
  218. package/dist/execution-backend.js +0 -961
  219. package/dist/gates.js +0 -48
  220. package/dist/harness.js +0 -61
  221. package/dist/loop-expansion.js +0 -60
  222. package/dist/mcp/tool-call.js +0 -434
  223. package/dist/mcp/tool-definitions.js +0 -1040
  224. package/dist/mcp-surface.js +0 -30
  225. package/dist/multi-agent/graph.js +0 -84
  226. package/dist/multi-agent/helpers.js +0 -141
  227. package/dist/multi-agent/ids.js +0 -20
  228. package/dist/multi-agent/paths.js +0 -22
  229. package/dist/multi-agent-eval/normalize.js +0 -51
  230. package/dist/multi-agent-eval.js +0 -678
  231. package/dist/multi-agent-host.js +0 -777
  232. package/dist/multi-agent.js +0 -984
  233. package/dist/node-projection.js +0 -59
  234. package/dist/node-snapshot.js +0 -260
  235. package/dist/operator-ux.js +0 -631
  236. package/dist/orchestrator/app-operations.js +0 -211
  237. package/dist/orchestrator/audit-operations.js +0 -182
  238. package/dist/orchestrator/candidate-operations.js +0 -117
  239. package/dist/orchestrator/cli-options.js +0 -294
  240. package/dist/orchestrator/collaboration-operations.js +0 -86
  241. package/dist/orchestrator/feedback-operations.js +0 -81
  242. package/dist/orchestrator/host-operations.js +0 -78
  243. package/dist/orchestrator/lifecycle-operations.js +0 -626
  244. package/dist/orchestrator/migration-operations.js +0 -44
  245. package/dist/orchestrator/multi-agent-operations.js +0 -362
  246. package/dist/orchestrator/topology-operations.js +0 -84
  247. package/dist/orchestrator.js +0 -917
  248. package/dist/pipeline-runner.js +0 -285
  249. package/dist/reclamation/hash.js +0 -72
  250. package/dist/reclamation.js +0 -812
  251. package/dist/reporter.js +0 -67
  252. package/dist/run-export.js +0 -784
  253. package/dist/run-registry/derive.js +0 -175
  254. package/dist/run-registry/format.js +0 -124
  255. package/dist/run-registry/gc.js +0 -251
  256. package/dist/run-registry/policy.js +0 -16
  257. package/dist/run-registry/queue.js +0 -115
  258. package/dist/run-registry.js +0 -850
  259. package/dist/run-state-schema.js +0 -68
  260. package/dist/scheduling.js +0 -184
  261. package/dist/state-explosion.js +0 -1014
  262. package/dist/state.js +0 -367
  263. package/dist/telemetry-ledger.js +0 -196
  264. package/dist/topology.js +0 -565
  265. package/dist/triggers.js +0 -184
  266. package/dist/trust-audit.js +0 -644
  267. package/dist/types/blackboard.js +0 -2
  268. package/dist/types/candidate.js +0 -2
  269. package/dist/types/collaboration.js +0 -2
  270. package/dist/types/core.js +0 -2
  271. package/dist/types/drive.js +0 -10
  272. package/dist/types/error-feedback.js +0 -2
  273. package/dist/types/evidence-reasoning.js +0 -2
  274. package/dist/types/execution-backend.js +0 -2
  275. package/dist/types/multi-agent.js +0 -2
  276. package/dist/types/observability.js +0 -2
  277. package/dist/types/pipeline.js +0 -2
  278. package/dist/types/reclamation.js +0 -8
  279. package/dist/types/report-bundle.js +0 -6
  280. package/dist/types/result.js +0 -2
  281. package/dist/types/run-registry.js +0 -2
  282. package/dist/types/run.js +0 -2
  283. package/dist/types/sandbox.js +0 -2
  284. package/dist/types/schedule.js +0 -2
  285. package/dist/types/state-node.js +0 -2
  286. package/dist/types/topology.js +0 -2
  287. package/dist/types/trust.js +0 -2
  288. package/dist/types/workbench.js +0 -2
  289. package/dist/types/worker.js +0 -2
  290. package/dist/types/workflow-app.js +0 -2
  291. package/dist/types.js +0 -44
  292. package/dist/util/fingerprint.js +0 -19
  293. package/dist/util/fingerprint.test.js +0 -27
  294. package/dist/verifier.js +0 -78
  295. package/dist/version.js +0 -8
  296. package/dist/workbench-host.js +0 -182
  297. package/dist/workbench.js +0 -192
  298. package/dist/worker-accept/acceptance.js +0 -114
  299. package/dist/worker-accept/blackboard-fanout.js +0 -80
  300. package/dist/worker-accept/blackboard-linkage.js +0 -19
  301. package/dist/worker-accept/context.js +0 -2
  302. package/dist/worker-accept/telemetry-ledger.js +0 -126
  303. package/dist/worker-accept/validation.js +0 -77
  304. package/dist/worker-accept/verifier-completion.js +0 -73
  305. package/dist/worker-isolation/helpers.js +0 -51
  306. package/dist/worker-isolation/paths.js +0 -46
  307. package/dist/worker-isolation.js +0 -656
  308. package/dist/workflow-api.js +0 -131
  309. /package/dist/{types → core/types}/boundary.js +0 -0
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,8 +0,0 @@
1
- "use strict";
2
- // Run Retention & Provable Reclamation (v0.1.39) — type contracts.
3
- //
4
- // Reclamation frees disk WITHOUT violating the audit/replay moat. It is a
5
- // VERIFIABLE, append-only state transition: freeing bytes leaves behind a
6
- // hash-chained tombstone proving what was freed is reconstructable-or-worthless
7
- // and that the audit-essential subset is sealed. See docs/run-retention-reclamation.7.md.
8
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,6 +0,0 @@
1
- "use strict";
2
- // Verifiable report bundle — result shapes shared across the run-export verifier,
3
- // the capability-core producer (reportBundle), and the quickstart auto-bundle field
4
- // on QuickstartResult. Kept in types/ (a leaf) so types/drive.ts can reference
5
- // ReportBundleResult without a types->core import cycle.
6
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
package/dist/types/run.js DELETED
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
package/dist/types.js DELETED
@@ -1,44 +0,0 @@
1
- "use strict";
2
- // Barrel for the workflow type system. The declarations were split out of a
3
- // single 3k-line types.ts into domain files under ./types/; importers keep
4
- // importing from "./types" unchanged. Pure types — no runtime cost.
5
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
6
- if (k2 === undefined) k2 = k;
7
- var desc = Object.getOwnPropertyDescriptor(m, k);
8
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
9
- desc = { enumerable: true, get: function() { return m[k]; } };
10
- }
11
- Object.defineProperty(o, k2, desc);
12
- }) : (function(o, m, k, k2) {
13
- if (k2 === undefined) k2 = k;
14
- o[k2] = m[k];
15
- }));
16
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
17
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
18
- };
19
- Object.defineProperty(exports, "__esModule", { value: true });
20
- __exportStar(require("./types/core"), exports);
21
- __exportStar(require("./types/workflow-app"), exports);
22
- __exportStar(require("./types/result"), exports);
23
- __exportStar(require("./types/trust"), exports);
24
- __exportStar(require("./types/state-node"), exports);
25
- __exportStar(require("./types/pipeline"), exports);
26
- __exportStar(require("./types/error-feedback"), exports);
27
- __exportStar(require("./types/sandbox"), exports);
28
- __exportStar(require("./types/execution-backend"), exports);
29
- __exportStar(require("./types/boundary"), exports);
30
- __exportStar(require("./types/drive"), exports);
31
- __exportStar(require("./types/report-bundle"), exports);
32
- __exportStar(require("./types/multi-agent"), exports);
33
- __exportStar(require("./types/topology"), exports);
34
- __exportStar(require("./types/blackboard"), exports);
35
- __exportStar(require("./types/worker"), exports);
36
- __exportStar(require("./types/candidate"), exports);
37
- __exportStar(require("./types/evidence-reasoning"), exports);
38
- __exportStar(require("./types/run"), exports);
39
- __exportStar(require("./types/schedule"), exports);
40
- __exportStar(require("./types/run-registry"), exports);
41
- __exportStar(require("./types/reclamation"), exports);
42
- __exportStar(require("./types/workbench"), exports);
43
- __exportStar(require("./types/observability"), exports);
44
- __exportStar(require("./types/collaboration"), exports);
@@ -1,19 +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.fingerprintStrings = fingerprintStrings;
7
- exports.fingerprintRecords = fingerprintRecords;
8
- // Deterministic content fingerprint — the single canonical implementation.
9
- // Replaces duplicated copies in observability.ts and run-registry.ts (v0.1.95).
10
- // Pure function of its arguments; never imports run state or high-level modules.
11
- const node_crypto_1 = __importDefault(require("node:crypto"));
12
- function fingerprintStrings(values) {
13
- const hash = node_crypto_1.default.createHash("sha256");
14
- hash.update(JSON.stringify([...values].sort()));
15
- return `sha256:${hash.digest("hex").slice(0, 32)}`;
16
- }
17
- function fingerprintRecords(records) {
18
- return fingerprintStrings(records.map((r) => `${r.id}:${r.status || ""}`).sort());
19
- }
@@ -1,27 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- // Unit test for the canonical fingerprint utility (v0.1.95).
4
- // Pure function — no run state or tmpdir needed.
5
- const strict_1 = require("node:assert/strict");
6
- const node_test_1 = require("node:test");
7
- const fingerprint_1 = require("../util/fingerprint");
8
- (0, node_test_1.test)("fingerprintStrings returns a sha256: prefix", () => {
9
- const fp = (0, fingerprint_1.fingerprintStrings)(["a", "b"]);
10
- (0, strict_1.ok)(fp.startsWith("sha256:"), "must have sha256: prefix");
11
- (0, strict_1.equal)(fp.length, 32 + "sha256:".length, "must be 32 hex chars");
12
- });
13
- (0, node_test_1.test)("fingerprintStrings is deterministic and order-independent", () => {
14
- const a = (0, fingerprint_1.fingerprintStrings)(["b", "a", "c"]);
15
- const b = (0, fingerprint_1.fingerprintStrings)(["c", "b", "a"]);
16
- (0, strict_1.equal)(a, b, "same values in different order must produce same fingerprint");
17
- });
18
- (0, node_test_1.test)("fingerprintStrings produces distinct values for different inputs", () => {
19
- const a = (0, fingerprint_1.fingerprintStrings)(["x"]);
20
- const b = (0, fingerprint_1.fingerprintStrings)(["y"]);
21
- (0, strict_1.ok)(a !== b, "different inputs must produce different fingerprints");
22
- });
23
- (0, node_test_1.test)("fingerprintRecords uses id:status sorted", () => {
24
- const a = (0, fingerprint_1.fingerprintRecords)([{ id: "b", status: "ok" }, { id: "a", status: "fail" }]);
25
- const b = (0, fingerprint_1.fingerprintRecords)([{ id: "a", status: "fail" }, { id: "b", status: "ok" }]);
26
- (0, strict_1.equal)(a, b, "records in different order must produce same fingerprint");
27
- });
package/dist/verifier.js DELETED
@@ -1,78 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.assertTaskCanComplete = assertTaskCanComplete;
4
- exports.parseResultEnvelope = parseResultEnvelope;
5
- exports.taskRequiresEvidence = taskRequiresEvidence;
6
- exports.validateResultEnvelope = validateResultEnvelope;
7
- exports.validateRunGates = validateRunGates;
8
- const dispatch_1 = require("./dispatch");
9
- const evidence_grounding_1 = require("./evidence-grounding");
10
- const result_normalize_1 = require("./result-normalize");
11
- const schema_validate_1 = require("./schema-validate");
12
- function assertTaskCanComplete(run, task) {
13
- const runnablePhase = (0, dispatch_1.firstRunnablePhase)(run);
14
- if (!runnablePhase || runnablePhase.name !== task.phase) {
15
- throw new Error(`Phase gate blocked task ${task.id}; current runnable phase is ${runnablePhase?.name || "none"}`);
16
- }
17
- if (!["pending", "running"].includes(task.status)) {
18
- throw new Error(`Task ${task.id} cannot be completed from status ${task.status}`);
19
- }
20
- }
21
- // Ingest is delegated to the robust normalizer (v0.1.42): canonical
22
- // `{summary, findings, evidence}` passes through unchanged, but when the agent
23
- // uses its own shape (or prose) CW extracts findings from alternative keys and
24
- // DERIVES grounded evidence itself rather than capturing nothing.
25
- function parseResultEnvelope(markdown) {
26
- return (0, result_normalize_1.normalizeResultEnvelope)(markdown);
27
- }
28
- /** Whether a task's result MUST carry evidence (verify/verdict/synthesis tasks
29
- * and any task that opted in via requiresEvidence). The commit gate reuses this
30
- * so its evidence-grounding check matches the acceptance-time policy exactly. */
31
- function taskRequiresEvidence(task) {
32
- return Boolean(task.requiresEvidence ||
33
- /^verify[:/]/i.test(task.id) ||
34
- /^verdict[:/]/i.test(task.id) ||
35
- /^synthesis[:/]/i.test(task.id));
36
- }
37
- function validateResultEnvelope(task, result) {
38
- const mustHaveEvidence = taskRequiresEvidence(task);
39
- if (mustHaveEvidence && !(0, evidence_grounding_1.hasGroundedEvidence)(result.evidence)) {
40
- throw new Error(`Task ${task.id} requires grounded cw:result evidence (a path-like locator, URL, or namespace:value token — not free text)`);
41
- }
42
- for (const finding of result.findings || []) {
43
- validateFinding(task, finding);
44
- }
45
- // Track 3: if the task declared an output schema, the accepted result envelope
46
- // must conform. Fail-closed (throw ⇒ the drive parks the hop), consistent with
47
- // the checks above. No schema declared ⇒ no check (opt-in by declaration).
48
- if (task.schema) {
49
- const violations = (0, schema_validate_1.validateAgainstSchema)(result, task.schema);
50
- if (violations.length) {
51
- throw new Error(`Task ${task.id} result violates declared schema: ${violations.slice(0, 5).join("; ")}${violations.length > 5 ? ` (+${violations.length - 5} more)` : ""}`);
52
- }
53
- }
54
- }
55
- function validateRunGates(run) {
56
- const verdictTasks = run.tasks.filter((task) => /^verdict[:/]|^synthesis[:/]/i.test(task.id));
57
- for (const verdictTask of verdictTasks) {
58
- if (verdictTask.status !== "completed")
59
- continue;
60
- const verdictPhaseIndex = run.phases.findIndex((phase) => phase.name === verdictTask.phase);
61
- const earlierPhases = run.phases.slice(0, verdictPhaseIndex);
62
- const incompleteEarlier = earlierPhases.find((phase) => phase.status !== "completed");
63
- if (incompleteEarlier) {
64
- throw new Error(`Verdict gate blocked ${verdictTask.id}; phase ${incompleteEarlier.name} is not complete`);
65
- }
66
- }
67
- }
68
- function validateFinding(task, finding) {
69
- if (!finding.id)
70
- throw new Error(`Task ${task.id} has a finding without id`);
71
- if (finding.classification &&
72
- !["real", "conditional", "non-issue", "unknown"].includes(finding.classification)) {
73
- throw new Error(`Task ${task.id} finding ${finding.id} has invalid classification`);
74
- }
75
- if (["P0", "P1", "P2"].includes(finding.severity || "") && !(0, evidence_grounding_1.hasGroundedEvidence)(finding.evidence)) {
76
- throw new Error(`Task ${task.id} finding ${finding.id} severity ${finding.severity} requires grounded evidence (a path-like locator, URL, or namespace:value token)`);
77
- }
78
- }
package/dist/version.js DELETED
@@ -1,8 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.MIN_SUPPORTED_RUN_STATE_SCHEMA_VERSION = exports.LEGACY_RUN_STATE_SCHEMA_VERSION = exports.CURRENT_RUN_STATE_SCHEMA_VERSION = exports.WORKFLOW_APP_SCHEMA_VERSION = exports.CURRENT_COOL_WORKFLOW_VERSION = void 0;
4
- exports.CURRENT_COOL_WORKFLOW_VERSION = "0.1.97";
5
- exports.WORKFLOW_APP_SCHEMA_VERSION = 1;
6
- exports.CURRENT_RUN_STATE_SCHEMA_VERSION = 1;
7
- exports.LEGACY_RUN_STATE_SCHEMA_VERSION = 0;
8
- exports.MIN_SUPPORTED_RUN_STATE_SCHEMA_VERSION = 0;
@@ -1,182 +0,0 @@
1
- "use strict";
2
- // Web / Desktop Workbench host (v0.1.30) — a thin, OPTIONAL localhost renderer.
3
- //
4
- // BSD discipline:
5
- // - LEAST PRIVILEGE, LOCAL BY DEFAULT. Binds 127.0.0.1 ONLY, serves read-only
6
- // derived views, exposes nothing beyond the current user's `.cw/` scope and
7
- // the v0.1.28 registry's registered repos. It also rejects non-localhost Host
8
- // headers (DNS-rebinding defense) and fails closed on anything it cannot read.
9
- // - READ-ONLY BY DEFAULT. Every route is GET; any write verb is refused 405.
10
- // The host offers no actions — it is pure inspection. (A future action would
11
- // have to route through a declared capability core entry, never a parallel
12
- // path, so it stays parity-gated.)
13
- // - NO HIDDEN DASHBOARD / OPTIONAL SURFACE. The host imports the kernel, never
14
- // the reverse. It holds zero authoritative state: every response is re-derived
15
- // on demand from disk via the SAME core entries the CLI/MCP use. The committed
16
- // `dist/` + plain `node` runtime keep working with this file deleted.
17
- //
18
- // See src/workbench.ts and docs/web-desktop-workbench.7.md.
19
- var __importDefault = (this && this.__importDefault) || function (mod) {
20
- return (mod && mod.__esModule) ? mod : { "default": mod };
21
- };
22
- Object.defineProperty(exports, "__esModule", { value: true });
23
- exports.WorkbenchHost = void 0;
24
- const node_http_1 = __importDefault(require("node:http"));
25
- const node_fs_1 = __importDefault(require("node:fs"));
26
- const node_path_1 = __importDefault(require("node:path"));
27
- const node_crypto_1 = __importDefault(require("node:crypto"));
28
- const workbench_1 = require("./workbench");
29
- const ALLOWED_HOSTNAMES = new Set(["127.0.0.1", "localhost", "::1", "[::1]"]);
30
- const CONTENT_TYPES = {
31
- ".html": "text/html; charset=utf-8",
32
- ".js": "text/javascript; charset=utf-8",
33
- ".css": "text/css; charset=utf-8",
34
- ".json": "application/json; charset=utf-8",
35
- ".svg": "image/svg+xml"
36
- };
37
- class WorkbenchHost {
38
- runner;
39
- cwd;
40
- port;
41
- scope;
42
- host = "127.0.0.1";
43
- server;
44
- constructor(options) {
45
- this.runner = options.runner;
46
- this.cwd = node_path_1.default.resolve(String(options.cwd || process.cwd()));
47
- this.port = options.port && options.port > 0 ? Math.floor(options.port) : workbench_1.WORKBENCH_DEFAULT_PORT;
48
- this.scope = options.scope === "repo" ? "repo" : "home";
49
- }
50
- /** The canonical serve descriptor — identical to `cw workbench serve --json`. */
51
- descriptor(once) {
52
- return (0, workbench_1.buildWorkbenchServeDescriptor)(this.runner, { cwd: this.cwd, port: this.port, scope: this.scope, once });
53
- }
54
- /** Start listening on loopback only. Resolves with the actually-bound port
55
- * (an ephemeral 0 becomes a real port — useful for tests). */
56
- listen() {
57
- const server = node_http_1.default.createServer((req, res) => this.handle(req, res));
58
- this.server = server;
59
- return new Promise((resolve, reject) => {
60
- server.once("error", reject);
61
- // Bind the loopback interface ONLY — never a public address.
62
- server.listen(this.port, this.host, () => {
63
- const address = server.address();
64
- const port = address && typeof address === "object" ? address.port : this.port;
65
- resolve({ host: this.host, port });
66
- });
67
- });
68
- }
69
- close() {
70
- return new Promise((resolve) => {
71
- if (!this.server)
72
- return resolve();
73
- this.server.close(() => resolve());
74
- });
75
- }
76
- /** Run until interrupted (the CLI default `workbench serve`). */
77
- async run() {
78
- const bound = await this.listen();
79
- process.stdout.write(`${JSON.stringify({ ...this.descriptor(false), boundPort: bound.port })}\n`);
80
- }
81
- handle(req, res) {
82
- try {
83
- // Fail closed on anything but a localhost GET.
84
- if (!isLocalHost(req.headers.host))
85
- return this.send(res, 403, { error: "forbidden: non-localhost Host header" });
86
- if ((req.method || "GET").toUpperCase() !== "GET") {
87
- return this.send(res, 405, { error: "read-only: only GET is permitted" }, { Allow: "GET" });
88
- }
89
- // Optional token auth (CW_WORKBENCH_TOKEN). When set, every request must
90
- // carry the token as an Authorization: Bearer header or ?token= query param.
91
- // Off by default — single-user loopback is already gated by the OS boundary.
92
- const url = new URL(req.url || "/", `http://${this.host}`);
93
- const requiredToken = (process.env.CW_WORKBENCH_TOKEN || "").trim();
94
- if (requiredToken) {
95
- const bearer = (req.headers.authorization || "").replace(/^Bearer\s+/i, "").trim();
96
- const queryToken = url.searchParams.get("token") || "";
97
- const tokenBuf = Buffer.from(requiredToken);
98
- const bearerBuf = Buffer.from(bearer);
99
- const queryBuf = Buffer.from(queryToken);
100
- const tokenOk = bearerBuf.length === tokenBuf.length && node_crypto_1.default.timingSafeEqual(bearerBuf, tokenBuf);
101
- const queryOk = queryBuf.length === tokenBuf.length && node_crypto_1.default.timingSafeEqual(queryBuf, tokenBuf);
102
- if (!tokenOk && !queryOk) {
103
- return this.send(res, 401, { error: "unauthorized: token mismatch" });
104
- }
105
- }
106
- const route = decodeURIComponent(url.pathname);
107
- if (route === "/" || route === "/index.html")
108
- return this.sendAsset(res, "index.html");
109
- if (route.startsWith("/ui/"))
110
- return this.sendAsset(res, route.slice("/ui/".length));
111
- if (route === "/api/serve")
112
- return this.send(res, 200, this.descriptor(true));
113
- if (route === "/api/index") {
114
- const args = Object.fromEntries(url.searchParams.entries());
115
- return this.send(res, 200, (0, workbench_1.buildWorkbenchIndex)(this.runner, { cwd: this.cwd, scope: this.scope, ...args }));
116
- }
117
- const runMatch = /^\/api\/run\/([^/]+)$/.exec(route);
118
- if (runMatch) {
119
- return this.send(res, 200, (0, workbench_1.buildWorkbenchRunView)(this.runner.withBaseDir(this.cwd), runMatch[1]));
120
- }
121
- this.send(res, 404, { error: `no such read-only view: ${route}` });
122
- }
123
- catch (error) {
124
- this.send(res, 500, { error: error instanceof Error ? error.message : String(error) });
125
- }
126
- }
127
- /** Serve a static UI asset from disk, re-read on every request (no caching of
128
- * authoritative state). Path-traversal is refused; a missing asset is an
129
- * honest 404 — the framework ships fine without the UI installed. */
130
- sendAsset(res, relative) {
131
- const uiRoot = (0, workbench_1.workbenchUiRoot)(this.runner);
132
- const resolved = node_path_1.default.resolve(uiRoot, relative);
133
- if (resolved !== uiRoot && !resolved.startsWith(uiRoot + node_path_1.default.sep)) {
134
- return this.send(res, 403, { error: "forbidden: path traversal" });
135
- }
136
- let body;
137
- try {
138
- body = node_fs_1.default.readFileSync(resolved);
139
- }
140
- catch {
141
- if (relative === "index.html") {
142
- return this.sendRaw(res, 200, CONTENT_TYPES[".html"], Buffer.from(FALLBACK_HTML(uiRoot)));
143
- }
144
- return this.send(res, 404, { error: `UI asset not installed: ${relative}` });
145
- }
146
- this.sendRaw(res, 200, CONTENT_TYPES[node_path_1.default.extname(resolved)] || "application/octet-stream", body);
147
- }
148
- send(res, status, body, headers = {}) {
149
- this.sendRaw(res, status, CONTENT_TYPES[".json"], Buffer.from(JSON.stringify(body, null, 2)), headers);
150
- }
151
- sendRaw(res, status, contentType, body, headers = {}) {
152
- res.writeHead(status, {
153
- "Content-Type": contentType,
154
- "Cache-Control": "no-store",
155
- "X-Content-Type-Options": "nosniff",
156
- ...headers
157
- });
158
- res.end(body);
159
- }
160
- }
161
- exports.WorkbenchHost = WorkbenchHost;
162
- function isLocalHost(hostHeader) {
163
- if (!hostHeader)
164
- return true; // HTTP/1.0 / no Host — loopback bind already constrains us.
165
- const hostname = hostHeader.replace(/:\d+$/, "");
166
- return ALLOWED_HOSTNAMES.has(hostname);
167
- }
168
- function FALLBACK_HTML(uiRoot) {
169
- return [
170
- "<!doctype html><meta charset=utf-8><title>Cool Workflow Workbench</title>",
171
- "<body style=\"font-family:system-ui;margin:2rem;color:#222\">",
172
- "<h1>Cool Workflow Workbench</h1>",
173
- "<p>The static UI assets are not installed at:</p>",
174
- `<pre>${escapeHtml(uiRoot)}</pre>`,
175
- "<p>The read-only JSON views are still served:</p>",
176
- "<ul><li><a href=\"/api/index\">/api/index</a></li><li><code>/api/run/&lt;runId&gt;</code></li><li><a href=\"/api/serve\">/api/serve</a></li></ul>",
177
- "</body>"
178
- ].join("");
179
- }
180
- function escapeHtml(value) {
181
- return value.replace(/[&<>]/g, (ch) => (ch === "&" ? "&amp;" : ch === "<" ? "&lt;" : "&gt;"));
182
- }
package/dist/workbench.js DELETED
@@ -1,192 +0,0 @@
1
- "use strict";
2
- // Web / Desktop Workbench core (v0.1.30) — the SINGLE source of the human
3
- // console's view models, and a THIRD FRONT DOOR over ONE mechanism.
4
- //
5
- // BSD discipline:
6
- // - MECHANISM VS POLICY. The kernel + durable `.cw/` state are the mechanism.
7
- // The CLI renders for human speed, MCP for machine context, and the Workbench
8
- // for human inspection at a glance. All three are presentation POLICY over the
9
- // same data. This module computes, decides, and stores NOTHING the CLI/MCP
10
- // cannot already produce — every panel embeds, verbatim, the canonical
11
- // `--json` payload of ONE already-declared capability, assembled by calling
12
- // the SAME runner core entries the CLI and MCP route through.
13
- // - NO HIDDEN DASHBOARD. These are DERIVED, read-only projections. They hold no
14
- // authoritative state; refresh re-derives everything from disk. Delete the
15
- // host process and nothing is lost — the data is the files.
16
- // - EXPLICIT, INSPECTABLE, FAIL CLOSED. When a source capability is unreadable
17
- // (e.g. a run with no blackboard yet, or unresolvable state), the panel is
18
- // rendered `absent` with the honest error; we never fabricate a view.
19
- //
20
- // See docs/web-desktop-workbench.7.md, src/capability-registry.ts, and the
21
- // v0.1.27 parity contract (docs/cli-mcp-parity.7.md).
22
- var __importDefault = (this && this.__importDefault) || function (mod) {
23
- return (mod && mod.__esModule) ? mod : { "default": mod };
24
- };
25
- Object.defineProperty(exports, "__esModule", { value: true });
26
- exports.WORKBENCH_UI_RELATIVE = exports.WORKBENCH_DEFAULT_PORT = void 0;
27
- exports.buildWorkbenchRunView = buildWorkbenchRunView;
28
- exports.buildWorkbenchIndex = buildWorkbenchIndex;
29
- exports.workbenchUiRoot = workbenchUiRoot;
30
- exports.buildWorkbenchServeDescriptor = buildWorkbenchServeDescriptor;
31
- const capability_core_1 = require("./capability-core");
32
- const node_path_1 = __importDefault(require("node:path"));
33
- const node_fs_1 = __importDefault(require("node:fs"));
34
- /** Default loopback port. Local by default, least privilege — never a public
35
- * interface. Overridable with `--port`. */
36
- exports.WORKBENCH_DEFAULT_PORT = 7717;
37
- /** Relative location of the optional, dependency-light static UI assets. Kept
38
- * OUT of the kernel: the host reads them lazily at request time, so the framework
39
- * builds and runs with the Workbench (and these files) absent. */
40
- exports.WORKBENCH_UI_RELATIVE = node_path_1.default.join("ui", "workbench");
41
- // ---------------------------------------------------------------------------
42
- // Panel assembly — each panel IS one capability payload, embedded verbatim.
43
- // ---------------------------------------------------------------------------
44
- /** Render one panel by invoking its single source capability. On success `data`
45
- * equals `cw <cmd> --json` byte-for-byte; on failure the panel is `absent` with
46
- * the honest reason (fail closed) — exactly what the CLI would report. */
47
- function panel(capability, cli, mcp, produce) {
48
- try {
49
- return { capability, cli, mcp, status: "present", data: produce() };
50
- }
51
- catch (error) {
52
- return { capability, cli, mcp, status: "absent", error: error instanceof Error ? error.message : String(error) };
53
- }
54
- }
55
- function buildPanels(runner, runId) {
56
- return {
57
- // Run graph — operator + multi-agent, including the v0.1.25 compact and
58
- // critical-path views. Backend ids/attestations (v0.1.29) ride on the nodes.
59
- graph: {
60
- operator: panel("graph", `cw graph ${runId} --json`, "cw_operator_graph", () => runner.operatorGraph(runId)),
61
- multiAgent: panel("multi-agent.graph", `cw multi-agent graph ${runId} --json`, "cw_multi_agent_graph", () => runner.multiAgentOperatorGraph(runId)),
62
- compact: panel("multi-agent.graph.compact", `cw multi-agent graph ${runId} --view compact --json`, "cw_multi_agent_graph_compact", () => runner.multiAgentGraphView(runId, { view: "compact" })),
63
- criticalPath: panel("multi-agent.graph.compact", `cw multi-agent graph ${runId} --view critical-path --json`, "cw_multi_agent_graph_compact", () => runner.multiAgentGraphView(runId, { view: "critical-path" }))
64
- },
65
- // Blackboard — coordinator topics/messages/contexts/artifacts/snapshots/
66
- // decisions/conflicts/adopted+missing evidence.
67
- blackboard: {
68
- coordinator: panel("coordinator.summary", `cw coordinator summary ${runId}`, "cw_coordinator_summary", () => runner.coordinatorSummary(runId)),
69
- digest: panel("blackboard.summarize", `cw blackboard summarize ${runId} --json`, "cw_blackboard_summarize", () => runner.blackboardSummarize(runId)),
70
- graph: panel("blackboard.graph", `cw blackboard graph ${runId}`, "cw_blackboard_graph", () => runner.blackboardGraph(runId))
71
- },
72
- // Worker logs — manifests, outputs, scoped results, failures, and the
73
- // recorded execution backend + sandbox attestation.
74
- worker: {
75
- summary: panel("worker.summary", `cw worker summary ${runId} --json`, "cw_worker_summary", () => runner.summarizeWorkerRecords(runId))
76
- },
77
- // Candidate compare — scores/selection/rejection, plus the v0.1.26
78
- // evidence-adoption reasoning chain (why adopted).
79
- candidate: {
80
- summary: panel("candidate.summary", `cw candidate summary ${runId} --json`, "cw_candidate_summary", () => runner.summarizeCandidateOperatorRecords(runId)),
81
- reasoning: panel("multi-agent.reasoning", `cw multi-agent reasoning ${runId} --json`, "cw_evidence_reasoning", () => runner.multiAgentReasoning(runId))
82
- },
83
- // Observability + cost (v0.1.31) — durations, failure/verifier/acceptance
84
- // rates with sample counts, attested usage + cost, coverage, `unreported`/
85
- // `n/a` shown honestly. Equals `cw metrics show <run> --json` byte-for-byte.
86
- metrics: {
87
- report: panel("metrics.show", `cw metrics show ${runId} --json`, "cw_metrics_show", () => runner.metricsShow(runId))
88
- },
89
- // Audit timeline — trust-audit events, role policy decisions, provenance,
90
- // judge/chair rationale, and policy violations.
91
- audit: {
92
- summary: panel("audit.summary", `cw audit summary ${runId}`, "cw_audit_summary", () => runner.auditSummary(runId)),
93
- multiAgent: panel("audit.multi-agent", `cw audit multi-agent ${runId} --json`, "cw_audit_multi_agent", () => runner.auditMultiAgent(runId)),
94
- policy: panel("audit.policy", `cw audit policy ${runId} --json`, "cw_audit_policy", () => runner.auditPolicy(runId)),
95
- judge: panel("audit.judge", `cw audit judge ${runId} --json`, "cw_audit_judge", () => runner.auditJudge(runId))
96
- },
97
- // Collaboration (v0.1.32) — derived per-target review state (pending/approved/
98
- // rejected/blocked/unattributed, required vs recorded), the append-only
99
- // approval/comment/handoff timeline, and the run owner. Read-only; equals
100
- // `cw review status <run> --json` and `cw comment list <run> --json`.
101
- collaboration: {
102
- review: panel("review.status", `cw review status ${runId} --json`, "cw_review_status", () => runner.reviewStatus(runId)),
103
- comments: panel("comment.list", `cw comment list ${runId} --json`, "cw_comment_list", () => runner.collaborationCommentList(runId))
104
- }
105
- };
106
- }
107
- /** Assemble the read-only five-panel view of ONE run. The run is first resolved
108
- * from its durable `.cw/runs/<id>/state.json`; when that source is unreadable
109
- * the view is `resolved: false` and every panel is `absent` — fail closed,
110
- * never fabricated. */
111
- function buildWorkbenchRunView(runner, runId) {
112
- const id = String(runId || "");
113
- return runner.loadWithCache((r) => {
114
- let resolved = true;
115
- let error;
116
- try {
117
- r.loadRun(id);
118
- }
119
- catch (caught) {
120
- resolved = false;
121
- error = caught instanceof Error ? caught.message : String(caught);
122
- }
123
- return {
124
- schemaVersion: 1,
125
- surface: "workbench",
126
- runId: id,
127
- resolved,
128
- ...(error ? { error } : {}),
129
- panels: buildPanels(r, id)
130
- };
131
- });
132
- }
133
- // ---------------------------------------------------------------------------
134
- // Cross-run entry (v0.1.28 Run Registry) — composed from already-declared
135
- // capabilities; adds NO new source of truth.
136
- // ---------------------------------------------------------------------------
137
- /** Build the cross-run index: the registry index plus the run list (or a
138
- * filtered search). Each field equals the corresponding `cw <cmd> --json`
139
- * payload; the Workbench can show nothing the CLI/MCP cannot. */
140
- function buildWorkbenchIndex(runner, args = {}) {
141
- const scope = args.scope === "repo" ? "repo" : "home";
142
- const scoped = { ...args, scope };
143
- const registry = (0, capability_core_1.runRegistryShow)((0, capability_core_1.runRegistryFor)(scoped, runner), scoped);
144
- const filtered = Boolean(args.text || args.q || args.query || args.app || args.appId || args.status || args.repo || args.since || args.until);
145
- const runs = filtered ? (0, capability_core_1.runSearch)((0, capability_core_1.runRegistryFor)(scoped, runner), scoped) : (0, capability_core_1.runList)((0, capability_core_1.runRegistryFor)(scoped, runner), scoped);
146
- return { schemaVersion: 1, surface: "workbench", command: "index", scope, registry, runs };
147
- }
148
- // ---------------------------------------------------------------------------
149
- // Serve descriptor — describes the OPTIONAL localhost host (no state).
150
- // ---------------------------------------------------------------------------
151
- /** Absolute path to the optional static UI assets for this plugin install. */
152
- function workbenchUiRoot(runner) {
153
- return node_path_1.default.join(runner.pluginRoot, exports.WORKBENCH_UI_RELATIVE);
154
- }
155
- /** The canonical `cw workbench serve` payload: a description of the localhost
156
- * bind and its read-only routes. Holds zero authoritative state. The CLI emits
157
- * this under `--json`/`--once`; `cw_workbench_serve` returns it directly. */
158
- function buildWorkbenchServeDescriptor(runner, args = {}) {
159
- const scope = args.scope === "repo" ? "repo" : "home";
160
- const root = node_path_1.default.resolve(String(args.cwd || process.cwd()));
161
- const portRaw = Number(args.port);
162
- const port = Number.isFinite(portRaw) && portRaw > 0 ? Math.floor(portRaw) : exports.WORKBENCH_DEFAULT_PORT;
163
- const uiRoot = workbenchUiRoot(runner);
164
- return {
165
- schemaVersion: 1,
166
- surface: "workbench",
167
- command: "serve",
168
- host: "127.0.0.1",
169
- port,
170
- once: Boolean(args.once),
171
- readOnly: true,
172
- scope,
173
- root,
174
- uiAvailable: dirExists(uiRoot),
175
- uiRoot,
176
- routes: [
177
- { method: "GET", path: "/", description: "Workbench UI shell (static, dependency-light)." },
178
- { method: "GET", path: "/ui/*", description: "Static UI assets (read from disk; absent if not installed)." },
179
- { method: "GET", path: "/api/index", description: "Cross-run index: registry show + run list/search (v0.1.28)." },
180
- { method: "GET", path: "/api/serve", description: "This serve descriptor." },
181
- { method: "GET", path: "/api/run/:runId", description: "Five-panel WorkbenchRunView for one run (read-only)." }
182
- ]
183
- };
184
- }
185
- function dirExists(target) {
186
- try {
187
- return node_fs_1.default.statSync(target).isDirectory();
188
- }
189
- catch {
190
- return false;
191
- }
192
- }