@slowcook-ai/cli 0.16.0-alpha.4 → 0.17.0-alpha.1

package/dist/commands/preview/ssh.js

@@ -0,0 +1,99 @@
+/**
+ * Thin shell wrappers around `ssh` + `scp` so deploy/teardown can talk
+ * to the consumer's box without pulling in a JS ssh library.
+ *
+ * Why shell out: ops people debug `ssh` + `scp` invocations daily; if a
+ * deploy fails, the failing command is something they can copy + paste.
+ * Pulling in a JS library for marginal API ergonomics adds a maintenance
+ * surface for a feature that's already box-specific.
+ *
+ * All wrappers use BatchMode=yes (no interactive password prompts) and
+ * StrictHostKeyChecking=accept-new (first connect adds the key, future
+ * connects verify against it). Failures throw with stderr captured so
+ * the workflow logs surface the underlying error.
+ */
+import { spawnSync } from "node:child_process";
+/**
+ * Standard ssh options: non-interactive, accept-new host keys, dedicated
+ * key file. Returns the array form spawnSync wants.
+ */
+function sshArgs(target, extra) {
+    return [
+        "-i", target.keyPath,
+        "-p", String(target.port),
+        "-o", "BatchMode=yes",
+        "-o", "StrictHostKeyChecking=accept-new",
+        "-o", "ConnectTimeout=15",
+        `${target.user}@${target.host}`,
+        ...extra,
+    ];
+}
+/**
+ * Run a remote command via ssh. Throws on non-zero exit with the
+ * captured stderr inlined into the error message.
+ */
+export function sshExec(target, command) {
+    const result = spawnSync("ssh", sshArgs(target, [command]), {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    if (result.error) {
+        throw new Error(`ssh spawn failed: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`ssh exited ${result.status} for command:\n  ${command}\nstderr:\n${(result.stderr || "").trim()}`);
+    }
+    return { stdout: result.stdout || "", stderr: result.stderr || "" };
+}
+/**
+ * scp a local file to a remote path. Throws on non-zero exit.
+ */
+export function scpUpload(target, localPath, remotePath) {
+    const result = spawnSync("scp", [
+        "-i", target.keyPath,
+        "-P", String(target.port),
+        "-o", "BatchMode=yes",
+        "-o", "StrictHostKeyChecking=accept-new",
+        "-o", "ConnectTimeout=15",
+        localPath,
+        `${target.user}@${target.host}:${remotePath}`,
+    ], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+    if (result.error) {
+        throw new Error(`scp spawn failed: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`scp exited ${result.status} uploading ${localPath} → ${target.user}@${target.host}:${remotePath}\nstderr:\n${(result.stderr || "").trim()}`);
+    }
+}
+/**
+ * Find the first free TCP port in [lo, hi] on the remote box. Uses
+ * `ss -ltn` (universally available on modern Linux) to enumerate
+ * already-bound ports.
+ *
+ * Returns the chosen port. Throws if every port in the range is in use.
+ */
+export function pickRemotePort(target, lo, hi) {
+    const cmd = `ss -ltn 'sport = :0' 2>/dev/null | awk 'NR>1 {split($4,a,":"); print a[length(a)]}' | sort -un`;
+    const { stdout } = sshExec(target, cmd);
+    const used = new Set(stdout
+        .split("\n")
+        .map((s) => parseInt(s.trim(), 10))
+        .filter((n) => !Number.isNaN(n)));
+    for (let p = lo; p <= hi; p++) {
+        if (!used.has(p))
+            return p;
+    }
+    throw new Error(`No free port in range ${lo}..${hi} on ${target.host}. Increase port_range or teardown stale containers.`);
+}
+/**
+ * Get the host port a running container is publishing to (the value
+ * after `0.0.0.0:` in `docker port` output). Returns null if the
+ * container isn't running or doesn't publish 3100.
+ */
+export function getContainerPort(target, containerName) {
+    const cmd = `docker port ${containerName} 3100/tcp 2>/dev/null || true`;
+    const { stdout } = sshExec(target, cmd);
+    const m = stdout.trim().match(/:(\d+)\s*$/m);
+    return m ? parseInt(m[1], 10) : null;
+}
+//# sourceMappingURL=ssh.js.map

package/dist/commands/preview/ssh.js.map

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

package/dist/commands/preview/teardown.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `slowcook preview teardown --pr <n>` — 0.16.0-α.5.
+ *
+ * Removes the running container + cleans up the staging directory for
+ * a given PR. Idempotent — running it twice is fine. Updates the PR
+ * comment to reflect the teardown.
+ *
+ * Triggered by the slowcook-preview-teardown.yml workflow on
+ * `pull_request: closed`. Safe to also run manually via
+ * workflow_dispatch when a stale container needs purging.
+ */
+interface ParsedArgs {
+    pr: number | undefined;
+    repoRoot: string;
+    keyPath: string | undefined;
+    owner: string | undefined;
+    repo: string | undefined;
+    /** Also remove the docker image (frees disk on the box). Default: keep image for fast redeploy. */
+    pruneImage: boolean;
+    dryRun: boolean;
+}
+export declare function parseTeardownArgs(argv: string[]): ParsedArgs;
+export declare function teardown(argv: string[], cliVersion: string): Promise<void>;
+export {};
+//# sourceMappingURL=teardown.d.ts.map

package/dist/commands/preview/teardown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teardown.d.ts","sourceRoot":"","sources":["../../../src/commands/preview/teardown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,mGAAmG;IACnG,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsB5D;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DhF"}

package/dist/commands/preview/teardown.js

@@ -0,0 +1,164 @@
+/**
+ * `slowcook preview teardown --pr <n>` — 0.16.0-α.5.
+ *
+ * Removes the running container + cleans up the staging directory for
+ * a given PR. Idempotent — running it twice is fine. Updates the PR
+ * comment to reflect the teardown.
+ *
+ * Triggered by the slowcook-preview-teardown.yml workflow on
+ * `pull_request: closed`. Safe to also run manually via
+ * workflow_dispatch when a stale container needs purging.
+ */
+import { execSync } from "node:child_process";
+import { readPreviewConfig, containerNameForPr, imageTagForPr, remoteDirForPr, } from "./config.js";
+import { sshExec } from "./ssh.js";
+export function parseTeardownArgs(argv) {
+    const args = {
+        pr: undefined,
+        repoRoot: process.cwd(),
+        keyPath: undefined,
+        owner: undefined,
+        repo: undefined,
+        pruneImage: false,
+        dryRun: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--pr" && next) {
+            args.pr = parseInt(next, 10);
+            i++;
+        }
+        else if (a === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (a === "--ssh-key" && next) {
+            args.keyPath = next;
+            i++;
+        }
+        else if (a === "--owner" && next) {
+            args.owner = next;
+            i++;
+        }
+        else if (a === "--repo" && next) {
+            args.repo = next;
+            i++;
+        }
+        else if (a === "--prune-image") {
+            args.pruneImage = true;
+        }
+        else if (a === "--dry-run") {
+            args.dryRun = true;
+        }
+    }
+    return args;
+}
+export async function teardown(argv, cliVersion) {
+    const parsed = parseTeardownArgs(argv);
+    if (!parsed.pr || Number.isNaN(parsed.pr)) {
+        console.error("--pr <number> is required.");
+        process.exit(64);
+    }
+    const cfg = readPreviewConfig(parsed.repoRoot);
+    const containerName = containerNameForPr(parsed.pr);
+    const imageTag = imageTagForPr(parsed.pr);
+    const remoteDir = remoteDirForPr(cfg, parsed.pr);
+    if (parsed.dryRun) {
+        console.log(`slowcook preview teardown · pr ${parsed.pr} (dry-run)`);
+        console.log(`  would: docker rm -f ${containerName}`);
+        console.log(`  would: rm -rf ${remoteDir}`);
+        if (parsed.pruneImage) {
+            console.log(`  would: docker rmi ${imageTag}`);
+        }
+        return;
+    }
+    const keyPath = parsed.keyPath ?? process.env["SLOWCOOK_PREVIEW_SSH_KEY_PATH"];
+    if (!keyPath) {
+        console.error("SSH key path not provided. Pass --ssh-key <path> or set SLOWCOOK_PREVIEW_SSH_KEY_PATH.");
+        process.exit(2);
+    }
+    const target = {
+        host: cfg.host,
+        user: cfg.user,
+        port: cfg.port,
+        keyPath,
+    };
+    console.log(`slowcook preview teardown · pr ${parsed.pr} → ${cfg.user}@${cfg.host}`);
+    console.log(`  ssh    docker rm -f ${containerName}`);
+    sshExec(target, `docker rm -f ${shellQuote(containerName)} 2>/dev/null || true`);
+    if (parsed.pruneImage) {
+        console.log(`  ssh    docker rmi ${imageTag}`);
+        sshExec(target, `docker rmi ${shellQuote(imageTag)} 2>/dev/null || true`);
+    }
+    console.log(`  ssh    rm -rf ${remoteDir}`);
+    sshExec(target, `rm -rf ${shellQuote(remoteDir)}`);
+    // Update the PR comment to indicate teardown.
+    const githubToken = process.env["GITHUB_TOKEN"];
+    const owner = parsed.owner ?? detectOwner(parsed.repoRoot);
+    const repo = parsed.repo ?? detectRepo(parsed.repoRoot);
+    if (githubToken && owner && repo) {
+        await markCommentTornDown({
+            owner, repo, pr: parsed.pr, githubToken, cliVersion,
+        });
+    }
+    else {
+        console.log(`  (skipped PR comment: no GITHUB_TOKEN or unknown owner/repo)`);
+    }
+    console.log(`Done. Preview for PR #${parsed.pr} is offline.`);
+}
+const PREVIEW_COMMENT_MARKER = "<!-- slowcook-preview-deploy -->";
+async function markCommentTornDown(args) {
+    const { Octokit } = await import("@octokit/rest");
+    const octokit = new Octokit({ auth: args.githubToken });
+    const list = await octokit.rest.issues.listComments({
+        owner: args.owner,
+        repo: args.repo,
+        issue_number: args.pr,
+        per_page: 100,
+    });
+    const existing = list.data.find((c) => c.body?.includes(PREVIEW_COMMENT_MARKER));
+    if (!existing)
+        return;
+    const body = [
+        PREVIEW_COMMENT_MARKER,
+        `## 🍳 Mockup preview torn down`,
+        ``,
+        `The preview container for PR #${args.pr} has been removed (PR closed).`,
+        ``,
+        `_Torn down by \`slowcook preview teardown@${args.cliVersion}\`._`,
+    ].join("\n");
+    await octokit.rest.issues.updateComment({
+        owner: args.owner,
+        repo: args.repo,
+        comment_id: existing.id,
+        body,
+    });
+    console.log(`  pr     comment ${existing.id} marked torn-down`);
+}
+function detectOwner(repoRoot) {
+    return detectOwnerRepo(repoRoot)?.owner;
+}
+function detectRepo(repoRoot) {
+    return detectOwnerRepo(repoRoot)?.repo;
+}
+function detectOwnerRepo(repoRoot) {
+    try {
+        const url = execSync("git remote get-url origin", {
+            cwd: repoRoot,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const m = url.match(/github\.com[:/]([^/]+)\/([^/.]+)(?:\.git)?$/);
+        if (m && m[1] && m[2])
+            return { owner: m[1], repo: m[2] };
+    }
+    catch {
+        // not a git repo
+    }
+    return undefined;
+}
+function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=teardown.js.map

package/dist/commands/preview/teardown.js.map

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

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

@@ -0,0 +1,60 @@
+/**
+ * `slowcook recon` — 0.17.6 — structural backstop after refine + history-aware
+ * vibe + testgen + plate + brew. Pure deterministic; no LLM.
+ *
+ * Runs as a CI pre-step in slowcook-brew-auto.yml (after both mockup PR
+ * + tests PR are merged, BEFORE brew dispatch). Catches residual vibe ⇄
+ * testgen divergence by comparing names + prop shapes + testid hooks.
+ *
+ * Output: `.brewing/recon-result.json` + a PR comment with the renaming
+ * map and any escalations.
+ *
+ * Exit codes:
+ *   0 — clean (or only "warn" issues; brew can proceed)
+ *   2 — `STORY_HISTORY_CONFLICT` or `VIBE_RECIPE_NAME_DRIFT` — escalates
+ *       to PM via PR comment; brew should NOT dispatch
+ *
+ * What recon checks:
+ *   1. Test imports → file exists in mock + src/
+ *   2. Test prop usage → matches mock's component signature
+ *   3. Testid selectors in tests → present in mock JSX
+ *   4. Brownfield safety: rename target collides with EXISTING prod
+ *      component covered by ANOTHER story's tests
+ */
+import { type HistoryIndex } from "../refine/history-index.js";
+interface RenameProposal {
+    kind: "component" | "import_path";
+    from: string;
+    to: string;
+    reason: string;
+    rename_safe: boolean;
+    blocker?: string;
+}
+interface TestidGap {
+    selector: string;
+    queried_by: string[];
+    in_mock: boolean;
+}
+interface StructuralGap {
+    kind: "missing_component" | "missing_route" | "prop_shape_mismatch" | "story_history_conflict";
+    test: string;
+    detail: string;
+    recommendation: string;
+}
+export interface ReconResult {
+    story: string;
+    generated_at: string;
+    generator: "slowcook-recon@0.17.6";
+    status: "clean" | "rename_needed" | "escalate";
+    renames: RenameProposal[];
+    testid_gaps: TestidGap[];
+    structural_gaps: StructuralGap[];
+    history_index_components: number;
+    warnings: string[];
+}
+export declare function recon(argv: string[], _cliVersion: string): Promise<void>;
+export declare function findStoryTestFiles(repoRoot: string, story: string): string[];
+export declare function extractImports(body: string): string[];
+export declare function extractTestids(body: string): string[];
+export type { HistoryIndex };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/recon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAalF,UAAU,cAAc;IACtB,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,mBAAmB,GAAG,eAAe,GAAG,qBAAqB,GAAG,wBAAwB,CAAC;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,UAAU,CAAC;IAC/C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAqDD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkH9E;AAID,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAU5E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrD;AA8CD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/commands/recon/index.js

@@ -0,0 +1,278 @@
+/**
+ * `slowcook recon` — 0.17.6 — structural backstop after refine + history-aware
+ * vibe + testgen + plate + brew. Pure deterministic; no LLM.
+ *
+ * Runs as a CI pre-step in slowcook-brew-auto.yml (after both mockup PR
+ * + tests PR are merged, BEFORE brew dispatch). Catches residual vibe ⇄
+ * testgen divergence by comparing names + prop shapes + testid hooks.
+ *
+ * Output: `.brewing/recon-result.json` + a PR comment with the renaming
+ * map and any escalations.
+ *
+ * Exit codes:
+ *   0 — clean (or only "warn" issues; brew can proceed)
+ *   2 — `STORY_HISTORY_CONFLICT` or `VIBE_RECIPE_NAME_DRIFT` — escalates
+ *       to PM via PR comment; brew should NOT dispatch
+ *
+ * What recon checks:
+ *   1. Test imports → file exists in mock + src/
+ *   2. Test prop usage → matches mock's component signature
+ *   3. Testid selectors in tests → present in mock JSX
+ *   4. Brownfield safety: rename target collides with EXISTING prod
+ *      component covered by ANOTHER story's tests
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { buildHistoryIndex } from "../refine/history-index.js";
+function parseArgs(argv) {
+    const args = {
+        story: "",
+        repoRoot: process.cwd(),
+        outPath: "",
+        verbose: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--story" && next) {
+            args.story = next;
+            i++;
+        }
+        else if (a === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (a === "--out" && next) {
+            args.outPath = next;
+            i++;
+        }
+        else if (a === "--verbose" || a === "-v") {
+            args.verbose = true;
+        }
+        else if (a === "--help" || a === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    if (!args.story) {
+        console.error("--story <id> is required.");
+        printHelp();
+        process.exit(64);
+    }
+    if (!args.outPath) {
+        args.outPath = join(args.repoRoot, ".brewing/recon-result.json");
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook recon — pre-brew structural divergence check (0.17.6+)
+
+Compares the story's test files against the mock + src/ tree. Detects:
+  - Tests importing non-existent components (vibe ⇄ testgen name drift)
+  - Tests asserting on testids the mock doesn't render
+  - Renames that would break OTHER stories' tests (brownfield safety)
+
+Usage:
+  slowcook recon --story <id> [--cwd <path>] [--out <path>] [--verbose]
+
+Options:
+  --story <id>   Story id (e.g. 017). Required.
+  --cwd <path>   Repo root (default: cwd).
+  --out <path>   Output JSON path (default: .brewing/recon-result.json).
+  --verbose      Print detailed breakdown to stdout.
+
+Exit codes:
+  0  status=clean OR status=rename_needed (recommendations only)
+  2  status=escalate (STORY_HISTORY_CONFLICT or VIBE_RECIPE_NAME_DRIFT)
+`);
+}
+export async function recon(argv, _cliVersion) {
+    const args = parseArgs(argv);
+    console.log(`slowcook recon · story-${args.story} · cwd: ${relative(process.cwd(), args.repoRoot) || "."}`);
+    const idx = buildHistoryIndex({ repoRoot: args.repoRoot });
+    const result = {
+        story: args.story,
+        generated_at: new Date().toISOString(),
+        generator: "slowcook-recon@0.17.6",
+        status: "clean",
+        renames: [],
+        testid_gaps: [],
+        structural_gaps: [],
+        history_index_components: idx.components.length,
+        warnings: [],
+    };
+    // Find this story's test files
+    const testFiles = findStoryTestFiles(args.repoRoot, args.story);
+    if (testFiles.length === 0) {
+        result.warnings.push(`No test files found for story-${args.story} under tests/integration/`);
+    }
+    for (const testRel of testFiles) {
+        const testAbs = join(args.repoRoot, testRel);
+        const body = readFileSync(testAbs, "utf8");
+        const imports = extractImports(body);
+        const testids = extractTestids(body);
+        // Check 1: every test import → file exists somewhere reachable
+        for (const imp of imports) {
+            const resolved = resolveImport(args.repoRoot, imp);
+            if (!resolved) {
+                // Not in src/ or mock/ — it's a missing component
+                // Search history-index for a near-match by name
+                const compName = imp.split("/").pop() ?? "";
+                const nearMatch = idx.components.find((c) => c.name === compName);
+                if (nearMatch) {
+                    result.structural_gaps.push({
+                        kind: "missing_component",
+                        test: testRel,
+                        detail: `Test imports "${imp}" — file not found. Closest match in history-index: ${nearMatch.name} at ${nearMatch.file}.`,
+                        recommendation: `Either rename mock/src/components to match "${compName}" OR /refine to use the existing name.`,
+                    });
+                }
+                else {
+                    result.structural_gaps.push({
+                        kind: "missing_component",
+                        test: testRel,
+                        detail: `Test imports "${imp}" — file not found anywhere. No near-match in history-index.`,
+                        recommendation: `Either vibe should add this component OR /refine to drop the assertion.`,
+                    });
+                }
+            }
+        }
+        // Check 2: testid selectors found in tests → assert mock has them
+        // (Light check — full check requires DOM render; this just greps mock files for the testid string.)
+        for (const tid of testids) {
+            const present = testidPresentInMock(args.repoRoot, tid);
+            if (!present) {
+                const existing = result.testid_gaps.find((g) => g.selector === tid);
+                if (existing) {
+                    if (!existing.queried_by.includes(testRel))
+                        existing.queried_by.push(testRel);
+                }
+                else {
+                    result.testid_gaps.push({ selector: tid, queried_by: [testRel], in_mock: false });
+                }
+            }
+        }
+    }
+    // Check 3: brownfield safety — for each component name in mock that
+    // doesn't appear in src/, check whether RENAMING the mock would break
+    // a different story's tests.
+    // (This is a heavier check; skip for v1. Recorded as a TODO.)
+    result.warnings.push("brownfield-rename-safety check is not yet implemented in 0.17.6 (recorded by simulation; defer to 0.17.7)");
+    // Decide status
+    if (result.structural_gaps.length > 0) {
+        result.status = "escalate";
+    }
+    else if (result.testid_gaps.length > 0 || result.renames.length > 0) {
+        result.status = "rename_needed";
+    }
+    else {
+        result.status = "clean";
+    }
+    // Write output
+    mkdirSync(dirname(args.outPath), { recursive: true });
+    writeFileSync(args.outPath, JSON.stringify(result, null, 2), "utf8");
+    // Print summary
+    console.log(`  status: ${result.status.toUpperCase()}`);
+    console.log(`  ${testFiles.length} test file(s) · ${result.structural_gaps.length} structural gap(s) · ${result.testid_gaps.length} testid gap(s) · ${result.renames.length} rename(s)`);
+    if (args.verbose || result.status === "escalate") {
+        for (const g of result.structural_gaps) {
+            console.log(`  ! ${g.kind}: ${g.detail}`);
+            console.log(`      → ${g.recommendation}`);
+        }
+        for (const t of result.testid_gaps) {
+            console.log(`  ? testid "${t.selector}" missing in mock; queried by ${t.queried_by.length} test(s)`);
+        }
+    }
+    console.log(`  wrote ${relative(args.repoRoot, args.outPath) || args.outPath}`);
+    if (result.status === "escalate") {
+        console.error("\nrecon escalation: structural gaps prevent brew from converging. Fix before dispatching brew.");
+        process.exit(2);
+    }
+}
+// ----- helpers -----
+export function findStoryTestFiles(repoRoot, story) {
+    const dir = join(repoRoot, "tests/integration");
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const name of readdirSync(dir)) {
+        if (!name.startsWith(`story-${story}`))
+            continue;
+        if (!/\.test\.(ts|tsx)$/.test(name))
+            continue;
+        out.push(`tests/integration/${name}`);
+    }
+    return out;
+}
+export function extractImports(body) {
+    const out = [];
+    for (const m of body.matchAll(/import[^"']*from\s+["']([^"']+)["']/g)) {
+        if (m[1] && (m[1].startsWith("@/") || m[1].startsWith(".")))
+            out.push(m[1]);
+    }
+    return [...new Set(out)];
+}
+export function extractTestids(body) {
+    const out = [];
+    for (const m of body.matchAll(/data-testid\s*=\s*["']([^"']+)["']/g)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    for (const m of body.matchAll(/getByTestId\s*\(\s*["']([^"']+)["']/g)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    for (const m of body.matchAll(/data-testid="([^"]+)"/g)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    return [...new Set(out)];
+}
+function resolveImport(repoRoot, imp) {
+    // @/foo → src/foo or mock/src/foo
+    if (imp.startsWith("@/")) {
+        const rel = imp.slice(2);
+        const candidates = [
+            `src/${rel}.ts`,
+            `src/${rel}.tsx`,
+            `src/${rel}/index.ts`,
+            `src/${rel}/index.tsx`,
+            `mock/src/${rel}.ts`,
+            `mock/src/${rel}.tsx`,
+            `mock/src/${rel}/index.ts`,
+            `mock/src/${rel}/index.tsx`,
+        ];
+        for (const c of candidates) {
+            if (existsSync(join(repoRoot, c)))
+                return c;
+        }
+    }
+    return null;
+}
+function testidPresentInMock(repoRoot, testid) {
+    // Walk mock/src/ + look for the literal testid string
+    const dir = join(repoRoot, "mock/src");
+    if (!existsSync(dir))
+        return false;
+    return walkAndGrep(dir, testid);
+}
+function walkAndGrep(dir, needle) {
+    for (const name of readdirSync(dir)) {
+        if (name.startsWith(".") || name === "node_modules")
+            continue;
+        const full = join(dir, name);
+        const st = statSync(full);
+        if (st.isDirectory()) {
+            if (walkAndGrep(full, needle))
+                return true;
+        }
+        else if (/\.(tsx?|jsx?)$/.test(name)) {
+            const body = readFileSync(full, "utf8");
+            if (body.includes(`"${needle}"`) || body.includes(`'${needle}'`))
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map