@slowcook-ai/cli 0.5.2 → 0.6.0

package/dist/commands/brew/prompts.js

@@ -0,0 +1,174 @@
+/**
+ * Prompts + tool definitions for the brew agent loop.
+ *
+ * The agent's one job per turn: make the TARGET red test go green without
+ * regressing any currently-green test. Slowcook (not the agent) runs the test
+ * suite between turns and applies the ratchet. The agent's tools are limited
+ * to reading and writing files, plus one "justify-overflow" tool for when it
+ * needs to break the graduality cap.
+ */
+export const BREW_SYSTEM = `You are the brewing implementer agent for slowcook — a rigorous TDD-first coding harness.
+
+## Your task per turn
+
+You will be told one specific failing test (the **target**). Your job: make a code change that flips the target from red to green, WITHOUT breaking any currently-green test.
+
+After your turn ends, slowcook runs the test suite and applies a mechanical ratchet:
+
+- If any previously-green test now fails → your changes are **reverted entirely**.
+- If the target went green (and no regressions) → your changes become a **checkpoint**.
+- If nothing changed green/red → your changes are **reverted** (no progress = no commit).
+
+This means: **you only keep changes that advance the green set.** Make real progress per turn, not exploratory edits.
+
+## Tools
+
+- **read_file(path)** — read a file from the worktree. Use it before editing.
+- **list_directory(path)** — see what's in a directory.
+- **write_file(path, contents)** — create or fully replace a file. Prefer reading first + writing a complete updated file.
+- **justify_diff_overflow({ reason_category, affected_scope, narrative, proposed_substories_if_split? })** — call ONLY if your intended change must exceed the graduality soft-cap (200 lines across ≤5 files). Explain why.
+
+You do NOT run tests. Slowcook runs them after your turn and tells you the result in the next turn's prompt.
+
+## Constraints
+
+- **One target per turn.** The prompt names ONE failing test. Work on that one. Incidental green flips on other tests are fine but not the goal.
+- **Minimum diff.** Smallest change that flips the target. Don't refactor. Don't anticipate future tests.
+- **Stay within \`allowed_paths\` from the spec.** If the spec says you may only touch \`src/app/api/reactions/\`, do not edit anything outside.
+- **Never modify frozen paths.** \`tests/\`, \`.brewing/\`, \`vitest.config.*\`, \`package.json\` scripts — read them, never write them. Slowcook will mechanically reject any such diff.
+- **Never use \`test.skip\` / \`.todo\` / \`.only\` / environment branches like \`if (NODE_ENV === 'test')\`.** Slowcook's static scan catches these and will reject the turn.
+
+## Output conventions
+
+- Use tools to make changes. Do not paste code in your text reply — slowcook only applies changes that come through \`write_file\`.
+- At the end of your turn, include a one-paragraph **rationale** explaining what you changed and why. Slowcook uses this for halt reports if brewing stalls.
+- If you need more information (read files, list directories), use the read tools first, THEN edit. Don't guess at file contents.
+
+## Failure recovery guidance
+
+- If you receive a prompt showing your previous turn was **reverted**, read the failure reason carefully. Typical causes:
+  1. **Regression** — one of your edits broke a currently-green test. Look at which test; your change touched its dependency.
+  2. **No progress** — your edits didn't change any test outcome. The code path you changed may not be exercised by the target test.
+  3. **Frozen-path violation** — you edited a file you shouldn't have. Don't.
+- On no-progress reverts, consider whether the target test is reachable from the code path you're editing, or whether it's testing a layer your code doesn't touch (e.g., the test calls \`fetch('http://localhost:3000')\` but no server is running).
+`;
+export const BREW_TOOLS = [
+    {
+        name: "read_file",
+        description: "Read a file from the worktree. Returns the file's current contents as a string. Throws if the file doesn't exist.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative path (e.g., 'src/app/api/reactions/route.ts')" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "list_directory",
+        description: "List entries in a directory. Returns an array of { name, type: 'file'|'dir' }. Useful for exploring code structure.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative directory path (e.g., 'src/app/api/reactions/')" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "write_file",
+        description: "Create or fully overwrite a file. Parent directories are created as needed. Returns the number of lines written.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Repo-relative path to write." },
+                contents: { type: "string", description: "Full file contents. This replaces whatever was there before." },
+            },
+            required: ["path", "contents"],
+        },
+    },
+    {
+        name: "justify_diff_overflow",
+        description: "Call ONLY when your proposed change must exceed the graduality soft-cap (200 lines / 5 files). Without this call, an oversized diff is rejected by slowcook.",
+        input_schema: {
+            type: "object",
+            properties: {
+                reason_category: {
+                    type: "string",
+                    enum: ["new_module", "protocol_change", "cross_cutting", "refactor_needed", "other"],
+                },
+                affected_scope: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Paths or directories affected by the overflow.",
+                },
+                narrative: {
+                    type: "string",
+                    description: "Concrete one-paragraph explanation of why the smaller diff isn't viable.",
+                },
+                proposed_substories_if_split: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "If this story should be split, list the sub-stories here.",
+                },
+            },
+            required: ["reason_category", "affected_scope", "narrative"],
+        },
+    },
+];
+/**
+ * Render a single-turn prompt for the agent. Keeps history short (we re-supply
+ * the same system prompt via prompt caching, then hand a fresh turn-state each
+ * iteration; agent doesn't carry over its own previous turns because slowcook
+ * may have reverted them).
+ */
+export function turnPrompt(args) {
+    const sections = [];
+    sections.push(`## Brew iteration ${args.iteration} of ${args.max_iterations}`);
+    sections.push(`**Budget:** $${args.budget_spent_usd.toFixed(2)} spent of $${args.budget_cap_usd.toFixed(2)} cap.`);
+    sections.push("");
+    sections.push("### Target test (flip this one from red to green)");
+    sections.push("```");
+    sections.push(args.target_test_id);
+    sections.push(`   (in ${args.target_test_file})`);
+    sections.push("```");
+    sections.push("");
+    sections.push("### Spec (the contract)");
+    sections.push("```yaml");
+    sections.push(args.spec_yaml.trim());
+    sections.push("```");
+    sections.push("");
+    if (args.allowed_paths.length > 0) {
+        sections.push("### Allowed paths for this story");
+        for (const p of args.allowed_paths)
+            sections.push(`- \`${p}\``);
+        sections.push("");
+    }
+    sections.push(`### Test state going into this turn: ${args.currently_green.length} green / ${args.currently_red.length} red`);
+    sections.push("");
+    if (args.currently_green.length > 0) {
+        sections.push("<details><summary>Currently green (keep them green!)</summary>");
+        sections.push("");
+        for (const t of args.currently_green.slice(0, 30))
+            sections.push(`- \`${t}\``);
+        if (args.currently_green.length > 30) {
+            sections.push(`- … (${args.currently_green.length - 30} more)`);
+        }
+        sections.push("</details>");
+        sections.push("");
+    }
+    if (args.previous_attempts && args.previous_attempts.length > 0) {
+        sections.push("### Your previous attempts on this target");
+        for (const a of args.previous_attempts.slice(-3)) {
+            sections.push(`- **iter ${a.iteration}: ${a.outcome}** — ${a.note}`);
+            if (a.files_touched.length > 0) {
+                sections.push(`  files: ${a.files_touched.map((f) => `\`${f}\``).join(", ")}`);
+            }
+        }
+        sections.push("");
+    }
+    sections.push("### Your turn");
+    sections.push("Use the tools to inspect the code, then write the minimum change that flips the target test. End with a one-paragraph rationale of what you changed and why.");
+    return sections.join("\n");
+}
+//# sourceMappingURL=prompts.js.map

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

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

package/dist/commands/init/templates.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION_FOR_TEMPLATES = "0.5.2";
+export declare const CLI_VERSION_FOR_TEMPLATES = "0.6.0";
 export interface TemplateParams {
     /** CODEOWNERS handle or team (e.g. "@aminazar" or "@acme/frontend"). */
     owner: string;

package/dist/commands/init/templates.js

@@ -1,6 +1,6 @@
 // Static and parameterized file contents written by `slowcook init`.
 // Version is bumped in lockstep with the CLI package.
-export const CLI_VERSION_FOR_TEMPLATES = "0.5.2";
+export const CLI_VERSION_FOR_TEMPLATES = "0.6.0";
 export const SLOWCOOK_CODEOWNERS_MARKER_BEGIN = "# --- slowcook:frozen-paths BEGIN ---";
 export const SLOWCOOK_CODEOWNERS_MARKER_END = "# --- slowcook:frozen-paths END ---";
 export function frozenPathsJson() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -37,9 +37,9 @@
     "@octokit/rest": "^21.0.2",
     "yaml": "^2.6.0",
     "zod": "^3.23.8",
-    "@slowcook-ai/forge-github": "^0.5.0",
     "@slowcook-ai/core": "^0.5.0",
-    "@slowcook-ai/stack-ts": "^0.5.0"
+    "@slowcook-ai/stack-ts": "^0.6.0",
+    "@slowcook-ai/forge-github": "^0.5.0"
   },
   "publishConfig": {
     "access": "public"