cool-workflow 0.1.79 → 0.1.80

package/dist/state-explosion.js

@@ -48,13 +48,55 @@ exports.GRAPH_VIEWS = [
     "candidate",
     "commit-gate"
 ];
+function createStateExplosionBuildContext() {
+    return {
+        stateSizes: new Map(),
+        blackboardDigests: new Map(),
+        graphRecords: new Map()
+    };
+}
+function fullGraphFor(run, context) {
+    if (!context.fullGraph)
+        context.fullGraph = (0, multi_agent_operator_ux_1.buildMultiAgentOperatorGraph)(run);
+    return context.fullGraph;
+}
+function operatorFor(run, context) {
+    if (!context.operator)
+        context.operator = (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(run);
+    return context.operator;
+}
+function reasoningCriticalIdsFor(run, context) {
+    if (!context.reasoningCriticalIds)
+        context.reasoningCriticalIds = (0, evidence_reasoning_1.reasoningCriticalNodeIds)(run, operatorFor(run, context));
+    return context.reasoningCriticalIds;
+}
+function thresholdsKey(thresholds) {
+    return [
+        thresholds.graphNodes,
+        thresholds.graphEdges,
+        thresholds.blackboardMessages,
+        thresholds.blackboardRecords,
+        thresholds.collapseBucket,
+        thresholds.totalRecords
+    ].join(":");
+}
+function graphKey(view, options) {
+    return [
+        view,
+        options.focus || "",
+        options.depth === undefined ? "" : String(options.depth),
+        thresholdsKey(options.thresholds || exports.DEFAULT_STATE_EXPLOSION_THRESHOLDS)
+    ].join("\0");
+}
 // ---------------------------------------------------------------------------
 // State size
 // ---------------------------------------------------------------------------
 function computeStateSize(run, thresholds = exports.DEFAULT_STATE_EXPLOSION_THRESHOLDS) {
+    return computeStateSizeWithGraph(run, thresholds, (0, multi_agent_operator_ux_1.buildMultiAgentOperatorGraph)(run));
+}
+function computeStateSizeWithGraph(run, thresholds, graph) {
     const ma = run.multiAgent || { runs: [], roles: [], groups: [], memberships: [], fanouts: [], fanins: [] };
     const bb = run.blackboard || { topics: [], messages: [], contexts: [], artifacts: [], snapshots: [], decisions: [] };
-    const graph = (0, multi_agent_operator_ux_1.buildMultiAgentOperatorGraph)(run);
     const counts = {
         multiAgentRuns: (ma.runs || []).length,
         roles: (ma.roles || []).length,
@@ -97,6 +139,15 @@ function computeStateSize(run, thresholds = exports.DEFAULT_STATE_EXPLOSION_THRE
         reasons.push(`run has ${total} multi-agent records (> ${thresholds.totalRecords})`);
     return { ...counts, total, compactionRecommended: reasons.length > 0, reasons: reasons.sort() };
 }
+function stateSizeFor(run, thresholds, context) {
+    const key = thresholdsKey(thresholds);
+    let size = context.stateSizes.get(key);
+    if (!size) {
+        size = computeStateSizeWithGraph(run, thresholds, fullGraphFor(run, context));
+        context.stateSizes.set(key, size);
+    }
+    return size;
+}
 // ---------------------------------------------------------------------------
 // Blackboard digest (deterministic structural summary)
 // ---------------------------------------------------------------------------
@@ -310,10 +361,26 @@ function summarizeBlackboardDigest(run, blackboardId) {
         highSignal
     };
 }
+function blackboardDigestFor(run, context, blackboardId) {
+    const key = blackboardId || "";
+    let digest = context.blackboardDigests.get(key);
+    if (!digest) {
+        digest = summarizeBlackboardDigest(run, blackboardId);
+        context.blackboardDigests.set(key, digest);
+    }
+    return digest;
+}
 function buildCompactGraph(run, view = "compact", options = {}) {
+    return buildCompactGraphWithContext(run, view, options, createStateExplosionBuildContext());
+}
+function buildCompactGraphWithContext(run, view, options, context) {
     const thresholds = options.thresholds || exports.DEFAULT_STATE_EXPLOSION_THRESHOLDS;
-    const full = (0, multi_agent_operator_ux_1.buildMultiAgentOperatorGraph)(run);
-    const operator = (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(run);
+    const key = graphKey(view, { ...options, thresholds });
+    const cached = context.graphRecords.get(key);
+    if (cached)
+        return cached;
+    const full = fullGraphFor(run, context);
+    const operator = operatorFor(run, context);
     const critical = criticalPathNodeIds(run, operator);
     const protectedIds = new Set(critical);
     // Failures, blocked, rejected, conflicting nodes are always preserved.
@@ -324,7 +391,7 @@ function buildCompactGraph(run, view = "compact", options = {}) {
     // v0.1.26: reasoning steps are on the critical path and must never be collapsed
     // into a synthetic summary node — protect every decision-gate node backing an
     // adopted reasoning chain (notably score nodes, which are otherwise collapsed).
-    for (const id of (0, evidence_reasoning_1.reasoningCriticalNodeIds)(run))
+    for (const id of reasoningCriticalIdsFor(run, context))
         protectedIds.add(id);
     for (const failure of operator.failures) {
         if (failure.linked)
@@ -349,13 +416,15 @@ function buildCompactGraph(run, view = "compact", options = {}) {
     const collapseEnabled = view === "compact" || view === "critical-path" || Boolean(options.focus);
     if (view === "full" || !collapseEnabled) {
         // No collapse: emit scoped graph verbatim (still records provenance + critical path).
-        return finalizeGraphRecord(run, view, options, full, {
+        const record = finalizeGraphRecord(run, view, options, full, {
             nodes: scopeNodes.map((node) => ({ ...node })),
             edges: scopeEdges.map((edge) => ({ ...edge })),
             syntheticNodes: [],
             critical,
             operator
         });
+        context.graphRecords.set(key, record);
+        return record;
     }
     // Determine collapse buckets per node.
     const rule = collapseRuleFor(view);
@@ -436,13 +505,15 @@ function buildCompactGraph(run, view = "compact", options = {}) {
         edgeSeen.add(key);
         edges.push({ from, to, label: edge.label });
     }
-    return finalizeGraphRecord(run, view, options, full, {
+    const record = finalizeGraphRecord(run, view, options, full, {
         nodes: nodes.sort((a, b) => a.kind.localeCompare(b.kind) || a.id.localeCompare(b.id)),
         edges: edges.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || (a.label || "").localeCompare(b.label || "")),
         syntheticNodes: synthetic.sort((a, b) => a.id.localeCompare(b.id)),
         critical,
         operator
     });
+    context.graphRecords.set(key, record);
+    return record;
 }
 function finalizeGraphRecord(run, view, options, full, built) {
     const collapsedNodeCount = built.syntheticNodes.reduce((acc, syn) => acc + syn.collapsedNodeCount, 0);
@@ -671,10 +742,13 @@ function expansionCommandFor(run, view, key) {
 // Operator digest
 // ---------------------------------------------------------------------------
 function buildOperatorDigest(run, thresholds = exports.DEFAULT_STATE_EXPLOSION_THRESHOLDS) {
-    const stateSize = computeStateSize(run, thresholds);
-    const operator = (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(run);
-    const compact = buildCompactGraph(run, "compact", { thresholds });
-    const blackboard = summarizeBlackboardDigest(run);
+    return buildOperatorDigestWithContext(run, thresholds, createStateExplosionBuildContext());
+}
+function buildOperatorDigestWithContext(run, thresholds, context) {
+    const stateSize = stateSizeFor(run, thresholds, context);
+    const operator = operatorFor(run, context);
+    const compact = buildCompactGraphWithContext(run, "compact", { thresholds }, context);
+    const blackboard = blackboardDigestFor(run, context);
     const evidence = operator.evidence;
     const adopted = evidence.filter((e) => e.status === "adopted");
     const missing = evidence.filter((e) => e.status === "missing" || e.status === "pending" || e.status === "conflicting");
@@ -753,12 +827,15 @@ function buildOperatorDigest(run, thresholds = exports.DEFAULT_STATE_EXPLOSION_T
 // State explosion report (combines all derived indexes)
 // ---------------------------------------------------------------------------
 function buildStateExplosionReport(run, options = {}) {
+    return buildStateExplosionReportWithContext(run, options, createStateExplosionBuildContext());
+}
+function buildStateExplosionReportWithContext(run, options, context) {
     const thresholds = options.thresholds || exports.DEFAULT_STATE_EXPLOSION_THRESHOLDS;
-    const stateSize = computeStateSize(run, thresholds);
-    const compactGraph = buildCompactGraph(run, "compact", { thresholds });
-    const criticalPathGraph = buildCompactGraph(run, "critical-path", { thresholds });
-    const blackboardDigest = summarizeBlackboardDigest(run);
-    const operatorDigest = buildOperatorDigest(run, thresholds);
+    const stateSize = stateSizeFor(run, thresholds, context);
+    const compactGraph = buildCompactGraphWithContext(run, "compact", { thresholds }, context);
+    const criticalPathGraph = buildCompactGraphWithContext(run, "critical-path", { thresholds }, context);
+    const blackboardDigest = blackboardDigestFor(run, context);
+    const operatorDigest = buildOperatorDigestWithContext(run, thresholds, context);
     const currentFingerprint = fingerprintStrings([
         compactGraph.sourceFingerprint,
         blackboardDigest.sourceFingerprint,
@@ -837,12 +914,13 @@ function summariesDir(run) {
 }
 function refreshStateExplosionSummaries(run, options = {}) {
     const thresholds = options.thresholds || exports.DEFAULT_STATE_EXPLOSION_THRESHOLDS;
+    const context = createStateExplosionBuildContext();
     const dir = summariesDir(run);
     node_fs_1.default.mkdirSync(dir, { recursive: true });
     const views = options.views || ["full", "compact", "critical-path", "failures", "evidence", "trust", "topology", "blackboard", "candidate", "commit-gate"];
-    const blackboardDigest = summarizeBlackboardDigest(run);
-    const operatorDigest = buildOperatorDigest(run, thresholds);
-    const graphRecords = views.map((view) => buildCompactGraph(run, view, { thresholds }));
+    const blackboardDigest = blackboardDigestFor(run, context);
+    const operatorDigest = buildOperatorDigestWithContext(run, thresholds, context);
+    const graphRecords = views.map((view) => buildCompactGraphWithContext(run, view, { thresholds }, context));
     const entries = [];
     const writeRecord = (id, record, scope, fingerprint, included, omitted) => {
         const file = node_path_1.default.join(dir, `${(0, state_1.safeFileName)(id)}.json`);
@@ -854,13 +932,14 @@ function refreshStateExplosionSummaries(run, options = {}) {
     for (const record of graphRecords) {
         writeRecord(record.id, record, "run", record.sourceFingerprint, record.compactNodeCount, record.collapsedNodeCount);
     }
-    const stateSize = computeStateSize(run, thresholds);
+    const stateSize = stateSizeFor(run, thresholds, context);
     const indexFingerprint = fingerprintStrings([
         operatorDigest.sourceFingerprint,
         blackboardDigest.sourceFingerprint,
         ...graphRecords.map((r) => r.sourceFingerprint),
         String(stateSize.total)
     ]);
+    const compactGraph = buildCompactGraphWithContext(run, "compact", { thresholds }, context);
     const reportPath = node_path_1.default.join(dir, "state-explosion-report.json");
     const index = {
         schemaVersion: exports.STATE_EXPLOSION_SCHEMA_VERSION,
@@ -869,7 +948,7 @@ function refreshStateExplosionSummaries(run, options = {}) {
         scope: "run",
         sourceRecordIds: unique([...blackboardDigest.sourceRecordIds, ...operatorDigest.sourceRecordIds]),
         sourceFingerprint: fingerprintStrings([
-            buildCompactGraph(run, "compact", { thresholds }).sourceFingerprint,
+            compactGraph.sourceFingerprint,
             blackboardDigest.sourceFingerprint,
             operatorDigest.sourceFingerprint,
             String(stateSize.total)
@@ -893,7 +972,7 @@ function refreshStateExplosionSummaries(run, options = {}) {
     };
     void indexFingerprint;
     (0, state_1.writeJson)(index.paths.indexPath, index);
-    const report = buildStateExplosionReport(run, { thresholds, index });
+    const report = buildStateExplosionReportWithContext(run, { thresholds, index }, context);
     (0, state_1.writeJson)(reportPath, report);
     (0, trust_audit_1.recordTrustAuditEvent)(run, {
         kind: "summary.refresh",

package/dist/version.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIN_SUPPORTED_RUN_STATE_SCHEMA_VERSION = exports.LEGACY_RUN_STATE_SCHEMA_VERSION = exports.CURRENT_RUN_STATE_SCHEMA_VERSION = exports.WORKFLOW_APP_SCHEMA_VERSION = exports.CURRENT_COOL_WORKFLOW_VERSION = void 0;
-exports.CURRENT_COOL_WORKFLOW_VERSION = "0.1.79";
+exports.CURRENT_COOL_WORKFLOW_VERSION = "0.1.80";
 exports.WORKFLOW_APP_SCHEMA_VERSION = 1;
 exports.CURRENT_RUN_STATE_SCHEMA_VERSION = 1;
 exports.LEGACY_RUN_STATE_SCHEMA_VERSION = 0;

package/docs/agent-delegation-drive.7.md

@@ -133,12 +133,66 @@ node dist/cli.js run architecture-review --drive --once --repo /path/to/repo --q
 node dist/cli.js run drive <run-id> --json       # read-only preview of the next step
 ```
 
+For faster first results, use the opt-in fast app instead of changing the full
+review contract:
+
+```text
+node scripts/architecture-review-fast.js --repo /path/to/repo --question "Is the design sound?" --fast-model gpt-5.5-high --strong-model gpt-5.5-extra-high --metrics --schedule-full
+```
+
+`architecture-review-fast` has six workers: two Map and two Assess workers in
+parallel, then sequential Verify and Verdict workers. The original
+`architecture-review` app remains the full 14-worker review and is the right
+target for background routines when a deep audit can finish outside the user's
+foreground wait.
+
+The model flags are policy, not attestation: they set task-level `{{model}}`
+hints for the delegated agent process. The recorded model still comes only from
+the agent-reported output.
+
+The wrapper computes the source-context digest and supplies it to the fast app.
+For external repositories, the documented no-profile command creates a repo-local
+default `repo` profile over common tracked text surfaces. If the selected profile
+exports zero records, the wrapper refuses rather than handing the app an empty
+context digest.
+The two Map workers opt in to result caching keyed by source-context digest plus
+prompt digest. The two Assess workers also opt in, but their cache key includes
+the completed previous-phase result digests so stale Map outputs do not satisfy
+an Assess cache hit. A cache hit still passes through `recordWorkerOutput`
+validation; a corrupt cached result parks/fails closed rather than spawning a
+silent fallback.
+
+`--metrics` is diagnostic and opt-in. It adds elapsed milliseconds, step counts,
+agent-spawn counts, and `result-cache` hit counts to the wrapper JSON payload;
+without it, the wrapper's default output shape stays unchanged.
+
 `{{manifest}}`, `{{input}}`, `{{result}}`, `{{workerDir}}`, `{{model}}`, and
 `{{prompt}}` are substituted into DISCRETE argv elements (never a shell-interpreted
 string). Each verb is declared once in `capability-registry.ts`, so `cw <cmd>
 --json` is byte-identical to the matching `cw_<tool>` MCP tool for the read-only
 preview/config-show verbs.
 
+## Live output — opt-in stderr passthrough (Unix-clean)
+
+A drive can show the agent's activity live, without touching the evidence
+contract, when the operator opts in with `CW_AGENT_STREAM=1`:
+
+- **Default stays buffered.** Without `CW_AGENT_STREAM=1`, the bundled wrapper
+  preserves the legacy `--output-format json` path and forwards claude's JSON
+  stdout verbatim after writing `result.md`.
+- **The opt-in wrapper renders; stderr only.** With `CW_AGENT_STREAM=1`, the
+  bundled wrapper runs claude in `--output-format stream-json` and renders a
+  concise human trace (tool uses, assistant text, per-turn summaries) to its
+  **stderr** — diagnostics, never data. It reconstructs the single
+  `{model, usage, result}` object for stdout only on that opt-in path.
+- **Core forwards, never parses.** `runAgentProcess` passes the agent child's
+  stderr straight through to the operator's terminal (`stdio` inherit) only when
+  `CW_AGENT_STREAM=1`, CW's own stderr is a TTY, and `CW_NO_STREAM` is not set.
+  Piped / CI runs stay silent (the Rule of Silence). Vendor-specific rendering
+  lives in the wrapper (policy), not the kernel (mechanism).
+- **Determinism intact.** The backend evidence triple hashes stdout only, so
+  the live stderr stream never affects recorded evidence or replay.
+
 ## Compatibility
 
 Agent Delegation Drive is introduced in CW v0.1.38. Adding the `agent` row leaves
@@ -190,3 +244,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

package/docs/canonical-workflow-apps.7.md

@@ -28,6 +28,43 @@ node scripts/cw.js plan architecture-review \
   --focus "runtime"
 ```
 
+`architecture-review-fast`
+
+Run a shorter architecture review for a fast first result. The app keeps the
+full `architecture-review` contract available under its original id, but uses two
+parallel Map workers, two parallel Assess workers, one verifier, and one verdict
+worker. Operators can optionally provide a pinned JSONL source context and route
+mapping/assessment work to a faster model while reserving stronger models for
+verification and synthesis.
+
+```bash
+node scripts/architecture-review-fast.js \
+  --repo /path/to/repo \
+  --question "Is this architecture sound?" \
+  --fast-model gpt-5.5-high \
+  --strong-model gpt-5.5-extra-high \
+  --metrics \
+  --schedule-full
+```
+
+The wrapper prepares one cached JSONL source context, passes its sha256 digest to
+the fast app, runs `quickstart architecture-review-fast`, and optionally creates
+a one-shot background schedule for the full `architecture-review` app. When run
+against an external repo without `--profile` or `--profile-file`, it writes a
+small repo-local `repo` profile covering common tracked text surfaces such as
+README/package metadata, `src/`, `lib/`, `apps/`, `scripts/`, docs, and tests.
+If the selected profile exports zero records, the wrapper fails closed instead of
+passing an empty context digest to the app.
+`--fast-model` and `--strong-model` are userland policy flags; internally they
+set the same task-level hints as `CW_ARCHITECTURE_REVIEW_FAST_MODEL` and
+`CW_ARCHITECTURE_REVIEW_STRONG_MODEL`.
+`--metrics` is opt-in; when present the wrapper adds elapsed-time, worker-step,
+agent-spawn, and result-cache-hit counts to the JSON payload so operators can
+measure foreground wait reductions without changing the default output shape.
+
+For long full reviews, use the existing routine or schedule surfaces to run
+`architecture-review` in the background after the fast report has returned.
+
 `pr-review-fix-ci`
 
 Review a pull request or branch, inspect CI failures, diagnose actionable

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

@@ -39,6 +39,14 @@ A new runtime capability is added once, in the registry, against one core entry.
 The CLI command and the MCP tool are then two policies over that one mechanism —
 which is exactly what the parity gate checks.
 
+The MCP tool list is also being collapsed toward that single source. The first
+read-only inspection group (`operator.status`, `graph`, `operator.report`,
+worker/candidate/feedback/commit summaries, and the basic multi-agent inspection
+views) derives its MCP tool name and description directly from the capability
+registry; `mcp-server.ts` still owns the MCP input schema for those tools. This
+keeps the public `tools/list` output unchanged while removing one duplicate
+description table at a time.
+
 ## Human vs Machine Contract
 
 The two surfaces have different contracts and must not interfere:
@@ -373,3 +381,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -123,3 +123,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -110,3 +110,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -107,3 +107,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -270,3 +270,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

package/docs/execution-backends.7.md

@@ -300,3 +300,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

package/docs/index.md

@@ -35,6 +35,7 @@ Read these in order when you are new to CW:
 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.
 
 CW is the base system. Workflow apps are userland. Release and migration rules
 must preserve that line: stable contracts, explicit compatibility checks, and

package/docs/launch/demo.tape

@@ -0,0 +1,28 @@
+# VHS tape — records the `cw demo tamper` proof to a GIF for the README hero.
+#
+# Reproducible, deterministic capture (no manual screen-recording). Install VHS
+# (https://github.com/charmbracelet/vhs), then from the repo root:
+#
+#   vhs plugins/cool-workflow/docs/launch/demo.tape
+#
+# Output: docs/launch/demo-tamper.gif. Then in the root README, replace the
+# fenced demo output block under "See it in 30 seconds" with:
+#   ![cw demo tamper](plugins/cool-workflow/docs/launch/demo-tamper.gif)
+
+Output plugins/cool-workflow/docs/launch/demo-tamper.gif
+
+Set FontSize 15
+Set Width 1180
+Set Height 760
+Set Padding 18
+Set Theme "Dracula"
+Set Framerate 24
+Set PlaybackSpeed 1.0
+
+# Use the published package so the GIF reflects exactly what a new user runs.
+Type "npx cool-workflow demo tamper"
+Sleep 600ms
+Enter
+
+# Allow npx fetch + the demo to run and print the verdict.
+Sleep 14s

package/docs/launch/launch-kit.md

@@ -6,6 +6,60 @@ Everything leads with the 30-second `npx cool-workflow demo tamper` proof.
 
 ---
 
+## ✅ FINAL — Show HN (copy-paste ready)
+
+**Pre-flight (do these first):**
+1. Record the demo GIF: `vhs plugins/cool-workflow/docs/launch/demo.tape` → swap it into the README hero (replace the fenced output block with the GIF).
+2. Confirm on a clean machine: `npx cool-workflow demo tamper` runs and prints `VERDICT: tamper-evidence holds ✓`.
+3. Post during US morning (HN traffic peak); reply to the first comment with the npm + provenance link.
+
+**Title** (exactly — HN strips most formatting):
+
+```
+Show HN: Cool Workflow – tamper-evident telemetry for agent pipelines (npx demo)
+```
+
+**URL field:** `https://github.com/coo1white/cool-workflow`
+
+**First comment (paste right after posting):**
+
+```
+I kept seeing agent-orchestration tools treat the model's self-reported token
+usage and results as ground truth. For anything auditable that's backwards — a
+control-plane that trusts unverified self-reports audits claims, not facts, and a
+forged "green" run looks identical to a real one.
+
+Cool Workflow takes the opposite stance. It DELEGATES model execution to whatever
+agent you configure (claude -p, codex exec, an HTTP endpoint) and never embeds a
+model SDK or holds an API key. What it owns is the audit trail: each agent hop's
+reported usage is signed (ed25519) and appended to a hash-chained ledger, so
+editing any record — or even recomputing its local hash to cover the edit — breaks
+the chain downstream. You re-verify a finished run offline, with only the public
+key. No telemetry service to trust or breach.
+
+30-second proof, no install:
+
+  npx cool-workflow demo tamper
+
+It builds a real signed ledger, forges it two ways (flip a verdict + re-seal its
+hash; inflate reported tokens + reuse the signature), and shows both caught. On a
+real run, `cw telemetry verify <run>` does the same against what's on disk.
+
+Also: concurrent parallel() phases with declared collapse semantics (collect-all +
+kill-on-timeout — 16 agents with a forced hang/crash/dirty-return finish without
+deadlock and replay who-passed-who-failed), per-task output-schema gates, token
+budgets enforced against attested usage, and a one-way executor boundary welded
+into the type system (a callable that could reach a model API fails `npm run
+build`). Zero runtime deps, BSD-2, published to npm with provenance.
+
+It's early (v0.1.79) — I'd genuinely like to hear where the "delegate, prove,
+replay" model breaks down for your workflows.
+
+npm: https://www.npmjs.com/package/cool-workflow
+```
+
+---
+
 ## One-liner
 
 > Cool Workflow is an auditable control-plane for multi-agent workflows. It
@@ -103,10 +157,12 @@ API) enforced at compile time. Zero deps, BSD-2.
 
 ## Assets to capture before posting
 
-- [ ] A terminal GIF of `npx cool-workflow demo tamper` (the ✗ DETECTED lines are
-      the hook) for the README top and the HN/tweet.
+- [ ] **Demo GIF** — reproducible, no manual screen-recording: `vhs
+      plugins/cool-workflow/docs/launch/demo.tape` → `docs/launch/demo-tamper.gif`,
+      then swap it into the README hero (replace the fenced output block). The
+      ✗ DETECTED lines are the hook.
 - [ ] Confirm `npx cool-workflow demo tamper` works from a clean machine (no clone).
-- [ ] Pin the npm version badge / release in the first comment.
+- [ ] Pin the npm version badge / release + provenance link in the first comment.
 
 ## Channels
 

package/docs/launch/pre-launch-checklist.md

@@ -0,0 +1,53 @@
+# Pre-Launch Checklist — Cool Workflow Show HN
+
+Tick top to bottom; when it's done, post. The one non-negotiable gate is ③.
+Copy for the post itself lives in [launch-kit.md](launch-kit.md) (the **✅ FINAL**
+block).
+
+## ① Fix the machine (prerequisite)
+
+- [ ] **Reboot the Mac** — clears the leaked ptys (`kern.tty.ptmx_max` was 511 with
+      527 allocated), so Terminal / VS Code can spawn shells again. Required before
+      the verification below.
+
+## ② Prepare assets (optional, recommended)
+
+- [ ] Install [vhs](https://github.com/charmbracelet/vhs) (`brew install vhs`).
+- [ ] Record the GIF: `vhs plugins/cool-workflow/docs/launch/demo.tape` →
+      `docs/launch/demo-tamper.gif`.
+- [ ] Swap it into the README hero (replace the fenced demo output block with
+      `![demo](plugins/cool-workflow/docs/launch/demo-tamper.gif)`), commit + push.
+  > Shippable without the GIF — the README's text `✗ DETECTED` hook already stands;
+  > the GIF is upside, not a blocker.
+
+## ③ Verify — the make-or-break gate (do not skip)
+
+- [ ] On a **clean machine / fresh terminal**: `npx cool-workflow demo tamper`
+      prints `VERDICT: tamper-evidence holds ✓`.
+  > Every click from HN runs this. One crash wastes that traffic. This is the only
+  > non-negotiable check.
+- [ ] Sanity: `npx cool-workflow quickstart architecture-review --repo . --question "risks?"`
+      → `status: blocked` with no agent configured (fails closed, no crash).
+
+## ④ Post (US morning, ~9–11am ET is peak)
+
+- [ ] Open the **✅ FINAL** block in [launch-kit.md](launch-kit.md).
+- [ ] HN title: `Show HN: Cool Workflow – tamper-evident telemetry for agent pipelines (npx demo)`
+- [ ] URL field: `https://github.com/coo1white/cool-workflow`
+- [ ] Immediately after posting, paste the FINAL "first comment" as the first reply.
+
+## ⑤ First hour (decides the outcome)
+
+- [ ] Watch and reply fast — early engagement weighs most on HN.
+- [ ] On the "single key holder / no second party" critique (the audit flagged it
+      too): concede it honestly and frame it as exactly why you're looking for early
+      integration partners. **Turn the critique into an invitation; don't argue.**
+- [ ] No vote-rigging, no asking friends to upvote, no deleting critical comments —
+      HN's anti-abuse will sink the post.
+
+---
+
+### Go / no-go
+
+> If **③ — `npx cool-workflow demo tamper` prints `✓` on a clean machine** — passes,
+> you can post. Everything else is upside.

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

@@ -265,3 +265,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -302,3 +302,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -314,3 +314,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -135,3 +135,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.

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

@@ -194,3 +194,7 @@ Migration DAG with reversible edges (v0.1.45), capability auto-discovery (v0.1.4
 0.1.78
 
 0.1.79
+
+## Fast Architecture Review (v0.1.80)
+
+Adds the opt-in fast architecture-review lane: scoped JSONL source contexts, diff-aware exports, reusable Map and Assess results, measurable wrapper metrics, actionable background full-review handoff, and userland model policy flags for routing fast/strong workers without changing the full review contract.