@slowcook-ai/cli 0.19.5 → 0.20.0

package/dist/commands/serve/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../src/commands/serve/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAajC;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,KAAK;YACnB,MAAM,EAAE,qEAAqE;SAC9E,CAAC;IACJ,CAAC;IACD,IAAI,GAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,KAAK;YACnB,MAAM,EAAE,wCAAyC,CAAW,CAAC,OAAO,EAAE;SACvE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;IACnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,KAAK;YACnB,MAAM,EACJ,wGAAwG;SAC3G,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;QAClB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/commands/serve/dev.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `slowcook serve dev <verb>` — Phase 1 implementation.
+ *
+ * Verbs (Phase 1):
+ *   - up      — bring up the dev profile (compose overlay or fallback)
+ *   - sync    — push source-branch + restart bind-mount targets
+ *   - down    — stop the profile's services (volumes preserved)
+ *   - logs    — pass-through to docker-compose logs
+ *   - reset   — no-op for dev profile (only meaningful for staging)
+ *
+ * Backward-compat aliases preserved on the cli switch:
+ *   - `slowcook dev-env push --branch X` ≡ `slowcook serve dev sync --branch X`
+ *   - `slowcook dev-env up` ≡ `slowcook serve dev up`
+ *   - `slowcook dev-env reset` ≡ `slowcook serve dev reset` (no-op + notice)
+ *
+ * 0.19.7 (sc#173 fixes):
+ *   - Planner populates `commands[]` (structured ShellCommand records).
+ *     The cli wrapper invokes runCommands() to actually execute (or
+ *     dry-run); previously `up`/`down`/`logs` were planners only.
+ *   - Compose-file layering: respects `profile.compose_files` (multi-`-f`)
+ *     OR `compose_overlay` (single). Real consumers need base+overlay.
+ *   - `--build` flag is suppressed for `bind-mount-source` mode (the
+ *     mode's whole point is skipping the build loop).
+ */
+import type { ProfileConfig, ServeConfig } from "./config.js";
+import type { ShellCommand } from "./runner.js";
+export interface DevVerbArgs {
+    verb: string;
+    branch?: string;
+    story?: string;
+    service?: string;
+    follow?: boolean;
+    prune?: boolean;
+    repoRoot: string;
+    /** Test seam: report the plan but skip actual git rev-parse. */
+    dryRun?: boolean;
+}
+export interface DevVerbResult {
+    exitCode: number;
+    /** Human narrative emitted by the planner. */
+    output: string[];
+    /** Shell commands the cli wrapper should execute (in order). */
+    commands?: ShellCommand[];
+}
+export declare function planServeDev(args: DevVerbArgs, _config: ServeConfig, profile: ProfileConfig): DevVerbResult;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/serve/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/commands/serve/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,aAAa,GACrB,aAAa,CAkBf"}

package/dist/commands/serve/dev.js

@@ -0,0 +1,122 @@
+/**
+ * `slowcook serve dev <verb>` — Phase 1 implementation.
+ *
+ * Verbs (Phase 1):
+ *   - up      — bring up the dev profile (compose overlay or fallback)
+ *   - sync    — push source-branch + restart bind-mount targets
+ *   - down    — stop the profile's services (volumes preserved)
+ *   - logs    — pass-through to docker-compose logs
+ *   - reset   — no-op for dev profile (only meaningful for staging)
+ *
+ * Backward-compat aliases preserved on the cli switch:
+ *   - `slowcook dev-env push --branch X` ≡ `slowcook serve dev sync --branch X`
+ *   - `slowcook dev-env up` ≡ `slowcook serve dev up`
+ *   - `slowcook dev-env reset` ≡ `slowcook serve dev reset` (no-op + notice)
+ *
+ * 0.19.7 (sc#173 fixes):
+ *   - Planner populates `commands[]` (structured ShellCommand records).
+ *     The cli wrapper invokes runCommands() to actually execute (or
+ *     dry-run); previously `up`/`down`/`logs` were planners only.
+ *   - Compose-file layering: respects `profile.compose_files` (multi-`-f`)
+ *     OR `compose_overlay` (single). Real consumers need base+overlay.
+ *   - `--build` flag is suppressed for `bind-mount-source` mode (the
+ *     mode's whole point is skipping the build loop).
+ */
+import { execSync } from "node:child_process";
+import { composeFiles, shouldBuildOnUp } from "./config.js";
+export function planServeDev(args, _config, profile) {
+    switch (args.verb) {
+        case "up":
+            return planUp(args, profile);
+        case "sync":
+            return planSync(args, profile);
+        case "down":
+            return planDown(args, profile);
+        case "logs":
+            return planLogs(args, profile);
+        case "reset":
+            return {
+                exitCode: 0,
+                output: ["[serve dev reset] dev profile has no scenario seed; nothing to reset (only meaningful for staging)."],
+            };
+        default:
+            return { exitCode: 64, output: [`Unknown verb: ${args.verb}. See \`slowcook serve dev --help\`.`] };
+    }
+}
+function planUp(_args, profile) {
+    const files = composeFiles(profile);
+    const apps = Object.keys(profile.apps);
+    const output = [`[serve dev up] bringing up: ${apps.join(", ") || "(no apps configured)"}`];
+    if (files.length === 0) {
+        output.push("  (no compose_files / compose_overlay set; declare one in serve.yaml)");
+        return { exitCode: 64, output };
+    }
+    const fileFlags = files.map((f) => `-f ${f}`).join(" ");
+    const buildFlag = shouldBuildOnUp(profile) ? " --build" : "";
+    const commands = [
+        { cmd: `docker compose ${fileFlags} up -d${buildFlag}`, remote: true, label: "bring up" },
+    ];
+    if (profile.seed_script) {
+        commands.push({ cmd: `pnpm exec ts-node ${profile.seed_script}`, remote: true, label: "seed" });
+    }
+    return { exitCode: 0, output, commands };
+}
+function planSync(args, profile) {
+    const sourceBranch = profile.source_branch;
+    let localBranch = args.branch;
+    if (!localBranch && !args.dryRun) {
+        try {
+            localBranch = execSync("git rev-parse --abbrev-ref HEAD", { cwd: args.repoRoot, encoding: "utf8" }).trim();
+        }
+        catch {
+            // handled below
+        }
+    }
+    else if (!localBranch && args.dryRun) {
+        localBranch = "<current-branch>";
+    }
+    if (!localBranch || localBranch === "HEAD") {
+        return {
+            exitCode: 64,
+            output: ["[serve dev sync] couldn't resolve a local branch (detached HEAD?). Pass --branch <name>."],
+        };
+    }
+    const output = [
+        `[serve dev sync] ${localBranch} → origin/${sourceBranch}${args.story ? ` (story-${args.story})` : ""}`,
+    ];
+    const commands = [
+        { cmd: `git push --force origin ${localBranch}:${sourceBranch}`, remote: false, label: "git push" },
+    ];
+    return { exitCode: 0, output, commands };
+}
+function planDown(args, profile) {
+    const files = composeFiles(profile);
+    if (files.length === 0) {
+        return { exitCode: 64, output: ["[serve dev down] no compose_files / compose_overlay set; nothing to stop."] };
+    }
+    const fileFlags = files.map((f) => `-f ${f}`).join(" ");
+    const cmd = args.prune
+        ? `docker compose ${fileFlags} down -v`
+        : `docker compose ${fileFlags} down`;
+    return {
+        exitCode: 0,
+        output: ["[serve dev down]"],
+        commands: [{ cmd, remote: true, label: "compose down" }],
+    };
+}
+function planLogs(args, profile) {
+    const files = composeFiles(profile);
+    if (files.length === 0) {
+        return { exitCode: 64, output: ["[serve dev logs] no compose_files / compose_overlay set; nothing to tail."] };
+    }
+    const fileFlags = files.map((f) => `-f ${f}`).join(" ");
+    const follow = args.follow ? "-f" : "";
+    const service = args.service ?? "";
+    const cmd = `docker compose ${fileFlags} logs ${follow} ${service}`.replace(/\s+/g, " ").trim();
+    return {
+        exitCode: 0,
+        output: ["[serve dev logs]"],
+        commands: [{ cmd, remote: true, label: "compose logs" }],
+    };
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/serve/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../src/commands/serve/dev.ts"],"names":[],"mappings":"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"}

package/dist/commands/serve/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `slowcook serve <profile> <verb>` — multi-mode dev/mock/staging.
+ *
+ * See `docs/plans/0.20-design-discussions.md` design #5.
+ *
+ * Phase 1 (this cut): `serve dev` is implemented end-to-end. `serve
+ * mock` and `serve staging` parse config + print a "Phase 2/3 stub"
+ * notice; the runtime implementation lands in tasks #20 / #21.
+ *
+ * Backward-compat: `slowcook dev-env <verb>` continues to work as an
+ * alias for `slowcook serve dev <verb>` (wired in cli.ts).
+ */
+export interface ServeArgs {
+    profile?: string;
+    verb?: string;
+    branch?: string;
+    story?: string;
+    service?: string;
+    scenario?: string;
+    follow?: boolean;
+    prune?: boolean;
+    repoRoot: string;
+    dryRun?: boolean;
+}
+export declare function parseServeArgs(argv: string[]): ServeArgs;
+export declare function printHelp(): void;
+export declare function serve(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/serve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/serve/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAwBxD;AAED,wBAAgB,SAAS,IAAI,IAAI,CAkChC;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEzD"}

package/dist/commands/serve/index.js

@@ -0,0 +1,224 @@
+/**
+ * `slowcook serve <profile> <verb>` — multi-mode dev/mock/staging.
+ *
+ * See `docs/plans/0.20-design-discussions.md` design #5.
+ *
+ * Phase 1 (this cut): `serve dev` is implemented end-to-end. `serve
+ * mock` and `serve staging` parse config + print a "Phase 2/3 stub"
+ * notice; the runtime implementation lands in tasks #20 / #21.
+ *
+ * Backward-compat: `slowcook dev-env <verb>` continues to work as an
+ * alias for `slowcook serve dev <verb>` (wired in cli.ts).
+ */
+import { loadServeConfig, getProfile } from "./config.js";
+import { planServeDev } from "./dev.js";
+import { planServeMock } from "./mock.js";
+import { detectMockRunnable } from "./detect.js";
+import { planServeStaging } from "./staging.js";
+import { runCommands } from "./runner.js";
+export function parseServeArgs(argv) {
+    const args = { repoRoot: process.cwd() };
+    // First two positionals (if present + not flags) are profile + verb.
+    let positionalIdx = 0;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a)
+            continue;
+        if (a.startsWith("-")) {
+            const next = argv[i + 1];
+            if (a === "--branch" && next) {
+                args.branch = next;
+                i++;
+            }
+            else if (a === "--story" && next) {
+                args.story = next;
+                i++;
+            }
+            else if (a === "--service" && next) {
+                args.service = next;
+                i++;
+            }
+            else if (a === "--scenario" && next) {
+                args.scenario = next;
+                i++;
+            }
+            else if (a === "--cwd" && next) {
+                args.repoRoot = next;
+                i++;
+            }
+            else if (a === "--follow" || a === "-f") {
+                args.follow = true;
+            }
+            else if (a === "--prune") {
+                args.prune = true;
+            }
+            else if (a === "--dry-run") {
+                args.dryRun = true;
+            }
+            else if (a === "--help" || a === "-h") {
+                args.verb = "--help";
+            }
+            continue;
+        }
+        if (positionalIdx === 0) {
+            args.profile = a;
+            positionalIdx++;
+        }
+        else if (positionalIdx === 1) {
+            args.verb = a;
+            positionalIdx++;
+        }
+    }
+    return args;
+}
+export function printHelp() {
+    console.log(`
+slowcook serve — multi-mode dev / mock / staging on a shared box
+
+Usage:
+  slowcook serve <profile> <verb> [options]
+
+Profiles:
+  dev      Bind-mount source for fast UI iteration.
+  mock     Vite-dev mock app for vibe-feedback loops (auto-skip if mock/ lacks scripts.dev).
+  staging  Built-image staging + named-scenario seed reset for PM walkthroughs.
+
+Verbs:
+  up                            Bring up the profile (compose overlay or consumer's bringup_cmd).
+  sync [--branch X]             Force-push branch X (or current HEAD) to the profile's source_branch.
+  down [--prune]                Stop the profile's services. --prune also drops volumes.
+  logs [--service] [--follow]   Tail logs (optionally one service).
+  reset [--scenario <name>]     Re-run a staging scenario's seed scripts (no-op for dev/mock).
+
+Backward-compat:
+  slowcook dev-env push  ≡  slowcook serve dev sync
+  slowcook dev-env up    ≡  slowcook serve dev up
+  slowcook dev-env reset ≡  slowcook serve dev reset
+
+Config:
+  .brewing/serve.yaml (new, optional) OR .brewing/dev-env.yaml (legacy).
+  See \`docs/plans/0.20-design-discussions.md\` design #5 for the schema.
+
+Examples:
+  slowcook serve dev up
+  slowcook serve dev sync --story 042
+  slowcook serve dev logs --service patient --follow
+  slowcook serve dev down --prune
+`);
+}
+export async function serve(argv) {
+    const args = parseServeArgs(argv);
+    if (args.verb === "--help" || (!args.profile && !args.verb)) {
+        printHelp();
+        return;
+    }
+    if (!args.profile) {
+        console.error("slowcook serve: missing <profile>. Try `slowcook serve --help`.");
+        process.exit(64);
+    }
+    if (!args.verb) {
+        console.error(`slowcook serve ${args.profile}: missing <verb>. Try \`slowcook serve --help\`.`);
+        process.exit(64);
+    }
+    let config;
+    try {
+        config = loadServeConfig(args.repoRoot);
+    }
+    catch (e) {
+        console.error(`slowcook serve: ${e.message}`);
+        process.exit(64);
+    }
+    const profile = getProfile(config, args.profile);
+    if (!profile) {
+        const available = Object.keys(config.profiles).join(", ") || "(none)";
+        console.error(`slowcook serve: profile "${args.profile}" not found in config. Available: ${available}.`);
+        process.exit(64);
+    }
+    let planResult;
+    switch (args.profile) {
+        case "dev":
+            planResult = runDevVerb(args, config, profile);
+            break;
+        case "mock": {
+            // Trade-off #4: auto-skip if mock/ isn't vite-runnable.
+            const detect = detectMockRunnable(args.repoRoot);
+            if (!detect.hasDevScript) {
+                console.log(`[serve mock] skipped — ${detect.reason}`);
+                return;
+            }
+            planResult = runMockVerb(args, config, profile);
+            break;
+        }
+        case "staging":
+            planResult = runStagingVerb(args, config, profile);
+            break;
+        default:
+            console.error(`slowcook serve: profile "${args.profile}" has no runtime in this release.`);
+            process.exit(64);
+    }
+    for (const line of planResult.output)
+        console.log(line);
+    if (planResult.exitCode !== 0)
+        process.exit(planResult.exitCode);
+    // sc#173 #1: actually execute the plan. Wraps `remote: true` commands
+    // in `ssh user@host 'cd <checkout_dir> && <cmd>'` when ssh_target is
+    // set; runs locally otherwise. --dry-run prints the wrapped form
+    // without executing.
+    if (planResult.commands && planResult.commands.length > 0) {
+        const runResult = runCommands({
+            commands: planResult.commands,
+            profile,
+            repoRoot: args.repoRoot,
+            dryRun: args.dryRun,
+        });
+        for (const line of runResult.output)
+            console.log(line);
+        if (runResult.exitCode !== 0)
+            process.exit(runResult.exitCode);
+    }
+}
+function runDevVerb(args, config, profile) {
+    if (!profile)
+        throw new Error("unreachable");
+    const devArgs = {
+        verb: args.verb,
+        branch: args.branch,
+        story: args.story,
+        service: args.service,
+        follow: args.follow,
+        prune: args.prune,
+        repoRoot: args.repoRoot,
+        dryRun: args.dryRun,
+    };
+    return planServeDev(devArgs, config, profile);
+}
+function runMockVerb(args, config, profile) {
+    if (!profile)
+        throw new Error("unreachable");
+    const mockArgs = {
+        verb: args.verb,
+        branch: args.branch,
+        service: args.service,
+        follow: args.follow,
+        prune: args.prune,
+        repoRoot: args.repoRoot,
+        dryRun: args.dryRun,
+    };
+    return planServeMock(mockArgs, config, profile);
+}
+function runStagingVerb(args, config, profile) {
+    if (!profile)
+        throw new Error("unreachable");
+    const stagingArgs = {
+        verb: args.verb,
+        branch: args.branch,
+        scenario: args.scenario,
+        service: args.service,
+        follow: args.follow,
+        prune: args.prune,
+        repoRoot: args.repoRoot,
+        dryRun: args.dryRun,
+    };
+    return planServeStaging(stagingArgs, config, profile);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/serve/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/serve/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAwC,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAqB,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAe1C,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,IAAI,GAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;IACpD,qEAAqE;IACrE,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,UAAU,IAAI,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;iBACrD,IAAI,CAAC,KAAK,SAAS,IAAI,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;iBACxD,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;iBAC5D,IAAI,CAAC,KAAK,YAAY,IAAI,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;iBAC9D,IAAI,CAAC,KAAK,OAAO,IAAI,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;iBACzD,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YAAC,CAAC;iBAC3D,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAAC,CAAC;iBAC3C,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;gBAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YAAC,CAAC;iBAC9C,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;YAAC,CAAC;YAChE,SAAS;QACX,CAAC;QACD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YAAC,aAAa,EAAE,CAAC;QAAC,CAAC;aAC1D,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAAC,aAAa,EAAE,CAAC;QAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACxC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,SAAS,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,OAAO,kDAAkD,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,mBAAoB,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QACtE,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,OAAO,qCAAqC,SAAS,GAAG,CAAC,CAAC;QACzG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,UAAyB,CAAC;IAC9B,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,KAAK;YACR,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,wDAAwD;YACxD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM;QACR,CAAC;QACD,KAAK,SAAS;YACZ,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,OAAO,mCAAmC,CAAC,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEjE,sEAAsE;IACtE,qEAAqE;IACrE,iEAAiE;IACjE,qBAAqB;IACrB,IAAI,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,WAAW,CAAC;YAC5B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAe,EAAE,MAAmB,EAAE,OAAsC;IAC9F,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAgB;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAK;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,IAAe,EAAE,MAAmB,EAAE,OAAsC;IAC/F,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAiB;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAK;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,OAAO,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,IAAe,EAAE,MAAmB,EAAE,OAAsC;IAClG,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAoB;QACnC,IAAI,EAAE,IAAI,CAAC,IAAK;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,OAAO,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/commands/serve/mock.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `slowcook serve mock <verb>` — Phase 2 implementation.
+ *
+ * The mock profile runs the consumer's `mock/` package as a vite-dev
+ * server on a shared box. See `dev.ts` header for the broader pattern.
+ *
+ * 0.19.7 (sc#173): same refactor as dev.ts — emit ShellCommand[] so
+ * runCommands() can actually execute (including ssh-wrapping for the
+ * remote case); support `compose_files` multi-`-f`; suppress `--build`
+ * for `bind-mount-source`.
+ */
+import type { ProfileConfig, ServeConfig } from "./config.js";
+import type { DevVerbResult } from "./dev.js";
+export interface MockVerbArgs {
+    verb: string;
+    branch?: string;
+    service?: string;
+    follow?: boolean;
+    prune?: boolean;
+    repoRoot: string;
+    dryRun?: boolean;
+}
+export declare function planServeMock(args: MockVerbArgs, _config: ServeConfig, profile: ProfileConfig): DevVerbResult;
+//# sourceMappingURL=mock.d.ts.map

package/dist/commands/serve/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/commands/serve/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,aAAa,GACrB,aAAa,CAkBf"}

package/dist/commands/serve/mock.js

@@ -0,0 +1,111 @@
+/**
+ * `slowcook serve mock <verb>` — Phase 2 implementation.
+ *
+ * The mock profile runs the consumer's `mock/` package as a vite-dev
+ * server on a shared box. See `dev.ts` header for the broader pattern.
+ *
+ * 0.19.7 (sc#173): same refactor as dev.ts — emit ShellCommand[] so
+ * runCommands() can actually execute (including ssh-wrapping for the
+ * remote case); support `compose_files` multi-`-f`; suppress `--build`
+ * for `bind-mount-source`.
+ */
+import { execSync } from "node:child_process";
+import { composeFiles, shouldBuildOnUp } from "./config.js";
+export function planServeMock(args, _config, profile) {
+    switch (args.verb) {
+        case "up":
+            return planUp(args, profile);
+        case "sync":
+            return planSync(args, profile);
+        case "down":
+            return planDown(args, profile);
+        case "logs":
+            return planLogs(args, profile);
+        case "reset":
+            return {
+                exitCode: 0,
+                output: ["[serve mock reset] mock profile has no scenario seed; nothing to reset (only meaningful for staging)."],
+            };
+        default:
+            return { exitCode: 64, output: [`Unknown verb: ${args.verb}. See \`slowcook serve --help\`.`] };
+    }
+}
+function planUp(_args, profile) {
+    const files = composeFiles(profile);
+    const apps = Object.keys(profile.apps);
+    const output = [`[serve mock up] bringing up: ${apps.join(", ") || "(no apps configured)"}`];
+    if (files.length === 0) {
+        // Fallback: no compose, run `pnpm --filter ./mock dev` locally. Used on
+        // a dev's laptop without a docker box.
+        output.push("  (no compose_files / compose_overlay set; falling back to local pnpm filter)");
+        return {
+            exitCode: 0,
+            output,
+            commands: [{ cmd: "pnpm --filter ./mock dev", remote: false, label: "vite dev" }],
+        };
+    }
+    // PM + designer reference URL: surface the vite port if exactly one app.
+    if (apps.length === 1) {
+        const vitePort = profile.apps[apps[0]].port;
+        output.push(`  vite dev URL (once up): http://<your-box>:${vitePort}`);
+    }
+    const fileFlags = files.map((f) => `-f ${f}`).join(" ");
+    const buildFlag = shouldBuildOnUp(profile) ? " --build" : "";
+    return {
+        exitCode: 0,
+        output,
+        commands: [{ cmd: `docker compose ${fileFlags} up -d${buildFlag}`, remote: true, label: "bring up" }],
+    };
+}
+function planSync(args, profile) {
+    const sourceBranch = profile.source_branch;
+    let localBranch = args.branch;
+    if (!localBranch && !args.dryRun) {
+        try {
+            localBranch = execSync("git rev-parse --abbrev-ref HEAD", {
+                cwd: args.repoRoot,
+                encoding: "utf8",
+            }).trim();
+        }
+        catch {
+            // handled below
+        }
+    }
+    else if (!localBranch && args.dryRun) {
+        localBranch = "<current-branch>";
+    }
+    if (!localBranch || localBranch === "HEAD") {
+        return {
+            exitCode: 64,
+            output: ["[serve mock sync] couldn't resolve a local branch (detached HEAD?). Pass --branch <name>."],
+        };
+    }
+    return {
+        exitCode: 0,
+        output: [`[serve mock sync] ${localBranch} → origin/${sourceBranch}`],
+        commands: [{ cmd: `git push --force origin ${localBranch}:${sourceBranch}`, remote: false, label: "git push" }],
+    };
+}
+function planDown(args, profile) {
+    const files = composeFiles(profile);
+    if (files.length === 0) {
+        return { exitCode: 64, output: ["[serve mock down] no compose_files / compose_overlay set; nothing to stop."] };
+    }
+    const fileFlags = files.map((f) => `-f ${f}`).join(" ");
+    const cmd = args.prune
+        ? `docker compose ${fileFlags} down -v`
+        : `docker compose ${fileFlags} down`;
+    return { exitCode: 0, output: ["[serve mock down]"], commands: [{ cmd, remote: true, label: "compose down" }] };
+}
+function planLogs(args, profile) {
+    const files = composeFiles(profile);
+    if (files.length === 0) {
+        return { exitCode: 64, output: ["[serve mock logs] no compose_files / compose_overlay set; nothing to tail."] };
+    }
+    const fileFlags = files.map((f) => `-f ${f}`).join(" ");
+    const follow = args.follow ? "-f" : "";
+    const service = args.service ?? "";
+    const cmd = `docker compose ${fileFlags} logs ${follow} ${service}`.replace(/\s+/g, " ").trim();
+    return { exitCode: 0, output: ["[serve mock logs]"], commands: [{ cmd, remote: true, label: "compose logs" }] };
+}
+//# sourceMappingURL=mock.js.map

package/dist/commands/serve/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../../src/commands/serve/mock.ts"],"names":[],"mappings":"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"}

package/dist/commands/serve/runner.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shell-command execution layer for `slowcook serve`.
+ *
+ * Closes sc#173 finding #1: prior to this, planners emitted command
+ * strings into `output[]` and exited without executing them, even when
+ * `profile.ssh_target` was set. Operators had to copy-paste the emitted
+ * command and run it themselves — the verb was documentation, not
+ * automation.
+ *
+ * Now planners populate `result.commands[]` with structured ShellCommand
+ * records; `runCommands()` wraps `remote: true` commands in
+ * `ssh user@host 'cd checkout_dir && <cmd>'` and executes (unless
+ * --dry-run, in which case the wrapped form is just printed).
+ *
+ * Local commands run via execSync in the repoRoot. Remote commands run
+ * via execSync of an ssh invocation. Either way: stdio inherited so the
+ * operator sees docker / git output in real time.
+ */
+import type { ProfileConfig } from "./config.js";
+export interface ShellCommand {
+    /** The local-shell-shape command (e.g. `docker compose -f a.yml up -d`). */
+    cmd: string;
+    /**
+     * When true AND `profile.ssh_target` is set, wrap the command in
+     * `ssh <user>@<host> 'cd <checkout_dir> && <cmd>'`. When `ssh_target`
+     * is absent, runs locally regardless. Use for docker / box-side
+     * operations (up, down, logs). Local-only operations like `git push`
+     * should pass `remote: false`.
+     */
+    remote?: boolean;
+    /** Optional label printed before the command (e.g. "bring up", "seed"). */
+    label?: string;
+}
+export interface RunCommandsArgs {
+    commands: ShellCommand[];
+    profile: ProfileConfig;
+    repoRoot: string;
+    /** When true: print the resolved command but don't execute. */
+    dryRun?: boolean;
+}
+export interface RunCommandsResult {
+    exitCode: number;
+    /** Additional human-readable lines emitted by the runner (resolved cmds, errors). */
+    output: string[];
+}
+/**
+ * Resolve a single ShellCommand into the wire-form string we'd actually
+ * pass to /bin/sh. Pure; useful for tests + the dry-run print path.
+ */
+export declare function resolveCommand(cmd: ShellCommand, profile: ProfileConfig): string;
+export declare function runCommands(args: RunCommandsArgs): RunCommandsResult;
+//# sourceMappingURL=runner.d.ts.map

package/dist/commands/serve/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/commands/serve/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAShF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAepE"}