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,211 +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.loadWorkflowFiles = loadWorkflowFiles;
7
- exports.loadAppManifestFiles = loadAppManifestFiles;
8
- exports.loadWorkflowApps = loadWorkflowApps;
9
- exports.loadWorkflowAppById = loadWorkflowAppById;
10
- exports.loadWorkflowAppTarget = loadWorkflowAppTarget;
11
- exports.listWorkflows = listWorkflows;
12
- exports.listApps = listApps;
13
- exports.showApp = showApp;
14
- exports.validateApp = validateApp;
15
- exports.initApp = initApp;
16
- exports.packageApp = packageApp;
17
- // Workflow-app management domain operations (v0.1.40 self-audit router pattern).
18
- // Carved out of CoolWorkflowRunner; pure functions (no instance state). Behavior
19
- // is identical to the inline versions — the runner-owned calls (resolveFromBase,
20
- // validateApp) are passed as callbacks so the bodies stay byte-identical.
21
- const node_fs_1 = __importDefault(require("node:fs"));
22
- const node_path_1 = __importDefault(require("node:path"));
23
- const workflow_api_1 = require("../workflow-api");
24
- const state_1 = require("../state");
25
- const workflow_app_framework_1 = require("../workflow-app-framework");
26
- const cli_options_1 = require("./cli-options");
27
- function loadWorkflowFiles(workflowsDir) {
28
- if (!node_fs_1.default.existsSync(workflowsDir))
29
- return [];
30
- return node_fs_1.default
31
- .readdirSync(workflowsDir)
32
- .filter((file) => file.endsWith(".workflow.js"))
33
- .sort()
34
- .map((file) => node_path_1.default.join(workflowsDir, file));
35
- }
36
- function loadAppManifestFiles(appsDir) {
37
- if (!node_fs_1.default.existsSync(appsDir))
38
- return [];
39
- return node_fs_1.default
40
- .readdirSync(appsDir, { withFileTypes: true })
41
- .filter((entry) => entry.isDirectory())
42
- .map((entry) => node_path_1.default.join(appsDir, entry.name, "app.json"))
43
- .filter((file) => node_fs_1.default.existsSync(file))
44
- .sort();
45
- }
46
- function loadWorkflowApps(workflowsDir, appsDir) {
47
- const records = [
48
- ...loadWorkflowFiles(workflowsDir).map((file) => (0, workflow_app_framework_1.loadWorkflowAppFromEntrypoint)(file)),
49
- ...loadAppManifestFiles(appsDir).map((file) => (0, workflow_app_framework_1.loadWorkflowAppFromManifest)(file))
50
- ].sort((left, right) => {
51
- const byId = left.app.id.localeCompare(right.app.id);
52
- if (byId)
53
- return byId;
54
- return (left.source.manifestPath || left.source.entrypointPath || left.source.path)
55
- .localeCompare(right.source.manifestPath || right.source.entrypointPath || right.source.path);
56
- });
57
- const seen = new Map();
58
- for (const record of records) {
59
- const previous = seen.get(record.app.id);
60
- if (previous) {
61
- throw new Error(`Duplicate workflow app id ${record.app.id}: ${previous.source.manifestPath || previous.source.entrypointPath || previous.source.path} and ${record.source.manifestPath || record.source.entrypointPath || record.source.path}`);
62
- }
63
- seen.set(record.app.id, record);
64
- }
65
- return records;
66
- }
67
- function loadWorkflowAppById(workflowsDir, appsDir, appId) {
68
- const record = loadWorkflowApps(workflowsDir, appsDir).find((candidate) => candidate.app.id === appId);
69
- if (!record)
70
- throw new Error(`Workflow app not found: ${appId}`);
71
- return record;
72
- }
73
- // The runner pre-resolves `target` via resolveFromBase and passes the resolved
74
- // path; the original `target` is still used for the id-fallback lookup.
75
- function loadWorkflowAppTarget(workflowsDir, appsDir, resolved, target) {
76
- if (!target)
77
- throw new Error("Missing workflow app path or id");
78
- if (node_fs_1.default.existsSync(resolved)) {
79
- const stat = node_fs_1.default.statSync(resolved);
80
- if (stat.isDirectory())
81
- return (0, workflow_app_framework_1.loadWorkflowAppFromManifest)(node_path_1.default.join(resolved, "app.json"));
82
- if (node_path_1.default.basename(resolved) === "app.json" || resolved.endsWith(".json"))
83
- return (0, workflow_app_framework_1.loadWorkflowAppFromManifest)(resolved);
84
- return (0, workflow_app_framework_1.loadWorkflowAppFromEntrypoint)(resolved);
85
- }
86
- return loadWorkflowAppById(workflowsDir, appsDir, target);
87
- }
88
- function listWorkflows(workflowsDir, appsDir) {
89
- return loadWorkflowApps(workflowsDir, appsDir).map((record) => {
90
- const summary = (0, workflow_app_framework_1.summarizeWorkflowApp)(record);
91
- return {
92
- id: summary.id,
93
- title: summary.title,
94
- summary: summary.summary,
95
- file: summary.file
96
- };
97
- });
98
- }
99
- function listApps(workflowsDir, appsDir) {
100
- return loadWorkflowApps(workflowsDir, appsDir).map((record) => (0, workflow_app_framework_1.summarizeWorkflowApp)(record));
101
- }
102
- function showApp(workflowsDir, appsDir, appId) {
103
- const record = loadWorkflowAppById(workflowsDir, appsDir, appId);
104
- const summary = (0, workflow_app_framework_1.summarizeWorkflowApp)(record);
105
- return {
106
- ...summary,
107
- source: record.source,
108
- app: {
109
- schemaVersion: record.app.schemaVersion,
110
- id: record.app.id,
111
- title: record.app.title,
112
- summary: record.app.summary || "",
113
- version: record.app.version,
114
- author: record.app.author,
115
- inputs: record.app.inputs || record.app.workflow.inputs,
116
- sandboxProfiles: record.app.sandboxProfiles || record.app.workflow.sandboxProfiles || [],
117
- compatibility: record.app.compatibility,
118
- metadata: record.app.metadata || {}
119
- },
120
- workflow: {
121
- id: record.app.workflow.id,
122
- title: record.app.workflow.title,
123
- summary: record.app.workflow.summary || "",
124
- limits: record.app.workflow.limits,
125
- inputs: record.app.workflow.inputs,
126
- sandboxProfiles: record.app.workflow.sandboxProfiles || [],
127
- phases: record.app.workflow.phases.map((phase) => ({
128
- id: phase.id,
129
- name: phase.name,
130
- status: phase.status,
131
- tasks: phase.tasks.map((task) => ({
132
- id: task.id,
133
- kind: task.kind,
134
- requiresEvidence: Boolean(task.requiresEvidence),
135
- sandboxProfileId: task.sandboxProfileId
136
- }))
137
- }))
138
- }
139
- };
140
- }
141
- // The runner pre-resolves `target` via resolveFromBase and passes the resolved
142
- // path; both the try-loader and the catch-branch appPath use resolvedTarget.
143
- function validateApp(workflowsDir, appsDir, target, resolvedTarget) {
144
- try {
145
- const record = loadWorkflowAppTarget(workflowsDir, appsDir, resolvedTarget, target);
146
- const result = (0, workflow_app_framework_1.validateWorkflowApp)(record.app, {
147
- appPath: record.source.manifestPath || record.source.entrypointPath || record.source.path
148
- });
149
- return {
150
- ...result,
151
- summary: (0, workflow_app_framework_1.summarizeWorkflowApp)(record)
152
- };
153
- }
154
- catch (error) {
155
- const issues = (0, cli_options_1.validationIssuesFromError)(error);
156
- return {
157
- valid: false,
158
- appId: target,
159
- appPath: resolvedTarget,
160
- issues
161
- };
162
- }
163
- }
164
- // resolveFromBase and validateApp are passed as callbacks so the body stays
165
- // byte-identical to the runner method (resolveFromBase(...) and validateApp(manifestPath)).
166
- function initApp(appsDir, appId, options, resolveFromBase, validateApp) {
167
- const id = (0, workflow_api_1.slugify)(appId);
168
- if (!id)
169
- throw new Error("App id must include at least one letter or digit");
170
- const title = String(options.title || titleize(id));
171
- const destinationDir = resolveFromBase(String(options.directory || options.output || node_path_1.default.join(appsDir, id)));
172
- // Reject writes to system-owned directories. The operator may provide any
173
- // output path, but writing to /etc, /bin, /usr etc. is never valid.
174
- const sysDirs = /^\/(etc|bin|sbin|usr|Library|System|Applications|boot|dev|proc|sys|root|var\/log|var\/run)\//;
175
- if (sysDirs.test(node_path_1.default.resolve(destinationDir))) {
176
- throw new Error(`Refusing to create app in a system directory: ${destinationDir}`);
177
- }
178
- const manifestPath = node_path_1.default.join(destinationDir, "app.json");
179
- const entrypointPath = node_path_1.default.join(destinationDir, "workflow.js");
180
- if (!options.force && (node_fs_1.default.existsSync(manifestPath) || node_fs_1.default.existsSync(entrypointPath))) {
181
- throw new Error(`Refusing to overwrite existing workflow app: ${destinationDir}`);
182
- }
183
- node_fs_1.default.mkdirSync(destinationDir, { recursive: true });
184
- node_fs_1.default.writeFileSync(manifestPath, (0, workflow_app_framework_1.renderWorkflowAppManifestTemplate)(id, title), "utf8");
185
- node_fs_1.default.writeFileSync(entrypointPath, (0, workflow_app_framework_1.renderWorkflowAppEntrypointTemplate)(id, title), "utf8");
186
- const validation = validateApp(manifestPath);
187
- if (!validation.valid) {
188
- throw new workflow_app_framework_1.WorkflowAppValidationError("Generated workflow app is invalid", validation.issues);
189
- }
190
- return { id, manifestPath, entrypointPath };
191
- }
192
- // resolveFromBase is passed as a callback so the body stays byte-identical.
193
- function packageApp(workflowsDir, appsDir, appId, options, resolveFromBase) {
194
- const record = loadWorkflowAppById(workflowsDir, appsDir, appId);
195
- const destination = resolveFromBase(String(options.output || node_path_1.default.join(".cw", "packages", `${record.app.id}-${record.app.version}.cwapp.json`)));
196
- node_fs_1.default.mkdirSync(node_path_1.default.dirname(destination), { recursive: true });
197
- (0, state_1.writeJson)(destination, {
198
- schemaVersion: 1,
199
- app: (0, workflow_app_framework_1.workflowAppRunMetadata)(record),
200
- workflow: record.app.workflow,
201
- packagedAt: new Date().toISOString()
202
- });
203
- return { id: record.app.id, version: record.app.version, path: destination };
204
- }
205
- function titleize(value) {
206
- return value
207
- .split("-")
208
- .filter(Boolean)
209
- .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
210
- .join(" ");
211
- }
@@ -1,182 +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.auditSummary = auditSummary;
7
- exports.auditMultiAgent = auditMultiAgent;
8
- exports.auditPolicy = auditPolicy;
9
- exports.auditRole = auditRole;
10
- exports.auditBlackboard = auditBlackboard;
11
- exports.auditJudge = auditJudge;
12
- exports.workerAudit = workerAudit;
13
- exports.auditEvidenceProvenance = auditEvidenceProvenance;
14
- exports.recordAuditAttestation = recordAuditAttestation;
15
- exports.recordAuditDecision = recordAuditDecision;
16
- // Audit domain operations (v0.1.40 self-audit P3 maintainability).
17
- //
18
- // Carved out of the CoolWorkflowRunner god-object as the first domain in the
19
- // router pattern: every function here takes an already-loaded WorkflowRun and
20
- // returns a value (mutating ops persist via the run), so the runner method is a
21
- // thin `loadRun -> delegate` wrapper. Behavior is identical to the inline
22
- // implementations these replaced; only the location changed.
23
- const node_path_1 = __importDefault(require("node:path"));
24
- const state_1 = require("../state");
25
- const report_1 = require("./report");
26
- const cli_options_1 = require("./cli-options");
27
- const worker_isolation_1 = require("../worker-isolation");
28
- const sandbox_profile_1 = require("../sandbox-profile");
29
- const trust_audit_1 = require("../trust-audit");
30
- const multi_agent_trust_1 = require("../multi-agent-trust");
31
- function auditSummary(run) {
32
- return (0, trust_audit_1.summarizeTrustAudit)(run);
33
- }
34
- function auditMultiAgent(run) {
35
- return (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run);
36
- }
37
- function auditPolicy(run) {
38
- const summary = (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run);
39
- return {
40
- schemaVersion: 1,
41
- runId: run.id,
42
- rolePolicies: summary.rolePolicies,
43
- permissionDecisions: summary.permissionDecisions,
44
- policyViolations: summary.policyViolations,
45
- nextAction: summary.nextAction
46
- };
47
- }
48
- function auditRole(run, roleId) {
49
- const summary = (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run);
50
- const events = (0, trust_audit_1.listTrustAuditEvents)(run).filter((event) => event.agentRoleId === roleId);
51
- return {
52
- schemaVersion: 1,
53
- runId: run.id,
54
- roleId,
55
- role: run.multiAgent?.roles.find((entry) => entry.id === roleId),
56
- rolePolicies: summary.rolePolicies.filter((entry) => entry.subjectId === roleId),
57
- permissionDecisions: events.filter((event) => event.kind === "multi-agent.permission"),
58
- blackboardWrites: events.filter((event) => event.kind === "blackboard.write"),
59
- messageProvenance: events.filter((event) => event.kind === "blackboard.message-provenance"),
60
- judgeRationales: events.filter((event) => event.kind === "judge.rationale"),
61
- panelDecisions: events.filter((event) => event.kind === "judge.panel-decision"),
62
- policyViolations: events.filter((event) => event.kind === "policy.violation"),
63
- events,
64
- nextAction: `node scripts/cw.js audit multi-agent ${run.id} --json`
65
- };
66
- }
67
- function auditBlackboard(run) {
68
- const summary = (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run);
69
- return {
70
- schemaVersion: 1,
71
- runId: run.id,
72
- blackboardWrites: summary.blackboardWrites,
73
- messageProvenance: summary.messageProvenance,
74
- policyViolations: summary.policyViolations.filter((event) => event.blackboardId),
75
- nextAction: summary.nextAction
76
- };
77
- }
78
- function auditJudge(run) {
79
- const summary = (0, multi_agent_trust_1.summarizeMultiAgentTrust)(run);
80
- return {
81
- schemaVersion: 1,
82
- runId: run.id,
83
- judgeRationales: summary.judgeRationales,
84
- panelDecisions: summary.panelDecisions,
85
- permissionDecisions: summary.permissionDecisions.filter((event) => String(event.metadata?.operation || "").startsWith("judge.")),
86
- policyViolations: summary.policyViolations.filter((event) => String(event.metadata?.operation || "").startsWith("judge.")),
87
- nextAction: summary.nextAction
88
- };
89
- }
90
- function workerAudit(run, workerId) {
91
- return (0, trust_audit_1.workerTrustAudit)(run, workerId);
92
- }
93
- function auditEvidenceProvenance(run, options = {}) {
94
- return (0, trust_audit_1.evidenceProvenance)(run, {
95
- workerId: (0, cli_options_1.stringOption)(options.worker || options.workerId),
96
- candidateId: (0, cli_options_1.stringOption)(options.candidate || options.candidateId),
97
- commitId: (0, cli_options_1.stringOption)(options.commit || options.commitId)
98
- });
99
- }
100
- function recordAuditAttestation(run, options = {}) {
101
- const workerId = (0, cli_options_1.stringOption)(options.worker || options.workerId);
102
- const worker = workerId ? (0, worker_isolation_1.getWorkerScope)(run, workerId) : undefined;
103
- const event = (0, trust_audit_1.recordHostAttestation)(run, {
104
- actor: (0, cli_options_1.stringOption)(options.actor) || "host",
105
- workerId,
106
- taskId: worker?.taskId || (0, cli_options_1.stringOption)(options.task || options.taskId),
107
- sandboxProfileId: worker?.sandboxProfileId || (0, cli_options_1.stringOption)(options.sandboxProfileId),
108
- policySnapshot: worker?.sandboxPolicy,
109
- command: (0, cli_options_1.stringOption)(options.command),
110
- networkTarget: (0, cli_options_1.stringOption)(options.network || options.networkTarget),
111
- envVars: (0, cli_options_1.valuesOption)(options.env || options.envVar || options.envVars),
112
- metadata: {
113
- note: (0, cli_options_1.stringOption)(options.note || options.message),
114
- hostEnforced: options.hostEnforced === undefined ? undefined : Boolean(options.hostEnforced)
115
- }
116
- });
117
- (0, state_1.saveCheckpoint)(run);
118
- return event;
119
- }
120
- function recordAuditDecision(run, workerId, options = {}) {
121
- const worker = (0, worker_isolation_1.getWorkerScope)(run, workerId);
122
- if (!worker)
123
- throw new Error(`Unknown worker id for run ${run.id}: ${workerId}`);
124
- const kind = (0, cli_options_1.stringOption)(options.kind) || (0, cli_options_1.inferAuditDecisionKind)(options);
125
- const target = (0, cli_options_1.stringOption)(options.path || options.command || options.network || options.networkTarget || options.env || options.envVar);
126
- if (!target)
127
- throw new Error("Missing audit decision target: provide --path, --command, --network, or --env");
128
- const policy = worker.sandboxPolicy;
129
- let denied = null;
130
- if (kind === "sandbox.command") {
131
- denied = policy ? (0, sandbox_profile_1.validateSandboxCommand)(policy, target, workerId) : null;
132
- }
133
- else if (kind === "sandbox.network") {
134
- denied = policy ? (0, sandbox_profile_1.validateSandboxNetwork)(policy, target, workerId) : null;
135
- }
136
- else if (kind === "sandbox.env") {
137
- const name = target.includes("=") ? target.split("=")[0] : target;
138
- const allowed = Boolean(policy?.env.inherit || policy?.env.expose.includes(name));
139
- denied = allowed ? null : { code: "sandbox-env-denied", message: `Worker ${workerId} env var is outside sandbox profile ${policy?.id || "unknown"}: ${name}` };
140
- }
141
- else {
142
- denied = (0, worker_isolation_1.validateWorkerBoundary)(run, workerId, { path: target });
143
- }
144
- const feedbackIds = [];
145
- if (denied) {
146
- const failure = (0, worker_isolation_1.recordWorkerFailure)(run, workerId, {
147
- code: denied.code,
148
- message: denied.message,
149
- at: new Date().toISOString(),
150
- path: denied.path || (kind === "sandbox.path" ? node_path_1.default.resolve(target) : undefined),
151
- retryable: false
152
- }, { persist: false });
153
- feedbackIds.push(...(failure.feedbackIds || []));
154
- }
155
- const event = kind === "sandbox.path"
156
- ? (0, trust_audit_1.recordSandboxPathDecision)(run, {
157
- workerId,
158
- taskId: worker.taskId,
159
- sandboxProfileId: worker.sandboxProfileId,
160
- policySnapshot: policy,
161
- target,
162
- decision: denied ? "denied" : "allowed",
163
- feedbackIds,
164
- metadata: { code: denied?.code }
165
- })
166
- : (0, trust_audit_1.recordSandboxPolicyDecision)(run, {
167
- kind,
168
- decision: denied ? "denied" : "allowed",
169
- workerId,
170
- taskId: worker.taskId,
171
- sandboxProfileId: worker.sandboxProfileId,
172
- policySnapshot: policy,
173
- command: kind === "sandbox.command" ? target : undefined,
174
- networkTarget: kind === "sandbox.network" ? target : undefined,
175
- envVars: kind === "sandbox.env" ? [target.includes("=") ? target.split("=")[0] : target] : undefined,
176
- feedbackIds,
177
- metadata: { code: denied?.code }
178
- });
179
- (0, report_1.writeReport)(run);
180
- (0, state_1.saveCheckpoint)(run);
181
- return event;
182
- }
@@ -1,117 +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.listCandidates = listCandidates;
7
- exports.showCandidate = showCandidate;
8
- exports.registerCandidate = registerCandidate;
9
- exports.scoreCandidate = scoreCandidate;
10
- exports.rankCandidates = rankCandidates;
11
- exports.selectCandidate = selectCandidate;
12
- exports.rejectCandidate = rejectCandidate;
13
- // Candidate domain operations (v0.1.40 self-audit P3 router pattern).
14
- // Carved out of CoolWorkflowRunner; each function takes a loaded run. Behavior is
15
- // identical to the inline implementations — only the location changed.
16
- const node_path_1 = __importDefault(require("node:path"));
17
- const state_1 = require("../state");
18
- const report_1 = require("./report");
19
- const cli_options_1 = require("./cli-options");
20
- const worker_isolation_1 = require("../worker-isolation");
21
- const candidate_scoring_1 = require("../candidate-scoring");
22
- function listCandidates(run, options = {}) {
23
- return (0, candidate_scoring_1.listCandidates)(run, {
24
- status: options.status ? String(options.status) : undefined,
25
- kind: options.kind ? String(options.kind) : undefined
26
- });
27
- }
28
- function showCandidate(run, candidateId) {
29
- const candidate = (0, candidate_scoring_1.getCandidate)(run, candidateId);
30
- if (!candidate)
31
- throw new Error(`Unknown candidate id for run ${run.id}: ${candidateId}`);
32
- return candidate;
33
- }
34
- function registerCandidate(run, options = {}) {
35
- const workerId = options.worker ? String(options.worker) : undefined;
36
- const worker = workerId ? (0, worker_isolation_1.getWorkerScope)(run, workerId) : undefined;
37
- if (workerId && !worker)
38
- throw new Error(`Unknown worker id for run ${run.id}: ${workerId}`);
39
- const task = worker ? run.tasks.find((candidate) => candidate.id === worker.taskId) : undefined;
40
- const resultNodeId = (0, cli_options_1.stringOption)(options.resultNode) || worker?.resultNodeId || task?.resultNodeId;
41
- const verifierNodeId = (0, cli_options_1.stringOption)(options.verifierNode) || worker?.output?.verifierNodeId || task?.verifierNodeId;
42
- const resultPath = (0, cli_options_1.stringOption)(options.resultPath) || worker?.output?.resultPath || task?.resultPath;
43
- const resultNode = resultNodeId ? run.nodes?.find((node) => node.id === resultNodeId) : undefined;
44
- const verifierNode = verifierNodeId ? run.nodes?.find((node) => node.id === verifierNodeId) : undefined;
45
- const candidate = (0, candidate_scoring_1.registerCandidate)(run, {
46
- id: (0, cli_options_1.stringOption)(options.id),
47
- kind: (0, cli_options_1.stringOption)(options.kind),
48
- workerId,
49
- taskId: (0, cli_options_1.stringOption)(options.task) || worker?.taskId,
50
- resultNodeId,
51
- verifierNodeId,
52
- resultPath,
53
- artifacts: [
54
- ...(resultPath ? [{ id: "result", kind: "markdown", path: node_path_1.default.resolve(resultPath) }] : []),
55
- ...(worker ? [{ id: "worker", kind: "json", path: node_path_1.default.join(worker.workerDir, "worker.json") }] : [])
56
- ],
57
- evidence: (0, cli_options_1.mergeEvidence)(resultNode?.evidence || [], verifierNode?.evidence || []),
58
- metadata: {
59
- source: worker ? "worker" : "manual",
60
- workerDir: worker?.workerDir
61
- }
62
- }, { persist: false });
63
- (0, report_1.writeReport)(run);
64
- (0, state_1.saveCheckpoint)(run);
65
- return candidate;
66
- }
67
- function scoreCandidate(run, candidateId, options = {}) {
68
- const score = (0, candidate_scoring_1.scoreCandidate)(run, candidateId, {
69
- id: (0, cli_options_1.stringOption)(options.id),
70
- scorer: (0, cli_options_1.stringOption)(options.scorer),
71
- criteria: (0, cli_options_1.parseCriteria)(options),
72
- maxTotal: (0, cli_options_1.numberOption)(options.maxTotal || options.max),
73
- verdict: (0, cli_options_1.stringOption)(options.verdict),
74
- evidence: (0, cli_options_1.parseEvidence)(options.evidence),
75
- notes: (0, cli_options_1.stringOption)(options.notes)
76
- }, { persist: false });
77
- (0, report_1.writeReport)(run);
78
- (0, state_1.saveCheckpoint)(run);
79
- return score;
80
- }
81
- function rankCandidates(run, options = {}) {
82
- const ranking = (0, candidate_scoring_1.rankCandidates)(run, {
83
- includeRejected: Boolean(options.includeRejected),
84
- policy: {
85
- minNormalized: (0, cli_options_1.numberOption)(options.minNormalized),
86
- requireEvidence: options.requireEvidence === undefined ? undefined : Boolean(options.requireEvidence),
87
- requireVerifierGate: options.requireVerifierGate === undefined ? undefined : Boolean(options.requireVerifierGate),
88
- tieBreaker: (0, cli_options_1.stringOption)(options.tieBreaker)
89
- }
90
- });
91
- (0, report_1.writeReport)(run);
92
- (0, state_1.saveCheckpoint)(run);
93
- return ranking;
94
- }
95
- function selectCandidate(run, candidateId, options = {}) {
96
- const selection = (0, candidate_scoring_1.selectCandidate)(run, candidateId, {
97
- selectedBy: (0, cli_options_1.stringOption)(options.by) || (0, cli_options_1.stringOption)(options.selectedBy),
98
- reason: (0, cli_options_1.stringOption)(options.reason),
99
- scoreId: (0, cli_options_1.stringOption)(options.score),
100
- allowUnverified: Boolean(options.allowUnverified)
101
- }, {
102
- persist: false,
103
- policy: {
104
- minNormalized: (0, cli_options_1.numberOption)(options.minNormalized),
105
- requireVerifierGate: options.requireVerifierGate === undefined ? undefined : Boolean(options.requireVerifierGate)
106
- }
107
- });
108
- (0, report_1.writeReport)(run);
109
- (0, state_1.saveCheckpoint)(run);
110
- return selection;
111
- }
112
- function rejectCandidate(run, candidateId, reason) {
113
- const candidate = (0, candidate_scoring_1.rejectCandidate)(run, candidateId, reason, { persist: false });
114
- (0, report_1.writeReport)(run);
115
- (0, state_1.saveCheckpoint)(run);
116
- return candidate;
117
- }