@slowcook-ai/cli 0.12.12 → 0.13.0

package/dist/commands/recipe-regression/index.js

@@ -0,0 +1,187 @@
+/**
+ * `slowcook recipe --regression --bug B-<n>` — emits a regression
+ * test from a bug-profile.
+ *
+ * **Status: alpha.3a**. Stub-only emitter: writes a deterministic
+ * vitest skeleton at `tests/regression/B-<n>-<slug>.test.ts` that
+ * asserts via `expect.fail()` so the test is red until sift replaces
+ * the body with real assertions (alpha.4) or alpha.3b upgrades this
+ * emitter to write real tests via an LLM agent.
+ *
+ * The skeleton structure is what sift expects to see:
+ *  - one `describe` named for the bug id + title
+ *  - one `it` per regression_assertion line
+ *  - body of each `it` calls `expect.fail(...)` referencing the bug
+ *    profile so the failure message points the operator at the right
+ *    artefact when the test runs.
+ *
+ * Usage:
+ *   slowcook recipe --regression --bug B-1 [--cwd <path>]
+ *
+ * Internally invoked from the CLI's `recipe`/`testgen` dispatch when
+ * `--regression` is present (see cli.ts wiring).
+ */
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { validateBugProfile } from "../investigate/schema.js";
+import { parseSimpleYaml } from "../investigate/agent.js";
+import { runRegressionRecipe } from "./agent.js";
+export function parseRecipeRegressionArgs(argv) {
+    const args = {
+        bugId: "",
+        repoRoot: process.cwd(),
+        dryRun: false,
+        useLlm: false,
+        model: "claude-sonnet-4-6",
+    };
+    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 === "--dry-run") {
+            args.dryRun = true;
+        }
+        else if (arg === "--llm") {
+            args.useLlm = true;
+        }
+        else if (arg === "--model" && next) {
+            args.model = next;
+            i++;
+        }
+    }
+    return args;
+}
+/**
+ * Accept "1", "B-1", or "B1" and normalise to "B-<n>".
+ */
+export function normaliseBugId(raw) {
+    const m = raw.trim().match(/^B?-?(\d+)$/i);
+    if (!m || !m[1])
+        return raw;
+    return `B-${m[1]}`;
+}
+export async function recipeRegression(argv, cliVersion) {
+    const args = parseRecipeRegressionArgs(argv);
+    if (!args.bugId) {
+        console.error("slowcook recipe --regression: --bug <id> is required");
+        process.exit(64);
+    }
+    const profile = loadBugProfile(args.repoRoot, args.bugId);
+    const slug = slugFromTitle(profile.title);
+    const relPath = `tests/regression/${profile.bug_id}-${slug}.test.ts`;
+    let contents;
+    if (args.useLlm) {
+        const apiKey = process.env["ANTHROPIC_API_KEY"];
+        if (!apiKey) {
+            console.error("slowcook recipe --regression --llm: ANTHROPIC_API_KEY required (or omit --llm for the stub emitter)");
+            process.exit(78);
+        }
+        console.error(`slowcook recipe --regression (${cliVersion}) — LLM mode (model ${args.model}) for ${profile.bug_id}.`);
+        const result = await runRegressionRecipe({
+            repoRoot: args.repoRoot,
+            anthropicApiKey: apiKey,
+            model: args.model,
+            bugProfile: profile,
+            cliVersion,
+        });
+        console.error(`Agent done: ${result.rounds} round(s), $${result.spendUsd.toFixed(4)} spent.`);
+        if (!result.emitted) {
+            console.error(`slowcook recipe --regression: agent halted. ${result.haltReason ?? "(no reason)"}`);
+            process.exit(1);
+        }
+        contents = result.testContents ?? "";
+    }
+    else {
+        const file = renderRegressionStub(profile, cliVersion);
+        contents = file.contents;
+    }
+    if (args.dryRun) {
+        console.log(contents);
+        console.error(`\n(dry-run: would write ${relPath})`);
+        return;
+    }
+    const fullPath = join(args.repoRoot, relPath);
+    mkdirSync(join(args.repoRoot, "tests/regression"), { recursive: true });
+    writeFileSync(fullPath, contents, "utf8");
+    console.error(`Wrote ${relPath}${args.useLlm ? " (LLM-emitted)" : " (alpha.3a stub — sift will replace expect.fail bodies)"}.`);
+}
+function slugFromTitle(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+export function loadBugProfile(repoRoot, bugId) {
+    const path = join(repoRoot, ".brewing/bug-profiles", `${bugId}.yaml`);
+    if (!existsSync(path)) {
+        throw new Error(`bug profile not found: ${path}. Run 'slowcook investigate --issue <n>' first.`);
+    }
+    const raw = parseSimpleYaml(readFileSync(path, "utf8"));
+    const validation = validateBugProfile(raw);
+    if (!validation.ok) {
+        throw new Error(`bug profile at ${path} is invalid:\n  ${validation.errors.join("\n  ")}`);
+    }
+    return validation.profile;
+}
+/**
+ * Build the stub regression test for a bug profile. Deterministic —
+ * same profile → same file. Sift overwrites with real assertions in
+ * alpha.4; alpha.3b will replace this stub emitter with an LLM-written
+ * real test.
+ */
+export function renderRegressionStub(profile, cliVersion) {
+    const slug = slugify(profile.title);
+    const path = `tests/regression/${profile.bug_id}-${slug}.test.ts`;
+    const lines = [];
+    lines.push(`// slowcook ${cliVersion} regression test — ${profile.bug_id}`);
+    lines.push(`//`);
+    lines.push(`// Bug profile: .brewing/bug-profiles/${profile.bug_id}.yaml`);
+    lines.push(`// Source issue: ${profile.source_issue}`);
+    lines.push(`// Failure locus: ${profile.failure_locus.file}${profile.failure_locus.line ? `:${profile.failure_locus.line}` : ""}`);
+    lines.push(`//`);
+    lines.push(`// alpha.3a stub: each \`it\` block calls expect.fail(...) so the`);
+    lines.push(`// test is red against current code. Sift (alpha.4) replaces the`);
+    lines.push(`// body with real assertions that exercise the regression. Once`);
+    lines.push(`// alpha.3b ships an LLM-backed emitter, this comment header goes`);
+    lines.push(`// away and the body is real from the start.`);
+    lines.push(``);
+    lines.push(`import { describe, it, expect } from "vitest";`);
+    lines.push(``);
+    lines.push(`describe(${jsonString(`${profile.bug_id} regression — ${profile.title}`)}, () => {`);
+    for (let i = 0; i < profile.regression_assertion.length; i++) {
+        const assertion = profile.regression_assertion[i] ?? "";
+        lines.push(`  it(${jsonString(assertion)}, () => {`);
+        lines.push(`    // Diagnosis: ${oneLine(profile.failure_locus.diagnosis)}`);
+        lines.push(`    // Expected: ${oneLine(profile.expected[0] ?? "(not specified)")}`);
+        lines.push(`    // alpha.3a stub — sift / alpha.3b replaces this body.`);
+        lines.push(`    expect.fail(${jsonString(`Regression test stub for ${profile.bug_id}. See .brewing/bug-profiles/${profile.bug_id}.yaml. Sift will replace this body once it lands.`)});`);
+        lines.push(`  });`);
+        if (i < profile.regression_assertion.length - 1)
+            lines.push(``);
+    }
+    lines.push(`});`);
+    lines.push(``);
+    return { path, contents: lines.join("\n") };
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+function oneLine(s) {
+    return s.split("\n").join(" ").trim();
+}
+function jsonString(s) {
+    return JSON.stringify(s);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/recipe-regression/index.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * Sift agent loop. Narrow red→green ratchet for bug fixes.
+ *
+ * Mirrors brew's iter loop in shape but smaller in every dimension:
+ *  - max 3 iterations (vs brew's 10)
+ *  - $0.50 budget cap (vs brew's $10)
+ *  - allowed_paths restricted to bug-profile.fix_scope
+ *  - test-runner is scoped to the regression test only
+ *  - no story manifest; the contract is just the regression test
+ *
+ * **Status: alpha.4a**. Single-iteration loop with no ratchet/revert.
+ * Iteration loop + multi-turn ratchet ships in alpha.4b alongside
+ * a brew/sift shared-engine refactor.
+ */
+import { type StackConfig, type RunResult } from "@slowcook-ai/stack-ts";
+import { type BugProfile } from "../investigate/schema.js";
+export interface SiftContext {
+    repoRoot: string;
+    anthropicApiKey: string;
+    model: string;
+    bugProfile: BugProfile;
+    /** Repo-relative path to the regression test file. */
+    regressionTestPath: string;
+    /** Read once at construction; passed through prompts. */
+    regressionTestSrc: string;
+    stackConfig: StackConfig;
+    /** Hard cap (seconds spend); default 3. */
+    maxIterations: number;
+    /** USD spend cap; default 0.5. */
+    budgetUsd: number;
+    now?: () => Date;
+}
+export interface SiftResult {
+    /** True when the regression test ended green. */
+    green: boolean;
+    /** Total iterations the agent took. */
+    iterations: number;
+    /** Total spend in USD. */
+    spendUsd: number;
+    /** Files written across the run. */
+    filesTouched: string[];
+    /** When green=false, why the run ended (`budget`, `iters`, `halt:<reason>`, etc.). */
+    haltReason?: string;
+    /** Last test result for diagnostics. */
+    lastTestResult: RunResult | null;
+}
+export declare function runSift(ctx: SiftContext): Promise<SiftResult>;
+export declare function isInFixScope(path: string, fixScope: ReadonlyArray<string>): boolean;
+export declare function regressionStatus(result: RunResult, regressionPath: string): "red" | "green";
+export declare function regressionFailureMessage(result: RunResult, regressionPath: string): string | undefined;
+export declare function parseHalt(text: string): string | null;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/commands/sift/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,sDAAsD;IACtD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,SAAS,GAAG,IAAI,CAAC;CAClC;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqInE;AAwJD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,OAAO,CAWT;AAMD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,GACrB,KAAK,GAAG,OAAO,CAWjB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,SAAS,CAKpB;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrD"}

package/dist/commands/sift/agent.js

@@ -0,0 +1,392 @@
+/**
+ * Sift agent loop. Narrow red→green ratchet for bug fixes.
+ *
+ * Mirrors brew's iter loop in shape but smaller in every dimension:
+ *  - max 3 iterations (vs brew's 10)
+ *  - $0.50 budget cap (vs brew's $10)
+ *  - allowed_paths restricted to bug-profile.fix_scope
+ *  - test-runner is scoped to the regression test only
+ *  - no story manifest; the contract is just the regression test
+ *
+ * **Status: alpha.4a**. Single-iteration loop with no ratchet/revert.
+ * Iteration loop + multi-turn ratchet ships in alpha.4b alongside
+ * a brew/sift shared-engine refactor.
+ */
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, mkdirSync, } from "node:fs";
+import { dirname, resolve, isAbsolute } from "node:path";
+import { execSync } from "node:child_process";
+import Anthropic from "@anthropic-ai/sdk";
+import { validateStackConfig, runTests, } from "@slowcook-ai/stack-ts";
+import { outlineFile } from "../brew/agent.js";
+import { findReferences, findDefinition, renderReferences, } from "../brew/retrieval.js";
+import { SIFT_SYSTEM, SIFT_TOOLS, buildSiftTurnPrompt } from "./prompts.js";
+const MAX_ROUNDS_PER_ITER = 8;
+const MAX_FILE_READ_BYTES = 20000;
+export async function runSift(ctx) {
+    const anthropic = new Anthropic({ apiKey: ctx.anthropicApiKey });
+    const filesTouched = new Set();
+    let spendUsd = 0;
+    let lastTestResult = null;
+    const priorEdits = [];
+    for (let iter = 1; iter <= ctx.maxIterations; iter++) {
+        if (spendUsd >= ctx.budgetUsd) {
+            return {
+                green: false,
+                iterations: iter - 1,
+                spendUsd,
+                filesTouched: [...filesTouched],
+                haltReason: `budget (spent $${spendUsd.toFixed(4)} of $${ctx.budgetUsd})`,
+                lastTestResult,
+            };
+        }
+        const turnPrompt = buildSiftTurnPrompt({
+            iteration: iter,
+            maxIterations: ctx.maxIterations,
+            bugProfileYaml: bugProfileToYamlSummary(ctx.bugProfile),
+            regressionTestPath: ctx.regressionTestPath,
+            regressionTestSrc: ctx.regressionTestSrc,
+            testResult: lastTestResult
+                ? {
+                    status: regressionStatus(lastTestResult, ctx.regressionTestPath),
+                    failureMessage: regressionFailureMessage(lastTestResult, ctx.regressionTestPath),
+                }
+                : undefined,
+            priorEdits,
+        });
+        const messages = [
+            { role: "user", content: turnPrompt },
+        ];
+        let haltReason = null;
+        let editsThisTurn = 0;
+        for (let round = 0; round < MAX_ROUNDS_PER_ITER; round++) {
+            const response = await anthropic.messages.create({
+                model: ctx.model,
+                max_tokens: 4096,
+                system: SIFT_SYSTEM,
+                tools: SIFT_TOOLS,
+                messages,
+            });
+            spendUsd += costUsd(response, ctx.model);
+            // Look for <halt> in any text block.
+            for (const block of response.content) {
+                if (block.type === "text") {
+                    const halt = parseHalt(block.text);
+                    if (halt !== null)
+                        haltReason = halt;
+                }
+            }
+            if (haltReason !== null)
+                break;
+            const toolUses = response.content.filter((b) => b.type === "tool_use");
+            if (response.stop_reason !== "tool_use" || toolUses.length === 0)
+                break;
+            const toolResults = toolUses.map((t) => {
+                const result = executeTool(ctx, t);
+                if (result.touched) {
+                    filesTouched.add(result.touched);
+                    editsThisTurn += 1;
+                }
+                return {
+                    type: "tool_result",
+                    tool_use_id: t.id,
+                    content: result.content,
+                    is_error: result.is_error,
+                };
+            });
+            messages.push({ role: "assistant", content: response.content });
+            messages.push({ role: "user", content: toolResults });
+        }
+        if (haltReason !== null) {
+            return {
+                green: haltReason.toLowerCase().includes("regression green"),
+                iterations: iter,
+                spendUsd,
+                filesTouched: [...filesTouched],
+                haltReason: `halt:${haltReason}`,
+                lastTestResult,
+            };
+        }
+        if (editsThisTurn === 0) {
+            return {
+                green: false,
+                iterations: iter,
+                spendUsd,
+                filesTouched: [...filesTouched],
+                haltReason: "agent made no edits this iteration",
+                lastTestResult,
+            };
+        }
+        priorEdits.push(...[...filesTouched].slice(priorEdits.length));
+        // Run the regression test scoped to the bug's test file.
+        lastTestResult = runTests(ctx.stackConfig, {
+            cwd: ctx.repoRoot,
+            scopeFiles: [ctx.regressionTestPath],
+        });
+        const status = regressionStatus(lastTestResult, ctx.regressionTestPath);
+        if (status === "green") {
+            return {
+                green: true,
+                iterations: iter,
+                spendUsd,
+                filesTouched: [...filesTouched],
+                lastTestResult,
+            };
+        }
+    }
+    return {
+        green: false,
+        iterations: ctx.maxIterations,
+        spendUsd,
+        filesTouched: [...filesTouched],
+        haltReason: `iters (${ctx.maxIterations} reached without green)`,
+        lastTestResult,
+    };
+}
+function executeTool(ctx, tool) {
+    const input = tool.input;
+    try {
+        switch (tool.name) {
+            case "read_file":
+                return readFile(ctx.repoRoot, String(input["path"] ?? ""));
+            case "outline_file":
+                return outlineCmd(ctx.repoRoot, String(input["path"] ?? ""));
+            case "list_directory":
+                return listDir(ctx.repoRoot, String(input["path"] ?? ""));
+            case "find_references": {
+                const symbol = String(input["symbol"] ?? "").trim();
+                if (!symbol)
+                    return { content: "symbol is required", is_error: true };
+                const refs = findReferences(ctx.repoRoot, symbol, { excludeDefinitions: false });
+                return { content: renderReferences(refs), is_error: false };
+            }
+            case "find_definition": {
+                const symbol = String(input["symbol"] ?? "").trim();
+                if (!symbol)
+                    return { content: "symbol is required", is_error: true };
+                const def = findDefinition(ctx.repoRoot, symbol);
+                if (!def)
+                    return { content: `(no declaration found for ${symbol})`, is_error: false };
+                return {
+                    content: `${def.kind} | ${def.file}:${def.line}:${def.column} | ${def.context}`,
+                    is_error: false,
+                };
+            }
+            case "grep":
+                return runGrep(ctx.repoRoot, String(input["pattern"] ?? ""), input["glob"] ? String(input["glob"]) : undefined);
+            case "write_file":
+                return writeFile(ctx, String(input["path"] ?? ""), String(input["contents"] ?? ""));
+            default:
+                return { content: `Unknown tool: ${tool.name}`, is_error: true };
+        }
+    }
+    catch (e) {
+        return { content: `Tool error: ${e.message}`, is_error: true };
+    }
+}
+function readFile(repoRoot, p) {
+    if (!isPathSafe(repoRoot, p))
+        return { content: `Path escape forbidden: ${p}`, is_error: true };
+    const full = resolve(repoRoot, p);
+    if (!existsSync(full))
+        return { content: `File not found: ${p}`, is_error: true };
+    if (!statSync(full).isFile())
+        return { content: `Not a file: ${p}`, is_error: true };
+    const txt = readFileSync(full, "utf8");
+    return {
+        content: txt.length > MAX_FILE_READ_BYTES
+            ? txt.slice(0, MAX_FILE_READ_BYTES) + "\n…(truncated)"
+            : txt,
+        is_error: false,
+    };
+}
+function outlineCmd(repoRoot, p) {
+    if (!isPathSafe(repoRoot, p))
+        return { content: `Path escape forbidden: ${p}`, is_error: true };
+    const full = resolve(repoRoot, p);
+    if (!existsSync(full))
+        return { content: `File not found: ${p}`, is_error: true };
+    if (!statSync(full).isFile())
+        return { content: `Not a file: ${p}`, is_error: true };
+    const txt = readFileSync(full, "utf8");
+    return { content: outlineFile(p, txt), is_error: false };
+}
+function listDir(repoRoot, p) {
+    if (!isPathSafe(repoRoot, p))
+        return { content: `Path escape forbidden: ${p}`, is_error: true };
+    const full = resolve(repoRoot, p);
+    if (!existsSync(full))
+        return { content: `Not found: ${p}`, is_error: true };
+    if (!statSync(full).isDirectory())
+        return { content: `Not a directory: ${p}`, is_error: true };
+    const entries = readdirSync(full, { withFileTypes: true })
+        .map((e) => `${e.name}${e.isDirectory() ? "/" : ""}`)
+        .sort()
+        .join("\n");
+    return { content: entries, is_error: false };
+}
+function writeFile(ctx, p, contents) {
+    if (!isPathSafe(ctx.repoRoot, p)) {
+        return { content: `Path escape forbidden: ${p}`, is_error: true };
+    }
+    if (!isInFixScope(p, ctx.bugProfile.fix_scope)) {
+        return {
+            content: `${p} is outside the bug profile's fix_scope (${ctx.bugProfile.fix_scope.join(", ")}). Halt voluntarily and ask the operator to widen scope.`,
+            is_error: true,
+        };
+    }
+    const full = resolve(ctx.repoRoot, p);
+    mkdirSync(dirname(full), { recursive: true });
+    writeFileSync(full, contents, "utf8");
+    return {
+        content: `Wrote ${contents.split("\n").length} lines to ${p}`,
+        is_error: false,
+        touched: p,
+    };
+}
+function runGrep(repoRoot, pattern, glob) {
+    if (!pattern)
+        return { content: "pattern is required", is_error: true };
+    const safePattern = pattern.replace(/'/g, "'\\''");
+    const cmd = glob
+        ? `rg --line-number --max-count=50 -e '${safePattern}' --glob '${glob.replace(/'/g, "'\\''")}'`
+        : `rg --line-number --max-count=50 -e '${safePattern}'`;
+    try {
+        const out = execSync(cmd, {
+            cwd: repoRoot,
+            stdio: ["ignore", "pipe", "pipe"],
+            maxBuffer: 1024 * 256,
+            encoding: "utf8",
+        });
+        if (!out.trim())
+            return { content: "(no matches)", is_error: false };
+        return {
+            content: out.length > MAX_FILE_READ_BYTES
+                ? out.slice(0, MAX_FILE_READ_BYTES) + "\n…(truncated)"
+                : out,
+            is_error: false,
+        };
+    }
+    catch (e) {
+        const exit = e.status;
+        if (exit === 1)
+            return { content: "(no matches)", is_error: false };
+        return { content: `grep error: ${e.message}`, is_error: true };
+    }
+}
+function isPathSafe(repoRoot, relPath) {
+    if (isAbsolute(relPath))
+        return false;
+    const resolved = resolve(repoRoot, relPath);
+    return resolved.startsWith(resolve(repoRoot));
+}
+export function isInFixScope(path, fixScope) {
+    if (fixScope.length === 0)
+        return false;
+    const norm = path.replace(/^\.\/+/, "");
+    for (const scope of fixScope) {
+        const s = scope.replace(/^\.\/+/, "");
+        if (norm === s)
+            return true;
+        // Directory prefix match (with or without trailing slash).
+        const sDir = s.endsWith("/") ? s : `${s}/`;
+        if (norm.startsWith(sDir))
+            return true;
+    }
+    return false;
+}
+// -------------------------------------------------------------------------
+// Test-result helpers
+// -------------------------------------------------------------------------
+export function regressionStatus(result, regressionPath) {
+    // Sift owns the regression test file; consider its tests only. If
+    // any are red OR errored, status is red.
+    const ours = result.tests.filter((t) => t.file.endsWith(regressionPath));
+    if (ours.length === 0) {
+        // Vitest may have crashed before reporting; treat as red.
+        return "red";
+    }
+    return ours.every((t) => t.status === "passed" || t.status === "skipped")
+        ? "green"
+        : "red";
+}
+export function regressionFailureMessage(result, regressionPath) {
+    const ours = result.tests.filter((t) => t.file.endsWith(regressionPath) && t.status !== "passed");
+    return ours[0]?.failure_message;
+}
+// -------------------------------------------------------------------------
+// Halt block parsing
+// -------------------------------------------------------------------------
+export function parseHalt(text) {
+    const m = text.match(/<halt>[\s\S]*?<reason>([\s\S]*?)<\/reason>[\s\S]*?<\/halt>/);
+    if (m && m[1])
+        return m[1].trim();
+    // Fallback: simple <halt>reason</halt>.
+    const fallback = text.match(/<halt>([\s\S]*?)<\/halt>/);
+    return fallback ? (fallback[1] ?? "").trim() : null;
+}
+// -------------------------------------------------------------------------
+// Cost accounting (mirrors investigate's; same pricing table)
+// -------------------------------------------------------------------------
+const PRICING_PER_M_TOKENS = {
+    "claude-opus-4-7": { input: 15, output: 75 },
+    "claude-sonnet-4-6": { input: 3, output: 15 },
+    "claude-sonnet-4-5": { input: 3, output: 15 },
+    "claude-haiku-4-5": { input: 1, output: 5 },
+};
+function costUsd(response, model) {
+    const pricing = PRICING_PER_M_TOKENS[model] ??
+        Object.entries(PRICING_PER_M_TOKENS).find(([k]) => model.startsWith(k))?.[1];
+    if (!pricing)
+        return 0;
+    const usage = response.usage;
+    const input = usage?.input_tokens ?? 0;
+    const output = usage?.output_tokens ?? 0;
+    const cacheRead = usage?.cache_read_input_tokens ?? 0;
+    const cacheCreate = usage?.cache_creation_input_tokens ?? 0;
+    const effectiveInput = input + cacheRead * 0.1 + cacheCreate * 1.25;
+    return (effectiveInput / 1_000_000) * pricing.input + (output / 1_000_000) * pricing.output;
+}
+// -------------------------------------------------------------------------
+// Bug profile rendering (compact YAML for prompt — full schema in
+// .brewing/bug-profiles/B-N.yaml; we only need the fields sift cares
+// about, kept compact to save tokens).
+// -------------------------------------------------------------------------
+function bugProfileToYamlSummary(p) {
+    const lines = [];
+    lines.push(`bug_id: ${p.bug_id}`);
+    lines.push(`title: ${JSON.stringify(p.title)}`);
+    lines.push(`source_issue: "${p.source_issue}"`);
+    if (p.symptom.length > 0) {
+        lines.push(`symptom:`);
+        for (const s of p.symptom)
+            lines.push(`  - ${JSON.stringify(s)}`);
+    }
+    if (p.expected.length > 0) {
+        lines.push(`expected:`);
+        for (const s of p.expected)
+            lines.push(`  - ${JSON.stringify(s)}`);
+    }
+    lines.push(`failure_locus:`);
+    lines.push(`  file: ${JSON.stringify(p.failure_locus.file)}`);
+    if (p.failure_locus.line !== undefined)
+        lines.push(`  line: ${p.failure_locus.line}`);
+    if (p.failure_locus.function !== undefined) {
+        lines.push(`  function: ${JSON.stringify(p.failure_locus.function)}`);
+    }
+    lines.push(`  diagnosis: |`);
+    for (const l of p.failure_locus.diagnosis.split("\n"))
+        lines.push(`    ${l}`);
+    if (p.regression_assertion.length > 0) {
+        lines.push(`regression_assertion:`);
+        for (const s of p.regression_assertion)
+            lines.push(`  - ${JSON.stringify(s)}`);
+    }
+    if (p.fix_scope.length > 0) {
+        lines.push(`fix_scope:`);
+        for (const s of p.fix_scope)
+            lines.push(`  - ${JSON.stringify(s)}`);
+    }
+    return lines.join("\n");
+}
+void validateStackConfig;
+//# sourceMappingURL=agent.js.map