@slowcook-ai/cli 0.12.12 → 0.13.0

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.12.12",
+  "version": "0.13.0",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -39,10 +39,10 @@
     "yaml": "^2.6.0",
     "zod": "^3.23.8",
     "@slowcook-ai/core": "^0.11.12",
-    "@slowcook-ai/llm-anthropic": "^0.8.1",
     "@slowcook-ai/stack-ts": "^0.9.6",
-    "@slowcook-ai/recorder": "^0.9.1",
-    "@slowcook-ai/forge-github": "^0.9.7"
+    "@slowcook-ai/llm-anthropic": "^0.8.1",
+    "@slowcook-ai/forge-github": "^0.10.0",
+    "@slowcook-ai/recorder": "^0.9.1"
   },
   "publishConfig": {
     "access": "public"