@slowcook-ai/cli 0.19.0-alpha.41 → 0.19.0

package/dist/commands/upsert-agent-docs.js

@@ -0,0 +1,298 @@
+/**
+ * `slowcook upsert-agent-docs` — α.64
+ *
+ * Writes (or refreshes) a marker-delimited "managed block" inside the
+ * consumer's agent-pointer doc(s) so that ANY visiting AI agent —
+ * Claude Code, Cursor, OpenAI Codex, Windsurf, etc. — discovers the
+ * slowcook methodology + the `.brewing/repo-knowledge/curated/`
+ * goldmine on first read.
+ *
+ * Strategy:
+ *   1. Scan for existing agent-pointer files:
+ *        AGENTS.md, CLAUDE.md, .cursorrules, .windsurfrules, GEMINI.md,
+ *        .github/copilot-instructions.md
+ *      For each that exists → upsert the managed block (markers below).
+ *   2. If NONE exist → create AGENTS.md as the canonical home.
+ *   3. README.md: add a one-line pointer to AGENTS.md if not present.
+ *   4. .gitignore: ensure `.brewing/repo-knowledge/auto/` is ignored
+ *      and `.brewing/repo-knowledge/curated/` is NOT (auto = derived,
+ *      curated = tracked organizational memory).
+ *
+ * The block is delimited with HTML comments humans wouldn't write by
+ * hand:
+ *   <!-- BEGIN: managed by slowcook upsert-agent-docs — edit outside markers -->
+ *   ...
+ *   <!-- END: managed by slowcook upsert-agent-docs -->
+ *
+ * Idempotent: re-running on a file with the block already present
+ * just refreshes the content between the markers. Content outside is
+ * never touched.
+ *
+ * Called from `slowcook init` automatically AND as a standalone
+ * command for repos that already ran `init` and want to refresh the
+ * block when the canonical content evolves.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const BEGIN_MARKER = "<!-- BEGIN: managed by slowcook upsert-agent-docs — edit outside markers -->";
+const END_MARKER = "<!-- END: managed by slowcook upsert-agent-docs -->";
+/** Agent-pointer files we know about. Order matters — first existing
+ *  one is treated as the canonical home; absent → create AGENTS.md. */
+const AGENT_POINTER_PATHS = [
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".cursorrules",
+    ".windsurfrules",
+    "GEMINI.md",
+    ".github/copilot-instructions.md",
+];
+export function buildManagedBlock() {
+    return `## Agent methodology + knowledge goldmine
+
+This repo uses [slowcook](https://github.com/aminazar/slowcook) pipeline conventions (refine → testgen → vibe → plate → brew → chef). **You don't need to be a slowcook agent to work here** — these conventions apply to any AI agent doing meaningful work on this repo, including Claude Code, Cursor, OpenAI Codex, Aider, Copilot, and Windsurf.
+
+### Read this BEFORE writing any code
+
+Look in \`.brewing/repo-knowledge/\` — it's the durable organizational memory of this codebase:
+
+#### \`.brewing/repo-knowledge/curated/\` (tracked in git, durable)
+
+Mined from git history + appended by agents over time:
+
+| File | What it gives you |
+|---|---|
+| \`commit-conventions.md\` | active type:scope prefixes used in this repo |
+| \`co-changes.md\` | files that historically change together (temporal coupling the type system can't see) |
+| \`ownership.md\` | top author per top-level directory |
+| \`fix-recipe-seeds.md\` | files with multiple \`fix(*)\` commits — known-fragile hotspots |
+| \`issue-traceability.md\` | \`#N\` → commits map for PM-intent lookup |
+| \`chef-known-fixes.md\` | fix-class catalog written by chef-agent runs (populated as the codebase ages) |
+| \`test-patterns.md\` | preferred testing conventions, observed mock isolation + helper-naming patterns |
+| \`design-conventions.md\` | design-system + token decisions, written by vibe-agent runs |
+
+Treat curated content as **soft signal**: entries carry evidence trails (\`PR #N\`, file path, date) but staleness is for review, not auto-invalidation. An insight like "vitest/config not found means deps missing" stays valid even if vitest.config.ts moves — the insight is about a CLASS of problem, not a snapshot.
+
+#### \`.brewing/repo-knowledge/auto/\` (gitignored, regenerated fresh)
+
+Deterministic extractions of the codebase shape — backend entities, HTTP routes, enums, mock TypeScript types, brand-token vocabulary, migrations, route inventory. Rebuilt by \`slowcook refresh-knowledge\`.
+
+### Methodology TL;DR
+
+| Stage | What it produces |
+|---|---|
+| **refine** | YAML spec from a PM issue (clarifying questions if needed) |
+| **testgen** | Failing integration tests against the spec contract |
+| **vibe** | Mock-UI page that matches the spec's PM intent |
+| **plate** | Reconciliation of mock + tests for the data-layer seam |
+| **brew** | Iterates code until tests pass (with optional pair-brew navigator) |
+| **chef** | Surgical fixes on test infra / drift / brew halts |
+
+The slowcook pipeline opens one branch per stage (\`slowcook/<kind>/story-N\`). You don't have to use slowcook to work on this repo, but conform to the conventions in \`.brewing/repo-knowledge/curated/\` so the agents downstream of you don't have to re-derive them.
+
+### Branch discipline
+
+- **Never push directly to \`main\`.** Branch protection blocks it anyway. Cut a branch, open a PR.
+- Slowcook agents stay on \`slowcook/<kind>/story-N\` branches; non-slowcook agents should use \`<your-name>/<short-description>\`.
+- Don't \`--force-push\` to shared branches. The human PM holds admin bypass for emergencies; agents don't.
+
+### Refreshing the goldmine
+
+Run when you've made structural changes that other agents will need to know about:
+
+\`\`\`bash
+slowcook refresh-knowledge              # rebuilds auto/ + curated/ (~2s on a 1k-commit repo)
+slowcook refresh-knowledge --mine-history  # curated/ only (faster delta-mining)
+slowcook refresh-knowledge --auto       # auto/ only
+\`\`\`
+
+### Contributing back
+
+When you discover a non-obvious convention, fix recipe, or temporal coupling worth recording:
+
+\`\`\`bash
+slowcook knowledge add <your-agent-name> "<one-line claim>" --evidence-pr <N> --evidence-file <path>
+\`\`\`
+
+Or (if you're not running slowcook) edit \`.brewing/repo-knowledge/curated/<topic>.md\` directly with:
+
+\`\`\`
+- (<your-name> · PR #<N> · YYYY-MM-DD) <one-line claim>
+\`\`\`
+
+Knowledge entries are soft signal — agents reading them weight by recency and evidence, not by exact matching. \`slowcook knowledge verify\` flags [PRECARIOUS] entries whose evidence file has moved (but never auto-deletes).
+`;
+}
+function upsertBlockInFile(repoRoot, relPath, blockBody, dryRun) {
+    const abs = join(repoRoot, relPath);
+    const wrappedBlock = `${BEGIN_MARKER}\n${blockBody.trim()}\n${END_MARKER}`;
+    if (!existsSync(abs)) {
+        if (dryRun)
+            return "created";
+        mkdirSync(dirname(abs), { recursive: true });
+        const header = `# ${basenameStem(relPath)}\n\nDoc for AI coding agents working in this repo.\n\n${wrappedBlock}\n`;
+        writeFileSync(abs, header, "utf8");
+        return "created";
+    }
+    const existing = readFileSync(abs, "utf8");
+    if (existing.includes(BEGIN_MARKER) && existing.includes(END_MARKER)) {
+        // Refresh the existing block in place.
+        const before = existing.split(BEGIN_MARKER)[0];
+        const after = existing.split(END_MARKER)[1] ?? "";
+        const next = `${before}${wrappedBlock}${after}`;
+        if (next === existing)
+            return "unchanged";
+        if (dryRun)
+            return "refreshed";
+        writeFileSync(abs, next, "utf8");
+        return "refreshed";
+    }
+    // No marker yet — append at end (with a divider for clarity).
+    const trailing = existing.endsWith("\n") ? "" : "\n";
+    const next = `${existing}${trailing}\n---\n\n${wrappedBlock}\n`;
+    if (dryRun)
+        return "refreshed";
+    writeFileSync(abs, next, "utf8");
+    return "refreshed";
+}
+function basenameStem(relPath) {
+    const fname = relPath.split("/").pop() ?? relPath;
+    return fname.replace(/\.[^.]+$/, "");
+}
+const README_POINTER_LINE = "> **AI agents working in this repo:** read [`AGENTS.md`](./AGENTS.md) first.";
+function upsertReadmePointer(repoRoot, dryRun) {
+    const candidates = ["README.md", "Readme.md", "readme.md"];
+    let readmePath = null;
+    for (const c of candidates) {
+        if (existsSync(join(repoRoot, c))) {
+            readmePath = c;
+            break;
+        }
+    }
+    if (!readmePath)
+        return "no-readme";
+    const abs = join(repoRoot, readmePath);
+    const body = readFileSync(abs, "utf8");
+    if (body.includes("AI agents working in this repo") || body.includes("read [`AGENTS.md`]") || body.includes("[`AGENTS.md`](./AGENTS.md)")) {
+        return "already-present";
+    }
+    if (dryRun)
+        return "added";
+    // Insert after the first `# heading` line (right under the title) so it's visible immediately.
+    const lines = body.split("\n");
+    let inserted = false;
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        out.push(lines[i]);
+        if (!inserted && /^#\s+/.test(lines[i]) && i < 3) {
+            out.push("");
+            out.push(README_POINTER_LINE);
+            inserted = true;
+        }
+    }
+    if (!inserted) {
+        // No top heading — prepend
+        out.unshift(README_POINTER_LINE, "");
+    }
+    writeFileSync(abs, out.join("\n"), "utf8");
+    return "added";
+}
+function upsertGitignore(repoRoot, dryRun) {
+    const path = join(repoRoot, ".gitignore");
+    if (!existsSync(path))
+        return "no-gitignore";
+    const body = readFileSync(path, "utf8");
+    // Want: auto/ ignored; curated/ NOT ignored.
+    // If the user has a broad `.brewing/` ignore, leave it; just append
+    // an explicit allowlist for curated/.
+    const needsAuto = !body.includes(".brewing/repo-knowledge/auto/");
+    const needsCuratedAllow = !body.includes("!.brewing/repo-knowledge/curated/");
+    if (!needsAuto && !needsCuratedAllow)
+        return "already-present";
+    if (dryRun)
+        return "added";
+    const block = [
+        "",
+        "# slowcook 0.19.0-α.64 — repo-knowledge layer",
+        "# auto/ is derived (cheap to regenerate); curated/ is durable",
+        "# organizational memory tracked in git.",
+        ".brewing/repo-knowledge/auto/",
+        "!.brewing/repo-knowledge/curated/",
+        "",
+    ].join("\n");
+    const next = body.endsWith("\n") ? body + block : body + "\n" + block;
+    writeFileSync(path, next, "utf8");
+    return "added";
+}
+export function upsertAgentDocsCore(repoRoot, opts = {}) {
+    const dryRun = opts.dryRun ?? false;
+    const block = buildManagedBlock();
+    const existing = AGENT_POINTER_PATHS.filter((p) => existsSync(join(repoRoot, p)));
+    const filesUpserted = [];
+    if (existing.length === 0) {
+        // No agent doc — create AGENTS.md.
+        const action = upsertBlockInFile(repoRoot, "AGENTS.md", block, dryRun);
+        filesUpserted.push({ path: "AGENTS.md", action });
+    }
+    else {
+        for (const p of existing) {
+            const action = upsertBlockInFile(repoRoot, p, block, dryRun);
+            filesUpserted.push({ path: p, action });
+        }
+    }
+    const readme = upsertReadmePointer(repoRoot, dryRun);
+    const gitignore = upsertGitignore(repoRoot, dryRun);
+    return { filesUpserted, readme, gitignore };
+}
+// --- CLI entry ---
+export async function upsertAgentDocs(argv) {
+    const args = parseArgs(argv);
+    if (args.help) {
+        printHelp();
+        return;
+    }
+    const result = upsertAgentDocsCore(args.repoRoot, { dryRun: args.dryRun });
+    console.log(`slowcook upsert-agent-docs · ${args.repoRoot}${args.dryRun ? " (dry-run)" : ""}`);
+    for (const f of result.filesUpserted) {
+        console.log(`  ${f.action.padEnd(10)}  ${f.path}`);
+    }
+    console.log(`  README.md   ${result.readme}`);
+    console.log(`  .gitignore  ${result.gitignore}`);
+}
+function parseArgs(argv) {
+    let repoRoot = process.cwd();
+    let dryRun = false;
+    let help = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--cwd" && next) {
+            repoRoot = next;
+            i++;
+        }
+        else if (a === "--dry-run") {
+            dryRun = true;
+        }
+        else if (a === "--help" || a === "-h") {
+            help = true;
+        }
+    }
+    return { repoRoot, dryRun, help };
+}
+function printHelp() {
+    console.log(`
+slowcook upsert-agent-docs — write/refresh AGENTS.md managed block
+
+Usage:
+  slowcook upsert-agent-docs [--cwd <path>] [--dry-run]
+
+Detects existing agent-pointer files (AGENTS.md / CLAUDE.md /
+.cursorrules / etc.) and inserts a marker-delimited managed block
+pointing at .brewing/repo-knowledge/curated/. README.md gets a
+one-line pointer to AGENTS.md if missing. .gitignore is updated to
+ignore auto/ but track curated/.
+
+Idempotent: re-running refreshes content inside the markers; outside
+content is never touched.
+`);
+}
+//# sourceMappingURL=upsert-agent-docs.js.map

package/dist/commands/upsert-agent-docs.js.map

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

package/dist/lib/budget.d.ts

@@ -1,62 +1,12 @@
 import { z } from "zod";
-declare const BudgetConfigSchema: z.ZodEffects<z.ZodObject<{
+declare const BudgetConfigSchema: z.ZodObject<{
     schema_version: z.ZodLiteral<1>;
     monthly_budget_usd: z.ZodOptional<z.ZodNumber>;
-    /** 1-31. The day of the calendar month the budget resets. */
     monthly_start_day: z.ZodDefault<z.ZodNumber>;
-    /** Optional per-story ceiling (informational). */
     story_budget_usd: z.ZodOptional<z.ZodNumber>;
-    /**
-     * 0.19.0-α.35 — anthropic credit deposit tracking. Unlike
-     * `monthly_budget_usd` (which resets each period), this models a
-     * non-recurring credit deposit (e.g. you topped up $25). The gauge
-     * subtracts ALL-TIME spend from this number, so once the sidecar
-     * shows $24 of usage you're down to $1 remaining.
-     *
-     * Set via: slowcook budget set --credit 25
-     *
-     * Re-set whenever you top up: slowcook budget set --credit 50
-     * (the all-time spend baseline is captured at the time of set, so
-     * re-setting resets the gauge to "full" for the new deposit).
-     */
     credit_balance_usd: z.ZodOptional<z.ZodNumber>;
-    /**
-     * ISO timestamp captured when `credit_balance_usd` was set / last
-     * topped up. The gauge sums sidecar entries with `at >=` this value;
-     * spend before this is presumed already paid for by an earlier
-     * deposit. Written by `slowcook budget set --credit`; consumers
-     * shouldn't author this by hand.
-     */
     credit_baseline_at: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    schema_version: 1;
-    monthly_start_day: number;
-    monthly_budget_usd?: number | undefined;
-    story_budget_usd?: number | undefined;
-    credit_balance_usd?: number | undefined;
-    credit_baseline_at?: string | undefined;
-}, {
-    schema_version: 1;
-    monthly_budget_usd?: number | undefined;
-    monthly_start_day?: number | undefined;
-    story_budget_usd?: number | undefined;
-    credit_balance_usd?: number | undefined;
-    credit_baseline_at?: string | undefined;
-}>, {
-    schema_version: 1;
-    monthly_start_day: number;
-    monthly_budget_usd?: number | undefined;
-    story_budget_usd?: number | undefined;
-    credit_balance_usd?: number | undefined;
-    credit_baseline_at?: string | undefined;
-}, {
-    schema_version: 1;
-    monthly_budget_usd?: number | undefined;
-    monthly_start_day?: number | undefined;
-    story_budget_usd?: number | undefined;
-    credit_balance_usd?: number | undefined;
-    credit_baseline_at?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type BudgetConfig = z.infer<typeof BudgetConfigSchema>;
 /**
  * Load `.brewing/budget.yaml`. Returns null when the file is absent —

package/dist/lib/budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/lib/budget.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,kBAAkB;;;IAGtB,6DAA6D;;IAE7D,kDAAkD;;IAElD;;;;;;;;;;;;OAYG;;IAEH;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKJ,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWtE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,EAC/C,GAAG,GAAE,IAAiB,GACrB,IAAI,CAUN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAuBzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,GAAG,GAAE,IAAiB,GACrB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAGzD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAKlD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAMxF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAqB3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAyBT;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CA6BlF"}
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/lib/budget.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,kBAAkB;;;;;;;iBAgCvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWtE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,EAC/C,GAAG,GAAE,IAAiB,GACrB,IAAI,CAUN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAuBzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,GAAG,GAAE,IAAiB,GACrB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAGzD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAKlD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAMxF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAqB3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAyBT;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CA6BlF"}

package/dist/lib/mock-shape.d.ts

@@ -1,32 +1,17 @@
 import { z } from "zod";
 declare const MockShapeConfigSchema: z.ZodObject<{
     schema_version: z.ZodLiteral<1>;
-    shape: z.ZodEnum<["vite", "nextjs"]>;
+    shape: z.ZodEnum<{
+        vite: "vite";
+        nextjs: "nextjs";
+    }>;
     mock_root: z.ZodDefault<z.ZodString>;
     screens_root: z.ZodDefault<z.ZodString>;
     design_system_dir: z.ZodDefault<z.ZodString>;
     router_file: z.ZodOptional<z.ZodString>;
     scenarios_dir: z.ZodDefault<z.ZodString>;
     scenario_registry_file: z.ZodDefault<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    schema_version: 1;
-    shape: "vite" | "nextjs";
-    mock_root: string;
-    screens_root: string;
-    design_system_dir: string;
-    scenarios_dir: string;
-    scenario_registry_file: string;
-    router_file?: string | undefined;
-}, {
-    schema_version: 1;
-    shape: "vite" | "nextjs";
-    mock_root?: string | undefined;
-    screens_root?: string | undefined;
-    design_system_dir?: string | undefined;
-    router_file?: string | undefined;
-    scenarios_dir?: string | undefined;
-    scenario_registry_file?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type MockShapeConfig = z.infer<typeof MockShapeConfigSchema>;
 /**
  * Load `.brewing/mock.yaml`. Returns a default config when the file is

package/dist/lib/mock-shape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-shape.d.ts","sourceRoot":"","sources":["../../src/lib/mock-shape.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAuBpE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAkBrE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD"}
+{"version":3,"file":"mock-shape.d.ts","sourceRoot":"","sources":["../../src/lib/mock-shape.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;iBASzB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAuBpE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAkBrE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.19.0-alpha.41",
+  "version": "0.19.0",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -35,18 +35,21 @@
     "AGENTS.md"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.95.2",
+    "@anthropic-ai/sdk": "^0.96.0",
     "@octokit/rest": "^22.0.1",
     "ts-morph": "^28.0.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@slowcook-ai/core": "^0.13.1",
-    "@slowcook-ai/forge-github": "^0.12.1",
-    "@slowcook-ai/stack-ts": "^0.9.9-alpha.0",
+    "@slowcook-ai/core": "^0.14.0",
+    "@slowcook-ai/stack-ts": "^0.9.9",
+    "@slowcook-ai/llm-anthropic": "^0.16.0",
     "@slowcook-ai/review-overlay": "^0.5.5",
-    "@slowcook-ai/llm-anthropic": "^0.16.0-alpha.15",
+    "@slowcook-ai/forge-github": "^0.12.2",
     "@slowcook-ai/recorder": "^0.9.1"
   },
+  "devDependencies": {
+    "@types/node": "^25.9.0"
+  },
   "publishConfig": {
     "access": "public"
   },