cool-workflow 0.1.92 → 0.1.94

package/dist/cli/handlers/multi-agent.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMultiAgent = handleMultiAgent;
+const operator_ux_1 = require("../../operator-ux");
+const multi_agent_operator_ux_1 = require("../../multi-agent-operator-ux");
+const state_explosion_1 = require("../../state-explosion");
+const evidence_reasoning_1 = require("../../evidence-reasoning");
+const io_1 = require("../io");
+/** `cw multi-agent <verb> <run-id> [id]` — the multi-agent operator surface. */
+function handleMultiAgent(args, runner) {
+    const [subcommand, runId, id] = args.positionals;
+    switch (subcommand) {
+        case "status":
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(runner.hostMultiAgentStatus((0, io_1.required)(runId, "run id")));
+            else
+                process.stdout.write(`${(0, multi_agent_operator_ux_1.formatMultiAgentOperatorStatus)(runner.multiAgentOperatorStatus((0, io_1.required)(runId, "run id")))}\n`);
+            return;
+        case "step":
+            (0, io_1.printJson)(runner.hostMultiAgentStep((0, io_1.required)(runId, "run id"), args.options));
+            return;
+        case "blackboard":
+            (0, io_1.printJson)(runner.hostMultiAgentBlackboard((0, io_1.required)(runId, "run id"), id, args.options));
+            return;
+        case "score":
+            (0, io_1.printJson)(runner.hostMultiAgentScore((0, io_1.required)(runId, "run id"), { ...args.options, candidate: args.options.candidate || args.options.candidateId || id }));
+            return;
+        case "select":
+            (0, io_1.printJson)(runner.hostMultiAgentSelect((0, io_1.required)(runId, "run id"), { ...args.options, candidate: args.options.candidate || args.options.candidateId || id }));
+            return;
+        case "summary": {
+            const summary = runner.multiAgentSummary((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(summary);
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatMultiAgentSummary)(summary)}\n`);
+            return;
+        }
+        case "summarize": {
+            const report = runner.multiAgentSummarize((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, state_explosion_1.formatStateExplosionReport)(report)}\n`);
+            return;
+        }
+        case "graph": {
+            const wantsView = args.options.view || args.options.focus || args.options.depth;
+            if (wantsView) {
+                const graph = runner.multiAgentGraphView((0, io_1.required)(runId, "run id"), args.options);
+                if ((0, io_1.wantsJson)(args.options))
+                    (0, io_1.printJson)(graph);
+                else
+                    process.stdout.write(`${(0, state_explosion_1.formatCompactGraph)(graph)}\n`);
+                return;
+            }
+            const graph = runner.multiAgentOperatorGraph((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(graph);
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatOperatorGraph)({ runId: (0, io_1.required)(runId, "run id"), nodes: graph.nodes, edges: graph.edges })}\n`);
+            return;
+        }
+        case "dependencies": {
+            const rows = runner.multiAgentDependencies((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(rows);
+            else
+                process.stdout.write(`${(0, multi_agent_operator_ux_1.formatMultiAgentDependencies)(rows)}\n`);
+            return;
+        }
+        case "failures": {
+            const rows = runner.multiAgentFailures((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(rows);
+            else
+                process.stdout.write(`${(0, multi_agent_operator_ux_1.formatMultiAgentFailures)(rows)}\n`);
+            return;
+        }
+        case "evidence": {
+            const rows = runner.multiAgentEvidence((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(rows);
+            else
+                process.stdout.write(`${(0, multi_agent_operator_ux_1.formatMultiAgentEvidence)(rows)}\n`);
+            return;
+        }
+        case "reasoning": {
+            if (args.options.refresh && !args.options.evidence && !args.options.evidenceId) {
+                const index = runner.multiAgentReasoningRefresh((0, io_1.required)(runId, "run id"));
+                (0, io_1.printJson)(index);
+                return;
+            }
+            const report = runner.multiAgentReasoning((0, io_1.required)(runId, "run id"), { ...args.options, evidence: args.options.evidence || args.options.evidenceId || id });
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, evidence_reasoning_1.formatEvidenceReasoningReport)(report)}\n`);
+            return;
+        }
+        case "run":
+            if (!runId ||
+                args.options.topology ||
+                args.options.topologyId ||
+                args.options.app ||
+                args.options.appId ||
+                args.options.workflow ||
+                args.options.workflowId) {
+                (0, io_1.printJson)(runner.hostMultiAgentRun(runId, args.options));
+                return;
+            }
+            if (id && !args.options.id && !args.options.status)
+                (0, io_1.printJson)(runner.showMultiAgentRun((0, io_1.required)(runId, "run id"), id));
+            else if (id && args.options.status)
+                (0, io_1.printJson)(runner.transitionMultiAgentRun((0, io_1.required)(runId, "run id"), id, args.options));
+            else
+                (0, io_1.printJson)(runner.createMultiAgentRun((0, io_1.required)(runId, "run id"), args.options));
+            return;
+        case "show":
+            (0, io_1.printJson)(runner.showMultiAgentRun((0, io_1.required)(runId, "run id"), (0, io_1.required)(id, "multi-agent run id")));
+            return;
+        case "role":
+            if (id && !args.options.id && !args.options["multi-agent-run"] && !args.options.multiAgentRun && !args.options.multiAgentRunId) {
+                (0, io_1.printJson)(runner.showAgentRole((0, io_1.required)(runId, "run id"), id));
+            }
+            else {
+                (0, io_1.printJson)(runner.createAgentRole((0, io_1.required)(runId, "run id"), { ...args.options, id: args.options.id || id }));
+            }
+            return;
+        case "group":
+            if (id && !args.options.id && !args.options["multi-agent-run"] && !args.options.multiAgentRun && !args.options.multiAgentRunId) {
+                (0, io_1.printJson)(runner.showAgentGroup((0, io_1.required)(runId, "run id"), id));
+            }
+            else {
+                (0, io_1.printJson)(runner.createAgentGroup((0, io_1.required)(runId, "run id"), { ...args.options, id: args.options.id || id }));
+            }
+            return;
+        case "membership":
+            if (id && !args.options.id && !args.options.group && !args.options.groupId && !args.options["multi-agent-group"]) {
+                (0, io_1.printJson)(runner.showAgentMembership((0, io_1.required)(runId, "run id"), id));
+            }
+            else {
+                (0, io_1.printJson)(runner.assignAgentMembership((0, io_1.required)(runId, "run id"), { ...args.options, id: args.options.id || id }));
+            }
+            return;
+        case "fanout":
+            if (id && !args.options.id && !args.options.group && !args.options.groupId && !args.options["multi-agent-group"]) {
+                (0, io_1.printJson)(runner.showAgentFanout((0, io_1.required)(runId, "run id"), id));
+            }
+            else {
+                (0, io_1.printJson)(runner.createAgentFanout((0, io_1.required)(runId, "run id"), { ...args.options, id: args.options.id || id }));
+            }
+            return;
+        case "fanin":
+            if (id && !args.options.id && !args.options.group && !args.options.groupId && !args.options["multi-agent-group"] && !args.options.fanout) {
+                (0, io_1.printJson)(runner.showAgentFanin((0, io_1.required)(runId, "run id"), id));
+            }
+            else {
+                (0, io_1.printJson)(runner.collectAgentFanin((0, io_1.required)(runId, "run id"), { ...args.options, id: args.options.id || id }));
+            }
+            return;
+        default:
+            throw new Error("Usage: cw.js multi-agent run|status|step|blackboard|score|select|summary|summarize|graph|dependencies|failures|evidence|reasoning|show|role|group|membership|fanout|fanin <run-id> [id]");
+    }
+}

package/dist/cli/handlers/node.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleNode = handleNode;
+const operator_ux_1 = require("../../operator-ux");
+const io_1 = require("../io");
+/** `cw node list|show|graph|snapshot|diff|replay|verify <run-id> …` — node inspection. */
+function handleNode(args, runner) {
+    const [subcommand, runId, nodeId] = args.positionals;
+    switch (subcommand) {
+        case "list":
+            (0, io_1.printJson)(runner.listNodes((0, io_1.required)(runId, "run id")));
+            return;
+        case "show":
+            (0, io_1.printJson)(runner.showNode((0, io_1.required)(runId, "run id"), (0, io_1.required)(nodeId, "node id")));
+            return;
+        case "graph":
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(runner.graphNodes((0, io_1.required)(runId, "run id")));
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatOperatorGraph)(runner.operatorGraph((0, io_1.required)(runId, "run id")))}\n`);
+            return;
+        case "snapshot":
+            (0, io_1.printJson)(runner.nodeSnapshot((0, io_1.required)(runId, "run id"), (0, io_1.required)(nodeId, "node id")));
+            return;
+        case "diff":
+            (0, io_1.printJson)(runner.nodeDiff((0, io_1.required)(runId, "run id"), (0, io_1.required)(nodeId, "baseline snapshot id"), (0, io_1.required)(args.positionals[3], "candidate snapshot id")));
+            return;
+        case "replay":
+            (0, io_1.printJson)(runner.nodeReplay((0, io_1.required)(runId, "run id"), (0, io_1.required)(nodeId, "snapshot id")));
+            return;
+        case "verify": {
+            const verdict = runner.nodeReplayVerify((0, io_1.required)(runId, "run id"), (0, io_1.required)(nodeId, "replay id"));
+            (0, io_1.printJson)(verdict);
+            if (!verdict.pass)
+                process.exitCode = 1;
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js node list|show|graph|snapshot|diff|replay|verify <run-id> [node-id|snapshot-id|replay-id]");
+    }
+}

package/dist/cli/handlers/operational.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSandbox = handleSandbox;
+exports.handleBackend = handleBackend;
+exports.handleContract = handleContract;
+exports.handleMigration = handleMigration;
+exports.handleFeedback = handleFeedback;
+exports.handleMetrics = handleMetrics;
+const capability_core_1 = require("../../capability-core");
+const observability_1 = require("../../observability");
+const operator_ux_1 = require("../../operator-ux");
+const io_1 = require("../io");
+/** `cw sandbox list|show|validate|choose|resolve [profile-id|profile-file]`. */
+function handleSandbox(args, runner) {
+    const [subcommand, profileIdOrFile] = args.positionals;
+    switch (subcommand) {
+        case "list":
+            (0, io_1.printJson)(runner.listSandboxProfiles(args.options));
+            return;
+        case "show":
+            (0, io_1.printJson)(runner.showSandboxProfile((0, io_1.required)(profileIdOrFile, "profile id"), args.options));
+            return;
+        case "validate": {
+            const result = runner.validateSandboxProfile((0, io_1.required)(profileIdOrFile, "profile file"), args.options);
+            (0, io_1.printJson)(result);
+            if (!result.valid)
+                process.exitCode = 1;
+            return;
+        }
+        case "choose":
+        case "resolve":
+            (0, io_1.printJson)((0, capability_core_1.sandboxChoose)(runner, { ...args.options, profileId: profileIdOrFile || args.options.profileId }));
+            return;
+        default:
+            throw new Error("Usage: cw.js sandbox list|show|validate|choose|resolve [profile-id|profile-file]");
+    }
+}
+/** `cw backend list|show|probe [backend-id]  |  cw backend agent config [show|set] …`. */
+function handleBackend(args, runner) {
+    const [subcommand, backendId] = args.positionals;
+    switch (subcommand) {
+        case "list":
+            (0, io_1.printJson)(runner.listBackends(args.options));
+            return;
+        case "show":
+            (0, io_1.printJson)(runner.showBackend((0, io_1.required)(backendId, "backend id"), args.options));
+            return;
+        case "probe":
+            (0, io_1.printJson)(runner.probeBackend(backendId, args.options));
+            return;
+        case "agent": {
+            // `backend agent config [show]` = read-only; `backend agent config set ...` = mutating.
+            const [, , action] = args.positionals;
+            if (action === "set") {
+                (0, io_1.printJson)((0, capability_core_1.backendAgentConfigSet)(args.options));
+                return;
+            }
+            (0, io_1.printJson)((0, capability_core_1.backendAgentConfigShow)(args.options));
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js backend list|show|probe [backend-id]  |  cw.js backend agent config [show|set] [--agent-command ... --agent-endpoint ... --agent-model ...]");
+    }
+}
+/** `cw contract show <run-id> [contract-id]`. */
+function handleContract(args, runner) {
+    const [subcommand, runId, contractId] = args.positionals;
+    switch (subcommand) {
+        case "show":
+            (0, io_1.printJson)(runner.showContract((0, io_1.required)(runId, "run id"), contractId));
+            return;
+        default:
+            throw new Error("Usage: cw.js contract show <run-id> [contract-id]");
+    }
+}
+/** `cw migration list|check|prove [target] …`. */
+function handleMigration(args, runner) {
+    const [subcommand, target] = args.positionals;
+    switch (subcommand) {
+        case "list":
+            (0, io_1.printJson)(runner.migrationList());
+            return;
+        case "check": {
+            const report = runner.migrationCheck((0, io_1.required)(target, "target (run-id or state/app file)"), args.options);
+            (0, io_1.printJson)(report);
+            if (report.status === "unsupported")
+                process.exitCode = 1;
+            return;
+        }
+        case "prove": {
+            const proof = runner.migrationProve((0, io_1.required)(target, "target (run-id or state/app file)"), args.options);
+            (0, io_1.printJson)(proof);
+            if (!proof.pass)
+                process.exitCode = 1;
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js migration list|check|prove [target] [--contract run-state|workflow-app]");
+    }
+}
+/** `cw feedback list|show|summary|collect|task|resolve <run-id> [feedback-id]`. */
+function handleFeedback(args, runner) {
+    const [subcommand, runId, feedbackId] = args.positionals;
+    switch (subcommand) {
+        case "list":
+            (0, io_1.printJson)(runner.listFeedback((0, io_1.required)(runId, "run id"), args.options));
+            return;
+        case "show":
+            (0, io_1.printJson)(runner.showFeedback((0, io_1.required)(runId, "run id"), (0, io_1.required)(feedbackId, "feedback id")));
+            return;
+        case "collect":
+            (0, io_1.printJson)(runner.collectFeedback((0, io_1.required)(runId, "run id")));
+            return;
+        case "summary": {
+            const summary = runner.summarizeFeedbackRecords((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(summary);
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatFeedbackSummary)(summary)}\n`);
+            return;
+        }
+        case "task":
+            (0, io_1.printJson)(runner.createFeedbackTask((0, io_1.required)(runId, "run id"), (0, io_1.required)(feedbackId, "feedback id"), args.options));
+            return;
+        case "resolve":
+            (0, io_1.printJson)(runner.resolveFeedback((0, io_1.required)(runId, "run id"), (0, io_1.required)(feedbackId, "feedback id"), args.options));
+            return;
+        default:
+            throw new Error("Usage: cw.js feedback list|show|summary|collect|task|resolve <run-id> [feedback-id]");
+    }
+}
+/** `cw metrics show <run-id> | metrics summary …`. */
+function handleMetrics(args, runner) {
+    const [subcommand, runId] = args.positionals;
+    switch (subcommand) {
+        case "show": {
+            const report = runner.metricsShow((0, io_1.required)(runId, "run id"), args.options);
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, observability_1.formatMetricsReport)(report)}\n`);
+            return;
+        }
+        case "summary": {
+            const report = (0, capability_core_1.metricsSummary)((0, capability_core_1.runRegistryFor)(args.options, runner), runner, args.options);
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, observability_1.formatMetricsSummary)(report)}\n`);
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js metrics show <run-id> | metrics summary [--scope repo|home] [--pricing <path>|default] [--json]");
+    }
+}

package/dist/cli/handlers/operator.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleReport = handleReport;
+exports.handleOperator = handleOperator;
+exports.handleGraph = handleGraph;
+exports.handleTopology = handleTopology;
+exports.handleSummary = handleSummary;
+const capability_core_1 = require("../../capability-core");
+const operator_ux_1 = require("../../operator-ux");
+const state_explosion_1 = require("../../state-explosion");
+const io_1 = require("../io");
+/** `cw report <run-id> [--show] | report bundle <run-id> | report verify-bundle <path>`. */
+function handleReport(args, runner) {
+    // `report verify-bundle <path>` is the offline self-contained bundle verifier;
+    // `report bundle <run-id>` exports a sealed bundle and self-verifies it;
+    // every other `report <run-id>` form prints/inspects a local run's report.
+    if (args.positionals[0] === "verify-bundle") {
+        const result = (0, capability_core_1.runVerifyReportBundle)(runner, { ...args.options, archive: args.positionals[1] || args.options.archive || args.options.path || args.options.file || args.options.bundle });
+        (0, io_1.printJson)(result);
+        // Fail closed: a forged/edited/corrupt bundle verifies false — surface it
+        // through the exit code so `cw report verify-bundle <file> && ship` cannot
+        // pass on a lie. Mirrors run inspect-archive / telemetry verify.
+        if (!result.ok)
+            process.exitCode = 1;
+        return;
+    }
+    if (args.positionals[0] === "bundle") {
+        const result = (0, capability_core_1.reportBundle)(runner, (0, io_1.required)(args.positionals[1] || (0, io_1.optionalArg)(args.options.runId || args.options.run), "run id"), args.options);
+        (0, io_1.printJson)(result);
+        // Fail closed: never report a "bundle made" success if the artifact does not
+        // self-verify — so `cw report bundle <run> && send-to-client` cannot ship an
+        // unverifiable report (e.g. no trust key under --strict-signatures).
+        if (!result.ok)
+            process.exitCode = 1;
+        return;
+    }
+    const runId = (0, io_1.required)(args.positionals[0], "run id");
+    const report = runner.report(runId);
+    if ((0, io_1.wantsJson)(args.options)) {
+        (0, io_1.printJson)(report);
+    }
+    else if (args.options.show || args.options.summary) {
+        process.stdout.write(`${(0, operator_ux_1.formatOperatorReport)(runner.operatorReport(runId))}\n`);
+        process.stdout.write(`\n${(0, state_explosion_1.formatStateExplosionReport)(runner.stateExplosionReport(runId))}\n`);
+    }
+    else {
+        process.stdout.write(`${report.path}\n`);
+    }
+}
+/** `cw operator status|report <run-id> [--json]`. */
+function handleOperator(args, runner) {
+    const [subcommand, runId] = args.positionals;
+    switch (subcommand) {
+        case "status":
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(runner.operatorStatus((0, io_1.required)(runId, "run id")));
+            else {
+                const summary = runner.operatorStatus((0, io_1.required)(runId, "run id"));
+                process.stdout.write(`${(args.options.summary || args.options.brief ? (0, operator_ux_1.formatOperatorSummary)(summary) : (0, operator_ux_1.formatOperatorStatus)(summary))}\n`);
+            }
+            return;
+        case "report":
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(runner.operatorReport((0, io_1.required)(runId, "run id")));
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatOperatorReport)(runner.operatorReport((0, io_1.required)(runId, "run id")))}\n`);
+            return;
+        default:
+            throw new Error("Usage: cw.js operator status|report <run-id> [--json]");
+    }
+}
+/** `cw graph <run-id> [--json]` — the operator run graph. */
+function handleGraph(args, runner) {
+    const graph = runner.operatorGraph((0, io_1.required)(args.positionals[0], "run id"));
+    if ((0, io_1.wantsJson)(args.options))
+        (0, io_1.printJson)(graph);
+    else
+        process.stdout.write(`${(0, operator_ux_1.formatOperatorGraph)(graph)}\n`);
+}
+/** `cw topology list|show|validate|apply|summary|graph …`. */
+function handleTopology(args, runner) {
+    const [subcommand, first, second] = args.positionals;
+    switch (subcommand) {
+        case "list":
+            (0, io_1.printJson)(runner.listTopologies());
+            return;
+        case "show":
+            if (second)
+                (0, io_1.printJson)(runner.showTopologyRun((0, io_1.required)(first, "run id"), second));
+            else
+                (0, io_1.printJson)(runner.showTopology((0, io_1.required)(first, "topology id")));
+            return;
+        case "validate": {
+            const result = runner.validateTopology((0, io_1.required)(first, "topology id"));
+            (0, io_1.printJson)(result);
+            if (!result.valid)
+                process.exitCode = 1;
+            return;
+        }
+        case "apply":
+            (0, io_1.printJson)(runner.applyTopology((0, io_1.required)(first, "run id"), (0, io_1.required)(second, "topology id"), args.options));
+            return;
+        case "summary": {
+            const summary = runner.topologySummary((0, io_1.required)(first, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(summary);
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatTopologySummary)(summary)}\n`);
+            return;
+        }
+        case "graph": {
+            const graph = runner.topologyGraph((0, io_1.required)(first, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(graph);
+            else
+                process.stdout.write(`${(0, operator_ux_1.formatOperatorGraph)({ runId: (0, io_1.required)(first, "run id"), nodes: graph.nodes, edges: graph.edges })}\n`);
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js topology list|show <topology-id>|show <run-id> <topology-run-id>|validate <topology-id>|apply <run-id> <topology-id>|summary <run-id>|graph <run-id>");
+    }
+}
+/** `cw summary refresh|show <run-id> [--json]` — durable state-explosion summary. */
+function handleSummary(args, runner) {
+    const [subcommand, runId] = args.positionals;
+    switch (subcommand) {
+        case "refresh": {
+            const index = runner.summaryRefresh((0, io_1.required)(runId, "run id"), args.options);
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(index);
+            else
+                process.stdout.write(`${(0, state_explosion_1.formatStateExplosionReport)(runner.summaryShow((0, io_1.required)(runId, "run id")))}\n`);
+            return;
+        }
+        case "show": {
+            const report = runner.summaryShow((0, io_1.required)(runId, "run id"));
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, state_explosion_1.formatStateExplosionReport)(report)}\n`);
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js summary refresh|show <run-id> [--json]");
+    }
+}

package/dist/cli/handlers/registry.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRegistry = handleRegistry;
+exports.handleQueue = handleQueue;
+exports.handleHistory = handleHistory;
+const capability_core_1 = require("../../capability-core");
+const run_registry_1 = require("../../run-registry");
+const io_1 = require("../io");
+/** `cw registry refresh|show [--scope repo|home] [--json]`. */
+function handleRegistry(args, runner) {
+    const registry = (0, capability_core_1.runRegistryFor)(args.options, runner);
+    const [subcommand] = args.positionals;
+    switch (subcommand) {
+        case "refresh": {
+            const report = (0, capability_core_1.runRegistryRefresh)(registry, args.options);
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, run_registry_1.formatRegistryReport)(report)}\n`);
+            return;
+        }
+        case "show": {
+            const report = (0, capability_core_1.runRegistryShow)(registry, args.options);
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(report);
+            else
+                process.stdout.write(`${(0, run_registry_1.formatRegistryReport)(report)}\n`);
+            return;
+        }
+        default:
+            throw new Error("Usage: cw.js registry refresh|show [--scope repo|home] [--json]");
+    }
+}
+/** `cw queue add|list|drain|show [queue-id] [--repo PATH] [--priority N]`. */
+function handleQueue(args, runner) {
+    const registry = (0, capability_core_1.runRegistryFor)(args.options, runner);
+    const [subcommand, id] = args.positionals;
+    switch (subcommand) {
+        case "add":
+            (0, io_1.printJson)((0, capability_core_1.queueAdd)(registry, args.options));
+            return;
+        case "list": {
+            const result = (0, capability_core_1.queueList)(registry, args.options);
+            if ((0, io_1.wantsJson)(args.options))
+                (0, io_1.printJson)(result);
+            else
+                process.stdout.write(`${(0, run_registry_1.formatQueueList)(result)}\n`);
+            return;
+        }
+        case "drain":
+            (0, io_1.printJson)((0, capability_core_1.queueDrain)(registry, args.options));
+            return;
+        case "show":
+            (0, io_1.printJson)((0, capability_core_1.queueShow)(registry, (0, io_1.required)(id, "queue id")));
+            return;
+        default:
+            throw new Error("Usage: cw.js queue add|list|drain|show [queue-id] [--repo PATH] [--priority N]");
+    }
+}
+/** `cw history [--json]` — recent runs across the resolved registry scope. */
+function handleHistory(args, runner) {
+    const registry = (0, capability_core_1.runRegistryFor)(args.options, runner);
+    const result = (0, capability_core_1.runHistory)(registry, args.options);
+    if ((0, io_1.wantsJson)(args.options))
+        (0, io_1.printJson)(result);
+    else
+        process.stdout.write(`${(0, run_registry_1.formatHistory)(result)}\n`);
+}