cool-workflow 0.1.86 → 0.1.87

package/dist/orchestrator.js

@@ -36,8 +36,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CoolWorkflowRunner = void 0;
+exports.KNOWN_COMMANDS = exports.CoolWorkflowRunner = void 0;
 exports.parseArgv = parseArgv;
+exports.suggestCommand = suggestCommand;
+exports.formatSearchResults = formatSearchResults;
+exports.formatInfo = formatInfo;
 exports.formatHelp = formatHelp;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -68,6 +71,7 @@ const feedbackOps = __importStar(require("./orchestrator/feedback-operations"));
 const topologyOps = __importStar(require("./orchestrator/topology-operations"));
 const lifecycleOps = __importStar(require("./orchestrator/lifecycle-operations"));
 const migrationOps = __importStar(require("./orchestrator/migration-operations"));
+const term_1 = require("./term");
 // CoolWorkflowRunner — the single FACADE both surfaces (cli.ts and the MCP server)
 // call through. It is deliberately WIDE but THIN: each method either
 //   (a) loads the run's durable state and delegates to a domain function in
@@ -816,83 +820,177 @@ function parseArgv(argv) {
     }
     return { command, positionals, options };
 }
+/** All known top-level CW commands. Used for "did you mean?" suggestions. */
+exports.KNOWN_COMMANDS = new Set([
+    "help", "list", "doctor", "info", "search", "man", "init", "quickstart", "plan", "status", "next",
+    "dispatch", "result", "state", "commit", "report", "app", "sandbox",
+    "backend", "contract", "node", "feedback", "worker", "audit", "candidate",
+    "review", "loop", "schedule", "routine", "registry", "run", "queue",
+    "history", "audit-run", "multi-agent", "topology", "summary", "blackboard",
+    "coordinator", "metrics", "operator", "sched", "gc", "telemetry",
+    "migration", "demo", "workbench", "approve", "reject", "comment", "handoff",
+    "graph", "eval"
+]);
+/** Levenshtein distance between two short strings. */
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    let prev = Array.from({ length: n + 1 }, (_, j) => j);
+    let curr = new Array(n + 1);
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[n];
+}
+/** Suggest the closest known command for a typo. Returns undefined if no match
+ *  within half the length of the input (avoiding wild guesses on short strings). */
+function suggestCommand(input) {
+    if (!input || input.length < 2)
+        return undefined;
+    const lower = input.toLowerCase();
+    let best = "";
+    let bestDist = Infinity;
+    for (const cmd of exports.KNOWN_COMMANDS) {
+        const dist = levenshtein(lower, cmd);
+        if (dist < bestDist) {
+            best = cmd;
+            bestDist = dist;
+        }
+    }
+    // Threshold: distance must be <= half the input length AND <= 3
+    if (bestDist <= 3 && bestDist <= lower.length / 2)
+        return best;
+    return undefined;
+}
+function formatSearchResults(keyword, results) {
+    if (!results.length)
+        return `No workflows matched "${keyword}".\n  Tip: cw list for all available workflows.`;
+    return [
+        (0, term_1.bold)(`${results.length} workflow${results.length !== 1 ? "s" : ""} matching "${keyword}"`),
+        ...results.map((r) => `  ${r.id} — ${r.title}\n    ${(0, term_1.dim)(r.summary.slice(0, 120))}${r.summary.length > 120 ? "…" : ""}`),
+        "",
+        (0, term_1.dim)("Use cw info <id> for full details.")
+    ].join("\n");
+}
+function formatInfo(appId, data) {
+    const app = (data.app || {});
+    const inputs = (Array.isArray(data.inputs) ? data.inputs : []);
+    const phases = (Array.isArray(data.phases) ? data.phases : []);
+    const lines = [(0, term_1.bold)(`cw info ${appId}`)];
+    if (data.title)
+        lines.push(`  Title: ${data.title}`);
+    if (data.version)
+        lines.push(`  Version: ${data.version}`);
+    if (data.summary)
+        lines.push(`  Summary: ${data.summary}`);
+    if (data.author)
+        lines.push(`  Author: ${typeof data.author === "object" ? data.author.name : data.author}`);
+    if (data.compatible !== undefined)
+        lines.push(`  Compatible: ${data.compatible ? "yes" : "no"}`);
+    if (inputs.length > 0) {
+        lines.push("  Inputs:");
+        for (const input of inputs) {
+            const name = input.name || "";
+            const type = input.type || "string";
+            const required = input.required ? ", required" : "";
+            const def = input.default ? `, default: ${input.default}` : "";
+            const desc = input.description ? ` — ${input.description}` : "";
+            lines.push(`    - ${name} (${type}${required}${def})${desc}`);
+        }
+    }
+    if (Array.isArray(data.sandboxProfiles) && data.sandboxProfiles.length > 0) {
+        lines.push(`  Sandbox: ${data.sandboxProfiles.join(", ")}`);
+    }
+    const taskCount = data.taskCount || 0;
+    if (phases.length > 0) {
+        lines.push(`  Phases: ${phases.length} phase${phases.length !== 1 ? "s" : ""}, ${taskCount} task${taskCount !== 1 ? "s" : ""}`);
+    }
+    lines.push(`  Run: cw quickstart ${appId} --repo . --question "..."`);
+    return lines.join("\n");
+}
 function formatHelp() {
     return [
-        "Cool Workflow",
+        (0, term_1.bold)("Cool Workflow"),
+        "",
+        "  Quick start (one command — plan → drive → report):",
+        "    cw quickstart [app] --repo . --question \"...\" --agent-command builtin:claude",
+        "      (--preview for a dry run without an agent; --bundle for a portable sealed report)",
+        "",
+        (0, term_1.bold)("Getting Started"),
+        "  list                          List available workflow apps",
+        "  search <keyword>              Search workflows by title or description",
+        "  info <app-id> [--json]         Show what a workflow app does and how to run it",
+        "  doctor [--json] [--onramp] [--fix]  Check setup (--fix for consolidated fix commands)",
+        "  init <id> [--title T]         Create a new workflow app",
+        "  quickstart [app] [...]        Plan → drive → report in one command",
+        "  demo tamper|bundle            Prove trust checks work (30s, no agent needed)",
+        "  man <topic>                   Show a man page (e.g. cw man release-tooling)",
+        "",
+        (0, term_1.bold)("Run Management"),
+        "  plan <id> [--repo P] [--question Q]   Create a new run plan",
+        "  quickstart|audit-run [app] [...]       Plan → drive → report in one command",
+        "  status <run-id> [--json] [--brief]    Show run status (--brief for compact summary)",
+        "  next <run-id> [--limit N]             Show pending dispatch tasks",
+        "  dispatch <run-id> [--limit N]         Dispatch tasks to workers",
+        "  result <run-id> <task-id> <file>      Record a task result",
+        "  state check <run-id> [--write]        Validate run state",
+        "  commit <run-id> <mode> [...]          Record a gated commit",
+        "  report <run-id> [--show|--summary]    Show the report (or bundle/verify-bundle)",
+        "  graph <run-id> [--json]               Show operator graph",
+        "",
+        (0, term_1.bold)("Inspection & Diagnostics"),
+        "  operator status|report <run-id> [--json]   Human-friendly operator panel",
+        "  metrics show|summary <run-id> [--json]     Cost and usage metrics",
+        "  telemetry verify <run-id> [--pubkey P]     Verify tamper-evident telemetry",
+        "  migration list|check|prove [target]        Schema migration tools",
+        "  gc plan|run|verify [run-id]                Garbage collection",
+        "",
+        (0, term_1.bold)("Audit & Trust"),
+        "  audit summary|worker|provenance|multi-agent|... <run-id>   Trust audit operations",
+        "  candidate list|register|score|rank|select|reject <run-id>  Candidate management",
+        "  node list|show|graph|snapshot|diff|replay|verify <run-id>  State-node inspection",
+        "  eval snapshot|replay|compare|score|gate|report             Eval/replay harness",
+        "",
+        (0, term_1.bold)("Multi‑Agent & Collaboration"),
+        "  multi-agent run|status|step|blackboard|score|... <run-id>   Multi-agent coordination",
+        "  topology list|show|validate|apply|summary|graph              Topology management",
+        "  blackboard summary|graph|resolve|topic|message|... <run-id>  Blackboard workspace",
+        "  coordinator summary|decision <run-id>                        Coordinator interface",
+        "  summary refresh|show <run-id>                                State explosion summaries",
+        "  approve|reject|comment <kind> <run-id> <id> [--reason T]    Team approval actions",
+        "  handoff <kind> <run-id> <id> [--to ROLE]                    Team handoff",
+        "  review status|policy <run-id> [--json]                      Review status",
+        "",
+        (0, term_1.bold)("Run Registry & Scheduling"),
+        "  run search|list|show|resume|archive|export|import <id>   Cross-repo run management",
+        "  registry refresh|show [--scope repo|home] [--json]       Run registry index",
+        "  queue add|list|drain|show [queue-id]                     Work queue operations",
+        "  history [--scope repo|home] [--json]                     Run history",
+        "  schedule create|list|due|complete|...                    Scheduled tasks",
+        "  routine create|fire|list|events|delete                   Event-driven triggers",
+        "  sched plan|lease|release|complete|...                    Lease-based scheduling",
+        "  loop --prompt T [--interval-minutes N]                   Continuous loop runner",
         "",
-        "Quick start (ONE command — plan -> drive -> report):",
-        "  quickstart [architecture-review] --repo PATH --question TEXT --agent-command \"claude -p\"",
-        "    (delegates each worker to YOUR configured agent backend; --preview for a dry run)",
+        (0, term_1.bold)("Developer & Workspace"),
+        "  app list|show|validate|init|package|run [id|path]    Workflow app management",
+        "  sandbox list|show|validate|choose|resolve [id]       Sandbox profiles",
+        "  backend list|show|probe [id]                         Agent execution backends",
+        "  contract show <run-id> [id]                          Run contract view",
+        "  worker list|summary|show|manifest|output|... <id>    Worker operations",
+        "  feedback list|show|summary|collect|task|resolve <id> Feedback loop",
+        "  workbench serve [--port N] | view <run-id>           Optional localhost workbench",
         "",
-        "Commands:",
-        "  list",
-        "  doctor [--json] [--onramp] [--changed-from REF]   (check setup and show the shortest safe next steps)",
-        "  init <workflow-id> [--title TEXT] [--output PATH]",
-        "  quickstart [app-id] [--repo PATH] [--question TEXT] [--agent-command CMD] [--check] [--once] [--preview]",
-        "  plan <workflow-id> [--repo PATH] [--question TEXT] [--invariant TEXT]",
-        "  status <run-id> [--json|--format json]",
-        "  next <run-id> [--limit N]",
-        "  graph <run-id> [--json]",
-        "  dispatch <run-id> [--limit N] [--sandbox PROFILE] [--backend node|bun|shell|container|remote|ci]",
-        "  result <run-id> <task-id> <result-file>",
-        "  state check <run-id> [--state PATH] [--write]",
-        "  commit <run-id> --verifier <node-id> [--reason TEXT]",
-        "  commit <run-id> --candidate <candidate-id> [--reason TEXT]",
-        "  commit <run-id> --selection <selection-id> [--reason TEXT]",
-        "  commit <run-id> --allow-unverified-checkpoint [--reason TEXT]",
-        "  commit summary <run-id> [--json]",
-        "  report <run-id> [--show|--summary]",
-        "  app list|show|validate|init|package",
-        "  sandbox list|show|validate",
-        "  backend list|show|probe [backend-id]",
-        "  contract show <run-id> [contract-id]",
-        "  node list|show|graph <run-id>",
-        "  feedback list|summary|show|collect|task|resolve <run-id>",
-        "  worker list|summary|show|manifest|output|fail|validate <run-id>",
-        "  audit summary <run-id>",
-        "  audit worker <run-id> <worker-id>",
-        "  audit provenance <run-id> [--worker ID|--candidate ID|--commit ID]",
-        "  audit multi-agent <run-id> [--json]",
-        "  audit policy <run-id> [--json]",
-        "  audit role <run-id> <role-id> [--json]",
-        "  audit blackboard <run-id> [--json]",
-        "  audit judge <run-id> [--json]",
-        "  audit attest <run-id> [--worker ID] [--hostEnforced true] [--env NAME]",
-        "  audit decision <run-id> <worker-id> [--path PATH|--command CMD|--network TARGET|--env NAME]",
-        "  candidate list|summary|register|score|rank|select|reject <run-id>",
-        "  eval snapshot|replay|compare|score|gate|report",
-        "  summary refresh|show <run-id> [--json]",
-        "  blackboard summary|summarize|graph|resolve <run-id>",
-        "  blackboard topic create <run-id> --id <topic-id> --title TEXT",
-        "  blackboard message post|list <run-id>",
-        "  blackboard context put <run-id>",
-        "  blackboard artifact add|list <run-id>",
-        "  blackboard snapshot <run-id>",
-        "  coordinator summary <run-id>",
-        "  coordinator decision <run-id> --kind KIND --outcome OUTCOME --reason TEXT",
-        "  multi-agent run|status|step|blackboard|score|select|summary|summarize|graph|dependencies|failures|evidence <run-id>",
-        "  multi-agent graph <run-id> --view full|compact|critical-path|failures|evidence|trust|topology|blackboard|candidate|commit-gate [--focus ID] [--depth N]",
-        "  topology list|show|validate|apply|summary|graph",
-        "  schedule create|list|due|complete|pause|resume|run-now|history|daemon|delete",
-        "  routine create|fire|list|events|delete",
-        "  registry refresh|show [--scope repo|home] [--json]",
-        "  run search|list|show|resume|archive|rerun|export|import|verify-import [run-id|archive] [--scope repo|home] [--json]",
-        "  queue add|list|drain|show [queue-id] [--repo PATH] [--priority N]",
-        "  history [--scope repo|home] [--app ID] [--status STATE] [--json]",
-        "  audit-run <app-id> [--repo PATH] [--question TEXT] [--agent-command CMD]",
-        "  metrics show|summary <run-id> [--scope repo|home] [--json]",
-        "  telemetry verify <run-id> [--pubkey PEM|PATH] [--json]",
-        "  gc plan|run|verify [run-id] [--json]",
-        "  sched plan|lease|release|complete|reclaim|reset|policy [--json]",
-        "  migration list|check|prove [target] [--json]",
-        "  operator status|report <run-id> [--json]",
-        "  review status|policy <run-id> [--json]",
-        "  approve|reject|comment <kind> <run-id> <target-id> [--reason TEXT]",
-        "  handoff <kind> <run-id> <target-id> [--to ROLE]",
-        "  loop --prompt TEXT [--interval-minutes N]",
-        "  demo tamper",
-        "  workbench view <run-id> [--json]",
-        "  workbench serve [--port N] [--scope repo|home] [--once|--json]",
+        (0, term_1.bold)("Common Flags"),
+        "  --json, --format json     Machine-readable JSON output",
+        "  --repo PATH               Target repository path",
+        "  --question TEXT           The task or question to answer",
+        "  --agent-command CMD       Agent backend (e.g. builtin:claude, builtin:codex)",
+        "  --scope repo|home         Scope for cross-repo operations",
+        "  --cwd PATH                Working directory override",
         ""
     ].join("\n");
 }

package/dist/term.js

@@ -0,0 +1,93 @@
+"use strict";
+// src/term.ts — zero-dependency terminal styling.
+//
+// Provides TTY-gated ANSI formatting for human-readable output. When output is
+// piped (non-TTY), styled calls return plain text. This keeps data channels
+// (stdout) and diagnostics (stderr) clean — never adds escape codes to pipes.
+//
+// Used by: doctor, help, error messages, status summaries.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bold = bold;
+exports.dim = dim;
+exports.green = green;
+exports.yellow = yellow;
+exports.red = red;
+exports.cyan = cyan;
+exports.doctorGlyph = doctorGlyph;
+exports.cwLabel = cwLabel;
+exports.indent = indent;
+exports.printSuccessSummary = printSuccessSummary;
+function isTTY(stream = process.stderr) {
+    return Boolean(stream.isTTY);
+}
+// ---- ansi codes ----
+const ansi = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    cyan: "\x1b[36m",
+};
+// ---- styled text ----
+function style(code, text, stream) {
+    if (!isTTY(stream))
+        return text;
+    return `${code}${text}${ansi.reset}`;
+}
+function bold(text, stream) {
+    return style(ansi.bold, text, stream);
+}
+function dim(text, stream) {
+    return style(ansi.dim, text, stream);
+}
+function green(text, stream) {
+    return style(ansi.green, text, stream);
+}
+function yellow(text, stream) {
+    return style(ansi.yellow, text, stream);
+}
+function red(text, stream) {
+    return style(ansi.red, text, stream);
+}
+function cyan(text, stream) {
+    return style(ansi.cyan, text, stream);
+}
+// ---- semantic helpers ----
+/** Returns the styled glyph + label for a doctor check severity. */
+function doctorGlyph(status, stream) {
+    const glyph = { ok: "✓", warn: "!", fail: "✗" };
+    const color = {
+        ok: green,
+        warn: yellow,
+        fail: red,
+    };
+    return color[status](`${glyph[status]}`, stream);
+}
+/** "cw:" prefix with bold and optional color. */
+function cwLabel(stream) {
+    return bold("cw:", stream);
+}
+/** Render a multi-line block with consistent 2-space indentation. */
+function indent(text, spaces = 2) {
+    const prefix = " ".repeat(spaces);
+    return text.split("\n").map((line) => `${prefix}${line}`).join("\n");
+}
+/** Print a success summary to stderr (TTY-gated). Shows the report path and a
+ *  suggested next command. Pipe-friendly: silent when stderr is not a TTY. */
+function printSuccessSummary(fields, stream) {
+    if (!isTTY(stream))
+        return;
+    const s = stream || process.stderr;
+    s.write(`\n${green("✓")} Report: ${fields.reportPath}\n`);
+    if (fields.status === "complete") {
+        s.write(`  Next: cw status ${fields.runId} --brief\n`);
+        if (fields.bundle !== false) {
+            s.write(`  Bundle: cw report bundle ${fields.runId}\n`);
+        }
+    }
+    else {
+        s.write(`  ${yellow("!")} Status: ${fields.status}. Next: cw status ${fields.runId}\n`);
+    }
+}

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.86";
+exports.CURRENT_COOL_WORKFLOW_VERSION = "0.1.87";
 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

@@ -204,13 +204,15 @@ 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
-  keeps the legacy `--output-format json` path and forwards claude's JSON stdout
-  word for word after writing `result.md`.
+  keeps the buffered path and writes one JSON report to stdout 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 short
-  human trace (tool uses, assistant text, per-turn summaries) to its
-  **stderr** — diagnostics, never data. It builds the single
-  `{model, usage, result}` object for stdout again only on that opt-in path.
+  bundled Claude wrapper runs claude in `--output-format stream-json`, and the
+  bundled Codex wrapper runs `codex exec --json --output-last-message`.
+  Each wrapper renders a short human trace (tool uses, assistant text, per-turn
+  summaries where present) to its **stderr** — diagnostics, never data. It builds
+  the single `{model, usage, result}` object for stdout after the final answer is
+  captured.
 - **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.
@@ -219,6 +221,18 @@ contract, when the operator opts in with `CW_AGENT_STREAM=1`:
 - **Determinism intact.** The backend evidence triple hashes stdout only, so
   the live stderr stream never changes recorded evidence or replay.
 
+The built-in templates are:
+
+```text
+--agent-command builtin:claude
+--agent-command builtin:codex
+```
+
+Gemini, OpenCode, DeepSeek, and GLM stay as external agent commands or HTTP
+endpoints until their stream format is proven by a local, deterministic wrapper
+smoke. DeepSeek and GLM are best reached through OpenCode or an HTTP agent
+adapter first; CW still imports no model SDK.
+
 ## Compatibility
 
 Agent Delegation Drive comes in first in CW v0.1.38. Adding the `agent` row leaves
@@ -291,3 +305,7 @@ 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/cli-mcp-parity.7.md

@@ -82,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 -->
@@ -90,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 |
@@ -295,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.
@@ -497,3 +503,7 @@ 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

@@ -145,3 +145,7 @@ 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

@@ -129,3 +129,7 @@ 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/durable-state-and-locking.7.md

@@ -128,3 +128,7 @@ 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

@@ -289,3 +289,7 @@ 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

@@ -319,3 +319,7 @@ 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-cli-mcp-surface.7.md

@@ -287,3 +287,7 @@ 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

@@ -321,3 +321,7 @@ 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

@@ -333,3 +333,7 @@ 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

@@ -154,3 +154,7 @@ 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

@@ -213,3 +213,7 @@ 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

@@ -5,11 +5,11 @@ Generated from the current repository code on 2026-06-19 by `npm run sync:projec
 ## Snapshot
 
 - Package: `cool-workflow`
-- Version: `0.1.86`
-- Source modules: `63`
+- Version: `0.1.87`
+- Source modules: `64`
 - Workflow apps: `7`
 - Docs: `51`
-- Smoke tests: `110`
+- Smoke tests: `115`
 - Repository: https://github.com/coo1white/cool-workflow
 
 ## Architecture
@@ -112,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)
@@ -201,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)
@@ -220,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)
@@ -235,9 +239,11 @@ Smoke tests mirror the public contracts. The high-signal suites are:
 - [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)

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

@@ -161,3 +161,7 @@ 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

@@ -301,3 +301,7 @@ 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-history.md

@@ -323,6 +323,16 @@ The orchestration vision came in one release, all reviewer-gated:
 
 Set `CW_AGENT_STREAM=1` to see each worker's live agent trace. The bundled claude wrapper (`builtin:claude` / `scripts/agents/claude-p-agent.js`) keeps the legacy `--output-format json` path by default; only the opt-in path runs claude in `--output-format stream-json` and renders a short human trace (tool uses, assistant text, per-turn summaries) to **stderr**. CW core sends that stderr on to the operator's terminal only when `CW_AGENT_STREAM=1`, CW's own stderr is a TTY, and `CW_NO_STREAM` is not set; piped/CI runs stay quiet (Rule of Silence). Core only sends the stream on, never reads it — vendor-specific rendering is the wrapper's business (policy), not the kernel's (mechanism).
 
+## Builtin Codex agent wrapper (on main, ships next)
+
+`--agent-command builtin:codex` points to a bundled read-only Codex wrapper. It
+runs `codex exec --json --output-last-message`, sends the worker prompt on stdin,
+writes the final answer to `result.md`, and writes one `{model, usage, result}`
+JSON object to stdout for CW provenance. With `CW_AGENT_STREAM=1`, it renders a
+short stderr trace from Codex JSONL events. Gemini, OpenCode, DeepSeek, and GLM
+stay outside CW until their wrapper stream shape is proven by a local smoke; CW
+still imports no model SDK.
+
 v0.1.79
 
 ## Fast Architecture Review (v0.1.80)