cool-workflow 0.1.98 → 0.2.0

package/dist/orchestrator.js

@@ -1,925 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.KNOWN_COMMANDS = exports.CoolWorkflowRunner = void 0;
-exports.parseArgv = parseArgv;
-exports.suggestCommand = suggestCommand;
-exports.formatSearchResults = formatSearchResults;
-exports.formatInfo = formatInfo;
-exports.formatHelp = formatHelp;
-exports.formatCommandHelp = formatCommandHelp;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const workflow_api_1 = require("./workflow-api");
-const capability_registry_1 = require("./capability-registry");
-const workflow_app_framework_1 = require("./workflow-app-framework");
-const dispatch_1 = require("./dispatch");
-const state_1 = require("./state");
-const observability_1 = require("./observability");
-const pipeline_runner_1 = require("./pipeline-runner");
-const worker_isolation_1 = require("./worker-isolation");
-const sandbox_profile_1 = require("./sandbox-profile");
-const execution_backend_1 = require("./execution-backend");
-const operator_ux_1 = require("./operator-ux");
-const trust_audit_1 = require("./trust-audit");
-const multi_agent_1 = require("./multi-agent");
-const multi_agent_operator_ux_1 = require("./multi-agent-operator-ux");
-const multi_agent_eval_1 = require("./multi-agent-eval");
-const node_snapshot_1 = require("./node-snapshot");
-const state_explosion_1 = require("./state-explosion");
-const evidence_reasoning_1 = require("./evidence-reasoning");
-const report_1 = require("./orchestrator/report");
-const cli_options_1 = require("./orchestrator/cli-options");
-const appOps = __importStar(require("./orchestrator/app-operations"));
-const auditOps = __importStar(require("./orchestrator/audit-operations"));
-const candidateOps = __importStar(require("./orchestrator/candidate-operations"));
-const collaborationOps = __importStar(require("./orchestrator/collaboration-operations"));
-const maOps = __importStar(require("./orchestrator/multi-agent-operations"));
-const hostOps = __importStar(require("./orchestrator/host-operations"));
-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
-//       ./orchestrator/*-operations.ts — the v0.1.40 self-audit "router pattern":
-//       one thin delegator per capability, NOT a god-object to dismantle; or
-//   (b) holds a small amount of surface-shared logic (app/worker loaders, report
-//       composition, read-snapshot-then-op).
-// The high method count is INTENTIONAL — it is the union of every both-surface
-// capability — and the fail-closed CLI<->MCP parity gate keeps each one honest (a
-// method present on one surface but not the other is exactly the drift it forbids).
-//
-// FreeBSD-audit R3 ("142-method god-facade with no-op passthroughs") was assessed
-// and CLOSED as won't-fix: of 141 public methods exactly ONE is a true
-// runner->runner forward (collaborationReject -> collaborationApprove(...,"reject")),
-// and it is kept on purpose — it is a registered capability `entry` bound to the
-// parity gate AND an intent-revealing veto verb, so collapsing it would be a
-// behavior-neutral readability LOSS touching both surfaces. Dismantling the facade
-// is an explicit anti-goal (small kernel, explicit delegation — see DIRECTION.md).
-class CoolWorkflowRunner {
-    pluginRoot;
-    workflowsDir;
-    appsDir;
-    // F7: the directory a run is resolved against (replaces the former process.chdir
-    // bracket in capability-core). undefined => fall back to process.cwd(). The runner
-    // reads runs from disk per call (no in-memory run state), so withBaseDir hands back
-    // a cheap scoped clone instead of mutating the global process cwd.
-    baseDir;
-    // Per-request cache (v0.1.95): when set, loadRun memoizes by runId so the 17
-    // workbench sub-panels that each call loadRun independently share one read.
-    _requestCache;
-    constructor({ pluginRoot, baseDir }) {
-        this.pluginRoot = resolvePluginRoot(pluginRoot);
-        this.workflowsDir = node_path_1.default.join(this.pluginRoot, "workflows");
-        this.appsDir = node_path_1.default.join(this.pluginRoot, "apps");
-        this.baseDir = baseDir ? node_path_1.default.resolve(baseDir) : undefined;
-    }
-    /** Run fn with a per-request loadRun cache. All loadRun calls inside fn share
-     *  the same cached run state, collapsing 18 reads into 1. Returns fn's result
-     *  and clears the cache afterwards (never leaks between requests).
-     *
-     *  Reentrant: a nested call (e.g. a concurrent drive round whose sub-workflow
-     *  task recursively drives a child run on the SAME runner instance) saves and
-     *  restores the OUTER scope's cache rather than clobbering it to undefined —
-     *  otherwise the inner call's `finally` would wipe the outer round's still-in-
-     *  flight (not yet persisted) mutations, and the outer scope's next loadRun
-     *  would silently fall back to a stale disk read. */
-    loadWithCache(fn) {
-        const previousCache = this._requestCache;
-        this._requestCache = new Map();
-        (0, trust_audit_1.setAuditEventCache)(new Map());
-        try {
-            return fn(this);
-        }
-        finally {
-            this._requestCache = previousCache;
-            (0, trust_audit_1.clearAuditEventCache)();
-        }
-    }
-    /** Return a runner that resolves runs against `dir` instead of process.cwd(),
-     *  WITHOUT chdir-ing the process (F7). Same instance when the dir is unchanged. */
-    withBaseDir(dir) {
-        const resolved = dir ? node_path_1.default.resolve(dir) : undefined;
-        if (resolved === this.baseDir)
-            return this;
-        return new CoolWorkflowRunner({ pluginRoot: this.pluginRoot, baseDir: resolved });
-    }
-    listWorkflows() {
-        return appOps.listWorkflows(this.workflowsDir, this.appsDir);
-    }
-    listApps() {
-        return appOps.listApps(this.workflowsDir, this.appsDir);
-    }
-    showApp(appId) {
-        return appOps.showApp(this.workflowsDir, this.appsDir, appId);
-    }
-    validateApp(target) {
-        return appOps.validateApp(this.workflowsDir, this.appsDir, target, this.resolveFromBase(target));
-    }
-    initApp(appId, options) {
-        return appOps.initApp(this.appsDir, appId, options, (t) => this.resolveFromBase(t), (m) => this.validateApp(m));
-    }
-    packageApp(appId, options = {}) {
-        return appOps.packageApp(this.workflowsDir, this.appsDir, appId, options, (t) => this.resolveFromBase(t));
-    }
-    init(workflowId, options) {
-        const id = (0, workflow_api_1.slugify)(workflowId);
-        if (!id)
-            throw new Error("Workflow id must include at least one letter or digit");
-        const title = String(options.title || titleize(id));
-        const destination = this.resolveFromBase(String(options.output || node_path_1.default.join(this.workflowsDir, `${id}.workflow.js`)));
-        if (node_fs_1.default.existsSync(destination) && !options.force) {
-            throw new Error(`Refusing to overwrite existing workflow: ${destination}`);
-        }
-        node_fs_1.default.mkdirSync(node_path_1.default.dirname(destination), { recursive: true });
-        node_fs_1.default.writeFileSync(destination, (0, workflow_app_framework_1.renderWorkflowAppTemplate)(id, title), "utf8");
-        return { id, path: destination };
-    }
-    // Core run lifecycle — delegated to ./orchestrator/lifecycle-operations. The
-    // runner resolves the workflow app record (instance-stateful) then hands the
-    // engine work to the module; the runner is now a pure router.
-    plan(workflowId, options) {
-        return lifecycleOps.plan(this.loadWorkflowAppById(workflowId), options);
-    }
-    status(runId) {
-        return (0, report_1.summarizeRun)(this.loadRun(runId));
-    }
-    operatorStatus(runId) {
-        return (0, operator_ux_1.summarizeOperatorRun)(this.loadRun(runId));
-    }
-    next(runId, options) {
-        return (0, dispatch_1.nextDispatchTasks)(this.loadRun(runId), (0, cli_options_1.numberOption)(options.limit));
-    }
-    dispatch(runId, options) {
-        return lifecycleOps.dispatch(this.loadRun(runId), options);
-    }
-    recordResult(runId, taskId, resultPath, options = {}) {
-        return lifecycleOps.recordResult(this.loadRun(runId), taskId, this.resolveFromBase(resultPath), options);
-    }
-    listWorkers(runId, options = {}) {
-        return (0, worker_isolation_1.listWorkerScopes)(this.loadRun(runId), {
-            status: options.status ? String(options.status) : undefined
-        });
-    }
-    showWorker(runId, workerId) {
-        const worker = (0, worker_isolation_1.getWorkerScope)(this.loadRun(runId), workerId);
-        if (!worker)
-            throw new Error(`Unknown worker id for run ${runId}: ${workerId}`);
-        return worker;
-    }
-    reclaimOrphans(runId, now) {
-        return (0, worker_isolation_1.reclaimOrphans)(this.loadRun(runId), now);
-    }
-    showWorkerManifest(runId, workerId) {
-        const run = this.loadRun(runId);
-        const worker = (0, worker_isolation_1.getWorkerScope)(run, workerId);
-        if (!worker)
-            throw new Error(`Unknown worker id for run ${runId}: ${workerId}`);
-        return (0, worker_isolation_1.writeWorkerManifest)(run, worker);
-    }
-    recordWorkerOutput(runId, workerId, resultPath, options = {}) {
-        return lifecycleOps.recordWorkerOutput(this.loadRun(runId), workerId, this.resolveFromBase(resultPath), options);
-    }
-    recordWorkerFailure(runId, workerId, message, options = {}) {
-        return lifecycleOps.recordWorkerFailure(this.loadRun(runId), workerId, message, options);
-    }
-    validateWorker(runId, workerId, targetPath) {
-        return (0, worker_isolation_1.validateWorkerBoundary)(this.loadRun(runId), workerId, targetPath ? { path: this.resolveFromBase(targetPath) } : {});
-    }
-    // Audit domain — delegated to ./orchestrator/audit-operations (v0.1.40 P3
-    // router pattern). The runner stays the routing surface; the logic lives in the
-    // domain module. Public signatures are unchanged.
-    auditSummary(runId) {
-        return auditOps.auditSummary(this.loadRun(runId));
-    }
-    auditMultiAgent(runId) {
-        return auditOps.auditMultiAgent(this.loadRun(runId));
-    }
-    auditPolicy(runId) {
-        return auditOps.auditPolicy(this.loadRun(runId));
-    }
-    auditRole(runId, roleId) {
-        return auditOps.auditRole(this.loadRun(runId), roleId);
-    }
-    auditBlackboard(runId) {
-        return auditOps.auditBlackboard(this.loadRun(runId));
-    }
-    auditJudge(runId) {
-        return auditOps.auditJudge(this.loadRun(runId));
-    }
-    workerAudit(runId, workerId) {
-        return auditOps.workerAudit(this.loadRun(runId), workerId);
-    }
-    evidenceProvenance(runId, options = {}) {
-        return auditOps.auditEvidenceProvenance(this.loadRun(runId), options);
-    }
-    recordAuditAttestation(runId, options = {}) {
-        return auditOps.recordAuditAttestation(this.loadRun(runId), options);
-    }
-    recordAuditDecision(runId, workerId, options = {}) {
-        return auditOps.recordAuditDecision(this.loadRun(runId), workerId, options);
-    }
-    listSandboxProfiles(options = {}) {
-        return (0, sandbox_profile_1.listBundledSandboxProfiles)((0, sandbox_profile_1.sandboxContextForValidation)(String(options.cwd || this.invocationCwd())));
-    }
-    showSandboxProfile(profileId, options = {}) {
-        return (0, sandbox_profile_1.showBundledSandboxProfile)(profileId, (0, sandbox_profile_1.sandboxContextForValidation)(String(options.cwd || this.invocationCwd())));
-    }
-    validateSandboxProfile(profileFile, options = {}) {
-        return (0, sandbox_profile_1.validateSandboxProfileFile)(this.resolveFromBase(profileFile), (0, sandbox_profile_1.sandboxContextForValidation)(String(options.cwd || this.invocationCwd())));
-    }
-    listBackends(options = {}) {
-        void options;
-        return (0, execution_backend_1.backendListPayload)();
-    }
-    showBackend(backendId, options = {}) {
-        void options;
-        return (0, execution_backend_1.backendShowPayload)(backendId);
-    }
-    probeBackend(backendId, options = {}) {
-        return (0, execution_backend_1.backendProbePayload)(backendId, { cwd: String(options.cwd || this.invocationCwd()) });
-    }
-    // Candidate domain — delegated to ./orchestrator/candidate-operations.
-    listCandidates(runId, options = {}) {
-        return candidateOps.listCandidates(this.loadRun(runId), options);
-    }
-    showCandidate(runId, candidateId) {
-        return candidateOps.showCandidate(this.loadRun(runId), candidateId);
-    }
-    registerCandidate(runId, options = {}) {
-        return candidateOps.registerCandidate(this.loadRun(runId), options);
-    }
-    scoreCandidate(runId, candidateId, options = {}) {
-        return candidateOps.scoreCandidate(this.loadRun(runId), candidateId, options);
-    }
-    rankCandidates(runId, options = {}) {
-        return candidateOps.rankCandidates(this.loadRun(runId), options);
-    }
-    selectCandidate(runId, candidateId, options = {}) {
-        return candidateOps.selectCandidate(this.loadRun(runId), candidateId, options);
-    }
-    rejectCandidate(runId, candidateId, reason) {
-        return candidateOps.rejectCandidate(this.loadRun(runId), candidateId, reason);
-    }
-    // ---- Team Collaboration (v0.1.32) — delegated to ./orchestrator/collaboration-operations.
-    // Append-only, host-attested (never authenticated) approvals/comments/handoffs
-    // + a derived review state. Both CLI and MCP route through these methods, so
-    // `cw <cmd> --json` is identical to `cw_<tool>` (the parity gate).
-    collaborationApprove(runId, targetKind, targetId, options = {}, decision = "approve") {
-        return collaborationOps.collaborationApprove(this.loadRun(runId), targetKind, targetId, options, decision);
-    }
-    collaborationReject(runId, targetKind, targetId, options = {}) {
-        return this.collaborationApprove(runId, targetKind, targetId, options, "reject");
-    }
-    collaborationComment(runId, targetKind, targetId, options = {}) {
-        return collaborationOps.collaborationComment(this.loadRun(runId), targetKind, targetId, options);
-    }
-    collaborationCommentList(runId, options = {}) {
-        return collaborationOps.collaborationCommentList(this.loadRun(runId), options);
-    }
-    collaborationHandoff(runId, targetKind, targetId, options = {}) {
-        return collaborationOps.collaborationHandoff(this.loadRun(runId), targetKind, targetId, options);
-    }
-    reviewStatus(runId, options = {}) {
-        return collaborationOps.reviewStatus(this.loadRun(runId), options);
-    }
-    reviewPolicy(runId, options = {}) {
-        return collaborationOps.reviewPolicy(this.loadRun(runId), options);
-    }
-    formatReviewStatus(report) {
-        return collaborationOps.formatReviewStatus(report);
-    }
-    formatCommentList(comments) {
-        return collaborationOps.formatCommentList(comments);
-    }
-    summarizeWorkerRecords(runId) {
-        return (0, operator_ux_1.summarizeOperatorWorkers)(this.loadRun(runId));
-    }
-    summarizeCandidateOperatorRecords(runId) {
-        return (0, operator_ux_1.summarizeOperatorCandidates)(this.loadRun(runId));
-    }
-    summarizeFeedbackRecords(runId) {
-        return (0, operator_ux_1.summarizeOperatorFeedback)(this.loadRun(runId));
-    }
-    summarizeCommitRecords(runId) {
-        return (0, operator_ux_1.summarizeOperatorCommits)(this.loadRun(runId));
-    }
-    report(runId) {
-        const run = this.loadRun(runId);
-        return { path: (0, report_1.writeReport)(run) };
-    }
-    operatorReport(runId) {
-        const run = this.loadRun(runId);
-        (0, report_1.writeReport)(run);
-        return (0, operator_ux_1.summarizeOperatorRun)(run);
-    }
-    showContract(runId, contractId) {
-        const run = this.loadRun(runId);
-        return (0, pipeline_runner_1.createPipelineRunner)().getRunContract(run, contractId);
-    }
-    listNodes(runId) {
-        return this.loadRun(runId).nodes || [];
-    }
-    showNode(runId, nodeId) {
-        return (0, pipeline_runner_1.createPipelineRunner)().getRunNode(this.loadRun(runId), nodeId);
-    }
-    graphNodes(runId) {
-        return (this.loadRun(runId).nodes || []).map((node) => ({
-            id: node.id,
-            kind: node.kind,
-            status: node.status,
-            parents: node.parents,
-            children: node.children
-        }));
-    }
-    operatorGraph(runId) {
-        return (0, operator_ux_1.buildOperatorGraph)(this.loadRun(runId));
-    }
-    multiAgentSummary(runId) {
-        return (0, multi_agent_1.summarizeMultiAgent)(this.loadRun(runId));
-    }
-    multiAgentGraph(runId) {
-        return (0, multi_agent_1.buildMultiAgentGraph)(this.loadRun(runId));
-    }
-    multiAgentOperatorStatus(runId) {
-        return (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(this.loadRun(runId));
-    }
-    multiAgentOperatorGraph(runId) {
-        return (0, multi_agent_operator_ux_1.buildMultiAgentOperatorGraph)(this.loadRun(runId));
-    }
-    multiAgentDependencies(runId) {
-        return (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(this.loadRun(runId)).dependencies;
-    }
-    multiAgentFailures(runId) {
-        return (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(this.loadRun(runId)).failures;
-    }
-    multiAgentEvidence(runId) {
-        const run = this.loadRun(runId);
-        const rows = (0, multi_agent_operator_ux_1.summarizeMultiAgentOperator)(run).evidence;
-        // Additive enrichment: attach the derived rationale status so `multi-agent
-        // evidence` answers WHAT + whether the WHY is recorded, without changing the
-        // existing row shape (POLA: old consumers ignore the new optional field).
-        const report = (0, evidence_reasoning_1.buildEvidenceReasoningReport)(run, { index: (0, evidence_reasoning_1.loadEvidenceReasoningIndex)(run) });
-        const byId = new Map(report.chains.map((chain) => [chain.id, chain.rationaleStatus]));
-        for (const row of rows)
-            row.rationaleStatus = byId.get(row.id);
-        return rows;
-    }
-    multiAgentReasoning(runId, options = {}) {
-        const run = this.loadRun(runId);
-        if (options.refresh) {
-            (0, evidence_reasoning_1.refreshEvidenceReasoning)(run);
-            (0, state_1.saveCheckpoint)(run);
-        }
-        return (0, evidence_reasoning_1.showEvidenceReasoning)(run, { evidenceId: (0, cli_options_1.stringOption)(options.evidence || options.evidenceId || options.id) });
-    }
-    multiAgentReasoningRefresh(runId) {
-        const run = this.loadRun(runId);
-        const index = (0, evidence_reasoning_1.refreshEvidenceReasoning)(run);
-        (0, state_1.saveCheckpoint)(run);
-        return index;
-    }
-    summaryRefresh(runId, options = {}) {
-        const run = this.loadRun(runId);
-        const index = (0, state_explosion_1.refreshStateExplosionSummaries)(run, { views: (0, cli_options_1.graphViewsOption)(options) });
-        (0, report_1.writeReport)(run);
-        (0, state_1.saveCheckpoint)(run);
-        return index;
-    }
-    summaryShow(runId) {
-        const run = this.loadRun(runId);
-        const report = (0, state_explosion_1.showStateExplosionSummary)(run);
-        (0, state_1.saveCheckpoint)(run);
-        return report;
-    }
-    /** Observability + cost report for ONE run (v0.1.31). DERIVED from durable
-     *  state; persists a fingerprinted snapshot under `metrics/` but NEVER mutates
-     *  the run's own state.json (no saveCheckpoint), so the source — and therefore
-     *  the report — is stable across repeated reads. `now` is injectable via
-     *  `args.now` for eval/replay determinism; pricing is POLICY via `--pricing`. */
-    metricsShow(runId, args = {}) {
-        const run = this.loadRun(runId);
-        const policy = (0, observability_1.loadCostPolicy)(args, this.pluginRoot);
-        const now = typeof args.now === "string" && args.now ? args.now : new Date().toISOString();
-        return (0, observability_1.showMetricsReport)(run, { now, policy });
-    }
-    blackboardSummarize(runId, options = {}) {
-        return (0, state_explosion_1.summarizeBlackboardDigest)(this.loadRun(runId), (0, cli_options_1.stringOption)(options.blackboard || options.blackboardId));
-    }
-    multiAgentSummarize(runId) {
-        const run = this.loadRun(runId);
-        const index = (0, state_explosion_1.loadStateExplosionSummaryIndex)(run);
-        return (0, state_explosion_1.buildStateExplosionReport)(run, { index });
-    }
-    multiAgentGraphView(runId, options = {}) {
-        const view = (0, cli_options_1.graphViewOption)(options.view);
-        return (0, state_explosion_1.buildCompactGraph)(this.loadRun(runId), view, {
-            focus: (0, cli_options_1.stringOption)(options.focus),
-            depth: (0, cli_options_1.numberOption)(options.depth)
-        });
-    }
-    stateExplosionReport(runId) {
-        const run = this.loadRun(runId);
-        const index = (0, state_explosion_1.loadStateExplosionSummaryIndex)(run);
-        return (0, state_explosion_1.buildStateExplosionReport)(run, { index });
-    }
-    // Host multi-agent — delegated to ./orchestrator/host-operations. The runner
-    // keeps the load-or-plan policy here because it owns plan().
-    hostMultiAgentRun(runId, options = {}) {
-        const workflowId = (0, cli_options_1.stringOption)(options.app || options.appId || options.workflow || options.workflowId);
-        const run = runId
-            ? this.loadRun(runId)
-            : workflowId
-                ? this.plan(workflowId, (0, cli_options_1.withoutHostRunKeys)(options))
-                : undefined;
-        if (!run)
-            throw new Error("multi-agent run requires <run-id> or --app <app-id>");
-        return hostOps.hostMultiAgentRun(run, options);
-    }
-    hostMultiAgentStatus(runId) {
-        return hostOps.hostMultiAgentStatus(this.loadRun(runId));
-    }
-    hostMultiAgentStep(runId, options = {}) {
-        return hostOps.hostMultiAgentStep(this.loadRun(runId), options);
-    }
-    hostMultiAgentBlackboard(runId, action, options = {}) {
-        return hostOps.hostMultiAgentBlackboard(this.loadRun(runId), action, options);
-    }
-    hostMultiAgentScore(runId, options = {}) {
-        return hostOps.hostMultiAgentScore(this.loadRun(runId), options);
-    }
-    hostMultiAgentSelect(runId, options = {}) {
-        return hostOps.hostMultiAgentSelect(this.loadRun(runId), options);
-    }
-    evalSnapshot(runId, options = {}) {
-        return (0, multi_agent_eval_1.createMultiAgentReplaySnapshot)(this.loadRun(runId), options);
-    }
-    evalReplay(target, options = {}) {
-        return (0, multi_agent_eval_1.replayMultiAgentSnapshot)(target, options);
-    }
-    evalCompare(baseline, replay) {
-        return (0, multi_agent_eval_1.compareMultiAgentReplay)(baseline, replay);
-    }
-    evalScore(target) {
-        return (0, multi_agent_eval_1.scoreMultiAgentReplay)(target);
-    }
-    evalGate(target) {
-        return (0, multi_agent_eval_1.gateMultiAgentEval)(target);
-    }
-    evalReport(target) {
-        return (0, multi_agent_eval_1.reportMultiAgentEval)(target);
-    }
-    // ---- node snapshot / diff / replay (v0.1.35) ----------------------------
-    nodeSnapshot(runId, nodeId, options = {}) {
-        return (0, node_snapshot_1.snapshotNode)(this.loadRun(runId), nodeId, options);
-    }
-    nodeDiff(runId, baselineSnapshotId, candidateSnapshotId) {
-        const run = this.loadRun(runId);
-        return (0, node_snapshot_1.diffNodeSnapshots)((0, node_snapshot_1.readNodeSnapshot)(run, baselineSnapshotId), (0, node_snapshot_1.readNodeSnapshot)(run, candidateSnapshotId));
-    }
-    nodeReplay(runId, snapshotId, options = {}) {
-        const run = this.loadRun(runId);
-        return (0, node_snapshot_1.replayNodeSnapshot)(run, (0, node_snapshot_1.readNodeSnapshot)(run, snapshotId), options);
-    }
-    nodeReplayVerify(runId, replayId, options = {}) {
-        const run = this.loadRun(runId);
-        return (0, node_snapshot_1.verifyNodeReplay)(run, (0, node_snapshot_1.readNodeReplay)(run, replayId), options);
-    }
-    // ---- contract migration (v0.1.36) ---------------------------------------
-    // Contract migration — delegated to ./orchestrator/migration-operations.
-    migrationList() {
-        return migrationOps.migrationList();
-    }
-    migrationCheck(target, options = {}) {
-        return migrationOps.migrationCheck(target, options);
-    }
-    migrationProve(target, options = {}) {
-        return migrationOps.migrationProve(target, options);
-    }
-    loadMigrationSnapshot(target, options) {
-        return migrationOps.loadMigrationSnapshot(target, options);
-    }
-    // Topology — delegated to ./orchestrator/topology-operations.
-    listTopologies() {
-        return topologyOps.listTopologies();
-    }
-    showTopology(topologyId) {
-        return topologyOps.showTopology(topologyId);
-    }
-    validateTopology(topologyId) {
-        return topologyOps.validateTopology(topologyId);
-    }
-    applyTopology(runId, topologyId, options = {}) {
-        return topologyOps.applyTopology(this.loadRun(runId), topologyId, options);
-    }
-    showTopologyRun(runId, topologyRunId) {
-        return topologyOps.showTopologyRun(this.loadRun(runId), topologyRunId);
-    }
-    topologySummary(runId) {
-        return topologyOps.topologySummary(this.loadRun(runId));
-    }
-    topologyGraph(runId) {
-        return topologyOps.topologyGraph(this.loadRun(runId));
-    }
-    // Multi-agent lifecycle + blackboard — delegated to ./orchestrator/multi-agent-operations.
-    createMultiAgentRun(runId, options = {}) {
-        return maOps.createMultiAgentRun(this.loadRun(runId), options);
-    }
-    transitionMultiAgentRun(runId, multiAgentRunId, options = {}) {
-        return maOps.transitionMultiAgentRun(this.loadRun(runId), multiAgentRunId, options);
-    }
-    createAgentRole(runId, options = {}) {
-        return maOps.createAgentRole(this.loadRun(runId), options);
-    }
-    createAgentGroup(runId, options = {}) {
-        return maOps.createAgentGroup(this.loadRun(runId), options);
-    }
-    assignAgentMembership(runId, options = {}) {
-        return maOps.assignAgentMembership(this.loadRun(runId), options);
-    }
-    createAgentFanout(runId, options = {}) {
-        return maOps.createAgentFanout(this.loadRun(runId), options);
-    }
-    collectAgentFanin(runId, options = {}) {
-        return maOps.collectAgentFanin(this.loadRun(runId), options);
-    }
-    showMultiAgentRun(runId, multiAgentRunId) {
-        return maOps.showMultiAgentRun(this.loadRun(runId), multiAgentRunId);
-    }
-    showAgentRole(runId, roleId) {
-        return maOps.showAgentRole(this.loadRun(runId), roleId);
-    }
-    showAgentGroup(runId, groupId) {
-        return maOps.showAgentGroup(this.loadRun(runId), groupId);
-    }
-    showAgentMembership(runId, membershipId) {
-        return maOps.showAgentMembership(this.loadRun(runId), membershipId);
-    }
-    showAgentFanout(runId, fanoutId) {
-        return maOps.showAgentFanout(this.loadRun(runId), fanoutId);
-    }
-    showAgentFanin(runId, faninId) {
-        return maOps.showAgentFanin(this.loadRun(runId), faninId);
-    }
-    blackboardSummary(runId, options = {}) {
-        return maOps.blackboardSummary(this.loadRun(runId), options);
-    }
-    coordinatorSummary(runId, options = {}) {
-        return maOps.blackboardSummary(this.loadRun(runId), options);
-    }
-    blackboardGraph(runId) {
-        return maOps.blackboardGraph(this.loadRun(runId));
-    }
-    resolveRunBlackboard(runId, options = {}) {
-        return maOps.resolveRunBlackboard(this.loadRun(runId), options);
-    }
-    createBlackboardTopic(runId, options = {}) {
-        return maOps.createBlackboardTopic(this.loadRun(runId), options);
-    }
-    postBlackboardMessage(runId, options = {}) {
-        return maOps.postBlackboardMessage(this.loadRun(runId), options);
-    }
-    listBlackboardMessages(runId, options = {}) {
-        return maOps.listBlackboardMessages(this.loadRun(runId), options);
-    }
-    putBlackboardContext(runId, options = {}) {
-        return maOps.putBlackboardContext(this.loadRun(runId), options);
-    }
-    addBlackboardArtifact(runId, options = {}) {
-        return maOps.addBlackboardArtifact(this.loadRun(runId), options);
-    }
-    listBlackboardArtifacts(runId, options = {}) {
-        return maOps.listBlackboardArtifacts(this.loadRun(runId), options);
-    }
-    snapshotBlackboard(runId, options = {}) {
-        return maOps.snapshotBlackboard(this.loadRun(runId), options);
-    }
-    recordCoordinatorDecision(runId, options = {}) {
-        return maOps.recordCoordinatorDecision(this.loadRun(runId), options);
-    }
-    checkState(runId, options = {}) {
-        return lifecycleOps.checkState(runId, options);
-    }
-    commit(runId, input = {}) {
-        return lifecycleOps.commit(this.loadRun(runId), input);
-    }
-    // Feedback — delegated to ./orchestrator/feedback-operations.
-    collectFeedback(runId) {
-        return feedbackOps.collectFeedback(this.loadRun(runId));
-    }
-    listFeedback(runId, options = {}) {
-        return feedbackOps.listFeedback(this.loadRun(runId), options);
-    }
-    showFeedback(runId, feedbackId) {
-        return feedbackOps.showFeedback(this.loadRun(runId), feedbackId);
-    }
-    createFeedbackTask(runId, feedbackId, options = {}) {
-        return feedbackOps.createFeedbackTask(this.loadRun(runId), feedbackId, options);
-    }
-    resolveFeedback(runId, feedbackId, options = {}) {
-        return feedbackOps.resolveFeedback(this.loadRun(runId), feedbackId, options);
-    }
-    loadRun(runId) {
-        if (this._requestCache) {
-            const cached = this._requestCache.get(runId);
-            if (cached)
-                return cached;
-        }
-        const run = (0, state_1.loadRunFromCwd)(runId, this.baseDir);
-        this._requestCache?.set(runId, run);
-        return run;
-    }
-    invocationCwd() {
-        return this.baseDir || process.cwd();
-    }
-    resolveFromBase(target) {
-        return node_path_1.default.resolve(this.invocationCwd(), target);
-    }
-    loadWorkflowAppById(appId) {
-        return appOps.loadWorkflowAppById(this.workflowsDir, this.appsDir, appId);
-    }
-}
-exports.CoolWorkflowRunner = CoolWorkflowRunner;
-function parseArgv(argv) {
-    const [command, ...rest] = argv;
-    const options = {};
-    const positionals = [];
-    for (let index = 0; index < rest.length; index += 1) {
-        const token = rest[index];
-        if (token === "--") {
-            // POSIX end-of-options: everything after `--` is a positional, even if it
-            // begins with `--`. Lets a legitimate value that starts with `--` through.
-            for (let restIndex = index + 1; restIndex < rest.length; restIndex += 1)
-                positionals.push(rest[restIndex]);
-            break;
-        }
-        if (!token.startsWith("-")) {
-            positionals.push(token);
-            continue;
-        }
-        if (!token.startsWith("--")) {
-            // Single-dash short flag aliases: -q → question, -r → repo, -a → agent-command, -h → help, -v → version
-            const shortMap = { q: "question", r: "repo", d: "dir", l: "link", a: "agent-command", h: "help", v: "version" };
-            const flag = token.slice(1);
-            // Handle combined short flags like -qr (not common but safe to ignore)
-            const key = shortMap[flag] || flag;
-            const val = rest[index + 1] && !rest[index + 1].startsWith("-") ? rest[++index] : true;
-            appendOption(options, key, val);
-            continue;
-        }
-        const withoutPrefix = token.slice(2);
-        const equalsIndex = withoutPrefix.indexOf("=");
-        let key;
-        let value;
-        if (equalsIndex >= 0) {
-            key = withoutPrefix.slice(0, equalsIndex);
-            value = withoutPrefix.slice(equalsIndex + 1);
-        }
-        else {
-            key = withoutPrefix;
-            // A flag's value is never ANOTHER flag: reject a next token starting with `-`
-            // (single OR double dash), matching the single-dash branch above. Without this, a
-            // valueless `--flag` greedily swallowed the following single-dash flag — e.g.
-            // `run app --drive -dir /p` made `drive="-dir"` and dropped `-dir` entirely. A
-            // value that legitimately starts with `-` still goes through `--key=-value` or
-            // after a `--` end-of-options marker (both handled above).
-            value = rest[index + 1] && !rest[index + 1].startsWith("-") ? rest[++index] : true;
-        }
-        appendOption(options, key, value);
-    }
-    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", "clones",
-    "history", "audit-run", "multi-agent", "topology", "summary", "blackboard",
-    "coordinator", "metrics", "operator", "sched", "gc", "telemetry",
-    "migration", "demo", "workbench", "approve", "reject", "comment", "handoff",
-    "graph", "eval", "version", "update", "fix"
-]);
-/** 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() {
-    // Help is written to stdout, so color must key off stdout (not the term default).
-    const out = process.stdout;
-    const moreCommands = ("list search info init plan status next dispatch result state commit report app " +
-        "sandbox backend contract node feedback worker audit candidate review loop schedule " +
-        "routine registry run queue clones history quickstart audit-run multi-agent topology summary " +
-        "blackboard coordinator metrics operator sched gc telemetry migration demo workbench " +
-        "approve reject comment handoff ledger graph eval man version update fix").split(" ");
-    // Wrap the command list into clean, indented, pipe-joined lines (<=76 cols) instead of
-    // one 400-char line that wraps raggedly and merges with the next shell prompt. Pipe-joined
-    // (no internal spaces) keeps it parseable by the CLI/MCP parity help-token check.
-    const wrapped = [];
-    let line = "  ";
-    for (const cmd of moreCommands) {
-        const sep = line.length > 2 ? "|" : "";
-        if (line.length + sep.length + cmd.length > 76) {
-            wrapped.push(line);
-            line = "  ";
-        }
-        line += (line.length > 2 ? "|" : "") + cmd;
-    }
-    if (line.length > 2)
-        wrapped.push(line);
-    return [
-        (0, term_1.bold)("Cool Workflow", out),
-        "",
-        "  -q \"question\" [-claude|-codex|-gemini|-deepseek]  Ask a question, get a report",
-        "  -q \"question\" --link <url>                 Review a remote repo by URL",
-        "  version                                   Show version",
-        "  update                                    Update to latest release",
-        "  doctor                                    Check setup",
-        "  fix                                       Show fix commands for setup issues",
-        "",
-        (0, term_1.bold)("Flags", out),
-        "  -q, --question TEXT    The task or question to answer",
-        "  -r, --repo PATH        Target repository path (default: .)",
-        "  -d, --dir PATH         Project folder to review (alias for --repo)",
-        "  -claude                Use Claude agent",
-        "  -codex                 Use Codex agent",
-        "  -gemini                Use Gemini (via opencode)",
-        "  -deepseek              Use DeepSeek (via opencode)",
-        "  --verbose              Show full agent narration live (default: compact)",
-        "  --full                 Verbose, plus the report printed inline at the end",
-        "  --no-color             Disable ANSI color (also honors NO_COLOR / FORCE_COLOR)",
-        "",
-        (0, term_1.bold)("More commands", out),
-        ...wrapped,
-        "",
-        // 4-space indent on purpose: the CLI/MCP parity help-token check only parses
-        // 2-space command lines, so this note never registers as a bogus token.
-        "    Run  cw help <command>  for one command's subcommands and descriptions."
-    ].join("\n");
-}
-/** Per-command help: `cw help <verb>` (and `cw <verb> --help`) lists that verb's
- *  CLI subcommands with one-line summaries, derived from CAPABILITY_REGISTRY — the
- *  SAME table the dispatcher and the CLI/MCP parity check use, so there is no
- *  second source to drift. Additive: formatHelp()'s parity-checked token list is
- *  untouched. */
-function formatCommandHelp(verb) {
-    const out = process.stdout;
-    const matches = capability_registry_1.CAPABILITY_REGISTRY.filter((cap) => cap.cli && cap.cli.path[0] === verb);
-    if (matches.length === 0) {
-        const lines = [`Unknown command: ${verb}`];
-        const hint = suggestCommand(verb);
-        if (hint)
-            lines.push(`  Did you mean:  cw ${hint}`);
-        lines.push("  Try:  cw help   (list all commands)");
-        return lines.join("\n");
-    }
-    const rows = matches
-        .map((cap) => ({ cmd: `cw ${cap.cli.path.join(" ")}`, summary: cap.summary }))
-        .sort((a, b) => (a.cmd < b.cmd ? -1 : a.cmd > b.cmd ? 1 : 0));
-    const width = Math.min(40, rows.reduce((max, row) => Math.max(max, row.cmd.length), 0));
-    return [
-        (0, term_1.bold)(`cw ${verb}`, out),
-        "",
-        ...rows.map((row) => `  ${row.cmd.padEnd(width)}  ${row.summary}`)
-    ].join("\n");
-}
-function appendOption(options, key, value) {
-    if (Object.prototype.hasOwnProperty.call(options, key)) {
-        const current = options[key];
-        options[key] = Array.isArray(current) ? [...current, value] : [current, value];
-        return;
-    }
-    options[key] = value;
-}
-function resolvePluginRoot(candidate) {
-    let current = node_path_1.default.resolve(candidate);
-    for (let depth = 0; depth < 5; depth += 1) {
-        if (node_fs_1.default.existsSync(node_path_1.default.join(current, "workflows")) && node_fs_1.default.existsSync(node_path_1.default.join(current, "package.json"))) {
-            return current;
-        }
-        current = node_path_1.default.dirname(current);
-    }
-    throw new Error("Run cw.js from the cool-workflow plugin directory");
-}
-function titleize(value) {
-    return value
-        .split("-")
-        .filter(Boolean)
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
-}