@slowcook-ai/cli 0.13.0-alpha.3 → 0.13.0

package/dist/commands/sift/index.js

@@ -0,0 +1,314 @@
+/**
+ * `slowcook sift --bug B-N` — bug-flow brew analogue.
+ *
+ * Reads a bug-profile + the regression test, runs an LLM ratchet to
+ * make the regression go green, halts when:
+ *  - regression test passes (green = success)
+ *  - budget cap hit
+ *  - max iterations hit
+ *  - agent halts voluntarily
+ *
+ * Usage:
+ *   slowcook sift --bug B-1 [--cwd <path>] [--model <id>]
+ *                          [--max-iterations <n>] [--budget-usd <n>]
+ *                          [--dry-run]
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { GitHubAdapter } from "@slowcook-ai/forge-github";
+import { runSift } from "./agent.js";
+import { loadBugProfile } from "../recipe-regression/index.js";
+import { validateStackConfig } from "@slowcook-ai/stack-ts";
+function parseArgs(argv) {
+    const args = {
+        bugId: "",
+        repoRoot: process.cwd(),
+        model: "claude-sonnet-4-6", // Sift defaults to Sonnet — narrow fixes shouldn't need Opus.
+        maxIterations: 3,
+        budgetUsd: 0.5,
+        dryRun: false,
+        noPr: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--bug" && next) {
+            args.bugId = normaliseBugId(next);
+            i++;
+        }
+        else if (arg === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (arg === "--model" && next) {
+            args.model = next;
+            i++;
+        }
+        else if ((arg === "--max-iterations" || arg === "--iters") && next) {
+            args.maxIterations = parseInt(next, 10);
+            i++;
+        }
+        else if (arg === "--budget-usd" && next) {
+            args.budgetUsd = parseFloat(next);
+            i++;
+        }
+        else if (arg === "--dry-run") {
+            args.dryRun = true;
+        }
+        else if (arg === "--no-pr") {
+            args.noPr = true;
+        }
+        else if (arg === "--owner" && next) {
+            args.owner = next;
+            i++;
+        }
+        else if (arg === "--repo" && next) {
+            args.repo = next;
+            i++;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return args;
+}
+function normaliseBugId(raw) {
+    const m = raw.trim().match(/^B?-?(\d+)$/i);
+    if (!m || !m[1])
+        return raw;
+    return `B-${m[1]}`;
+}
+function printHelp() {
+    console.log(`
+slowcook sift — narrow red→green ratchet for a bug fix
+
+Reads .brewing/bug-profiles/B-N.yaml + the matching regression test
+under tests/regression/B-N-*.test.ts, runs an LLM agent in a tight
+loop to flip the regression to green with minimum-diff edits scoped
+to the bug profile's fix_scope.
+
+Usage:
+  slowcook sift --bug B-1 [options]
+
+Options:
+  --bug <id>             Bug id (B-N or just N).
+  --cwd <path>           Repo root (default: cwd).
+  --model <id>           LLM model (default: claude-sonnet-4-6).
+  --max-iterations <n>   Max iterations (default: 3).
+  --budget-usd <n>       Spend cap in USD (default: 0.5).
+  --dry-run              Print plan + exit; don't make LLM calls.
+
+Environment:
+  ANTHROPIC_API_KEY (required unless --dry-run)
+  GITHUB_TOKEN      (optional; not used by sift directly today)
+
+Exit codes:
+  0  regression went green
+  1  halted (budget / iters / voluntary halt / no-progress)
+  2  setup error (missing profile / regression test / stack config)
+`);
+}
+export async function sift(argv, cliVersion) {
+    const args = parseArgs(argv);
+    if (!args.bugId) {
+        console.error("slowcook sift: --bug <id> is required");
+        printHelp();
+        process.exit(64);
+    }
+    // Load bug profile + regression test + stack config.
+    let bugProfile;
+    try {
+        bugProfile = loadBugProfile(args.repoRoot, args.bugId);
+    }
+    catch (e) {
+        console.error(`slowcook sift: ${e.message}`);
+        process.exit(2);
+    }
+    const regressionTestPath = findRegressionTestForBug(args.repoRoot, args.bugId);
+    if (!regressionTestPath) {
+        console.error(`slowcook sift: no regression test found at tests/regression/${args.bugId}-*.test.ts. ` +
+            `Run 'slowcook recipe --regression --bug ${args.bugId}' first.`);
+        process.exit(2);
+    }
+    const regressionTestSrc = readFileSync(join(args.repoRoot, regressionTestPath), "utf8");
+    let stackConfig;
+    try {
+        const raw = JSON.parse(readFileSync(join(args.repoRoot, ".brewing/stack.json"), "utf8"));
+        stackConfig = validateStackConfig(raw);
+    }
+    catch (e) {
+        console.error(`slowcook sift: stack.json missing or invalid: ${e.message}`);
+        process.exit(2);
+    }
+    console.error(`slowcook sift (${cliVersion}) — ${args.bugId}, model ${args.model}, max ${args.maxIterations} iter, budget $${args.budgetUsd.toFixed(2)}.`);
+    console.error(`  bug profile : .brewing/bug-profiles/${args.bugId}.yaml`);
+    console.error(`  regression  : ${regressionTestPath}`);
+    console.error(`  fix_scope   : ${bugProfile.fix_scope.join(", ")}`);
+    if (args.dryRun) {
+        console.error("\n(dry-run: would invoke runSift; not making LLM calls)");
+        process.exit(0);
+    }
+    const apiKey = process.env["ANTHROPIC_API_KEY"];
+    if (!apiKey) {
+        console.error("slowcook sift: ANTHROPIC_API_KEY is required");
+        process.exit(78);
+    }
+    const ctx = {
+        repoRoot: args.repoRoot,
+        anthropicApiKey: apiKey,
+        model: args.model,
+        bugProfile,
+        regressionTestPath,
+        regressionTestSrc,
+        stackConfig,
+        maxIterations: args.maxIterations,
+        budgetUsd: args.budgetUsd,
+    };
+    const branchName = `slowcook/sift/${args.bugId}-${Date.now()}`;
+    // Create the branch BEFORE the agent edits so the diff lands on
+    // the sift branch, not on whatever branch was checked out.
+    try {
+        execSync(`git -C "${args.repoRoot}" checkout -b ${branchName}`, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+    }
+    catch (e) {
+        console.error(`slowcook sift: could not create branch ${branchName}: ${e.message}`);
+        process.exit(2);
+    }
+    const result = await runSift(ctx);
+    console.error("");
+    if (result.green) {
+        console.error(`✓ Sift succeeded — regression green after ${result.iterations} iter(s), $${result.spendUsd.toFixed(4)} spent.`);
+        console.error(`  Files touched: ${result.filesTouched.join(", ") || "(none)"}`);
+    }
+    else {
+        console.error(`✗ Sift halted: ${result.haltReason}. ${result.iterations} iter(s), $${result.spendUsd.toFixed(4)} spent.`);
+        if (result.filesTouched.length > 0) {
+            console.error(`  Files touched: ${result.filesTouched.join(", ")}`);
+        }
+    }
+    // Commit + push + open PR even on halt — the operator wants to see
+    // partial progress when sift halts mid-fix. Skipped only on
+    // --no-pr or when no files were edited.
+    if (args.noPr) {
+        console.error(`(--no-pr: branch ${branchName} kept locally; commit/push/PR skipped.)`);
+        process.exit(result.green ? 0 : 1);
+    }
+    if (result.filesTouched.length === 0) {
+        console.error(`(no files edited; nothing to push.)`);
+        process.exit(result.green ? 0 : 1);
+    }
+    await openSiftPr({
+        repoRoot: args.repoRoot,
+        bugId: args.bugId,
+        branchName,
+        profile: bugProfile,
+        result,
+        owner: args.owner,
+        repo: args.repo,
+        cliVersion,
+    });
+    process.exit(result.green ? 0 : 1);
+}
+async function openSiftPr(args) {
+    const githubToken = process.env["GITHUB_TOKEN"];
+    if (!githubToken) {
+        console.error(`GITHUB_TOKEN not set — branch ${args.branchName} kept locally with edits but PR not opened.`);
+        return;
+    }
+    const detected = detectOwnerRepo(args.repoRoot);
+    const owner = args.owner ?? detected?.owner;
+    const repo = args.repo ?? detected?.repo;
+    if (!owner || !repo) {
+        console.error("Could not detect owner/repo from git remote — pass --owner + --repo to open the PR.");
+        return;
+    }
+    const forge = new GitHubAdapter({ owner, repo, token: githubToken });
+    try {
+        // Stage all touched files + commit + push.
+        for (const f of args.result.filesTouched) {
+            await forge.git.stage(f);
+        }
+        await forge.git.commit(`slowcook sift ${args.result.green ? "✓" : "(partial)"} ${args.bugId}: ${args.result.iterations} iter(s) · $${args.result.spendUsd.toFixed(2)}`);
+        await forge.git.push(args.branchName);
+    }
+    catch (e) {
+        console.error(`Push failed: ${e.message}. Branch is local; commit/push manually.`);
+        return;
+    }
+    try {
+        const titlePrefix = args.result.green ? "sift ✓" : "sift (partial)";
+        const pr = await forge.createPullRequest({
+            title: `${titlePrefix} ${args.bugId}: ${args.profile.title}`,
+            body: buildSiftPrBody(args),
+            base: "main",
+            head: args.branchName,
+            draft: !args.result.green,
+            labels: ["slowcook-sift", "bug"],
+        });
+        console.error(`Opened PR ${pr.url}.`);
+    }
+    catch (e) {
+        console.error(`Pushed branch ${args.branchName} but PR open failed: ${e.message}\n  Open manually at https://github.com/${owner}/${repo}/pull/new/${args.branchName}`);
+    }
+}
+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 null;
+}
+function buildSiftPrBody(args) {
+    const lines = [];
+    lines.push(`Auto-emitted by \`slowcook sift\` (${args.cliVersion}) for bug profile \`${args.bugId}\`.`);
+    lines.push("");
+    lines.push(`Closes related: ${args.profile.source_issue}`);
+    lines.push("");
+    lines.push("## Result");
+    lines.push(`- **${args.result.green ? "Regression GREEN" : "Halted: " + (args.result.haltReason ?? "(unknown)")}**`);
+    lines.push(`- Iterations: ${args.result.iterations}`);
+    lines.push(`- Spend: $${args.result.spendUsd.toFixed(4)}`);
+    lines.push(`- Files: ${args.result.filesTouched.map((f) => "`" + f + "`").join(", ") || "(none)"}`);
+    lines.push("");
+    lines.push("## Bug profile (summary)");
+    lines.push(`**Symptom:** ${args.profile.symptom.join(" / ")}`);
+    lines.push("");
+    lines.push(`**Failure locus:** \`${args.profile.failure_locus.file}\`${args.profile.failure_locus.line ? `:${args.profile.failure_locus.line}` : ""}`);
+    lines.push(`> ${args.profile.failure_locus.diagnosis.split("\n").join("\n> ")}`);
+    lines.push("");
+    lines.push("## Verification");
+    lines.push(`Sift's ratchet ran the regression test (\`tests/regression/${args.bugId}-*.test.ts\`) after each iteration; ` +
+        `it ${args.result.green ? "passed on iteration " + args.result.iterations : "remained red — see haltReason"}.`);
+    return lines.join("\n");
+}
+/**
+ * Find the regression test file for a bug. Looks for
+ * `tests/regression/B-N-<slug>.test.ts` (matching what
+ * recipe --regression emits).
+ */
+export function findRegressionTestForBug(repoRoot, bugId) {
+    const dir = join(repoRoot, "tests/regression");
+    if (!existsSync(dir))
+        return null;
+    const prefix = `${bugId}-`;
+    for (const entry of readdirSync(dir)) {
+        if (entry.startsWith(prefix) && entry.endsWith(".test.ts")) {
+            return `tests/regression/${entry}`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/sift/prompts.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Prompts for the `slowcook sift` agent.
+ *
+ * Sift is the bug-flow analogue of brew. Where brew is exploratory
+ * and ratchets across many iterations to flip many tests green, sift
+ * is **narrow**: one bug, one regression test, minimum-diff fix.
+ *
+ * The system prompt has a different orientation from brew's:
+ *  - "the regression test is the contract" (not "the spec")
+ *  - "the bug profile names the failure locus — go there first"
+ *  - "touch the named file and nothing else; halt voluntarily if
+ *    the fix needs more"
+ *  - "this is restoration, not feature work — match existing patterns
+ *    instead of inventing"
+ */
+export declare const SIFT_SYSTEM = "You are the sift agent for slowcook \u2014 a TDD-first bug-fix flow.\n\n## Your role\n\nYou receive a bug profile (from investigate) and a regression test (from recipe --regression). The regression test is currently RED against the codebase. Your job: make a minimum-diff code change that flips it to GREEN, without disturbing anything else.\n\nYou are NOT brew. Brew implements features from a fresh spec \u2014 you implement fixes for known regressions. Different posture:\n\n- **The regression test IS the contract.** You don't read the spec; you read the test. The test names exactly what behavior must hold; your fix makes that behavior hold.\n- **The bug profile names the failure locus.** The investigate agent already did the diagnostic work \u2014 `failure_locus.file`, `.line`, `.function`, `.diagnosis`. Trust that. Open the file, find the named function, see why the test is failing.\n- **Stay inside fix_scope.** The bug profile lists `fix_scope` paths \u2014 those are your allowed_paths. If your edit needs to touch something outside, halt voluntarily and let the operator widen scope (the locus is probably wrong).\n- **Restoration, not invention.** Match the patterns already in the file. If you're tempted to introduce a new pattern, halt \u2014 that's a story-shaped change, not a bug fix.\n- **Minimum diff.** Bug fixes that look like refactors are bug fixes that have lost the plot. If your diff is more than ~30 lines across more than 2 files, you've drifted. Halt.\n\n## Tools\n\n- **read_file(path)** \u2014 read a file in full.\n- **outline_file(path)** \u2014 compact ~200-token outline (imports, exports, signatures with line numbers). Use first.\n- **list_directory(path)** \u2014 see what's in a dir.\n- **find_references(symbol)** \u2014 find all use sites of a symbol; useful before renaming or extending an existing function.\n- **find_definition(symbol)** \u2014 find where a symbol is declared.\n- **grep(pattern, glob?)** \u2014 repo-wide ripgrep.\n- **write_file(path, contents)** \u2014 replace a file with new contents. Read first, then write the COMPLETE updated contents.\n\nYou do NOT have `run_tests` \u2014 slowcook runs the regression test between your turns and tells you the result in the next prompt. Your only output per turn is read calls + at most one write call.\n\n## Halting voluntarily\n\nIf after one turn of investigation the fix doesn't look minimum-diff\nwithin the bug profile's `fix_scope`, end your turn with:\n\n```\n<halt>\n<reason>One-line reason \u2014 e.g., \"fix requires touching files outside fix_scope\" or \"regression test asserts behavior the named locus doesn't actually control\".</reason>\n</halt>\n```\n\nThe operator picks up your halt, edits the bug profile or widens the scope, and re-runs sift. **Don't guess.** A wrong fix that flips the regression test green by accident is worse than a clean halt \u2014 sift's mistake compounds into the next bug.\n\n## Iteration limits\n\nDefault budget: 3 iterations, ~$0.50 spend cap. The harness halts you automatically beyond that. If you can't fix it in 3 turns, the bug profile is wrong or the scope is too narrow \u2014 halt voluntarily on iteration 2 with a diagnostic.\n";
+/**
+ * Anthropic-shape tool definitions sift presents to the LLM. Subset
+ * of brew's: read tools + write_file. Excludes brew's
+ * \`justify_diff_overflow\` (sift halts instead of overflowing) and
+ * \`find_handler\` (sift's failure locus is already named).
+ */
+export declare const SIFT_TOOLS: ({
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: {
+            path: {
+                type: "string";
+                description: string;
+            };
+            symbol?: undefined;
+            pattern?: undefined;
+            glob?: undefined;
+            contents?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: {
+            symbol: {
+                type: "string";
+                description: string;
+            };
+            path?: undefined;
+            pattern?: undefined;
+            glob?: undefined;
+            contents?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: {
+            pattern: {
+                type: "string";
+                description: string;
+            };
+            glob: {
+                type: "string";
+                description: string;
+            };
+            path?: undefined;
+            symbol?: undefined;
+            contents?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: {
+            path: {
+                type: "string";
+                description: string;
+            };
+            contents: {
+                type: "string";
+                description: string;
+            };
+            symbol?: undefined;
+            pattern?: undefined;
+            glob?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export interface SiftTurnPromptArgs {
+    iteration: number;
+    maxIterations: number;
+    bugProfileYaml: string;
+    regressionTestPath: string;
+    regressionTestSrc: string;
+    /** Latest test run result. Empty on iter 1. */
+    testResult?: {
+        status: "red" | "green";
+        /** Vitest failure message for the regression test (when red). */
+        failureMessage?: string;
+    };
+    /** Files sift has touched in prior iters. Empty on iter 1. */
+    priorEdits?: string[];
+}
+export declare function buildSiftTurnPrompt(args: SiftTurnPromptArgs): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/commands/sift/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/commands/sift/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,WAAW,moGA0CvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwFtB,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;QACxB,iEAAiE;QACjE,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CA4CpE"}

package/dist/commands/sift/prompts.js

@@ -0,0 +1,193 @@
+/**
+ * Prompts for the `slowcook sift` agent.
+ *
+ * Sift is the bug-flow analogue of brew. Where brew is exploratory
+ * and ratchets across many iterations to flip many tests green, sift
+ * is **narrow**: one bug, one regression test, minimum-diff fix.
+ *
+ * The system prompt has a different orientation from brew's:
+ *  - "the regression test is the contract" (not "the spec")
+ *  - "the bug profile names the failure locus — go there first"
+ *  - "touch the named file and nothing else; halt voluntarily if
+ *    the fix needs more"
+ *  - "this is restoration, not feature work — match existing patterns
+ *    instead of inventing"
+ */
+export const SIFT_SYSTEM = `You are the sift agent for slowcook — a TDD-first bug-fix flow.
+
+## Your role
+
+You receive a bug profile (from investigate) and a regression test (from recipe --regression). The regression test is currently RED against the codebase. Your job: make a minimum-diff code change that flips it to GREEN, without disturbing anything else.
+
+You are NOT brew. Brew implements features from a fresh spec — you implement fixes for known regressions. Different posture:
+
+- **The regression test IS the contract.** You don't read the spec; you read the test. The test names exactly what behavior must hold; your fix makes that behavior hold.
+- **The bug profile names the failure locus.** The investigate agent already did the diagnostic work — \`failure_locus.file\`, \`.line\`, \`.function\`, \`.diagnosis\`. Trust that. Open the file, find the named function, see why the test is failing.
+- **Stay inside fix_scope.** The bug profile lists \`fix_scope\` paths — those are your allowed_paths. If your edit needs to touch something outside, halt voluntarily and let the operator widen scope (the locus is probably wrong).
+- **Restoration, not invention.** Match the patterns already in the file. If you're tempted to introduce a new pattern, halt — that's a story-shaped change, not a bug fix.
+- **Minimum diff.** Bug fixes that look like refactors are bug fixes that have lost the plot. If your diff is more than ~30 lines across more than 2 files, you've drifted. Halt.
+
+## Tools
+
+- **read_file(path)** — read a file in full.
+- **outline_file(path)** — compact ~200-token outline (imports, exports, signatures with line numbers). Use first.
+- **list_directory(path)** — see what's in a dir.
+- **find_references(symbol)** — find all use sites of a symbol; useful before renaming or extending an existing function.
+- **find_definition(symbol)** — find where a symbol is declared.
+- **grep(pattern, glob?)** — repo-wide ripgrep.
+- **write_file(path, contents)** — replace a file with new contents. Read first, then write the COMPLETE updated contents.
+
+You do NOT have \`run_tests\` — slowcook runs the regression test between your turns and tells you the result in the next prompt. Your only output per turn is read calls + at most one write call.
+
+## Halting voluntarily
+
+If after one turn of investigation the fix doesn't look minimum-diff
+within the bug profile's \`fix_scope\`, end your turn with:
+
+\`\`\`
+<halt>
+<reason>One-line reason — e.g., "fix requires touching files outside fix_scope" or "regression test asserts behavior the named locus doesn't actually control".</reason>
+</halt>
+\`\`\`
+
+The operator picks up your halt, edits the bug profile or widens the scope, and re-runs sift. **Don't guess.** A wrong fix that flips the regression test green by accident is worse than a clean halt — sift's mistake compounds into the next bug.
+
+## Iteration limits
+
+Default budget: 3 iterations, ~$0.50 spend cap. The harness halts you automatically beyond that. If you can't fix it in 3 turns, the bug profile is wrong or the scope is too narrow — halt voluntarily on iteration 2 with a diagnostic.
+`;
+/**
+ * Anthropic-shape tool definitions sift presents to the LLM. Subset
+ * of brew's: read tools + write_file. Excludes brew's
+ * \`justify_diff_overflow\` (sift halts instead of overflowing) and
+ * \`find_handler\` (sift's failure locus is already named).
+ */
+export const SIFT_TOOLS = [
+    {
+        name: "read_file",
+        description: "Read a file's full contents. Always read before write_file on the same path.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative path." },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "outline_file",
+        description: "Compact outline (imports, top-level exports, signatures with line numbers). Use first to scope.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative path." },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "list_directory",
+        description: "List entries in a directory.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative path." },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "find_references",
+        description: "All use sites of a symbol across the repo (file:line entries).",
+        input_schema: {
+            type: "object",
+            properties: {
+                symbol: { type: "string", description: "Identifier name." },
+            },
+            required: ["symbol"],
+        },
+    },
+    {
+        name: "find_definition",
+        description: "Where a symbol is declared.",
+        input_schema: {
+            type: "object",
+            properties: {
+                symbol: { type: "string", description: "Identifier name." },
+            },
+            required: ["symbol"],
+        },
+    },
+    {
+        name: "grep",
+        description: "Repo-wide ripgrep. Use when find_references is too narrow (e.g. searching column names in SQL files).",
+        input_schema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "Pattern to search." },
+                glob: {
+                    type: "string",
+                    description: "Optional glob (e.g., 'supabase/migrations/*.sql').",
+                },
+            },
+            required: ["pattern"],
+        },
+    },
+    {
+        name: "write_file",
+        description: "Create or fully replace a file. ALWAYS read first, then write the complete updated contents. Restricted to paths inside the bug profile's fix_scope.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative path." },
+                contents: { type: "string", description: "Full new file contents." },
+            },
+            required: ["path", "contents"],
+        },
+    },
+];
+export function buildSiftTurnPrompt(args) {
+    const lines = [];
+    lines.push(`# Sift iteration ${args.iteration} of ${args.maxIterations}`);
+    lines.push("");
+    lines.push("## Bug profile");
+    lines.push("```yaml");
+    lines.push(args.bugProfileYaml);
+    lines.push("```");
+    lines.push("");
+    lines.push("## Regression test (the contract)");
+    lines.push(`File: \`${args.regressionTestPath}\``);
+    lines.push("```ts");
+    lines.push(args.regressionTestSrc);
+    lines.push("```");
+    lines.push("");
+    if (args.testResult) {
+        if (args.testResult.status === "green") {
+            lines.push("## Last run: GREEN");
+            lines.push("");
+            lines.push("The regression test now passes. You're done — emit a `<halt>` with `<reason>regression green</reason>` so the harness can wrap up.");
+        }
+        else {
+            lines.push("## Last run: RED");
+            if (args.testResult.failureMessage) {
+                lines.push("```");
+                lines.push(args.testResult.failureMessage.slice(0, 1500));
+                lines.push("```");
+            }
+            else {
+                lines.push("(no failure message captured — run the regression file by hand to see why)");
+            }
+        }
+        lines.push("");
+    }
+    if (args.priorEdits && args.priorEdits.length > 0) {
+        lines.push("## Prior edits this run");
+        for (const e of args.priorEdits)
+            lines.push(`- \`${e}\``);
+        lines.push("");
+    }
+    lines.push("## Your turn");
+    lines.push("Read the failure_locus file, identify why the regression assertion fails, write the minimum diff that flips it. Stay inside fix_scope. Halt voluntarily if the fix needs more.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompts.js.map

package/dist/commands/sift/prompts.js.map

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