@slowcook-ai/cli 0.19.0-alpha.18 → 0.19.0-alpha.40

package/dist/commands/budget/index.js

@@ -0,0 +1,252 @@
+/**
+ * 0.19.0-α.35 (sc#66 follow-up) — `slowcook budget` subcommand.
+ *
+ *   slowcook budget                              # show config + month-to-date spend
+ *   slowcook budget set --monthly 50             # set monthly_budget_usd
+ *   slowcook budget set --monthly 50 --start-day 15 --story 10
+ *   slowcook budget rm                           # delete config (disables gauge)
+ *
+ * Writes/reads `.brewing/budget.yaml`. Idempotent: `set` merges into
+ * existing config; absent flags keep their current values; missing
+ * monthly_budget_usd on a brand-new config defaults nothing (must be
+ * supplied at least once).
+ */
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+import { loadBudgetConfig, aggregateMonthSpend, aggregateSpendSince, currentPeriodStart, classifyBudgetStatus, } from "../../lib/budget.js";
+function parseArgs(argv) {
+    const args = { cwd: process.cwd(), action: "show" };
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--cwd" && next) {
+            args.cwd = next;
+            i++;
+        }
+        else if (arg === "--monthly" && next) {
+            args.monthly = Number(next);
+            i++;
+        }
+        else if (arg === "--start-day" && next) {
+            args.startDay = Number(next);
+            i++;
+        }
+        else if (arg === "--story" && next) {
+            args.story = Number(next);
+            i++;
+        }
+        else if (arg === "--credit" && next) {
+            args.credit = Number(next);
+            i++;
+        }
+        else if (arg === "--credit-baseline" && next) {
+            args.creditBaselineAt = next;
+            i++;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg && !arg.startsWith("--")) {
+            positional.push(arg);
+        }
+    }
+    const verb = positional[0];
+    if (verb === "set" || verb === "rm")
+        args.action = verb;
+    else if (verb && verb !== "show") {
+        throw new Error(`Unknown budget action: ${verb}. Use show | set | rm.`);
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook budget — manage the project budget(s) for the fuel gauge
+
+Two independent gauges, both optional, both opt-in:
+
+  monthly_budget_usd     A per-period cap that resets each month.
+  credit_balance_usd     A non-recurring credit deposit (e.g. you topped
+                         up $25 on Anthropic and DON'T have auto-recharge);
+                         the gauge subtracts ALL-TIME spend from this.
+
+Usage:
+  slowcook budget                                    Show current config + spend
+  slowcook budget set --monthly <usd>                Set the monthly cap
+  slowcook budget set --monthly 50 --start-day 15    Non-1st reset day
+  slowcook budget set --credit <usd>                 Track a one-shot deposit
+  slowcook budget set --story <usd>                  Optional per-story ceiling
+  slowcook budget rm                                 Delete .brewing/budget.yaml
+
+Flags:
+  --monthly <usd>      Monthly budget in USD. Resets each period.
+  --start-day <1-31>   Calendar day the monthly budget resets. Default 1.
+  --credit <usd>       One-shot credit deposit. Captures the date of set as
+                       a baseline; spend tracked from there. Re-run to top up.
+  --story <usd>        Optional per-story informational ceiling.
+  --cwd <path>         Project root. Defaults to current working dir.
+
+When set, every refine comment appends:
+  ⛽ Project this month: $X of $Y  (monthly cap)
+  🪙 Anthropic credit:   $X of $Y  (credit balance)
+
+Both fire ⚠️ at 80% and 🛑 at 95%.
+
+Top-up workflow (no auto-recharge):
+  $ slowcook budget set --credit 25         # at the start of $25 deposit
+  ... burn through credit ...
+  $ slowcook budget set --credit 50         # after topping up to $50 (new baseline)
+`);
+}
+function configPath(cwd) {
+    return join(cwd, ".brewing", "budget.yaml");
+}
+function fmtUsd(n) {
+    return `$${n.toFixed(2)}`;
+}
+export async function budget(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs(argv);
+    }
+    catch (e) {
+        console.error(e.message);
+        process.exit(2);
+    }
+    if (parsed.action === "rm") {
+        const p = configPath(parsed.cwd);
+        if (!existsSync(p)) {
+            console.log(`No .brewing/budget.yaml — nothing to remove.`);
+            return;
+        }
+        unlinkSync(p);
+        console.log(`Removed ${p}. Fuel gauge now disabled.`);
+        return;
+    }
+    if (parsed.action === "set") {
+        // Merge into existing config; allow updating individual fields.
+        let existing = null;
+        try {
+            existing = loadBudgetConfig(parsed.cwd);
+        }
+        catch (e) {
+            console.error(`Existing config is invalid — fix or rm first: ${e.message}`);
+            process.exit(2);
+        }
+        const monthly = parsed.monthly ?? existing?.monthly_budget_usd;
+        if (monthly !== undefined && (!Number.isFinite(monthly) || monthly <= 0)) {
+            console.error(`--monthly must be a positive number, got ${parsed.monthly}`);
+            process.exit(2);
+        }
+        const startDay = parsed.startDay ?? existing?.monthly_start_day ?? 1;
+        if (!Number.isInteger(startDay) || startDay < 1 || startDay > 31) {
+            console.error(`--start-day must be an integer 1-31, got ${parsed.startDay}`);
+            process.exit(2);
+        }
+        const story = parsed.story ?? existing?.story_budget_usd;
+        if (story !== undefined && (!Number.isFinite(story) || story <= 0)) {
+            console.error(`--story must be a positive number, got ${parsed.story}`);
+            process.exit(2);
+        }
+        // Credit handling — a fresh --credit captures "now" as the
+        // baseline. Re-running --credit (top-up) refreshes the baseline so
+        // the gauge tracks ONLY spend from the new deposit forward.
+        let credit = existing?.credit_balance_usd;
+        let creditBaselineAt = existing?.credit_baseline_at;
+        if (parsed.credit !== undefined) {
+            if (!Number.isFinite(parsed.credit) || parsed.credit <= 0) {
+                console.error(`--credit must be a positive number, got ${parsed.credit}`);
+                process.exit(2);
+            }
+            credit = parsed.credit;
+            creditBaselineAt = parsed.creditBaselineAt ?? new Date().toISOString();
+        }
+        if (monthly === undefined && credit === undefined) {
+            console.error(`Set at least one of --monthly or --credit. Try: slowcook budget set --credit 25`);
+            process.exit(2);
+        }
+        const next = {
+            schema_version: 1,
+            monthly_start_day: startDay,
+            ...(monthly !== undefined ? { monthly_budget_usd: monthly } : {}),
+            ...(story !== undefined ? { story_budget_usd: story } : {}),
+            ...(credit !== undefined ? { credit_balance_usd: credit } : {}),
+            ...(creditBaselineAt !== undefined ? { credit_baseline_at: creditBaselineAt } : {}),
+        };
+        const p = configPath(parsed.cwd);
+        mkdirSync(join(parsed.cwd, ".brewing"), { recursive: true });
+        writeFileSync(p, YAML.stringify(next, { lineWidth: 0 }), "utf8");
+        const verb = existing ? "Updated" : "Wrote";
+        console.log(`${verb} ${p}`);
+        console.log(readFileSync(p, "utf8"));
+        return;
+    }
+    // show
+    let config;
+    try {
+        config = loadBudgetConfig(parsed.cwd);
+    }
+    catch (e) {
+        console.error(`Config at ${configPath(parsed.cwd)} is invalid: ${e.message}`);
+        process.exit(2);
+    }
+    if (!config) {
+        console.log(`No .brewing/budget.yaml — fuel gauge disabled.`);
+        console.log(`Set one with:  slowcook budget set --credit 25      (one-shot deposit)`);
+        console.log(`         or:  slowcook budget set --monthly 50     (recurring cap)`);
+        return;
+    }
+    const now = new Date();
+    console.log(`Config: ${configPath(parsed.cwd)}`);
+    if (config.monthly_budget_usd !== undefined) {
+        console.log(`  monthly_budget_usd:  ${fmtUsd(config.monthly_budget_usd)}`);
+        console.log(`  monthly_start_day:   ${config.monthly_start_day}`);
+    }
+    if (config.story_budget_usd !== undefined) {
+        console.log(`  story_budget_usd:    ${fmtUsd(config.story_budget_usd)}`);
+    }
+    if (config.credit_balance_usd !== undefined) {
+        console.log(`  credit_balance_usd:  ${fmtUsd(config.credit_balance_usd)}`);
+        console.log(`  credit_baseline_at:  ${config.credit_baseline_at ?? "(unset)"}`);
+    }
+    console.log(``);
+    if (config.monthly_budget_usd !== undefined) {
+        const period = currentPeriodStart(config, now);
+        const spend = aggregateMonthSpend(parsed.cwd, config, now);
+        const status = classifyBudgetStatus(spend.usd, config.monthly_budget_usd);
+        const pct = Math.round((spend.usd / config.monthly_budget_usd) * 100);
+        const icon = status === "halt" ? "🛑" : status === "warn" ? "⚠️" : "⛽";
+        console.log(`Period start: ${period.toISOString().slice(0, 10)}`);
+        console.log(`${icon} Spent this period: ${fmtUsd(spend.usd)} of ${fmtUsd(config.monthly_budget_usd)} (${pct}%)`);
+        console.log(`   ${spend.entryCount} entr${spend.entryCount === 1 ? "y" : "ies"} across ${spend.storyCount} stor${spend.storyCount === 1 ? "y" : "ies"}.`);
+        if (status === "warn") {
+            console.log(`   ⚠️  approaching monthly budget — consider topping up.`);
+        }
+        else if (status === "halt") {
+            console.log(`   🛑 over budget — agents will halt without the override-budget label.`);
+        }
+        console.log(``);
+    }
+    if (config.credit_balance_usd !== undefined && config.credit_baseline_at) {
+        const baseline = new Date(config.credit_baseline_at);
+        const spend = aggregateSpendSince(parsed.cwd, baseline);
+        const status = classifyBudgetStatus(spend.usd, config.credit_balance_usd);
+        const remaining = Math.max(0, config.credit_balance_usd - spend.usd);
+        const pctLeft = Math.max(0, 100 - Math.round((spend.usd / config.credit_balance_usd) * 100));
+        const icon = status === "halt" ? "🛑" : status === "warn" ? "⚠️" : "🪙";
+        console.log(`Credit baseline: ${config.credit_baseline_at.slice(0, 10)}`);
+        console.log(`${icon} Anthropic credit: ${fmtUsd(remaining)} of ${fmtUsd(config.credit_balance_usd)} remaining (${pctLeft}%)`);
+        console.log(`   Spent ${fmtUsd(spend.usd)} since baseline. ${spend.entryCount} entr${spend.entryCount === 1 ? "y" : "ies"}.`);
+        if (status === "warn") {
+            console.log(`   ⚠️  approaching empty — top up at https://console.anthropic.com/settings/billing.`);
+            console.log(`       Then: slowcook budget set --credit <new-total>     # captures fresh baseline`);
+        }
+        else if (status === "halt") {
+            console.log(`   🛑 credit nearly exhausted — pipeline will halt on 402 imminently.`);
+            console.log(`       Top up + re-run: slowcook budget set --credit <new-total>`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/dev-env/config.d.ts

@@ -0,0 +1,136 @@
+/**
+ * `.brewing/dev-env.yaml` config schema — Phase 2 of the dev-env
+ * upstreaming (delgoosh-first proof in Phase 1, generalised here).
+ *
+ * Consumers describe their dev env once: which apps run, in what
+ * mode (hot-reload vs production-shaped), which git branch the env
+ * mirrors (default `dev`), how seed data flows, and the optional SSH
+ * target if the env runs on a remote box.
+ *
+ * Then `slowcook dev-env <subcmd>` reads the file and acts. Today
+ * this Phase 2 cut ships only `push` end-to-end (the load-bearing
+ * operation for Phase 3 brew/plate wiring); `up`, `sync`, `switch`,
+ * `reset` ship as stubs that emit the canonical command shell for
+ * the consumer to wire into their workflow.
+ */
+import { z } from "zod";
+export declare const DEV_ENV_CONFIG_PATH = ".brewing/dev-env.yaml";
+declare const AppModeSchema: z.ZodEnum<["dev", "start", "nest-watch", "static", "none"]>;
+export declare const DevEnvConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schema_version: z.ZodLiteral<1>;
+    /**
+     * The git branch the dev env always reads from. Force-pushable —
+     * agents shove story-branch heads here to preview them. Default:
+     * `dev`.
+     */
+    source_branch: z.ZodDefault<z.ZodString>;
+    /**
+     * Path (repo-relative) to the seed script. Run by `dev-env up` and
+     * `dev-env reset`. Must be idempotent on already-seeded data.
+     */
+    seed_script: z.ZodOptional<z.ZodString>;
+    /**
+     * Where the dev env physically runs. Omit for "local docker compose
+     * on the runner" semantics (rare); set for SSH-to-box deploys.
+     */
+    ssh_target: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        user: z.ZodString;
+        /** Absolute path on the box where the consumer's checkout lives. */
+        checkout_dir: z.ZodString;
+        /** Repo secret name holding the SSH private key. */
+        key_secret: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        user: string;
+        checkout_dir: string;
+        key_secret: string;
+    }, {
+        host: string;
+        user: string;
+        checkout_dir: string;
+        key_secret?: string | undefined;
+    }>>;
+    persistence: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /**
+         * Named docker volume that survives `dev-env reset`. PM-added DB
+         * rows persist across redeploys; only the seed-owned rows are
+         * touched by reset.
+         */
+        db_volume: z.ZodOptional<z.ZodString>;
+        /** Named volume for uploaded user files / object storage. */
+        uploads_volume: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        db_volume?: string | undefined;
+        uploads_volume?: string | undefined;
+    }, {
+        db_volume?: string | undefined;
+        uploads_volume?: string | undefined;
+    }>>>;
+    apps: z.ZodRecord<z.ZodString, z.ZodObject<{
+        mode: z.ZodEnum<["dev", "start", "nest-watch", "static", "none"]>;
+        port: z.ZodNumber;
+        /** Restart on crash. Defaults to true. */
+        autoheal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Optional: explicit container/process name override (otherwise the key). */
+        container: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "dev" | "start" | "nest-watch" | "static" | "none";
+        port: number;
+        autoheal: boolean;
+        container?: string | undefined;
+    }, {
+        mode: "dev" | "start" | "nest-watch" | "static" | "none";
+        port: number;
+        autoheal?: boolean | undefined;
+        container?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    source_branch: string;
+    persistence: {
+        db_volume?: string | undefined;
+        uploads_volume?: string | undefined;
+    };
+    apps: Record<string, {
+        mode: "dev" | "start" | "nest-watch" | "static" | "none";
+        port: number;
+        autoheal: boolean;
+        container?: string | undefined;
+    }>;
+    $schema?: string | undefined;
+    seed_script?: string | undefined;
+    ssh_target?: {
+        host: string;
+        user: string;
+        checkout_dir: string;
+        key_secret: string;
+    } | undefined;
+}, {
+    schema_version: 1;
+    apps: Record<string, {
+        mode: "dev" | "start" | "nest-watch" | "static" | "none";
+        port: number;
+        autoheal?: boolean | undefined;
+        container?: string | undefined;
+    }>;
+    $schema?: string | undefined;
+    source_branch?: string | undefined;
+    seed_script?: string | undefined;
+    ssh_target?: {
+        host: string;
+        user: string;
+        checkout_dir: string;
+        key_secret?: string | undefined;
+    } | undefined;
+    persistence?: {
+        db_volume?: string | undefined;
+        uploads_volume?: string | undefined;
+    } | undefined;
+}>;
+export type DevEnvConfig = z.infer<typeof DevEnvConfigSchema>;
+export type AppMode = z.infer<typeof AppModeSchema>;
+export declare function loadDevEnvConfig(repoRoot: string): DevEnvConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/dev-env/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/dev-env/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,QAAA,MAAM,aAAa,6DAMjB,CAAC;AA+BH,eAAO,MAAM,kBAAkB;;;IAG7B;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;OAGG;;;;QAvBH,oEAAoE;;QAEpE,oDAAoD;;;;;;;;;;;;;;QAfpD;;;;WAIG;;QAEH,6DAA6D;;;;;;;;;;;;QAb7D,0CAA0C;;QAE1C,8EAA8E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6C9E,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAwB/D"}

package/dist/commands/dev-env/config.js

@@ -0,0 +1,96 @@
+/**
+ * `.brewing/dev-env.yaml` config schema — Phase 2 of the dev-env
+ * upstreaming (delgoosh-first proof in Phase 1, generalised here).
+ *
+ * Consumers describe their dev env once: which apps run, in what
+ * mode (hot-reload vs production-shaped), which git branch the env
+ * mirrors (default `dev`), how seed data flows, and the optional SSH
+ * target if the env runs on a remote box.
+ *
+ * Then `slowcook dev-env <subcmd>` reads the file and acts. Today
+ * this Phase 2 cut ships only `push` end-to-end (the load-bearing
+ * operation for Phase 3 brew/plate wiring); `up`, `sync`, `switch`,
+ * `reset` ship as stubs that emit the canonical command shell for
+ * the consumer to wire into their workflow.
+ */
+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";
+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
+    "static", // serve a built static export, never re-run
+    "none", // entry exists but isn't started by `dev-env up` (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 `dev-env reset`. PM-added DB
+     * rows persist across redeploys; only the seed-owned rows are
+     * touched by reset.
+     */
+    db_volume: z.string().optional(),
+    /** Named volume for uploaded user files / object storage. */
+    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"),
+});
+export const DevEnvConfigSchema = z.object({
+    $schema: z.string().optional(),
+    schema_version: z.literal(1),
+    /**
+     * The git branch the dev env always reads from. Force-pushable —
+     * agents shove story-branch heads here to preview them. Default:
+     * `dev`.
+     */
+    source_branch: z.string().default("dev"),
+    /**
+     * Path (repo-relative) to the seed script. Run by `dev-env up` and
+     * `dev-env reset`. Must be idempotent on already-seeded data.
+     */
+    seed_script: z.string().optional(),
+    /**
+     * Where the dev env physically runs. Omit for "local docker compose
+     * on the runner" semantics (rare); set for SSH-to-box deploys.
+     */
+    ssh_target: SshTargetSchema.optional(),
+    persistence: PersistenceSchema.optional().default({}),
+    apps: z.record(z.string(), AppSchema),
+});
+export function loadDevEnvConfig(repoRoot) {
+    const path = join(repoRoot, DEV_ENV_CONFIG_PATH);
+    if (!existsSync(path)) {
+        throw new Error(`${DEV_ENV_CONFIG_PATH} not found. Run \`slowcook dev-env init\` to scaffold.`);
+    }
+    let raw;
+    try {
+        raw = YAML.parse(readFileSync(path, "utf8"));
+    }
+    catch (e) {
+        throw new Error(`${DEV_ENV_CONFIG_PATH} is not valid YAML: ${e.message}`);
+    }
+    const parsed = DevEnvConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`${DEV_ENV_CONFIG_PATH} failed validation: ${parsed.error.issues
+            .map((i) => `${i.path.join(".")}: ${i.message}`)
+            .join("; ")}`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/dev-env/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/dev-env/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;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;AAE3D,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,KAAK,EAAE,kEAAkE;IACzE,OAAO,EAAE,8DAA8D;IACvE,YAAY,EAAE,wDAAwD;IACtE,QAAQ,EAAE,4CAA4C;IACtD,MAAM,EAAE,6DAA6D;CACtE,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,6DAA6D;IAC7D,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,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B;;;;OAIG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC;;;OAGG;IACH,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC;CACtC,CAAC,CAAC;AAKH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,GAAG,mBAAmB,wDAAwD,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,GAAG,mBAAmB,uBAAwB,CAAW,CAAC,OAAO,EAAE,CACpE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,GAAG,mBAAmB,uBAAuB,MAAM,CAAC,KAAK,CAAC,MAAM;aAC7D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/commands/dev-env/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `slowcook dev-env <subcmd>` — manages the consumer's long-lived
+ * dev/preview environment. Phase 2 of the dev-env design.
+ *
+ * Subcommands:
+ *
+ *   push --story <id> [--branch <name>]
+ *     Force-push the current branch (or --branch) to the configured
+ *     `source_branch` (default: `dev`). Agents (brew, plate) invoke
+ *     this to preview their story-branch on the shared dev URL.
+ *     Phase 3 wires this into brew/plate workflows automatically.
+ *
+ *   switch --story <id>
+ *     Locate the PR for story <id>, force-push its HEAD to
+ *     `source_branch`. Operator-driven version of `push`.
+ *
+ *   up | sync | reset
+ *     Phase 2 stubs — print the canonical shell-out for the consumer
+ *     to wire into their dev-deploy workflow. Phase 2.1 fills in the
+ *     SSH-driven runtime path.
+ *
+ *   init
+ *     Phase 2.1 stub — scaffold `.brewing/dev-env.yaml` from detected
+ *     apps. Not implemented yet; consumers hand-author for now.
+ */
+export declare function devEnv(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/dev-env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/dev-env/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAuEH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC1D"}