@slowcook-ai/cli 0.19.0-alpha.8 → 0.19.1

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"}

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

@@ -0,0 +1,226 @@
+/**
+ * `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.
+ */
+import { execSync } from "node:child_process";
+import { loadDevEnvConfig } from "./config.js";
+import { devEnvInit } from "./init.js";
+function parseArgs(argv) {
+    const args = {
+        subcommand: argv[0] ?? "help",
+        repoRoot: process.cwd(),
+    };
+    for (let i = 1; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--story" && next) {
+            args.story = next;
+            i++;
+        }
+        else if (a === "--branch" && next) {
+            args.branch = next;
+            i++;
+        }
+        else if (a === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (a === "--help" || a === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook dev-env — manage the long-lived dev/preview environment
+
+Subcommands:
+  init [--apps-dir <path>] [--force]
+      Scaffold .brewing/dev-env.yaml from detected apps in apps/*.
+      Infers per-app mode from package.json deps (Next → dev,
+      NestJS → nest-watch, else → start). Assigns ports starting at
+      3000. ssh_target left as REPLACE_ME — hand-edit.
+
+  push --story <id> [--branch <name>]
+      Force-push the current branch (or --branch) to the dev env's
+      source_branch (default: dev). Agents invoke this to preview a
+      story-branch on the shared dev URL.
+
+  switch --story <id>
+      Look up the PR for story <id> and push its HEAD to source_branch.
+
+  up | sync | reset
+      Phase 2 stubs — print the canonical shell-out for the consumer
+      to wire into their dev-deploy workflow.
+
+Config:
+  .brewing/dev-env.yaml describes apps, modes, ports, ssh target, seed
+  script. See slowcook's docs/dev-env.md for the schema.
+
+Examples:
+  slowcook dev-env push --story 001
+  slowcook dev-env switch --story 001
+`);
+}
+export async function devEnv(argv) {
+    const args = parseArgs(argv);
+    // help has no config dependency — render before anything else
+    if (args.subcommand === "help" ||
+        args.subcommand === "--help" ||
+        args.subcommand === "-h") {
+        printHelp();
+        return;
+    }
+    // init runs BEFORE config exists — it's the bootstrap step.
+    if (args.subcommand === "init") {
+        await devEnvInit(argv.slice(1));
+        return;
+    }
+    let config;
+    try {
+        config = loadDevEnvConfig(args.repoRoot);
+    }
+    catch (e) {
+        console.error(`slowcook dev-env: ${e.message}`);
+        process.exit(64);
+    }
+    switch (args.subcommand) {
+        case "push":
+            return runPush(args, config);
+        case "switch":
+            return runSwitch(args, config);
+        case "up":
+        case "sync":
+        case "reset":
+            return printStubShell(args.subcommand, config);
+        default:
+            console.error(`Unknown subcommand: ${args.subcommand}`);
+            printHelp();
+            process.exit(64);
+    }
+}
+/**
+ * Force-push the local branch to source_branch on origin. The git
+ * mechanics are the load-bearing part of Phase 3's auto-preview flow.
+ */
+function runPush(args, config) {
+    const sourceBranch = config.source_branch;
+    const localBranch = args.branch ??
+        execSync("git rev-parse --abbrev-ref HEAD", {
+            cwd: args.repoRoot,
+            encoding: "utf8",
+        }).trim();
+    if (!localBranch || localBranch === "HEAD") {
+        console.error("slowcook dev-env push: couldn't resolve a local branch (detached HEAD?). Pass --branch <name>.");
+        process.exit(64);
+    }
+    console.log(`[dev-env push] ${localBranch} → origin/${sourceBranch}${args.story ? ` (story-${args.story})` : ""}`);
+    try {
+        execSync(`git push --force origin ${localBranch}:${sourceBranch}`, {
+            cwd: args.repoRoot,
+            stdio: "inherit",
+        });
+    }
+    catch {
+        console.error(`slowcook dev-env push: git push failed. Check your push permissions on origin/${sourceBranch}.`);
+        process.exit(1);
+    }
+    console.log(`[dev-env push] done. dev-deploy workflow will fire on origin/${sourceBranch}.`);
+}
+/**
+ * Look up a PR by story id (via the gh CLI) and push its HEAD to
+ * source_branch. For operator-driven "show me story X on the dev URL"
+ * without checking out the branch locally.
+ */
+function runSwitch(args, config) {
+    if (!args.story) {
+        console.error("slowcook dev-env switch: --story <id> required.");
+        process.exit(64);
+    }
+    const sourceBranch = config.source_branch;
+    // Use the GitHub CLI to find the open PR for the story. gh is part
+    // of slowcook's hard dependencies (already used by every other
+    // command); fail clearly if missing.
+    let prRef;
+    try {
+        const out = execSync(`gh pr list --search "story-${args.story} in:title" --json headRefName,number --limit 1 --jq '.[0].headRefName'`, { cwd: args.repoRoot, encoding: "utf8" }).trim();
+        if (!out) {
+            console.error(`slowcook dev-env switch: no open PR found with "story-${args.story}" in the title.`);
+            process.exit(1);
+        }
+        prRef = out;
+    }
+    catch (e) {
+        console.error(`slowcook dev-env switch: gh CLI failed — ${e.message.slice(0, 200)}`);
+        process.exit(1);
+    }
+    console.log(`[dev-env switch] story-${args.story} → ${prRef} → origin/${sourceBranch}`);
+    // Fetch the PR's branch + push it to source_branch.
+    execSync(`git fetch origin ${prRef}`, {
+        cwd: args.repoRoot,
+        stdio: "inherit",
+    });
+    execSync(`git push --force origin origin/${prRef}:${sourceBranch}`, {
+        cwd: args.repoRoot,
+        stdio: "inherit",
+    });
+    console.log(`[dev-env switch] done.`);
+}
+/**
+ * Stub for up / sync / reset — emits the canonical shell command the
+ * consumer wires into their dev-deploy workflow. Phase 2.1 will fill
+ * in the SSH-driven runtime path that respects ssh_target + apps[*].mode.
+ */
+function printStubShell(subcommand, config) {
+    const apps = Object.keys(config.apps).join(", ");
+    console.log(`slowcook dev-env ${subcommand}: phase-2 stub. Apps configured: ${apps}.`);
+    console.log("");
+    switch (subcommand) {
+        case "up":
+            console.log("Wire this into your dev-deploy workflow:");
+            console.log("  docker compose -f compose.dev.yml up -d --build");
+            if (config.seed_script) {
+                console.log(`  pnpm exec ts-node ${config.seed_script}`);
+            }
+            break;
+        case "sync":
+            console.log("Wire this into your dev-deploy workflow:");
+            console.log(`  git fetch origin && git reset --hard origin/${config.source_branch}`);
+            console.log("  pnpm install --prefer-frozen-lockfile && pnpm build");
+            console.log("  docker compose -f compose.dev.yml up -d --build");
+            break;
+        case "reset":
+            console.log("Wire this into your dev-deploy workflow:");
+            if (config.seed_script) {
+                console.log(`  pnpm exec ts-node ${config.seed_script} --reset`);
+            }
+            else {
+                console.log("  (no seed_script configured — nothing to reset)");
+            }
+            break;
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * `slowcook dev-env init` — scaffold `.brewing/dev-env.yaml` from
+ * detected apps in the consumer's repo. Phase 2.1 of the dev-env arc.
+ *
+ * Detection heuristics (lightweight, no actual build):
+ *   - Walks `apps/*` looking for sub-dirs with a package.json.
+ *   - Infers `mode` from dependencies:
+ *       Next.js  → mode: dev (hot-reload-friendly)
+ *       NestJS   → mode: nest-watch
+ *       fallback → mode: start
+ *   - Assigns sequential ports starting at 3000.
+ *   - Sets reasonable defaults for source_branch, persistence.
+ *   - Leaves ssh_target empty (consumer fills in).
+ *
+ * The output is a STARTING POINT — consumers tweak ports, container
+ * names, ssh_target details by hand. `init --force` overwrites; the
+ * default refuses to clobber an existing file.
+ */
+interface DetectedApp {
+    name: string;
+    mode: "dev" | "start" | "nest-watch";
+    port: number;
+}
+export declare function detectAppsForInit(repoRoot: string, appsDir?: string): DetectedApp[];
+export declare function renderDevEnvYaml(apps: DetectedApp[]): string;
+export declare function devEnvInit(argv: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/dev-env/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,YAAY,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AA8BD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAS,GACf,WAAW,EAAE,CAuBf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAqC5D;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B9D"}

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

@@ -0,0 +1,135 @@
+/**
+ * `slowcook dev-env init` — scaffold `.brewing/dev-env.yaml` from
+ * detected apps in the consumer's repo. Phase 2.1 of the dev-env arc.
+ *
+ * Detection heuristics (lightweight, no actual build):
+ *   - Walks `apps/*` looking for sub-dirs with a package.json.
+ *   - Infers `mode` from dependencies:
+ *       Next.js  → mode: dev (hot-reload-friendly)
+ *       NestJS   → mode: nest-watch
+ *       fallback → mode: start
+ *   - Assigns sequential ports starting at 3000.
+ *   - Sets reasonable defaults for source_branch, persistence.
+ *   - Leaves ssh_target empty (consumer fills in).
+ *
+ * The output is a STARTING POINT — consumers tweak ports, container
+ * names, ssh_target details by hand. `init --force` overwrites; the
+ * default refuses to clobber an existing file.
+ */
+import { readFileSync, writeFileSync, readdirSync, existsSync, statSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import YAML from "yaml";
+function parseArgs(argv) {
+    const args = {
+        repoRoot: process.cwd(),
+        force: false,
+        appsDir: "apps",
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (a === "--apps-dir" && next) {
+            args.appsDir = next;
+            i++;
+        }
+        else if (a === "--force") {
+            args.force = true;
+        }
+    }
+    return args;
+}
+export function detectAppsForInit(repoRoot, appsDir = "apps") {
+    const root = join(repoRoot, appsDir);
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    let port = 3000;
+    for (const name of readdirSync(root).sort()) {
+        const appDir = join(root, name);
+        if (!statSync(appDir).isDirectory())
+            continue;
+        const pkgPath = join(appDir, "package.json");
+        if (!existsSync(pkgPath))
+            continue;
+        let pkg = {};
+        try {
+            pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        }
+        catch {
+            continue;
+        }
+        const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+        let mode = "start";
+        if (deps["next"])
+            mode = "dev";
+        else if (deps["@nestjs/core"] || deps["@nestjs/common"])
+            mode = "nest-watch";
+        out.push({ name, mode, port: port++ });
+    }
+    return out;
+}
+export function renderDevEnvYaml(apps) {
+    const yaml = {
+        $schema: "./dev-env.schema.json",
+        schema_version: 1,
+        source_branch: "dev",
+        seed_script: "scripts/seed-dev-data.ts",
+        ssh_target: {
+            host: "REPLACE_ME.example.com",
+            user: "deploy",
+            checkout_dir: "/opt/yourapp-dev",
+            key_secret: "YOURAPP_DEV_SSH_KEY",
+        },
+        persistence: {
+            db_volume: "pg-dev-data",
+            uploads_volume: "",
+        },
+        apps: Object.fromEntries(apps.map((a) => [
+            a.name,
+            {
+                mode: a.mode,
+                port: a.port,
+                container: a.name,
+            },
+        ])),
+    };
+    return (`# slowcook dev-env config — generated by \`slowcook dev-env init\`.\n` +
+        `# Hand-tweak: ssh_target.{host,user,checkout_dir,key_secret} must point at\n` +
+        `# YOUR deploy box; ports may collide on a small host — adjust to free ones;\n` +
+        `# container names default to app names — change if your compose uses others.\n` +
+        `#\n` +
+        `# See packages/cli/src/commands/dev-env/config.ts in slowcook for the\n` +
+        `# full zod schema.\n\n` +
+        YAML.stringify(yaml, { lineWidth: 0 }));
+}
+export async function devEnvInit(argv) {
+    const args = parseArgs(argv);
+    const outPath = join(args.repoRoot, ".brewing/dev-env.yaml");
+    if (existsSync(outPath) && !args.force) {
+        console.error(`slowcook dev-env init: ${outPath} already exists. Pass --force to overwrite.`);
+        process.exit(64);
+    }
+    const apps = detectAppsForInit(args.repoRoot, args.appsDir);
+    if (apps.length === 0) {
+        console.error(`slowcook dev-env init: no apps detected under \`${args.appsDir}/\`. Pass --apps-dir <path> or hand-author the config.`);
+        process.exit(1);
+    }
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, renderDevEnvYaml(apps), "utf8");
+    console.log(`slowcook dev-env init: wrote ${outPath}`);
+    console.log(`  apps detected (${apps.length}):`);
+    for (const a of apps) {
+        console.log(`    - ${a.name} (mode: ${a.mode}, port: ${a.port})`);
+    }
+    console.log("");
+    console.log("Next steps:");
+    console.log("  1. Edit ssh_target.{host,user,checkout_dir,key_secret}");
+    console.log("  2. Adjust ports if they collide on your deploy box");
+    console.log("  3. Add the dev-deploy.yml workflow (see slowcook docs/dev-env-checkpoint-phase-3.md for the canonical shape)");
+    console.log(`  4. Set the SSH-key secret named in ssh_target.key_secret on your repo`);
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * `slowcook docs <topic>` — print bundled documentation pages.
+ *
+ * Useful when an agent (or maintainer) is on a fresh box without
+ * cloned slowcook repo — `slowcook docs reporting` prints
+ * REPORTING.md straight from the installed package. Same shape as
+ * `git help <topic>` or `npm help <topic>`.
+ *
+ * Topics today:
+ *   reporting   — how to file a slowcook bug
+ *   agents      — onboarding doc for AI agents using slowcook (stub
+ *                 until AGENTS.md ships)
+ *   read-only   — read-only mode reference (SLOWCOOK_READ_ONLY env var)
+ */
+export declare function docs(argv: string[], _cliVersion: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqFH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC7E"}

package/dist/commands/docs/index.js

@@ -0,0 +1,127 @@
+/**
+ * `slowcook docs <topic>` — print bundled documentation pages.
+ *
+ * Useful when an agent (or maintainer) is on a fresh box without
+ * cloned slowcook repo — `slowcook docs reporting` prints
+ * REPORTING.md straight from the installed package. Same shape as
+ * `git help <topic>` or `npm help <topic>`.
+ *
+ * Topics today:
+ *   reporting   — how to file a slowcook bug
+ *   agents      — onboarding doc for AI agents using slowcook (stub
+ *                 until AGENTS.md ships)
+ *   read-only   — read-only mode reference (SLOWCOOK_READ_ONLY env var)
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TOPICS = {
+    reporting: "REPORTING.md",
+    agents: "AGENTS.md",
+    // 'read-only' is a synthetic topic — content is built inline below.
+    "read-only": "",
+};
+function repoRootDocPath(filename) {
+    // Walk up from this file's location to find the repo root (where
+    // REPORTING.md / AGENTS.md live). When installed via npm, the file
+    // sits at `node_modules/@slowcook-ai/cli/dist/commands/docs/index.js`,
+    // so the docs would be at `node_modules/@slowcook-ai/cli/REPORTING.md`
+    // — we package them as `files` in package.json.
+    // When run from the monorepo, files are at the repo root directly.
+    const candidates = [
+        join(__dirname, "..", "..", "..", filename), // installed: dist/commands/docs/ → package root
+        join(__dirname, "..", "..", "..", "..", filename), // monorepo: src/commands/docs/ → cli root
+        join(__dirname, "..", "..", "..", "..", "..", filename), // monorepo: cli root → repo root
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+const READ_ONLY_DOC = `# Read-only mode
+
+Set the env var \`SLOWCOOK_READ_ONLY=1\` and slowcook commands will
+NOT write to the consumer's GitHub repo. Use this when running
+slowcook on someone else's repo to reproduce a bug — you can
+exercise the LLM + see verdicts without commenting / committing /
+pushing / labeling / closing.
+
+What it gates:
+
+- chef-drift: skips applying edits, committing, pushing, posting
+  audit comment.
+- chef-orchestrate: skips posting escalation/close comments,
+  applying labels, calling \`gh pr close\`. Verdict is still
+  computed + persisted to disk (in your local cwd, not the consumer's
+  repo).
+- chef (PR-CI handler): skips posting any comment + dispatching
+  retries.
+- recon \`--stub-escalate\`: skips posting PM comments on source
+  issues.
+- recon \`--write-proposals\` (under \`--reuse-scan\`): skips
+  appending to \`.brewing/refactor/proposals.json\` (still prints to
+  stdout).
+
+What it does NOT gate (intentional):
+
+- Local file reads (cloning, fetching PR heads, reading source).
+- Local artifact writes to the maintainer's own \`/tmp/\` and
+  \`.brewing/\` (these aren't pushed anywhere).
+- The Anthropic API call itself (you pay your own tokens for
+  reproduction).
+
+Use the per-command \`--dry-run\` flag for command-specific gating
+when you want SOME writes (e.g., to your local \`.brewing/\`) but no
+GitHub-side writes. \`SLOWCOOK_READ_ONLY=1\` is the broader knob.
+
+Example reproducing a chef-drift bug from a downloaded artifact:
+
+\`\`\`bash
+gh run download <run-id> -n chef-drift-story-N -D /tmp/repro
+gh repo clone <consumer-repo> /tmp/consumer
+cd /tmp/consumer && gh pr checkout <pr-num>
+SLOWCOOK_READ_ONLY=1 ANTHROPIC_API_KEY=... slowcook chef-drift \\
+  --pr <pr-num> --story <id> --trigger brew_halt_class \\
+  --trigger-raw /tmp/repro/chef-drift-input/halt-trigger.json
+\`\`\`
+
+No edits, no comments, no pushes will hit the consumer's repo. The
+verdict prints to stdout + persists to YOUR \`.brewing/chef/\`
+locally.
+`;
+export async function docs(argv, _cliVersion) {
+    const topic = argv[0];
+    if (!topic || topic === "--help" || topic === "-h") {
+        console.log(`slowcook docs <topic>`);
+        console.log("");
+        console.log("Topics:");
+        for (const t of Object.keys(TOPICS)) {
+            console.log(`  ${t}`);
+        }
+        console.log("");
+        console.log("Example:  slowcook docs reporting");
+        process.exit(topic ? 0 : 64);
+    }
+    if (topic === "read-only") {
+        console.log(READ_ONLY_DOC);
+        return;
+    }
+    const filename = TOPICS[topic];
+    if (!filename) {
+        console.error(`Unknown topic: ${topic}`);
+        console.error(`Available: ${Object.keys(TOPICS).join(", ")}`);
+        process.exit(64);
+    }
+    const path = repoRootDocPath(filename);
+    if (!path) {
+        console.error(`Could not locate ${filename} on disk.`);
+        console.error(`(Looked relative to ${__dirname}.)`);
+        console.error(`If installed from npm, this likely means the package's`);
+        console.error(`files: field doesn't include ${filename}. File a bug.`);
+        process.exit(2);
+    }
+    console.log(readFileSync(path, "utf8"));
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,MAAM,GAA2B;IACrC,SAAS,EAAE,cAAc;IACzB,MAAM,EAAE,WAAW;IACnB,oEAAoE;IACpE,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,SAAS,eAAe,CAAC,QAAgB;IACvC,iEAAiE;IACjE,mEAAmE;IACnE,uEAAuE;IACvE,uEAAuE;IACvE,gDAAgD;IAChD,mEAAmE;IACnE,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,gDAAgD;QAC7F,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,0CAA0C;QAC7F,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,iCAAiC;KAC3F,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,WAAmB;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,oBAAoB,QAAQ,WAAW,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CAAC,gCAAgC,QAAQ,eAAe,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * `slowcook eval` — 0.19.0-α.17 (closes #19, partial).
+ *
+ * No-regression gate for prompt-changing PRs. Loads frozen fixtures
+ * from `packages/cli/eval/fixtures/<id>/fixture.json`, calls the
+ * relevant `build*Prompt(args)` function from `@slowcook-ai/llm-anthropic`,
+ * and asserts the resulting prompt string contains all of the
+ * fixture's `expected_prompt_includes` substrings and none of its
+ * `expected_prompt_excludes` substrings.
+ *
+ * Why prompt-shape assertions instead of running the LLM against the
+ * fixture: the regression class #19 names ("subtle prompt drift that
+ * drops critical context") is structural. Asserting on construction
+ * shape catches it deterministically without burning Anthropic credit
+ * or introducing nondeterminism into CI. A future fixture-class can
+ * layer LLM-output assertions on top once we have a recorded-replay
+ * shape; today this gate is the cheap, fast, contract-grade floor.
+ *
+ * Discovery model: walks `packages/cli/eval/fixtures/<id>/` directly
+ * by listing subdirectories with a `fixture.json` inside. No central
+ * registry — each fixture is self-describing.
+ */
+export interface Fixture {
+    id: string;
+    agent: string;
+    description: string;
+    captured_from?: {
+        pr?: number;
+        date?: string;
+        context?: string;
+    };
+    input: Record<string, unknown>;
+    expected_prompt_includes: string[];
+    expected_prompt_excludes?: string[];
+}
+export interface FixtureResult {
+    id: string;
+    agent: string;
+    status: "pass" | "fail" | "error";
+    missingIncludes: string[];
+    unexpectedExcludes: string[];
+    errorMessage?: string;
+}
+/**
+ * Resolve the default fixtures directory. Walks up from the CLI's
+ * compiled location to find the `packages/cli/eval/fixtures/` tree.
+ * In tests + local dev the caller passes `--fixtures-dir` directly.
+ */
+export declare function defaultFixturesDir(): string;
+export declare function listFixtureIds(fixturesDir: string): string[];
+export declare function loadFixture(fixturesDir: string, id: string): Fixture;
+export declare function runFixture(f: Fixture): FixtureResult;
+export declare function evalCmd(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/eval/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAmBH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAkHD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAS5D;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAcpE;AA0BD,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAkCpD;AAmBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD3D"}