cool-workflow 0.2.0 → 0.2.2

package/dist/wiring/capability-table/exec-backend.js

@@ -0,0 +1,162 @@
+"use strict";
+// wiring/capability-table/exec-backend.ts — MILESTONE 5 (execution backend,
+// agent spawn, sandbox) CLI bindings: sandbox.*, backend.*, app.run. Split
+// out of core/capability-table.ts, byte-for-byte (extracted with sed, not
+// retyped).
+Object.defineProperty(exports, "__esModule", { value: true });
+const registry_core_1 = require("./registry-core");
+// MILESTONE 5 (execution backend, agent spawn, sandbox) CLI bindings:
+// sandbox.list|show|validate, backend.list|show|probe,
+// backend.agent.config.show|set, doctor, fix. Handler BODIES live in
+// shell/exec-backend-cli.ts / shell/doctor.ts (impure — env/fs reads);
+// this table only wires argv shape -> handler call, per cli/dispatch.ts's
+// generic executor contract. `sandbox.list`/`backend.list` are ALREADY
+// declared MCP-only rows from milestone 2 (MCP_TOOL_DATA above) — this
+// section layers a `cli` binding onto them (attachCliBinding) and replaces
+// their milestone-2 placeholder `mcp.handler` with the real body, exactly
+// as milestones 3/4 did for their own rows.
+// ---------------------------------------------------------------------
+const exec_backend_cli_1 = require("../../shell/exec-backend-cli");
+const doctor_1 = require("../../shell/doctor");
+const io_1 = require("../../cli/io");
+const app_run_cli_1 = require("../../shell/app-run-cli");
+(0, registry_core_1.attachCliBinding)("sandbox.list", {
+    path: ["sandbox", "list"],
+    jsonMode: "default",
+    handler: (args) => ({ json: (0, exec_backend_cli_1.listSandboxProfilesCli)(args.options) }),
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("sandbox.list").mcp.handler = (args) => (0, exec_backend_cli_1.listSandboxProfilesCli)(args);
+// GAP #24: cw_sandbox_choose / cw_sandbox_resolve + cw_app_run were declared
+// MCP-only rows with the notYetImplemented placeholder handler. Wire them to
+// the ported shell bodies (both are MCP-only in the old build — no CLI path).
+registry_core_1.REGISTRY_BY_CAPABILITY.get("sandbox.choose").mcp.handler = (args) => (0, app_run_cli_1.sandboxChooseCli)(args);
+registry_core_1.REGISTRY_BY_CAPABILITY.get("sandbox.resolve").mcp.handler = (args) => (0, app_run_cli_1.sandboxChooseCli)(args);
+registry_core_1.REGISTRY_BY_CAPABILITY.get("app.run").mcp.handler = (args) => (0, app_run_cli_1.appRunCli)(args);
+(0, registry_core_1.attachCliBinding)("sandbox.show", {
+    path: ["sandbox", "show"],
+    jsonMode: "default",
+    handler: (args) => ({ json: (0, exec_backend_cli_1.showSandboxProfileCli)((0, io_1.required)(args.positionals[0], "profile id"), args.options) }),
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("sandbox.show").mcp.handler = (args) => (0, exec_backend_cli_1.showSandboxProfileCli)((0, io_1.required)((0, io_1.optionalArg)(args.profileId), "profile id"), args);
+(0, registry_core_1.attachCliBinding)("sandbox.validate", {
+    path: ["sandbox", "validate"],
+    jsonMode: "default",
+    handler: (args) => {
+        const result = (0, exec_backend_cli_1.validateSandboxProfileCli)((0, io_1.required)(args.positionals[0], "profile file"), args.options);
+        return { json: result, exitCode: result.valid ? undefined : 1 };
+    },
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("sandbox.validate").mcp.handler = (args) => (0, exec_backend_cli_1.validateSandboxProfileCli)((0, io_1.required)((0, io_1.optionalArg)(args.profileFile), "profile file"), args);
+// PARITY: `sandbox.choose`/`sandbox.resolve` are BOTH-surface capabilities
+// per SPEC/mcp.md (old build cli.path ["sandbox","choose"]/["sandbox",
+// "resolve"]) — they were left MCP-only at GAP #24 (see the comment
+// above sandboxChooseCli's mcp.handler wiring). Attach the same, already-
+// working shell body as the cli.handler too, so the CLI front door and
+// the parity payload probe both reach it (no new business logic, same
+// function both surfaces already call over MCP).
+(0, registry_core_1.attachCliBinding)("sandbox.choose", {
+    path: ["sandbox", "choose"],
+    jsonMode: "default",
+    handler: (args) => ({ json: (0, app_run_cli_1.sandboxChooseCli)(args.options) }),
+});
+(0, registry_core_1.attachCliBinding)("sandbox.resolve", {
+    path: ["sandbox", "resolve"],
+    jsonMode: "default",
+    handler: (args) => ({ json: (0, app_run_cli_1.sandboxChooseCli)(args.options) }),
+});
+(0, registry_core_1.attachCliBinding)("backend.list", {
+    path: ["backend", "list"],
+    jsonMode: "default",
+    handler: () => ({ json: (0, exec_backend_cli_1.listBackendsCli)() }),
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.list").mcp.handler = () => (0, exec_backend_cli_1.listBackendsCli)();
+(0, registry_core_1.attachCliBinding)("backend.show", {
+    path: ["backend", "show"],
+    jsonMode: "default",
+    handler: (args) => ({ json: (0, exec_backend_cli_1.showBackendCli)((0, io_1.required)(args.positionals[0], "backend id")) }),
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.show").mcp.handler = (args) => (0, exec_backend_cli_1.showBackendCli)((0, io_1.required)((0, io_1.optionalArg)(args.backendId), "backend id"));
+(0, registry_core_1.attachCliBinding)("backend.probe", {
+    path: ["backend", "probe"],
+    jsonMode: "default",
+    handler: (args) => ({ json: (0, exec_backend_cli_1.probeBackendCli)(args.positionals[0], args.options) }),
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.probe").mcp.handler = (args) => (0, exec_backend_cli_1.probeBackendCli)((0, io_1.optionalArg)(args.backendId), args);
+// `backend agent config [show]` = read-only; `backend agent config set
+// ...` = mutating. CLI path is ["backend", "agent"] (2 tokens, matching
+// dispatchTable's supported path lengths); the remaining positionals
+// ("config", "show"/"set") are read inside the handler, byte-exact to the
+// old build's handleBackend "agent" case (src/cli/handlers/
+// operational.ts:52-62).
+(0, registry_core_1.attachCliBinding)("backend.agent.config.show", {
+    path: ["backend", "agent"],
+    helpPath: ["backend", "agent", "config"],
+    jsonMode: "default",
+    handler: (args) => {
+        const action = args.positionals[1];
+        if (action === "set")
+            return { json: (0, exec_backend_cli_1.backendAgentConfigSet)(args.options) };
+        return { json: (0, exec_backend_cli_1.backendAgentConfigShow)(args.options) };
+    },
+});
+// `backend.agent.config.set` shares the SAME dispatch path/handler as
+// `.show` above (dispatchTable only supports 2-token paths, and the
+// show-vs-set branch lives inside that one handler on positionals[1] —
+// byte-exact to the old build's handleBackend "agent" case). This second
+// attachCliBinding call exists ONLY so `cw help backend` lists both rows
+// (cliCommandHelpRows iterates cliCapabilities(), one row per capability),
+// matching the old registry's two declared rows sharing one caseTokens
+// group; dispatchTable itself never reaches this row a second time because
+// `backend.agent.config.show`'s row is found first by
+// findCapabilityByCliPath's linear scan and its handler already covers
+// both actions.
+(0, registry_core_1.attachCliBinding)("backend.agent.config.set", {
+    path: ["backend", "agent"],
+    helpPath: ["backend", "agent", "config"],
+    jsonMode: "default",
+    handler: (args) => {
+        const action = args.positionals[1];
+        if (action === "set")
+            return { json: (0, exec_backend_cli_1.backendAgentConfigSet)(args.options) };
+        return { json: (0, exec_backend_cli_1.backendAgentConfigShow)(args.options) };
+    },
+});
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.agent.config.show").mcp.handler = (args) => (0, exec_backend_cli_1.backendAgentConfigShow)(args);
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.agent.config.set").mcp.handler = (args) => (0, exec_backend_cli_1.backendAgentConfigSet)(args);
+// PARITY: `backend.agent.config.set` mutates $CW_HOME/agent-config.json
+// (secret-stripped) before returning the effective config; both surfaces
+// perform the same write, so it is a documented opt-out from the
+// read-payload probe, not an undocumented divergence.
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.agent.config.set").payloadIdentical = false;
+registry_core_1.REGISTRY_BY_CAPABILITY.get("backend.agent.config.set").reason =
+    "Mutating: persists $CW_HOME/agent-config.json (secret-stripped) before returning the effective config; both surfaces perform the same write — it is a surface-mutating verb, not a read probe.";
+(0, registry_core_1.addCliOnlyCapability)("doctor", "Diagnose the host for setup problems (Node version, agent backend, agent binary on PATH, git, writable home/repo state) and print an actionable fix per check.", {
+    path: ["doctor"],
+    jsonMode: "flag",
+    handler: (args) => {
+        const report = (0, doctor_1.runDoctor)(args.options, process.env, String(args.options.cwd || process.cwd()));
+        // Byte-exact port of src/cli/command-surface.ts:170-176: both text
+        // branches are written as `${formatX(report)}\n` UNCONDITIONALLY —
+        // formatDoctorFixes already ends in its own "\n" (its last joined
+        // element is ""), so its case needs one MORE explicit "\n" here to
+        // reproduce that unconditional append; cli/dispatch.ts's generic
+        // renderer only appends "\n" when the text does NOT already end in
+        // one, so a bare `formatDoctorFixes(report)` here would silently
+        // drop the old build's trailing blank line.
+        const text = (0, io_1.wantsJson)(args.options) ? undefined : args.options.fix ? `${(0, doctor_1.formatDoctorFixes)(report)}\n` : (0, doctor_1.formatDoctorReport)(report);
+        return { json: report, text, exitCode: report.ok ? undefined : 1 };
+    },
+}, "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`.");
+(0, registry_core_1.addCliOnlyCapability)("fix", "Print consolidated fix commands for CW setup issues.", {
+    path: ["fix"],
+    jsonMode: "human",
+    handler: (args) => {
+        const report = (0, doctor_1.runDoctor)(args.options, process.env, String(args.options.cwd || process.cwd()));
+        // See the "doctor" handler's comment above: formatDoctorFixes
+        // already ends in "\n", so one more explicit "\n" here reproduces
+        // src/cli/command-surface.ts:126-130's unconditional
+        // `${formatDoctorFixes(report)}\n` write.
+        return { text: `${(0, doctor_1.formatDoctorFixes)(report)}\n`, exitCode: report.ok ? undefined : 1 };
+    },
+}, "Environment fix commands are local diagnostics, same reasoning as doctor.");
+// ---------------------------------------------------------------------

package/dist/wiring/capability-table/index.js

@@ -0,0 +1,42 @@
+"use strict";
+// wiring/capability-table/index.ts — composes the capability table from
+// registry-core (the shared machinery) plus every domain slice, in the
+// EXACT original source order (REGISTRY array order is a pinned
+// behavior: tools/list order, gen-parity-doc's byte-diff gate, cw help
+// line order). Each slice is a plain module whose top-level
+// attachCliBinding/addCliOnlyCapability/REGISTRY_BY_CAPABILITY calls run
+// once, at first import — Node's module system guarantees that happens
+// in exactly the order these imports are written below, the same
+// guarantee the single original file relied on for its own top-to-bottom
+// statement order.
+//
+// No slice imports another slice; every slice imports only from
+// registry-core.ts, core/capability-data.ts, and shell/core as needed —
+// so this file is the only place the full domain list is assembled, and
+// there is no cross-slice circular dependency to reason about.
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./registry-core"), exports);
+require("./basics");
+require("./state");
+require("./exec-backend");
+require("./pipeline");
+require("./trust-ledger");
+require("./multi-agent");
+require("./scheduling-registry");
+require("./reporting");
+require("./workflow-apps");
+__exportStar(require("./parity"), exports);