cool-workflow 0.1.85 → 0.1.87

package/docs/cli-mcp-parity.7.md

@@ -64,6 +64,16 @@ ISO timestamps from the moment of generation. The `--json` payload is the
 contract, and it is the same bytes the MCP tool gives back. The human text view
 is policy put on top; it never changes the payload.
 
+Some payload checks need more than `cwd` or `runId`. The registry may name a
+scenario probe for a safe local case. A scenario gets two new temp workspaces,
+one for CLI and one for MCP, sets up the same state, runs one capability through
+each door, and then compares the payload after taking out temp roots, run ids,
+time stamps, and chain hashes that are made by that workspace. This is used for
+local deterministic work such as app show/validate/package, topology
+show/validate/apply/summary/graph, sandbox show/validate/choose/resolve, state
+summary refresh/show, `plan`, `approve`, `reject`, `comment.add`, `handoff`, and
+`review.policy`.
+
 ## The Parity Matrix
 
 The matrix below is made from the live registry — one row per capability,
@@ -72,7 +82,7 @@ relationship. `identical` means `cw <cmd> --json` is equal to the `cw_<tool>`
 payload; `projected` means a declared divergence with a reason; `cli-only` marks
 a surface-specific capability with a recorded reason. The matrix is
 <!-- gen:parity:count -->
-machine-complete by design: 193 capabilities, 186 MCP tools.
+machine-complete by design: 196 capabilities, 186 MCP tools.
 <!-- /gen:parity:count -->
 
 <!-- gen:parity:table -->
@@ -80,6 +90,9 @@ machine-complete by design: 193 capabilities, 186 MCP tools.
 | --- | --- | --- | --- | --- | --- |
 | `help` | `cw help` | `—` | `formatHelp` | cli-only | cli-only |
 | `list` | `cw list` | `cw_list` | `listWorkflows` | both | identical |
+| `info` | `cw info` | `—` | `showApp` | cli-only | cli-only |
+| `search` | `cw search` | `—` | `listApps` | cli-only | cli-only |
+| `man` | `cw man` | `—` | `n/a` | cli-only | cli-only |
 | `doctor` | `cw doctor` | `—` | `runDoctor` | cli-only | cli-only |
 | `init` | `cw init` | `cw_init` | `init` | both | identical |
 | `plan` | `cw plan` | `cw_plan` | `planSummary` | both | identical |
@@ -285,9 +298,12 @@ A capability may be on one surface only, but never without word of it — it mus
 carry a recorded reason in the registry.
 
 <!-- gen:parity:cliOnly -->
-Seven capabilities are CLI-only:
+Ten capabilities are CLI-only:
 
 - `help` — Human help text. MCP hosts enumerate capabilities via tools/list, not a help command.
+- `info` — Human-focused workflow discovery tool (like Homebrew's `brew info`). MCP agents discover workflows via cw_list and cw_app_show tools.
+- `search` — Human-focused workflow discovery (like Homebrew's `brew search`). MCP agents discover workflows via cw_list tool.
+- `man` — Human documentation viewer. MCP agents read docs/ directly via file tools.
 - `doctor` — Environment diagnostics are inherently local to the CLI host — Node version, $PATH, $CW_HOME/cwd writability. An MCP client diagnosing the server process's environment is not meaningful; agents already receive the same readiness facts in their typed results (e.g. status: blocked, agentConfigured). Inspired by `brew doctor`.
 - `loop` — Convenience alias of `schedule create` with kind=loop. MCP hosts use cw_schedule_create with kind=loop.
 - `schedule daemon` — Long-running desktop daemon process, not a request/response tool. MCP hosts drive ticks via cw_schedule_due + cw_schedule_run_now.
@@ -332,10 +348,23 @@ of the rules above.
 registry ⇄ CLI ⇄ MCP coverage (every declared capability is found on its declared
 surfaces and nothing live is undeclared), makes sure `--json` output is equal to
 the MCP payload for every `payloadIdentical` capability, makes sure of the
-declared `commit` projection, and makes sure of fail-closed behavior by putting in
-drift — a peer taken away, an undeclared tool, an exception with no reason, a
-changed payload — and checking that the gate says no to each one. It is part of
-`npm test` and `npm run release:check`.
+declared `commit` projection, checks that safe write/multi-argument capabilities
+are named scenario probes rather than deferred work, and makes sure of
+fail-closed behavior by putting in drift — a peer taken away, an undeclared tool,
+an exception with no reason, a bad probe classification, a changed payload — and
+checking that the gate says no to each one. It is part of `npm test` and
+`npm run release:check`.
+
+The scenario probes now cover local worker/candidate/feedback read and write
+paths. They make temp runs, send out a worker, write a fixed `result.md`, score
+and pick a candidate, and make feedback from local state. No outside agent is
+run; the probe checks only that CLI and MCP carry the same JSON to the same CW
+core.
+
+They also cover local state-node read, snapshot, diff, replay, and replay-check
+paths from the same temp run. Snapshot and replay ids are made by CW, so the
+parity check sets aside only those made ids and timestamps before it compares the
+JSON.
 
 In CW, parity is not a custom; it is a built, declared, and kept property of the
 build. It is not done till it is put in the docs and tested.
@@ -472,3 +501,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/contract-migration-tooling.7.md

@@ -143,3 +143,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/control-plane-scheduling.7.md

@@ -127,3 +127,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/dogfood-one-real-repo.7.md

@@ -89,12 +89,20 @@ report, and audit tools.
 
 ```bash
 node test/dogfood-release-smoke.js
+node test/dogfood-architecture-review-smoke.js
 ```
 
 The smoke test runs `scripts/dogfood-release.js --smoke --json`. It still
 uses the real repository, `release-cut`, worker manifests, trust audit records,
 candidate scoring, selection, verifier-gated commit, and a report, but keeps the
-command set smaller so it does not do recursive release checking.
+command set smaller so it does not do recursive release checking. Smoke mode
+does not run `canonical-apps` or `golden-path`; `npm test` runs those checks as
+separate smokes.
+
+The architecture-review smoke runs beside it. That smoke uses a stub agent to
+drive the real `architecture-review` app to a report and audit proof. Keeping it
+as a second smoke lets the parallel gate run both dogfood halves at the same
+time while keeping the same proof.
 
 ## Promote To Real Release Actions
 

package/docs/durable-state-and-locking.7.md

@@ -126,3 +126,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/evidence-adoption-reasoning-chain.7.md

@@ -287,3 +287,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/execution-backends.7.md

@@ -317,3 +317,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/getting-started.md

@@ -17,6 +17,8 @@ start a run:
 ```bash
 node scripts/cw.js doctor          # human-readable
 node scripts/cw.js doctor --json   # stable payload for scripts
+node scripts/cw.js doctor --onramp # short path for users and code work
+node scripts/cw.js doctor --onramp --changed-from origin/main
 ```
 
 It checks the Node version (v18+), whether an agent backend is set up (and its
@@ -26,6 +28,22 @@ read-only — it makes nothing on disk. It exits non-zero only on a blocking
 problem; a missing agent is a warning (you are still able to run `demo` and
 `--preview`).
 
+Use `--onramp` when you are not certain what to do next. It keeps the main path
+small:
+
+1. `cw demo tamper` - prove the trust check with no agent.
+2. `cw quickstart architecture-review --check ...` - check a real run with no
+   writes.
+3. `cw quickstart architecture-review ...` - make the report.
+4. `cw quickstart architecture-review ... --bundle` - make a portable report
+   file for another person.
+5. `cw report verify-bundle report.cwrun.json` - check that file offline.
+6. `npm run test:fast` - use the fast code check while you work.
+7. `npm run release:check` - use the full gate only when the batch is ready.
+
+Add `--changed-from origin/main` in a source checkout to get the nearest smoke
+tests and guard checks for your current change.
+
 Make a run with a canonical workflow app:
 
 ```bash
@@ -73,17 +91,37 @@ node scripts/cw.js eval report .cw/evals/<suite-id>/replay-run.json
 node scripts/cw.js report <run-id> --show
 ```
 
-Run the deterministic regression commands. They give the same result every time:
+Run the smallest check that fits the change:
 
 ```bash
 npm run check
-npm test
+npm run build
+node test/<nearest-smoke>.js
+npm run onramp:check
+npm run test:fast
+npm test                    # slow serial backstop
 npm run canonical-apps
 npm run golden-path
 npm run eval:replay
 npm run fixture-compat
 ```
 
+When a test run is slow, make a read-only timing report:
+
+```bash
+npm run test:ci -- --json-summary /tmp/cw-test-summary.json
+```
+
+Use the `slowest` list in that file to choose one test-speed cycle. This is a
+guide, not a release gate.
+
+For a CLI or MCP surface change, also run:
+
+```bash
+npm run parity:check
+npm run gen:manifests -- --check
+```
+
 Before you cut a release, run the full dry-run gate:
 
 ```bash

package/docs/index.md

@@ -1,43 +1,56 @@
 # Cool Workflow Docs
 
-Read these in order when you are new to CW:
-
-1. [Getting Started](getting-started.md) - clone, install, run a workflow, inspect it, and run the release check.
-2. [Project Index](project-index.md) - code-derived map of source modules, workflow apps, docs, tests, and sync targets.
-3. [Workflow App framework](workflow-app-framework.7.md) - userland app manifests, entrypoints, compatibility, and validation.
-4. [Sandbox Profiles](sandbox-profiles.7.md) - named worker policy contracts for read/write/execute/network/env handling.
-5. [Security / Trust Hardening](security-trust-hardening.7.md) - audit records, provenance, sandbox attestations, and acceptance rationale.
-   - [Trust Model & Limitations](trust-model.md) - what the ed25519 + hash-chain tamper-evidence proves and what it does **not** (the single-keyholder ceiling). Read this before you trust a green verdict.
-6. [Multi-Agent Runtime Core](multi-agent-runtime-core.7.md) - first-class MultiAgentRun, roles, groups, memberships, fanout, fanin, and lifecycle state.
-7. [Coordinator / Blackboard](coordinator-blackboard.7.md) - shared topics, messages, context frames, artifact refs, snapshots, decisions, conflicts, and fanin evidence.
-8. [Multi-Agent Topologies](multi-agent-topologies.7.md) - official map-reduce, debate, and judge-panel recipes built on multi-agent and blackboard records.
-9. [Multi-Agent CLI + MCP Surface](multi-agent-cli-mcp-surface.7.md) - preferred host loop for run, status, step, blackboard, score, and select.
-10. [Multi-Agent Operator UX](multi-agent-operator-ux.7.md) - graph, dependencies, failures, and evidence adoption for topology-backed multi-agent runs.
-11. [Multi-Agent Trust / Policy / Audit](multi-agent-trust-policy-audit.7.md) - role authority, message provenance, blackboard write audit, judge rationale, and policy violations.
-12. [Multi-Agent Eval & Replay Harness](multi-agent-eval-replay-harness.7.md) - snapshots, isolated replays, comparison, scoring, gates, reports, and MCP parity.
-13. [State Explosion Management](state-explosion-management.7.md) - durable summary records, compact and focused graph views, blackboard digests, and stale-aware compaction for large multi-agent runs.
-14. [Evidence Adoption Reasoning Chain](evidence-adoption-reasoning-chain.7.md) - derived, fingerprinted reasoning chains explaining why each evidence item was adopted/rejected with basis, authority, rationale, and counterfactual, and a fail-closed `unexplained` state.
-15. [Run Registry / Control Plane](run-registry-control-plane.7.md) - derived, fingerprinted, fail-closed index over runs across repos: search, resume, archive, durable queue, cross-repo history, and failed-run rerun with provenance.
-16. [Execution Backends](execution-backends.7.md) - the pluggable driver layer (node/bun/shell/container/remote/ci): one narrow `ExecutionBackend` contract, sandbox attestation, identical envelopes across backends, and fail-closed delegation.
-17. [Operator UX](operator-ux.7.md) - `status`, `graph`, report, worker, candidate, feedback, commit, topology, multi-agent, blackboard, coordinator, and trust summaries.
-18. [MCP App Surface](mcp-app-surface.7.md) - JSON tool parity for agent hosts.
-19. [CLI ↔ MCP Parity](cli-mcp-parity.7.md) - the capability registry and fail-closed gate proving the CLI and MCP surfaces render one data source.
-20. [End-to-End Golden Path](end-to-end-golden-path.7.md) - deterministic proof of app, worker, verifier, candidate, commit, and report flow.
-21. [Dogfood One Real Repo](dogfood-one-real-repo.7.md) - dry-run release proof against the real Cool Workflow repository.
-22. [Web / Desktop Workbench](web-desktop-workbench.7.md) - a read-only, localhost-only human console rendering the run graph, blackboard, worker logs, candidate compare, and audit timeline over existing capability payloads — a third front door that holds no authoritative state.
-23. [Observability + Cost Accounting](observability-cost-accounting.7.md) - derived time/duration, failure/verifier/acceptance rates with sample counts and fail-closed `n/a`, plus host-attested token usage and attested-vs-estimated cost with explicit `unreported` coverage; pricing is policy as data.
-24. [Team Collaboration](team-collaboration.7.md) - host-attested actor, append-only approvals/rejections/comments/handoffs provenance-linked to durable targets, and a review gate that stacks on the verifier gate (required approvals from authorized roles, fail-closed quorum/authority/self-approval); policy is data.
-25. [Release And Migration](release-and-migration.7.md) - release and migration discipline for durable run state.
-26. [Release Tooling](release-tooling.7.md) - one-command version bump across every surface, a per-feature scaffolder, forward-reference doc automation, and a de-duplicated release gate.
-27. [Real Execution Backend Integrations](real-execution-backends.7.md) - container/remote/ci backends really execute (docker/podman run, remote/CI POST-and-poll) under the sandbox contract, byte-stable evidence vs node, fail-closed on an unavailable runtime/endpoint.
-28. [Node Snapshot / Diff / Replay](node-snapshot-diff-replay.7.md) - per-node snapshot, structural diff, and isolated deterministic replay over StateNode, reusing the eval harness; sha256-fingerprinted with fail-closed `valid|stale|absent` freshness.
-29. [Contract Migration Tooling](contract-migration-tooling.7.md) - a declared migration registry (run-state + workflow-app) with per-edge compatibility proofs, fail-closed reachability, and a round-trip/non-destruction prover over the existing migrateRunState pipeline.
-30. [Control-Plane Scheduling](control-plane-scheduling.7.md) - priority + hard concurrency ceiling + lease lifecycle + retry/backoff + fail-closed park policy over the v0.1.28 Run Registry queue; policy-as-data, deterministic, with a read-only `sched plan`.
-31. [Agent Delegation Drive](agent-delegation-drive.7.md) - the `agent` backend delegates each worker to an EXTERNAL agent process (claude/codex/HTTP endpoint) and `run --drive` auto-advances plan→dispatch→fulfill→accept→commit; the model runs in the agent's process, never in CW. Two-layer evidence, operator-vs-attested model, fail-closed park, replay without re-spawn.
-32. [Run Retention & Provable Reclamation](run-retention-reclamation.7.md) - tiered, append-only, cryptographically-verifiable disk reclamation over the v0.1.28 archive overlay: seal the audit skeleton, free the reconstructable/scratch bulk, and prove it via a hash-chained tombstone; `gc plan|run|verify`, write-ahead + fail-closed, explicit capability downgrade.
-33. [Durable State & Locking](durable-state-and-locking.7.md) - atomic (temp→rename) writes for every authoritative store with fsync-durability for the audit-essential ones, plus a portable stale-stealing file lock serializing the cross-process read-modify-write stores (home queue, archive overlay, reclamation chain); closes the prior verdict's non-atomic/unlocked P1.
-34. [Source Context Profiles](source-context-profiles.7.md) - opt-in JSONL source exports for AI context slimming, with profile policy in manifest data and manifest records proving every included or omitted tracked file.
-35. [Verifiable Report Bundle](report-verifiable-bundle.7.md) - embed the operator's ed25519 public key into a portable run archive so anyone can `report verify-bundle` it OFFLINE and self-contained (archive bytes + telemetry chain + trust-audit chain + signatures); `report bundle` produces-and-proves in one command. Fail-closed, no repo/key/install beyond npx.
+Start with the first run. Use the developer loop when you change code. Read the
+advanced pages only when you need those parts.
+
+## First Run
+
+1. [Getting Started](getting-started.md) - clone, install, run `doctor --onramp`, run one workflow, inspect it, and run the right check.
+2. [End-to-End Golden Path](end-to-end-golden-path.7.md) - deterministic proof of app, worker, verifier, candidate, commit, and report flow.
+3. [Verifiable Report Bundle](report-verifiable-bundle.7.md) - make a portable report bundle and verify it offline.
+4. [Trust Model & Limitations](trust-model.md) - what the ed25519 and hash-chain proof does and does not prove.
+
+## Developer Loop
+
+1. [Project Index](project-index.md) - code-derived map of source modules, workflow apps, docs, tests, and sync targets.
+2. [Workflow App framework](workflow-app-framework.7.md) - userland app manifests, entrypoints, compatibility, and validation.
+3. [Sandbox Profiles](sandbox-profiles.7.md) - named worker policy contracts for read/write/execute/network/env handling.
+4. [CLI <-> MCP Parity](cli-mcp-parity.7.md) - the capability registry and fail-closed gate proving the CLI and MCP surfaces render one data source.
+5. [Release And Migration](release-and-migration.7.md) - release and migration discipline for durable run state.
+6. [Release Tooling](release-tooling.7.md) - version bump, feature scaffold, forward-reference docs, and release gates.
+7. [Cool Workflow Release History](release-history.md) - long capability notes moved out of the README.
+
+## Advanced And Multi-Agent
+
+1. [Agent Delegation Drive](agent-delegation-drive.7.md) - the `agent` backend delegates workers to an external process and drives plan -> report.
+2. [Run Registry / Control Plane](run-registry-control-plane.7.md) - search, resume, archive, queue, history, and rerun across repos.
+3. [Execution Backends](execution-backends.7.md) - node/bun/shell/container/remote/ci drivers, sandbox attestation, and fail-closed delegation.
+4. [Multi-Agent Runtime Core](multi-agent-runtime-core.7.md) - MultiAgentRun, roles, groups, memberships, fanout, fanin, and lifecycle state.
+5. [Coordinator / Blackboard](coordinator-blackboard.7.md) - topics, messages, context, artifacts, snapshots, decisions, conflicts, and fanin evidence.
+6. [Multi-Agent Topologies](multi-agent-topologies.7.md) - map-reduce, debate, and judge-panel recipes.
+7. [Multi-Agent CLI + MCP Surface](multi-agent-cli-mcp-surface.7.md) - host loop for run, status, step, blackboard, score, and select.
+8. [Multi-Agent Operator UX](multi-agent-operator-ux.7.md) - graph, dependencies, failures, and evidence adoption.
+9. [Multi-Agent Trust / Policy / Audit](multi-agent-trust-policy-audit.7.md) - role authority, message provenance, blackboard audit, judge rationale, and policy violations.
+10. [Multi-Agent Eval & Replay Harness](multi-agent-eval-replay-harness.7.md) - snapshots, replay, comparison, scoring, gates, reports, and MCP parity.
+
+## Reference
+
+- [Operator UX](operator-ux.7.md) - `status`, `graph`, reports, worker, candidate, feedback, commit, topology, blackboard, coordinator, and trust summaries.
+- [MCP App Surface](mcp-app-surface.7.md) - JSON tool parity for agent hosts.
+- [Dogfood One Real Repo](dogfood-one-real-repo.7.md) - dry-run release proof against this repository.
+- [Web / Desktop Workbench](web-desktop-workbench.7.md) - read-only localhost console over existing run state.
+- [Observability + Cost Accounting](observability-cost-accounting.7.md) - derived durations, rates, token usage, and cost.
+- [Team Collaboration](team-collaboration.7.md) - append-only approvals, comments, handoffs, and review gates.
+- [Real Execution Backend Integrations](real-execution-backends.7.md) - real container/remote/ci execution under the sandbox contract.
+- [Node Snapshot / Diff / Replay](node-snapshot-diff-replay.7.md) - per-node snapshots, structural diff, and deterministic replay.
+- [Contract Migration Tooling](contract-migration-tooling.7.md) - declared migration registry and compatibility proofs.
+- [Control-Plane Scheduling](control-plane-scheduling.7.md) - priority, leases, retry/backoff, and scheduling policy.
+- [Run Retention & Provable Reclamation](run-retention-reclamation.7.md) - tiered, hash-chained disk reclamation.
+- [Durable State & Locking](durable-state-and-locking.7.md) - atomic writes, fsync durability, and portable file locks.
+- [Source Context Profiles](source-context-profiles.7.md) - opt-in JSONL source exports for context slimming.
+- [Security / Trust Hardening](security-trust-hardening.7.md) - audit records, provenance, sandbox attestations, and acceptance rationale.
+- [State Explosion Management](state-explosion-management.7.md) - summaries, compact graph views, blackboard digests, and stale-aware compaction.
+- [Evidence Adoption Reasoning Chain](evidence-adoption-reasoning-chain.7.md) - why evidence was adopted or rejected.
 
 CW is the base system. Workflow apps are userland. Release and migration rules
 must keep that line clear: stable contracts, clear compatibility checks, and

package/docs/multi-agent-cli-mcp-surface.7.md

@@ -285,3 +285,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/multi-agent-eval-replay-harness.7.md

@@ -319,3 +319,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/multi-agent-operator-ux.7.md

@@ -331,3 +331,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/node-snapshot-diff-replay.7.md

@@ -152,3 +152,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/observability-cost-accounting.7.md

@@ -211,3 +211,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/project-index.md

@@ -1,15 +1,15 @@
 # Cool Workflow Project Index
 
-Generated from the current repository code on 2026-06-18 by `npm run sync:project-index`.
+Generated from the current repository code on 2026-06-19 by `npm run sync:project-index`.
 
 ## Snapshot
 
 - Package: `cool-workflow`
-- Version: `0.1.85`
-- Source modules: `62`
+- Version: `0.1.87`
+- Source modules: `64`
 - Workflow apps: `7`
-- Docs: `50`
-- Smoke tests: `101`
+- Docs: `51`
+- Smoke tests: `115`
 - Repository: https://github.com/coo1white/cool-workflow
 
 ## Architecture
@@ -99,6 +99,7 @@ multi-agent host -> topology -> blackboard/coordinator
 - [node-projection.ts](../src/node-projection.ts)
 - [node-snapshot.ts](../src/node-snapshot.ts)
 - [observability.ts](../src/observability.ts)
+- [onramp.ts](../src/onramp.ts)
 - [reclamation.ts](../src/reclamation.ts)
 - [result-normalize.ts](../src/result-normalize.ts)
 - [run-export.ts](../src/run-export.ts)
@@ -111,6 +112,7 @@ multi-agent host -> topology -> blackboard/coordinator
 - [telemetry-attestation.ts](../src/telemetry-attestation.ts)
 - [telemetry-demo.ts](../src/telemetry-demo.ts)
 - [telemetry-ledger.ts](../src/telemetry-ledger.ts)
+- [term.ts](../src/term.ts)
 - [validation.ts](../src/validation.ts)
 - [workbench-host.ts](../src/workbench-host.ts)
 - [workbench.ts](../src/workbench.ts)
@@ -160,6 +162,7 @@ multi-agent host -> topology -> blackboard/coordinator
 - [Cool Workflow Project Index](project-index.md)
 - [Real Execution Backend Integrations](real-execution-backends.7.md)
 - [Release And Migration Discipline](release-and-migration.7.md)
+- [Cool Workflow Release History](release-history.md)
 - [Release Tooling](release-tooling.7.md)
 - [Verifiable Report Bundle](report-verifiable-bundle.7.md)
 - [Routines](routines.md)
@@ -190,6 +193,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [artifact-integrity-smoke.js](../test/artifact-integrity-smoke.js)
 - [audit-verify-smoke.js](../test/audit-verify-smoke.js)
 - [backend-registry-smoke.js](../test/backend-registry-smoke.js)
+- [blackboard-state-explosion-management-smoke.js](../test/blackboard-state-explosion-management-smoke.js)
 - [block-unapproved-tag-smoke.js](../test/block-unapproved-tag-smoke.js)
 - [bump-version-idempotent-smoke.js](../test/bump-version-idempotent-smoke.js)
 - [candidate-scoring-smoke.js](../test/candidate-scoring-smoke.js)
@@ -198,6 +202,8 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [cli-command-surface-smoke.js](../test/cli-command-surface-smoke.js)
 - [cli-jsonmode-parity-smoke.js](../test/cli-jsonmode-parity-smoke.js)
 - [cli-mcp-parity-smoke.js](../test/cli-mcp-parity-smoke.js)
+- [codex-agent-wrapper-smoke.js](../test/codex-agent-wrapper-smoke.js)
+- [concurrency-default-smoke.js](../test/concurrency-default-smoke.js)
 - [concurrent-failure-semantics-smoke.js](../test/concurrent-failure-semantics-smoke.js)
 - [concurrent-workflow-dsl-smoke.js](../test/concurrent-workflow-dsl-smoke.js)
 - [contract-migration-tooling-smoke.js](../test/contract-migration-tooling-smoke.js)
@@ -206,6 +212,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [demo-bundle-smoke.js](../test/demo-bundle-smoke.js)
 - [det-ids-b-smoke.js](../test/det-ids-b-smoke.js)
 - [doctor-smoke.js](../test/doctor-smoke.js)
+- [dogfood-architecture-review-smoke.js](../test/dogfood-architecture-review-smoke.js)
 - [dogfood-release-smoke.js](../test/dogfood-release-smoke.js)
 - [durable-atomic-write-smoke.js](../test/durable-atomic-write-smoke.js)
 - [end-to-end-demo-smoke.js](../test/end-to-end-demo-smoke.js)
@@ -216,6 +223,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [evidence-content-extraction-smoke.js](../test/evidence-content-extraction-smoke.js)
 - [execution-backends-smoke.js](../test/execution-backends-smoke.js)
 - [freebsd-audit-fixes-smoke.js](../test/freebsd-audit-fixes-smoke.js)
+- [gemini-agent-wrapper-smoke.js](../test/gemini-agent-wrapper-smoke.js)
 - [h7-custom-profile-persist-smoke.js](../test/h7-custom-profile-persist-smoke.js)
 - [mcp-app-surface-smoke.js](../test/mcp-app-surface-smoke.js)
 - [mcp-surface-registry-smoke.js](../test/mcp-surface-registry-smoke.js)
@@ -225,12 +233,17 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [multi-agent-eval-replay-smoke.js](../test/multi-agent-eval-replay-smoke.js)
 - [multi-agent-operator-ux-smoke.js](../test/multi-agent-operator-ux-smoke.js)
 - [multi-agent-runtime-core-smoke.js](../test/multi-agent-runtime-core-smoke.js)
-- [multi-agent-topologies-smoke.js](../test/multi-agent-topologies-smoke.js)
+- [multi-agent-topologies-debate-smoke.js](../test/multi-agent-topologies-debate-smoke.js)
+- [multi-agent-topologies-judge-panel-smoke.js](../test/multi-agent-topologies-judge-panel-smoke.js)
+- [multi-agent-topologies-map-reduce-smoke.js](../test/multi-agent-topologies-map-reduce-smoke.js)
 - [multi-agent-trust-policy-audit-smoke.js](../test/multi-agent-trust-policy-audit-smoke.js)
 - [no-false-green-smoke.js](../test/no-false-green-smoke.js)
 - [node-snapshot-diff-replay-smoke.js](../test/node-snapshot-diff-replay-smoke.js)
+- [npm-trusted-publish-smoke.js](../test/npm-trusted-publish-smoke.js)
 - [observability-cost-accounting-smoke.js](../test/observability-cost-accounting-smoke.js)
 - [one-way-boundary-smoke.js](../test/one-way-boundary-smoke.js)
+- [onramp-check-smoke.js](../test/onramp-check-smoke.js)
+- [opencode-agent-wrapper-smoke.js](../test/opencode-agent-wrapper-smoke.js)
 - [operator-ux-smoke.js](../test/operator-ux-smoke.js)
 - [parallel-onramp-smoke.js](../test/parallel-onramp-smoke.js)
 - [parity-doc-sync-smoke.js](../test/parity-doc-sync-smoke.js)
@@ -239,6 +252,8 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [pipeline-runner-smoke.js](../test/pipeline-runner-smoke.js)
 - [project-index-sync-smoke.js](../test/project-index-sync-smoke.js)
 - [quickstart-bundle-smoke.js](../test/quickstart-bundle-smoke.js)
+- [quickstart-check-smoke.js](../test/quickstart-check-smoke.js)
+- [quickstart-readme-path-smoke.js](../test/quickstart-readme-path-smoke.js)
 - [quickstart-smoke.js](../test/quickstart-smoke.js)
 - [real-execution-backends-smoke.js](../test/real-execution-backends-smoke.js)
 - [registry-corrupt-fail-closed-smoke.js](../test/registry-corrupt-fail-closed-smoke.js)
@@ -250,6 +265,7 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [result-normalize-smoke.js](../test/result-normalize-smoke.js)
 - [robustness-failclosed-smoke.js](../test/robustness-failclosed-smoke.js)
 - [robustness-hardening-smoke.js](../test/robustness-hardening-smoke.js)
+- [run-all-json-summary-smoke.js](../test/run-all-json-summary-smoke.js)
 - [run-export-import-smoke.js](../test/run-export-import-smoke.js)
 - [run-export-restore-rerun-smoke.js](../test/run-export-restore-rerun-smoke.js)
 - [run-export-restore-resume-smoke.js](../test/run-export-restore-resume-smoke.js)
@@ -265,9 +281,10 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [schema-validation-smoke.js](../test/schema-validation-smoke.js)
 - [security-trust-hardening-smoke.js](../test/security-trust-hardening-smoke.js)
 - [self-audit-hardening-smoke.js](../test/self-audit-hardening-smoke.js)
+- [source-context-batch-smoke.js](../test/source-context-batch-smoke.js)
 - [source-context-profile-smoke.js](../test/source-context-profile-smoke.js)
-- [state-explosion-management-smoke.js](../test/state-explosion-management-smoke.js)
 - [state-node-smoke.js](../test/state-node-smoke.js)
+- [surface-explicit-cwd-smoke.js](../test/surface-explicit-cwd-smoke.js)
 - [tamper-evidence-demo-smoke.js](../test/tamper-evidence-demo-smoke.js)
 - [team-collaboration-smoke.js](../test/team-collaboration-smoke.js)
 - [telemetry-attest-wrap-smoke.js](../test/telemetry-attest-wrap-smoke.js)

package/docs/real-execution-backends.7.md

@@ -159,3 +159,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing

package/docs/release-and-migration.7.md

@@ -68,7 +68,7 @@ changed.
 - `npm test`
 - `node test/multi-agent-runtime-core-smoke.js`
 - `node test/coordinator-blackboard-smoke.js`
-- `node test/multi-agent-topologies-smoke.js`
+- multi-agent topologies smoke coverage
 - `node test/multi-agent-eval-replay-harness-smoke.js`
 - `npm run eval:replay`
 - dogfood release smoke coverage
@@ -299,3 +299,9 @@ Loaders fail closed on corrupt state; store writes are made safe under more than
 No other change to this page in v0.1.84.
 
 0.1.85
+
+0.1.86
+
+## 0.1.87 (v0.1.87)
+
+npm test parallel, 4-vendor wrappers (Claude/Codex/Gemini/OpenCode), Homebrew-style CLI UX (colors/did-you-mean/categorized help/error tips/cw info/cw search/cw man/doctor --fix), post-success summaries, agent execution timing