cool-workflow 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/apps/architecture-review/app.json +1 -1
  4. package/apps/architecture-review-fast/app.json +1 -1
  5. package/apps/end-to-end-golden-path/app.json +1 -1
  6. package/apps/pr-review-fix-ci/app.json +1 -1
  7. package/apps/release-cut/app.json +1 -1
  8. package/apps/research-synthesis/app.json +1 -1
  9. package/dist/cli/dispatch.js +29 -91
  10. package/dist/cli/entry.js +41 -1
  11. package/dist/cli/io.js +6 -2
  12. package/dist/cli/parseargv.js +6 -2
  13. package/dist/core/capability-data.js +271 -0
  14. package/dist/core/capability-table.js +16 -3504
  15. package/dist/core/format/completion.js +68 -0
  16. package/dist/core/format/help.js +50 -8
  17. package/dist/core/format/safe-json.js +73 -0
  18. package/dist/core/format/state-explosion-text.js +1 -1
  19. package/dist/core/multi-agent/candidate-scoring.js +5 -1
  20. package/dist/core/multi-agent/collaboration.js +6 -5
  21. package/dist/core/multi-agent/coordinator.js +9 -8
  22. package/dist/core/multi-agent/runtime.js +4 -4
  23. package/dist/core/multi-agent/topology.js +3 -3
  24. package/dist/core/pipeline/commit-gate.js +2 -1
  25. package/dist/core/pipeline/dispatch.js +18 -4
  26. package/dist/core/pipeline/drive-decide.js +2 -1
  27. package/dist/core/state/migrations.js +16 -1
  28. package/dist/core/state/state-explosion/digest.js +16 -15
  29. package/dist/core/state/state-explosion/graph.js +26 -19
  30. package/dist/core/state/state-explosion/helpers.js +2 -1
  31. package/dist/core/state/state-explosion/report.js +6 -6
  32. package/dist/core/trust/ledger.js +2 -1
  33. package/dist/core/types/execution-backend.js +18 -0
  34. package/dist/core/types/observability.js +7 -0
  35. package/dist/core/util/collate.js +23 -0
  36. package/dist/core/util/numeric-flag.js +40 -0
  37. package/dist/core/version.js +1 -1
  38. package/dist/mcp/server.js +99 -11
  39. package/dist/shell/audit-cli.js +99 -23
  40. package/dist/shell/commit-summary.js +2 -1
  41. package/dist/shell/coordinator-io.js +73 -13
  42. package/dist/shell/dispatch.js +1 -1
  43. package/dist/shell/doctor.js +80 -1
  44. package/dist/shell/drive.js +269 -59
  45. package/dist/shell/eval-text.js +2 -2
  46. package/dist/shell/evidence-reasoning.js +8 -7
  47. package/dist/shell/execution-backend/agent.js +20 -1
  48. package/dist/shell/execution-backend/container.js +4 -1
  49. package/dist/shell/execution-backend/local.js +4 -1
  50. package/dist/shell/execution-backend/registry.js +2 -1
  51. package/dist/shell/execution-backend/types.js +0 -9
  52. package/dist/shell/feedback-cli.js +6 -6
  53. package/dist/shell/fs-atomic.js +232 -30
  54. package/dist/shell/man-cli.js +6 -0
  55. package/dist/shell/metrics-cli.js +2 -1
  56. package/dist/shell/multi-agent-cli.js +367 -323
  57. package/dist/shell/multi-agent-host.js +9 -9
  58. package/dist/shell/multi-agent-operator-ux.js +82 -39
  59. package/dist/shell/node-store.js +10 -4
  60. package/dist/shell/observability.js +13 -12
  61. package/dist/shell/onramp.js +17 -1
  62. package/dist/shell/operator-ux-text.js +24 -23
  63. package/dist/shell/operator-ux.js +22 -20
  64. package/dist/shell/orchestrator.js +49 -38
  65. package/dist/shell/pipeline-cli.js +168 -111
  66. package/dist/shell/reclamation-io.js +16 -5
  67. package/dist/shell/registry-cli.js +19 -17
  68. package/dist/shell/remote-source.js +13 -8
  69. package/dist/shell/report-cli.js +45 -0
  70. package/dist/shell/report.js +4 -2
  71. package/dist/shell/run-registry-io.js +77 -19
  72. package/dist/shell/run-store.js +91 -2
  73. package/dist/shell/scheduling-io.js +12 -13
  74. package/dist/shell/state-cli.js +2 -7
  75. package/dist/shell/state-explosion-cli.js +19 -10
  76. package/dist/shell/topology-io.js +38 -6
  77. package/dist/shell/trust-audit.js +264 -23
  78. package/dist/shell/trust-policy-io.js +1 -1
  79. package/dist/shell/worker-cli.js +41 -29
  80. package/dist/shell/worker-isolation.js +34 -9
  81. package/dist/shell/workflow-app-loader.js +3 -2
  82. package/dist/wiring/capability-table/basics.js +91 -0
  83. package/dist/wiring/capability-table/exec-backend.js +171 -0
  84. package/dist/wiring/capability-table/index.js +42 -0
  85. package/dist/wiring/capability-table/multi-agent.js +630 -0
  86. package/dist/wiring/capability-table/parity.js +467 -0
  87. package/dist/wiring/capability-table/pipeline.js +292 -0
  88. package/dist/wiring/capability-table/registry-core.js +208 -0
  89. package/dist/wiring/capability-table/reporting.js +435 -0
  90. package/dist/wiring/capability-table/scheduling-registry.js +592 -0
  91. package/dist/wiring/capability-table/state.js +181 -0
  92. package/dist/wiring/capability-table/trust-ledger.js +158 -0
  93. package/dist/wiring/capability-table/workflow-apps.js +381 -0
  94. package/docs/agent-delegation-drive.7.md +4 -0
  95. package/docs/candidate-scoring.7.md +1 -1
  96. package/docs/canonical-workflow-apps.7.md +7 -7
  97. package/docs/cli-mcp-parity.7.md +13 -3
  98. package/docs/contract-migration-tooling.7.md +4 -0
  99. package/docs/control-plane-scheduling.7.md +4 -0
  100. package/docs/coordinator-blackboard.7.md +17 -17
  101. package/docs/dogfood-one-real-repo.7.md +11 -11
  102. package/docs/durable-state-and-locking.7.md +24 -0
  103. package/docs/end-to-end-golden-path.7.md +14 -14
  104. package/docs/evidence-adoption-reasoning-chain.7.md +4 -0
  105. package/docs/execution-backends.7.md +4 -0
  106. package/docs/getting-started.md +37 -37
  107. package/docs/index.md +1 -0
  108. package/docs/multi-agent-cli-mcp-surface.7.md +21 -17
  109. package/docs/multi-agent-eval-replay-harness.7.md +17 -13
  110. package/docs/multi-agent-operator-ux.7.md +23 -19
  111. package/docs/multi-agent-runtime-core.7.md +22 -22
  112. package/docs/multi-agent-topologies.7.md +6 -6
  113. package/docs/multi-agent-trust-policy-audit.7.md +11 -11
  114. package/docs/node-snapshot-diff-replay.7.md +4 -0
  115. package/docs/observability-cost-accounting.7.md +4 -0
  116. package/docs/operator-ux.7.md +34 -34
  117. package/docs/pipeline-runner.7.md +4 -4
  118. package/docs/project-index.md +48 -5
  119. package/docs/real-execution-backends.7.md +4 -0
  120. package/docs/release-and-migration.7.md +5 -1
  121. package/docs/release-tooling.7.md +4 -0
  122. package/docs/routines.md +4 -4
  123. package/docs/run-registry-control-plane.7.md +23 -19
  124. package/docs/run-retention-reclamation.7.md +4 -0
  125. package/docs/scheduled-tasks.md +14 -14
  126. package/docs/security-trust-hardening.7.md +43 -13
  127. package/docs/state-explosion-management.7.md +14 -10
  128. package/docs/team-collaboration.7.md +4 -0
  129. package/docs/trust-audit-anchor.7.md +71 -0
  130. package/docs/unix-principles.md +3 -1
  131. package/docs/verifier-gated-commit.7.md +1 -1
  132. package/docs/web-desktop-workbench.7.md +4 -0
  133. package/docs/workflow-app-framework.7.md +13 -13
  134. package/manifest/plugin.manifest.json +1 -1
  135. package/package.json +4 -2
  136. package/scripts/agents/claude-p-agent.js +2 -2
  137. package/scripts/block-unapproved-tag.sh +23 -2
  138. package/scripts/bump-version.js +24 -2
  139. package/scripts/canonical-apps.js +4 -4
  140. package/scripts/children/batch-delegate-child.js +52 -2
  141. package/scripts/dogfood-release.js +1 -1
  142. package/scripts/fake-date-for-reproduction.js +44 -0
  143. package/scripts/golden-path.js +4 -4
  144. package/scripts/purity-baseline.json +71 -0
  145. package/scripts/purity-gate.js +239 -0
  146. package/scripts/release-check.js +8 -1
  147. package/scripts/release-flow.js +57 -1
  148. package/scripts/verdict-keygen.js +83 -0
  149. package/scripts/verify-bump-reproduction.sh +148 -0
  150. package/scripts/verify-verdict-signature.js +61 -0
  151. package/scripts/version-sync-check.js +33 -12
  152. package/skills/cool-workflow/SKILL.md +9 -9
  153. package/skills/cool-workflow/references/commands.md +89 -88
  154. package/ui/workbench/app.css +37 -1
  155. package/ui/workbench/app.js +124 -6
  156. package/workflows/README.md +19 -0
@@ -10,7 +10,7 @@ deterministic summaries for people, while it keeps JSON for scripts and MCP.
10
10
  Human status is the default:
11
11
 
12
12
  ```bash
13
- node scripts/cw.js status <run-id>
13
+ cw status <run-id>
14
14
  ```
15
15
 
16
16
  The status view gives you run id, workflow/app id and version, loop stage, active
@@ -21,8 +21,8 @@ path, and the next command it puts forward.
21
21
  Machine-readable status is still there for you:
22
22
 
23
23
  ```bash
24
- node scripts/cw.js status <run-id> --json
25
- node scripts/cw.js status <run-id> --format json
24
+ cw status <run-id> --json
25
+ cw status <run-id> --format json
26
26
  ```
27
27
 
28
28
  `CoolWorkflowRunner.status()` and MCP `cw_status` still give back structured
@@ -39,19 +39,19 @@ The things it puts forward are deterministic and use only commands that are in
39
39
  the CW CLI. Examples:
40
40
 
41
41
  ```text
42
- node scripts/cw.js dispatch <run-id> --limit 4
42
+ cw dispatch <run-id> --limit 4
43
43
  reason: pending tasks are ready for the active phase
44
44
 
45
- node scripts/cw.js worker manifest <run-id> <worker-id>
45
+ cw worker manifest <run-id> <worker-id>
46
46
  reason: running workers need their manifests inspected
47
47
 
48
- node scripts/cw.js feedback show <run-id> <feedback-id>
48
+ cw feedback show <run-id> <feedback-id>
49
49
  reason: open feedback should be resolved before more dispatch
50
50
 
51
- node scripts/cw.js candidate register <run-id> --worker <worker-id>
51
+ cw candidate register <run-id> --worker <worker-id>
52
52
  reason: a completed worker result has not been registered as a candidate
53
53
 
54
- node scripts/cw.js commit <run-id> --selection <selection-id>
54
+ cw commit <run-id> --selection <selection-id>
55
55
  reason: a verified selected candidate is ready for a verifier-gated commit
56
56
  ```
57
57
 
@@ -63,15 +63,15 @@ work is done, the advisor points to `cw report <run-id> --show`.
63
63
  Use the top-level graph command for a small console map:
64
64
 
65
65
  ```bash
66
- node scripts/cw.js graph <run-id>
67
- node scripts/cw.js graph <run-id> --json
66
+ cw graph <run-id>
67
+ cw graph <run-id> --json
68
68
  ```
69
69
 
70
70
  The legacy node command still works:
71
71
 
72
72
  ```bash
73
- node scripts/cw.js node graph <run-id>
74
- node scripts/cw.js node graph <run-id> --json
73
+ cw node graph <run-id>
74
+ cw node graph <run-id> --json
75
75
  ```
76
76
 
77
77
  The human graph puts phases, tasks, dispatches, workers, result nodes,
@@ -90,10 +90,10 @@ v0.1.21 adds clear multi-agent operator views that answer who is dependent on
90
90
  whom, who is blocked, and which evidence went into the accepted result:
91
91
 
92
92
  ```bash
93
- node scripts/cw.js multi-agent graph <run-id>
94
- node scripts/cw.js multi-agent dependencies <run-id>
95
- node scripts/cw.js multi-agent failures <run-id>
96
- node scripts/cw.js multi-agent evidence <run-id>
93
+ cw multi-agent graph <run-id>
94
+ cw multi-agent dependencies <run-id>
95
+ cw multi-agent failures <run-id>
96
+ cw multi-agent evidence <run-id>
97
97
  ```
98
98
 
99
99
  The same derived model is in `status`, `report --show`, and
@@ -106,14 +106,14 @@ trace from agent membership to verifier-gated commit.
106
106
  `cw report` still writes the Markdown report file and prints its path:
107
107
 
108
108
  ```bash
109
- node scripts/cw.js report <run-id>
109
+ cw report <run-id>
110
110
  ```
111
111
 
112
112
  Use `--show` or `--summary` when the operator needs a console report that is easy to read:
113
113
 
114
114
  ```bash
115
- node scripts/cw.js report <run-id> --show
116
- node scripts/cw.js report <run-id> --summary
115
+ cw report <run-id> --show
116
+ cw report <run-id> --summary
117
117
  ```
118
118
 
119
119
  The console report gives the same high-value status panels plus active and
@@ -124,25 +124,25 @@ pending tasks, evidence paths and locators, and resource inspection commands.
124
124
  The chief run resources have human summaries by default and JSON when you ask for it:
125
125
 
126
126
  ```bash
127
- node scripts/cw.js worker summary <run-id>
128
- node scripts/cw.js worker summary <run-id> --json
127
+ cw worker summary <run-id>
128
+ cw worker summary <run-id> --json
129
129
 
130
- node scripts/cw.js candidate summary <run-id>
131
- node scripts/cw.js candidate summary <run-id> --json
130
+ cw candidate summary <run-id>
131
+ cw candidate summary <run-id> --json
132
132
 
133
- node scripts/cw.js feedback summary <run-id>
134
- node scripts/cw.js feedback summary <run-id> --json
133
+ cw feedback summary <run-id>
134
+ cw feedback summary <run-id> --json
135
135
 
136
- node scripts/cw.js commit summary <run-id>
137
- node scripts/cw.js commit summary <run-id> --json
136
+ cw commit summary <run-id>
137
+ cw commit summary <run-id> --json
138
138
 
139
- node scripts/cw.js multi-agent summary <run-id>
140
- node scripts/cw.js multi-agent summary <run-id> --json
141
- node scripts/cw.js multi-agent graph <run-id>
142
- node scripts/cw.js multi-agent graph <run-id> --json
143
- node scripts/cw.js multi-agent dependencies <run-id>
144
- node scripts/cw.js multi-agent failures <run-id>
145
- node scripts/cw.js multi-agent evidence <run-id>
139
+ cw multi-agent summary <run-id>
140
+ cw multi-agent summary <run-id> --json
141
+ cw multi-agent graph <run-id>
142
+ cw multi-agent graph <run-id> --json
143
+ cw multi-agent dependencies <run-id>
144
+ cw multi-agent failures <run-id>
145
+ cw multi-agent evidence <run-id>
146
146
  ```
147
147
 
148
148
  Worker summaries show allocated/running/verified/failed/rejected counts,
@@ -93,10 +93,10 @@ commit stage.
93
93
  Commands that look at runs print stable JSON:
94
94
 
95
95
  ```text
96
- cw.js contract show <run-id> [contract-id]
97
- cw.js node list <run-id>
98
- cw.js node show <run-id> <node-id>
99
- cw.js node graph <run-id>
96
+ cw contract show <run-id> [contract-id]
97
+ cw node list <run-id>
98
+ cw node show <run-id> <node-id>
99
+ cw node graph <run-id>
100
100
  ```
101
101
 
102
102
  ## EXAMPLES
@@ -1,15 +1,15 @@
1
1
  # Cool Workflow Project Index
2
2
 
3
- Generated from the current repository code on 2026-07-07 by `npm run sync:project-index`.
3
+ Generated from the current repository code on 2026-07-10 by `npm run sync:project-index`.
4
4
 
5
5
  ## Snapshot
6
6
 
7
7
  - Package: `cool-workflow`
8
- - Version: `0.2.1`
9
- - Source modules: `129`
8
+ - Version: `0.2.3`
9
+ - Source modules: `148`
10
10
  - Workflow apps: `8`
11
- - Docs: `61`
12
- - Smoke tests: `178`
11
+ - Docs: `62`
12
+ - Smoke tests: `201`
13
13
  - Repository: https://github.com/coo1white/cool-workflow
14
14
 
15
15
  ## Architecture
@@ -82,8 +82,11 @@ multi-agent host -> topology -> blackboard/coordinator
82
82
  - [cli/entry.ts](../src/cli/entry.ts)
83
83
  - [cli/io.ts](../src/cli/io.ts)
84
84
  - [cli/parseargv.ts](../src/cli/parseargv.ts)
85
+ - [core/capability-data.ts](../src/core/capability-data.ts)
85
86
  - [core/capability-table.ts](../src/core/capability-table.ts)
87
+ - [core/format/completion.ts](../src/core/format/completion.ts)
86
88
  - [core/format/help.ts](../src/core/format/help.ts)
89
+ - [core/format/safe-json.ts](../src/core/format/safe-json.ts)
87
90
  - [core/format/state-explosion-text.ts](../src/core/format/state-explosion-text.ts)
88
91
  - [core/hash.ts](../src/core/hash.ts)
89
92
  - [core/multi-agent/collaboration.ts](../src/core/multi-agent/collaboration.ts)
@@ -113,6 +116,10 @@ multi-agent host -> topology -> blackboard/coordinator
113
116
  - [core/trust/telemetry-ledger.ts](../src/core/trust/telemetry-ledger.ts)
114
117
  - [core/types.ts](../src/core/types.ts)
115
118
  - [core/types/boundary.ts](../src/core/types/boundary.ts)
119
+ - [core/types/execution-backend.ts](../src/core/types/execution-backend.ts)
120
+ - [core/types/observability.ts](../src/core/types/observability.ts)
121
+ - [core/util/collate.ts](../src/core/util/collate.ts)
122
+ - [core/util/numeric-flag.ts](../src/core/util/numeric-flag.ts)
116
123
  - [mcp/dispatch.ts](../src/mcp/dispatch.ts)
117
124
  - [mcp/server.ts](../src/mcp/server.ts)
118
125
  - [shell/agent-config.ts](../src/shell/agent-config.ts)
@@ -181,6 +188,18 @@ multi-agent host -> topology -> blackboard/coordinator
181
188
  - [shell/workbench-text.ts](../src/shell/workbench-text.ts)
182
189
  - [shell/workbench.ts](../src/shell/workbench.ts)
183
190
  - [shell/worker-cli.ts](../src/shell/worker-cli.ts)
191
+ - [wiring/capability-table/basics.ts](../src/wiring/capability-table/basics.ts)
192
+ - [wiring/capability-table/exec-backend.ts](../src/wiring/capability-table/exec-backend.ts)
193
+ - [wiring/capability-table/index.ts](../src/wiring/capability-table/index.ts)
194
+ - [wiring/capability-table/multi-agent.ts](../src/wiring/capability-table/multi-agent.ts)
195
+ - [wiring/capability-table/parity.ts](../src/wiring/capability-table/parity.ts)
196
+ - [wiring/capability-table/pipeline.ts](../src/wiring/capability-table/pipeline.ts)
197
+ - [wiring/capability-table/registry-core.ts](../src/wiring/capability-table/registry-core.ts)
198
+ - [wiring/capability-table/reporting.ts](../src/wiring/capability-table/reporting.ts)
199
+ - [wiring/capability-table/scheduling-registry.ts](../src/wiring/capability-table/scheduling-registry.ts)
200
+ - [wiring/capability-table/state.ts](../src/wiring/capability-table/state.ts)
201
+ - [wiring/capability-table/trust-ledger.ts](../src/wiring/capability-table/trust-ledger.ts)
202
+ - [wiring/capability-table/workflow-apps.ts](../src/wiring/capability-table/workflow-apps.ts)
184
203
 
185
204
  ## Workflow Apps
186
205
 
@@ -251,6 +270,7 @@ multi-agent host -> topology -> blackboard/coordinator
251
270
  - [State Explosion Management](state-explosion-management.7.md)
252
271
  - [STATE-NODE(7)](state-node.7.md)
253
272
  - [Team Collaboration](team-collaboration.7.md)
273
+ - [Trust Audit Anchor](trust-audit-anchor.7.md)
254
274
  - [Trust Model & Limitations](trust-model.md)
255
275
  - [Unix-Inspired Workflow Principles](unix-principles.md)
256
276
  - [Vendor Manifest Loadability](vendor-manifest-loadability.7.md)
@@ -286,6 +306,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
286
306
  - [claude-p-agent-wrapper-smoke.js](../test/claude-p-agent-wrapper-smoke.js)
287
307
  - [cli-arg-parsing-smoke.js](../test/cli-arg-parsing-smoke.js)
288
308
  - [cli-command-surface-smoke.js](../test/cli-command-surface-smoke.js)
309
+ - [cli-epipe-smoke.js](../test/cli-epipe-smoke.js)
289
310
  - [cli-format-smoke.js](../test/cli-format-smoke.js)
290
311
  - [cli-handler-clones-smoke.js](../test/cli-handler-clones-smoke.js)
291
312
  - [cli-handler-eval-node-smoke.js](../test/cli-handler-eval-node-smoke.js)
@@ -307,17 +328,22 @@ Smoke tests mirror the public contracts. The high-signal suites are:
307
328
  - [contract-migration-tooling-smoke.js](../test/contract-migration-tooling-smoke.js)
308
329
  - [control-plane-scheduling-smoke.js](../test/control-plane-scheduling-smoke.js)
309
330
  - [coordinator-blackboard-smoke.js](../test/coordinator-blackboard-smoke.js)
331
+ - [coordinator-topology-persist-dirty-tracking-smoke.js](../test/coordinator-topology-persist-dirty-tracking-smoke.js)
310
332
  - [cw-help-per-command-smoke.js](../test/cw-help-per-command-smoke.js)
311
333
  - [dead-export-removal-guard-smoke.js](../test/dead-export-removal-guard-smoke.js)
312
334
  - [deepseek-agent-wrapper-smoke.js](../test/deepseek-agent-wrapper-smoke.js)
313
335
  - [deferred-checkpoint-batching-smoke.js](../test/deferred-checkpoint-batching-smoke.js)
314
336
  - [demo-bundle-smoke.js](../test/demo-bundle-smoke.js)
315
337
  - [det-ids-b-smoke.js](../test/det-ids-b-smoke.js)
338
+ - [dispatch-legacy-burndown-smoke.js](../test/dispatch-legacy-burndown-smoke.js)
339
+ - [doctor-audit-integrity-repair-smoke.js](../test/doctor-audit-integrity-repair-smoke.js)
316
340
  - [doctor-smoke.js](../test/doctor-smoke.js)
317
341
  - [dogfood-architecture-review-smoke.js](../test/dogfood-architecture-review-smoke.js)
318
342
  - [dogfood-release-smoke.js](../test/dogfood-release-smoke.js)
343
+ - [drive-async-real-signal-smoke.js](../test/drive-async-real-signal-smoke.js)
319
344
  - [drive-concurrency-flag-smoke.js](../test/drive-concurrency-flag-smoke.js)
320
345
  - [drive-exhaustion-blocked-smoke.js](../test/drive-exhaustion-blocked-smoke.js)
346
+ - [drive-round-cache-serial-smoke.js](../test/drive-round-cache-serial-smoke.js)
321
347
  - [durable-atomic-write-smoke.js](../test/durable-atomic-write-smoke.js)
322
348
  - [end-to-end-demo-smoke.js](../test/end-to-end-demo-smoke.js)
323
349
  - [end-to-end-golden-path-smoke.js](../test/end-to-end-golden-path-smoke.js)
@@ -330,6 +356,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
330
356
  - [execution-backends-smoke.js](../test/execution-backends-smoke.js)
331
357
  - [feedback-ops-unit-smoke.js](../test/feedback-ops-unit-smoke.js)
332
358
  - [freebsd-audit-fixes-smoke.js](../test/freebsd-audit-fixes-smoke.js)
359
+ - [fs-atomic-lock-steal-race-smoke.js](../test/fs-atomic-lock-steal-race-smoke.js)
333
360
  - [gemini-agent-wrapper-smoke.js](../test/gemini-agent-wrapper-smoke.js)
334
361
  - [gemini-opencode-agent-wrapper-smoke.js](../test/gemini-opencode-agent-wrapper-smoke.js)
335
362
  - [h7-custom-profile-persist-smoke.js](../test/h7-custom-profile-persist-smoke.js)
@@ -339,9 +366,11 @@ Smoke tests mirror the public contracts. The high-signal suites are:
339
366
  - [ledger-resolution-smoke.js](../test/ledger-resolution-smoke.js)
340
367
  - [ledger-verify-smoke.js](../test/ledger-verify-smoke.js)
341
368
  - [loop-bounded-expansion-smoke.js](../test/loop-bounded-expansion-smoke.js)
369
+ - [man-run-registry-traversal-smoke.js](../test/man-run-registry-traversal-smoke.js)
342
370
  - [mcp-app-surface-smoke.js](../test/mcp-app-surface-smoke.js)
343
371
  - [mcp-surface-registry-smoke.js](../test/mcp-surface-registry-smoke.js)
344
372
  - [mcp-tool-call-coverage-smoke.js](../test/mcp-tool-call-coverage-smoke.js)
373
+ - [mcp-untrusted-content-advisory-smoke.js](../test/mcp-untrusted-content-advisory-smoke.js)
345
374
  - [metrics-summary-limit-smoke.js](../test/metrics-summary-limit-smoke.js)
346
375
  - [multi-agent-cli-mcp-surface-smoke.js](../test/multi-agent-cli-mcp-surface-smoke.js)
347
376
  - [multi-agent-eval-determinism-regression-smoke.js](../test/multi-agent-eval-determinism-regression-smoke.js)
@@ -349,6 +378,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
349
378
  - [multi-agent-eval-replay-smoke.js](../test/multi-agent-eval-replay-smoke.js)
350
379
  - [multi-agent-operator-ux-smoke.js](../test/multi-agent-operator-ux-smoke.js)
351
380
  - [multi-agent-runtime-core-smoke.js](../test/multi-agent-runtime-core-smoke.js)
381
+ - [multi-agent-state-lock-concurrency-smoke.js](../test/multi-agent-state-lock-concurrency-smoke.js)
352
382
  - [multi-agent-topologies-debate-smoke.js](../test/multi-agent-topologies-debate-smoke.js)
353
383
  - [multi-agent-topologies-judge-panel-smoke.js](../test/multi-agent-topologies-judge-panel-smoke.js)
354
384
  - [multi-agent-topologies-map-reduce-smoke.js](../test/multi-agent-topologies-map-reduce-smoke.js)
@@ -357,6 +387,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
357
387
  - [node-snapshot-diff-replay-smoke.js](../test/node-snapshot-diff-replay-smoke.js)
358
388
  - [npm-global-install-smoke.js](../test/npm-global-install-smoke.js)
359
389
  - [npm-trusted-publish-smoke.js](../test/npm-trusted-publish-smoke.js)
390
+ - [numeric-flag-parsing-smoke.js](../test/numeric-flag-parsing-smoke.js)
360
391
  - [observability-cost-accounting-smoke.js](../test/observability-cost-accounting-smoke.js)
361
392
  - [one-way-boundary-smoke.js](../test/one-way-boundary-smoke.js)
362
393
  - [onramp-check-smoke.js](../test/onramp-check-smoke.js)
@@ -383,6 +414,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
383
414
  - [readme-trust-claim-smoke.js](../test/readme-trust-claim-smoke.js)
384
415
  - [real-execution-backends-smoke.js](../test/real-execution-backends-smoke.js)
385
416
  - [registry-corrupt-fail-closed-smoke.js](../test/registry-corrupt-fail-closed-smoke.js)
417
+ - [registry-corrupt-state-distinct-error-smoke.js](../test/registry-corrupt-state-distinct-error-smoke.js)
386
418
  - [release-check-skip-smoke.js](../test/release-check-skip-smoke.js)
387
419
  - [release-flow-smoke.js](../test/release-flow-smoke.js)
388
420
  - [release-gate-smoke.js](../test/release-gate-smoke.js)
@@ -409,6 +441,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
409
441
  - [run-restore-failclosed-smoke.js](../test/run-restore-failclosed-smoke.js)
410
442
  - [run-resume-drive-smoke.js](../test/run-resume-drive-smoke.js)
411
443
  - [run-retention-reclamation-smoke.js](../test/run-retention-reclamation-smoke.js)
444
+ - [run-state-lock-concurrency-smoke.js](../test/run-state-lock-concurrency-smoke.js)
412
445
  - [sample-determinism-smoke.js](../test/sample-determinism-smoke.js)
413
446
  - [sandbox-env-batch-hardening-smoke.js](../test/sandbox-env-batch-hardening-smoke.js)
414
447
  - [sandbox-profile-smoke.js](../test/sandbox-profile-smoke.js)
@@ -418,10 +451,14 @@ Smoke tests mirror the public contracts. The high-signal suites are:
418
451
  - [schema-validation-smoke.js](../test/schema-validation-smoke.js)
419
452
  - [security-trust-hardening-smoke.js](../test/security-trust-hardening-smoke.js)
420
453
  - [self-audit-hardening-smoke.js](../test/self-audit-hardening-smoke.js)
454
+ - [sigint-sigterm-drive-loop-smoke.js](../test/sigint-sigterm-drive-loop-smoke.js)
455
+ - [smoke-duration-scheduling-smoke.js](../test/smoke-duration-scheduling-smoke.js)
421
456
  - [source-context-batch-smoke.js](../test/source-context-batch-smoke.js)
422
457
  - [source-context-profile-smoke.js](../test/source-context-profile-smoke.js)
423
458
  - [state-node-smoke.js](../test/state-node-smoke.js)
459
+ - [status-run-flag-smoke.js](../test/status-run-flag-smoke.js)
424
460
  - [sub-workflow-nesting-smoke.js](../test/sub-workflow-nesting-smoke.js)
461
+ - [summary-show-no-checkpoint-write-smoke.js](../test/summary-show-no-checkpoint-write-smoke.js)
425
462
  - [surface-explicit-cwd-smoke.js](../test/surface-explicit-cwd-smoke.js)
426
463
  - [tamper-evidence-demo-smoke.js](../test/tamper-evidence-demo-smoke.js)
427
464
  - [team-collaboration-smoke.js](../test/team-collaboration-smoke.js)
@@ -432,11 +469,17 @@ Smoke tests mirror the public contracts. The high-signal suites are:
432
469
  - [telemetry-metrics-coverage-smoke.js](../test/telemetry-metrics-coverage-smoke.js)
433
470
  - [telemetry-verify-signatures-smoke.js](../test/telemetry-verify-signatures-smoke.js)
434
471
  - [token-budget-enforcement-smoke.js](../test/token-budget-enforcement-smoke.js)
472
+ - [trust-audit-anchor-smoke.js](../test/trust-audit-anchor-smoke.js)
473
+ - [trust-audit-append-lock-concurrency-smoke.js](../test/trust-audit-append-lock-concurrency-smoke.js)
474
+ - [trust-audit-append-tail-cache-smoke.js](../test/trust-audit-append-tail-cache-smoke.js)
435
475
  - [vendor-manifest-load-smoke.js](../test/vendor-manifest-load-smoke.js)
436
476
  - [vendor-preflight-smoke.js](../test/vendor-preflight-smoke.js)
477
+ - [verdict-signing-workflow-smoke.js](../test/verdict-signing-workflow-smoke.js)
437
478
  - [verifier-gated-commit-smoke.js](../test/verifier-gated-commit-smoke.js)
479
+ - [verify-bump-reproduction-smoke.js](../test/verify-bump-reproduction-smoke.js)
438
480
  - [verify-import-audit-chain-smoke.js](../test/verify-import-audit-chain-smoke.js)
439
481
  - [web-desktop-workbench-smoke.js](../test/web-desktop-workbench-smoke.js)
482
+ - [wiring-lazy-shell-imports-smoke.js](../test/wiring-lazy-shell-imports-smoke.js)
440
483
  - [worker-accept-path-architecture-smoke.js](../test/worker-accept-path-architecture-smoke.js)
441
484
  - [worker-isolation-smoke.js](../test/worker-isolation-smoke.js)
442
485
  - [worker-retry-count-smoke.js](../test/worker-retry-count-smoke.js)
@@ -193,3 +193,7 @@ _No behavioral change in v0.1.89 (CLI-surface golden-path + help-output fixes on
193
193
  0.2.0
194
194
 
195
195
  0.2.1
196
+
197
+ 0.2.2
198
+
199
+ 0.2.3
@@ -9,7 +9,7 @@ Maintainers cutting CW releases should use `npm run release:check` from
9
9
  files can check compatibility with:
10
10
 
11
11
  ```bash
12
- node scripts/cw.js state check <run-id>
12
+ cw state check <run-id>
13
13
  ```
14
14
 
15
15
  Use `--state /path/to/state.json` when checking a state file outside the
@@ -333,3 +333,7 @@ _No behavioral change in v0.1.89 (CLI-surface golden-path + help-output fixes on
333
333
  0.2.0
334
334
 
335
335
  0.2.1
336
+
337
+ 0.2.2
338
+
339
+ 0.2.3
@@ -296,3 +296,7 @@ _No behavioral change in v0.1.89 (CLI-surface golden-path + help-output fixes on
296
296
  0.2.0
297
297
 
298
298
  0.2.1
299
+
300
+ 0.2.2
301
+
302
+ 0.2.3
package/docs/routines.md CHANGED
@@ -15,7 +15,7 @@ CW keeps routine data in:
15
15
  Create an API trigger:
16
16
 
17
17
  ```bash
18
- node scripts/cw.js routine create \
18
+ cw routine create \
19
19
  --kind api \
20
20
  --prompt "Handle this API event."
21
21
  ```
@@ -23,7 +23,7 @@ node scripts/cw.js routine create \
23
23
  Create a GitHub trigger:
24
24
 
25
25
  ```bash
26
- node scripts/cw.js routine create \
26
+ cw routine create \
27
27
  --kind github \
28
28
  --prompt "Review this GitHub event." \
29
29
  --match '{"action":"opened"}'
@@ -32,13 +32,13 @@ node scripts/cw.js routine create \
32
32
  Fire a trigger from a payload file:
33
33
 
34
34
  ```bash
35
- node scripts/cw.js routine fire github payload.json
35
+ cw routine fire github payload.json
36
36
  ```
37
37
 
38
38
  Inspect events:
39
39
 
40
40
  ```bash
41
- node scripts/cw.js routine events
41
+ cw routine events
42
42
  ```
43
43
 
44
44
  ## Long Architecture Reviews
@@ -251,25 +251,25 @@ freshness, and provenance back to its `.cw/runs/<id>/`. Filter with `--app` and
251
251
  ## CLI
252
252
 
253
253
  ```text
254
- node scripts/cw.js registry refresh [--scope repo|home] [--json]
255
- node scripts/cw.js registry show [--scope repo|home] [--json]
256
- node scripts/cw.js run search [--app ID] [--status STATE] [--text Q] [--repo PATH] [--since ISO] [--until ISO] [--limit N] [--offset N] [--scope repo|home] [--json]
257
- node scripts/cw.js run list [--scope repo|home] [--json]
258
- node scripts/cw.js run show <run-id> [--scope repo|home] [--json]
259
- node scripts/cw.js run resume <run-id> [--limit N] [--drive [--once]] [--json]
260
- node scripts/cw.js run archive <run-id> [--reason TEXT] [--unarchive]
261
- node scripts/cw.js run archive --older-than-days N [--state completed --state failed]
262
- node scripts/cw.js run rerun <run-id> [--reason TEXT]
263
- node scripts/cw.js run export <run-id> --output PATH
264
- node scripts/cw.js run import PATH --target DIR
265
- node scripts/cw.js run verify-import <run-id> [--cwd DIR]
266
- node scripts/cw.js run inspect-archive PATH [--json]
267
- node scripts/cw.js run restore PATH --target DIR [--json]
268
- node scripts/cw.js queue add [--app ID|--workflow ID|--runId ID] [--repo PATH] [--priority N] [--note TEXT]
269
- node scripts/cw.js queue list [--status STATE] [--repo PATH] [--json]
270
- node scripts/cw.js queue show <queue-id>
271
- node scripts/cw.js queue drain [--limit N] [--repo PATH]
272
- node scripts/cw.js history [--app ID] [--status STATE] [--limit N] [--offset N] [--scope repo|home] [--json]
254
+ cw registry refresh [--scope repo|home] [--json]
255
+ cw registry show [--scope repo|home] [--json]
256
+ cw run search [--app ID] [--status STATE] [--text Q] [--repo PATH] [--since ISO] [--until ISO] [--limit N] [--offset N] [--scope repo|home] [--json]
257
+ cw run list [--scope repo|home] [--json]
258
+ cw run show <run-id> [--scope repo|home] [--json]
259
+ cw run resume <run-id> [--limit N] [--drive [--once]] [--json]
260
+ cw run archive <run-id> [--reason TEXT] [--unarchive]
261
+ cw run archive --older-than-days N [--state completed --state failed]
262
+ cw run rerun <run-id> [--reason TEXT]
263
+ cw run export <run-id> --output PATH
264
+ cw run import PATH --target DIR
265
+ cw run verify-import <run-id> [--cwd DIR]
266
+ cw run inspect-archive PATH [--json]
267
+ cw run restore PATH --target DIR [--json]
268
+ cw queue add [--app ID|--workflow ID|--runId ID] [--repo PATH] [--priority N] [--note TEXT]
269
+ cw queue list [--status STATE] [--repo PATH] [--json]
270
+ cw queue show <queue-id>
271
+ cw queue drain [--limit N] [--repo PATH]
272
+ cw history [--app ID] [--status STATE] [--limit N] [--offset N] [--scope repo|home] [--json]
273
273
  ```
274
274
 
275
275
  Read commands print short human panels by default (lifecycle, freshness, counts,
@@ -476,3 +476,7 @@ _No behavioral change in v0.1.89 (CLI-surface golden-path + help-output fixes on
476
476
  0.2.0
477
477
 
478
478
  0.2.1
479
+
480
+ 0.2.2
481
+
482
+ 0.2.3
@@ -265,3 +265,7 @@ _No behavioral change in v0.1.89 (CLI-surface golden-path + help-output fixes on
265
265
  0.2.0
266
266
 
267
267
  0.2.1
268
+
269
+ 0.2.2
270
+
271
+ 0.2.3
@@ -14,7 +14,7 @@ CW keeps schedules in:
14
14
  Make a `/loop`-ready schedule:
15
15
 
16
16
  ```bash
17
- node scripts/cw.js loop \
17
+ cw loop \
18
18
  --intervalMinutes 30 \
19
19
  --prompt "Check this workflow and continue if work is due."
20
20
  ```
@@ -22,7 +22,7 @@ node scripts/cw.js loop \
22
22
  Make a loop:
23
23
 
24
24
  ```bash
25
- node scripts/cw.js schedule create \
25
+ cw schedule create \
26
26
  --kind loop \
27
27
  --intervalMinutes 30 \
28
28
  --prompt "Check this workflow and continue if work is due."
@@ -31,7 +31,7 @@ node scripts/cw.js schedule create \
31
31
  Make a cron schedule:
32
32
 
33
33
  ```bash
34
- node scripts/cw.js schedule create \
34
+ cw schedule create \
35
35
  --kind cron \
36
36
  --cron "*/15 * * * *" \
37
37
  --prompt "Run the due workflow scan."
@@ -40,7 +40,7 @@ node scripts/cw.js schedule create \
40
40
  Make a reminder:
41
41
 
42
42
  ```bash
43
- node scripts/cw.js schedule create \
43
+ cw schedule create \
44
44
  --kind reminder \
45
45
  --delayMinutes 60 \
46
46
  --prompt "Remind me to inspect the report."
@@ -49,26 +49,26 @@ node scripts/cw.js schedule create \
49
49
  List and look through:
50
50
 
51
51
  ```bash
52
- node scripts/cw.js schedule list
53
- node scripts/cw.js schedule due
54
- node scripts/cw.js schedule complete <schedule-id>
55
- node scripts/cw.js schedule pause <schedule-id>
56
- node scripts/cw.js schedule resume <schedule-id>
57
- node scripts/cw.js schedule run-now <schedule-id>
58
- node scripts/cw.js schedule history <schedule-id>
59
- node scripts/cw.js schedule delete <schedule-id>
52
+ cw schedule list
53
+ cw schedule due
54
+ cw schedule complete <schedule-id>
55
+ cw schedule pause <schedule-id>
56
+ cw schedule resume <schedule-id>
57
+ cw schedule run-now <schedule-id>
58
+ cw schedule history <schedule-id>
59
+ cw schedule delete <schedule-id>
60
60
  ```
61
61
 
62
62
  Run the local desktop-like daemon one time:
63
63
 
64
64
  ```bash
65
- node scripts/cw.js schedule daemon --once
65
+ cw schedule daemon --once
66
66
  ```
67
67
 
68
68
  Run it without stopping:
69
69
 
70
70
  ```bash
71
- node scripts/cw.js schedule daemon --intervalSeconds 60
71
+ cw schedule daemon --intervalSeconds 60
72
72
  ```
73
73
 
74
74
  ## Notes
@@ -51,22 +51,52 @@ The agent host must still make certain of OS-level read isolation, write isolati
51
51
  limits on process execution, limits on network, and environment filtering.
52
52
  The audit layer lets you look at that boundary; it is not a kernel.
53
53
 
54
+ ## Requiring Attested Telemetry
55
+
56
+ `CW_REQUIRE_ATTESTED_TELEMETRY=1` (or `--require-attested-telemetry`, or a
57
+ durable `agent-config.json` field) is an opt-in, off-by-default gate: once
58
+ on, CW refuses to accept ANY worker result whose usage telemetry is not
59
+ cryptographically `attested` — a delegated hop whose signature does not
60
+ verify, and now also a MANUAL accept (`cw worker output`, `cw result`) that
61
+ carries no delegation telemetry at all. The manual shape used to slip past
62
+ the gate silently; it is now blocked the same way, with its own code
63
+ (`telemetry-missing-blocked`, distinct from a present-but-unverified hop's
64
+ `telemetry-unattested-blocked`).
65
+
66
+ An operator who genuinely needs to accept an unattested manual result under
67
+ the require flag passes `--allow-unattested` (MCP: `allowUnattested`). This
68
+ is never silent: it writes a `telemetry.gate-override` trust-audit event
69
+ (`decision: "allowed"`, `source: "operator"`) into the same hash-chained log
70
+ every other audit decision goes through, so the override itself is part of
71
+ the auditable record, not a hole in it.
72
+
73
+ A result-cache hit (the drive loop replaying a previously accepted result) is
74
+ never re-blocked by this gate — the underlying result was already gated (or
75
+ overridden) at its first acceptance. When the require flag is on, a cache
76
+ accept still records a `telemetry.cache-accept` event, so the audit trail
77
+ shows which accepts came from a fresh hop and which from the cache.
78
+
79
+ With the require flag off (the default), none of this changes: a plain
80
+ `cw worker output` / `cw result` behaves exactly as before.
81
+
54
82
  ## CLI
55
83
 
56
84
  ```bash
57
- node scripts/cw.js audit summary <run-id>
58
- node scripts/cw.js audit worker <run-id> <worker-id>
59
- node scripts/cw.js audit provenance <run-id> [--worker ID|--candidate ID|--commit ID]
60
- node scripts/cw.js audit multi-agent <run-id>
61
- node scripts/cw.js audit policy <run-id>
62
- node scripts/cw.js audit role <run-id> <role-id>
63
- node scripts/cw.js audit blackboard <run-id>
64
- node scripts/cw.js audit judge <run-id>
65
- node scripts/cw.js audit attest <run-id> --worker <worker-id> --hostEnforced true
66
- node scripts/cw.js audit decision <run-id> <worker-id> --path <path>
67
- node scripts/cw.js audit decision <run-id> <worker-id> --command "npm test"
68
- node scripts/cw.js audit decision <run-id> <worker-id> --network example.com
69
- node scripts/cw.js audit decision <run-id> <worker-id> --env SECRET_NAME
85
+ cw audit summary <run-id>
86
+ cw audit worker <run-id> <worker-id>
87
+ cw audit provenance <run-id> [--worker ID|--candidate ID|--commit ID]
88
+ cw audit multi-agent <run-id>
89
+ cw audit policy <run-id>
90
+ cw audit role <run-id> <role-id>
91
+ cw audit blackboard <run-id>
92
+ cw audit judge <run-id>
93
+ cw audit attest <run-id> --worker <worker-id> --hostEnforced true
94
+ cw audit decision <run-id> <worker-id> --path <path>
95
+ cw audit decision <run-id> <worker-id> --command "npm test"
96
+ cw audit decision <run-id> <worker-id> --network example.com
97
+ cw audit decision <run-id> <worker-id> --env SECRET_NAME
98
+ cw worker output <run-id> <worker-id> <result-file> [--allow-unattested]
99
+ cw result <run-id> <task-id> <result-file> [--allow-unattested]
70
100
  ```
71
101
 
72
102
  Denied audit decisions are put into audit files and joined to feedback/error
@@ -84,14 +84,14 @@ folded.
84
84
  ## CLI
85
85
 
86
86
  ```text
87
- node scripts/cw.js summary refresh <run-id> [--json] [--view <view> ...]
88
- node scripts/cw.js summary show <run-id> [--json]
89
- node scripts/cw.js blackboard summarize <run-id> [--json]
90
- node scripts/cw.js multi-agent summarize <run-id> [--json]
91
- node scripts/cw.js multi-agent graph <run-id> --view compact [--json]
92
- node scripts/cw.js multi-agent graph <run-id> --view critical-path [--json]
93
- node scripts/cw.js multi-agent graph <run-id> --focus <id> --depth <n> [--json]
94
- node scripts/cw.js report <run-id> --show
87
+ cw summary refresh <run-id> [--json] [--view <view> ...]
88
+ cw summary show <run-id> [--json]
89
+ cw blackboard summarize <run-id> [--json]
90
+ cw multi-agent summarize <run-id> [--json]
91
+ cw multi-agent graph <run-id> --view compact [--json]
92
+ cw multi-agent graph <run-id> --view critical-path [--json]
93
+ cw multi-agent graph <run-id> --focus <id> --depth <n> [--json]
94
+ cw report <run-id> --show
95
95
  ```
96
96
 
97
97
  Every command supports deterministic JSON with `--json` or `--format json`.
@@ -106,8 +106,8 @@ summaries and tells the operator how to look at the full data, for example:
106
106
 
107
107
  ```text
108
108
  Graph compacted: 420 nodes collapsed into 18 summary nodes
109
- Use: node scripts/cw.js multi-agent graph <run-id> --view full --json
110
- Use: node scripts/cw.js blackboard message list <run-id> --topic <topic-id>
109
+ Use: cw multi-agent graph <run-id> --view full --json
110
+ Use: cw blackboard message list <run-id> --topic <topic-id>
111
111
  ```
112
112
 
113
113
  ## MCP parity
@@ -322,3 +322,7 @@ _No behavioral change in v0.1.89 (CLI-surface golden-path + help-output fixes on
322
322
  0.2.0
323
323
 
324
324
  0.2.1
325
+
326
+ 0.2.2
327
+
328
+ 0.2.3