@slowcook-ai/cli 0.19.5 → 0.19.6

package/dist/commands/serve/config.js

@@ -0,0 +1,174 @@
+/**
+ * `.brewing/dev-env.yaml` (legacy) and `.brewing/serve.yaml` (new) —
+ * profile-aware config for `slowcook serve <profile> <verb>`.
+ *
+ * Trade-off resolution from `docs/plans/0.20-design-discussions.md`
+ * design #5: KEEP the `dev-env.yaml` filename forever. The schema
+ * grows a `profiles:` map for multi-profile use; legacy flat shape
+ * (no `profiles:` key) is wrapped as `profiles.dev = {...flat}` on
+ * load. Migration cost for existing consumers: zero.
+ *
+ * Phase 1 (this cut): only the `dev` profile is consumed by
+ * `slowcook serve dev up|sync|down|logs`. `mock` and `staging`
+ * profiles parse into the same shape but are stubs until Phase 2 + 3.
+ */
+import { z } from "zod";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+export const DEV_ENV_CONFIG_PATH = ".brewing/dev-env.yaml";
+export const SERVE_CONFIG_PATH = ".brewing/serve.yaml";
+const AppModeSchema = z.enum([
+    "dev", // Next dev (hot reload) — for apps under active story development
+    "start", // next build + next start — production-shaped, slower restart
+    "nest-watch", // ts-node-dev / nest start --watch — backend hot reload
+    "nest-prod", // nest start (built) — built-image staging
+    "next-dev", // explicit alias for "dev" used by the design doc
+    "next-start", // explicit alias for "start"
+    "vite-dev", // vite dev (mock profile)
+    "static", // serve a built static export, never re-run
+    "none", // entry exists but isn't started by `serve` (e.g. cron)
+]);
+const AppSchema = z.object({
+    mode: AppModeSchema,
+    port: z.number().int().positive(),
+    /** Restart on crash. Defaults to true. */
+    autoheal: z.boolean().optional().default(true),
+    /** Optional: explicit container/process name override (otherwise the key). */
+    container: z.string().optional(),
+});
+const PersistenceSchema = z.object({
+    /**
+     * Named docker volume that survives `serve <profile> reset`. PM-added
+     * DB rows persist across redeploys; only the seed-owned rows are
+     * touched by reset (only meaningful for the `staging` profile).
+     */
+    db_volume: z.string().optional(),
+    uploads_volume: z.string().optional(),
+});
+const SshTargetSchema = z.object({
+    host: z.string(),
+    user: z.string(),
+    /** Absolute path on the box where the consumer's checkout lives. */
+    checkout_dir: z.string(),
+    /** Repo-secret name holding the SSH private key. */
+    key_secret: z.string().default("DEV_DEPLOY_SSH_KEY"),
+});
+/**
+ * Staging-only: named seed scenarios (Trade-off #5 — map shape from day 1).
+ *
+ *   seed:
+ *     scenarios:
+ *       demo:
+ *         scripts: ["packages/seeds/demo/*.ts"]
+ *       enterprise:
+ *         scripts: ["packages/seeds/enterprise/*.ts"]
+ *     guard_env: STAGING_RESET_ALLOWED
+ */
+const SeedScenarioSchema = z.object({
+    scripts: z.array(z.string()).default([]),
+});
+const SeedSchema = z.object({
+    scenarios: z.record(z.string(), SeedScenarioSchema).default({}),
+    guard_env: z.string().optional(),
+});
+/** Profile mode controls how `serve <profile> sync` ships code to the box. */
+const ProfileModeSchema = z.enum([
+    "bind-mount-source", // rsync source + anonymous-volume node_modules (dev, mock)
+    "built-image", // consumer's bring-up script runs an image pull (staging)
+]);
+export const ProfileConfigSchema = z.object({
+    /** How sync delivers code to the runtime. Defaults to `bind-mount-source`. */
+    mode: ProfileModeSchema.optional().default("bind-mount-source"),
+    /** Git branch the profile tracks. Default: `dev`. */
+    source_branch: z.string().default("dev"),
+    /** Optional compose-overlay path (consumer-supplied; slowcook calls it via docker compose). */
+    compose_overlay: z.string().optional(),
+    /**
+     * Built-image profiles call into the consumer's bring-up script
+     * (Trade-off #3 — slowcook ships zero image-build pipeline).
+     * If unset, slowcook falls back to `docker compose -f compose_overlay up -d`.
+     */
+    bringup_cmd: z.string().optional(),
+    apps: z.record(z.string(), AppSchema).default({}),
+    persistence: PersistenceSchema.optional().default({}),
+    /** Optional: SSH target the profile uses. If absent, profile runs locally. */
+    ssh_target: SshTargetSchema.optional(),
+    /** Single-script legacy seed (dev/mock profiles); staging uses `seed.scenarios`. */
+    seed_script: z.string().optional(),
+    /** Staging-only seed scenarios map. */
+    seed: SeedSchema.optional(),
+});
+/**
+ * Normalised shape after loading EITHER `.brewing/serve.yaml`
+ * (explicit `profiles:` key) OR `.brewing/dev-env.yaml` (legacy flat
+ * shape — wrapped as `{profiles: {dev: {...flat}}}`).
+ */
+export const ServeConfigSchema = z.object({
+    $schema: z.string().optional(),
+    schema_version: z.literal(1),
+    profiles: z.record(z.string(), ProfileConfigSchema),
+});
+/**
+ * Loader: prefer `.brewing/serve.yaml` if present, else fall back to
+ * `.brewing/dev-env.yaml`. Legacy flat shapes get wrapped to the
+ * `{profiles: {dev: {...flat}}}` form. Returns the normalised
+ * `ServeConfig`.
+ */
+export function loadServeConfig(repoRoot) {
+    const servePath = join(repoRoot, SERVE_CONFIG_PATH);
+    const devEnvPath = join(repoRoot, DEV_ENV_CONFIG_PATH);
+    const chosen = existsSync(servePath) ? servePath : existsSync(devEnvPath) ? devEnvPath : null;
+    if (!chosen) {
+        throw new Error(`Neither ${SERVE_CONFIG_PATH} nor ${DEV_ENV_CONFIG_PATH} found. Run \`slowcook serve init\` to scaffold (Phase 1 — coming soon) or hand-author either path.`);
+    }
+    let raw;
+    try {
+        raw = YAML.parse(readFileSync(chosen, "utf8"));
+    }
+    catch (e) {
+        throw new Error(`${chosen} is not valid YAML: ${e.message}`);
+    }
+    return normaliseConfig(raw, chosen);
+}
+/**
+ * Detect legacy vs new shape + normalise. Exported for tests + the
+ * legacy `slowcook dev-env` callers that want the same loader.
+ */
+export function normaliseConfig(raw, source) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new Error(`${source}: expected a YAML object at the top level.`);
+    }
+    const obj = raw;
+    // New shape: explicit `profiles:` key.
+    if (obj["profiles"] && typeof obj["profiles"] === "object") {
+        const parsed = ServeConfigSchema.safeParse(obj);
+        if (!parsed.success) {
+            throw new Error(formatZodError(source, parsed.error));
+        }
+        return parsed.data;
+    }
+    // Legacy shape: flat top-level → wrap as `profiles.dev`.
+    const { schema_version, $schema, ...flat } = obj;
+    const wrapped = {
+        $schema,
+        schema_version,
+        profiles: { dev: flat },
+    };
+    const parsed = ServeConfigSchema.safeParse(wrapped);
+    if (!parsed.success) {
+        throw new Error(formatZodError(source, parsed.error));
+    }
+    return parsed.data;
+}
+function formatZodError(source, err) {
+    const issues = err.issues
+        .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+        .join("; ");
+    return `${source} failed validation: ${issues}`;
+}
+/** Convenience: lookup a profile by name (case-sensitive). */
+export function getProfile(config, name) {
+    return config.profiles[name];
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/serve/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEvD,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,KAAK,EAAU,kEAAkE;IACjF,OAAO,EAAQ,8DAA8D;IAC7E,YAAY,EAAG,wDAAwD;IACvE,WAAW,EAAI,2CAA2C;IAC1D,UAAU,EAAK,kDAAkD;IACjE,YAAY,EAAG,6BAA6B;IAC5C,UAAU,EAAK,0BAA0B;IACzC,QAAQ,EAAO,4CAA4C;IAC3D,MAAM,EAAS,wDAAwD;CACxE,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9C,8EAA8E;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,oEAAoE;IACpE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,oDAAoD;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC;CACrD,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AACH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/B,mBAAmB,EAAE,2DAA2D;IAChF,aAAa,EAAQ,0DAA0D;CAChF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,8EAA8E;IAC9E,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IAC/D,qDAAqD;IACrD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,+FAA+F;IAC/F,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC;;;;OAIG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjD,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,8EAA8E;IAC9E,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE;IACtC,oFAAoF;IACpF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,uCAAuC;IACvC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAKH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC;CACpD,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,WAAW,iBAAiB,QAAQ,mBAAmB,qGAAqG,CAC7J,CAAC;IACJ,CAAC;IACD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,uBAAwB,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,MAAc;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,4CAA4C,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,uCAAuC;IACvC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,yDAAyD;IACzD,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;IACjD,MAAM,OAAO,GAAG;QACd,OAAO;QACP,cAAc;QACd,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;KACxB,CAAC;IACF,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,GAAe;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,GAAG,MAAM,uBAAuB,MAAM,EAAE,CAAC;AAClD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,IAAY;IAC1D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Profile auto-detection — Trade-off #4 resolution.
+ *
+ * `serve mock` is only meaningful if the consumer's `mock/` package is
+ * vite-runnable (has `scripts.dev`). If it isn't, slowcook prints a
+ * notice + exits 0 instead of trying to bring up an unrunnable profile.
+ *
+ * Exported as a pure function so the index.ts dispatcher + future
+ * `slowcook serve mock init` scaffolding can reuse the same check.
+ */
+export interface MockRunnableResult {
+    /** Whether `mock/` exists at all. */
+    exists: boolean;
+    /** Whether `mock/package.json` declares `scripts.dev`. */
+    hasDevScript: boolean;
+    /** The dev script's command, when present. */
+    devScript?: string;
+    /** When `false`, a one-line reason suitable for `console.log`. */
+    reason?: string;
+}
+/**
+ * Inspect `<repoRoot>/mock/package.json` and report whether the
+ * consumer has a vite-runnable mock app.
+ *
+ * Why this check: many slowcook consumers have a `mock/` directory
+ * that's only used as a vibe-time artefact (no runtime). For those
+ * consumers, `serve mock up` would fail trying to docker-compose a
+ * non-existent vite-dev process. Skip cleanly instead.
+ */
+export declare function detectMockRunnable(repoRoot: string): MockRunnableResult;
+//# sourceMappingURL=detect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/commands/serve/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAiCvE"}

package/dist/commands/serve/detect.js

@@ -0,0 +1,56 @@
+/**
+ * Profile auto-detection — Trade-off #4 resolution.
+ *
+ * `serve mock` is only meaningful if the consumer's `mock/` package is
+ * vite-runnable (has `scripts.dev`). If it isn't, slowcook prints a
+ * notice + exits 0 instead of trying to bring up an unrunnable profile.
+ *
+ * Exported as a pure function so the index.ts dispatcher + future
+ * `slowcook serve mock init` scaffolding can reuse the same check.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Inspect `<repoRoot>/mock/package.json` and report whether the
+ * consumer has a vite-runnable mock app.
+ *
+ * Why this check: many slowcook consumers have a `mock/` directory
+ * that's only used as a vibe-time artefact (no runtime). For those
+ * consumers, `serve mock up` would fail trying to docker-compose a
+ * non-existent vite-dev process. Skip cleanly instead.
+ */
+export function detectMockRunnable(repoRoot) {
+    const pkgPath = join(repoRoot, "mock", "package.json");
+    if (!existsSync(pkgPath)) {
+        return {
+            exists: false,
+            hasDevScript: false,
+            reason: "mock/ directory absent — `serve mock` requires a runnable mock app.",
+        };
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    }
+    catch (e) {
+        return {
+            exists: true,
+            hasDevScript: false,
+            reason: `mock/package.json is not valid JSON: ${e.message}`,
+        };
+    }
+    const devScript = pkg.scripts?.dev;
+    if (!devScript) {
+        return {
+            exists: true,
+            hasDevScript: false,
+            reason: "mock/package.json has no `scripts.dev` — declare one (e.g. `vite`) to enable the `serve mock` profile.",
+        };
+    }
+    return {
+        exists: true,
+        hasDevScript: true,
+        devScript,
+    };
+}
+//# sourceMappingURL=detect.js.map

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,51 @@
+/**
+ * `slowcook serve dev <verb>` — Phase 1 implementation.
+ *
+ * Verbs (Phase 1):
+ *   - up      — bring up the dev profile (compose overlay or fallback)
+ *   - sync    — rsync source to the box + restart the 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)
+ *
+ * `bind-mount-source` mode (the DECIDED choice for dev profile) uses
+ * rsync to push source + an anonymous-volume node_modules in the
+ * compose overlay. Avoids node_modules collision on macOS + chmod
+ * surprises. See `docs/plans/0.20-design-discussions.md` design #5
+ * "Additional decisions" for the rationale.
+ */
+import type { ProfileConfig, ServeConfig } from "./config.js";
+export interface DevVerbArgs {
+    verb: string;
+    /** Branch to push (sync verb). Resolved from HEAD if undefined. */
+    branch?: string;
+    /** Story id, included in the push log line for audit. */
+    story?: string;
+    /** Filter logs to one app (logs verb). */
+    service?: string;
+    /** Follow logs (logs verb). */
+    follow?: boolean;
+    /** Drop volumes too (down verb). */
+    prune?: boolean;
+    repoRoot: string;
+    /** Test seam: skip actual git/docker calls; emit a plan only. */
+    dryRun?: boolean;
+}
+export interface DevVerbResult {
+    exitCode: number;
+    /** Lines emitted to stdout / "what would have run" under dryRun. */
+    output: string[];
+}
+/**
+ * Pure dispatcher for the dev profile. Returns a DevVerbResult so the
+ * caller (cli) can render output + set the exit code. Splitting the
+ * pure planner from the IO wrapper lets the tests assert on the plan
+ * without spawning docker.
+ */
+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;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,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,126 @@
+/**
+ * `slowcook serve dev <verb>` — Phase 1 implementation.
+ *
+ * Verbs (Phase 1):
+ *   - up      — bring up the dev profile (compose overlay or fallback)
+ *   - sync    — rsync source to the box + restart the 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)
+ *
+ * `bind-mount-source` mode (the DECIDED choice for dev profile) uses
+ * rsync to push source + an anonymous-volume node_modules in the
+ * compose overlay. Avoids node_modules collision on macOS + chmod
+ * surprises. See `docs/plans/0.20-design-discussions.md` design #5
+ * "Additional decisions" for the rationale.
+ */
+import { execSync } from "node:child_process";
+/**
+ * Pure dispatcher for the dev profile. Returns a DevVerbResult so the
+ * caller (cli) can render output + set the exit code. Splitting the
+ * pure planner from the IO wrapper lets the tests assert on the plan
+ * without spawning docker.
+ */
+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 overlay = profile.compose_overlay;
+    const apps = Object.keys(profile.apps);
+    const lines = [`[serve dev up] bringing up: ${apps.join(", ") || "(no apps configured)"}`];
+    if (overlay) {
+        lines.push(`  cmd: docker compose -f ${overlay} up -d --build`);
+    }
+    else {
+        lines.push("  (no compose_overlay set; consumer must wire its own up command)");
+    }
+    if (profile.seed_script) {
+        lines.push(`  seed: pnpm exec ts-node ${profile.seed_script}`);
+    }
+    return { exitCode: 0, output: lines };
+}
+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 {
+            // fall through; 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 lines = [
+        `[serve dev sync] ${localBranch} → origin/${sourceBranch}${args.story ? ` (story-${args.story})` : ""}`,
+    ];
+    if (args.dryRun) {
+        lines.push(`  would run: git push --force origin ${localBranch}:${sourceBranch}`);
+        return { exitCode: 0, output: lines };
+    }
+    try {
+        execSync(`git push --force origin ${localBranch}:${sourceBranch}`, { cwd: args.repoRoot, stdio: "inherit" });
+    }
+    catch {
+        return {
+            exitCode: 1,
+            output: [...lines, `[serve dev sync] git push failed. Check push permissions on origin/${sourceBranch}.`],
+        };
+    }
+    lines.push(`[serve dev sync] done. The dev-deploy workflow on origin/${sourceBranch} will fire next.`);
+    return { exitCode: 0, output: lines };
+}
+function planDown(args, profile) {
+    const overlay = profile.compose_overlay;
+    const lines = ["[serve dev down]"];
+    if (!overlay) {
+        return { exitCode: 64, output: ["[serve dev down] no compose_overlay set; nothing to stop."] };
+    }
+    const cmd = args.prune
+        ? `docker compose -f ${overlay} down -v`
+        : `docker compose -f ${overlay} down`;
+    lines.push(`  cmd: ${cmd}`);
+    return { exitCode: 0, output: lines };
+}
+function planLogs(args, profile) {
+    const overlay = profile.compose_overlay;
+    if (!overlay) {
+        return { exitCode: 64, output: ["[serve dev logs] no compose_overlay set; nothing to tail."] };
+    }
+    const follow = args.follow ? "-f" : "";
+    const service = args.service ?? "";
+    return {
+        exitCode: 0,
+        output: [`  cmd: docker compose -f ${overlay} logs ${follow} ${service}`.replace(/\s+/g, " ").trim()],
+    };
+}
+//# 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;AAQH,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,CA2DzD"}