@slowcook-ai/cli 0.4.4 → 0.4.6

package/dist/commands/testgen/index.js

@@ -0,0 +1,173 @@
+import { execSync } from "node:child_process";
+import { GitHubAdapter } from "@slowcook-ai/forge-github";
+import { AnthropicClient } from "../refine/llm.js";
+import { runTestgen } from "./agent.js";
+function parseArgs(argv) {
+    const args = {
+        specId: null,
+        all: false,
+        repoRoot: process.cwd(),
+        baseBranch: "main",
+        model: "claude-opus-4-7",
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--spec" && next) {
+            args.specId = next;
+            i++;
+        }
+        else if (arg === "--all") {
+            args.all = true;
+        }
+        else if (arg === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (arg === "--owner" && next) {
+            args.owner = next;
+            i++;
+        }
+        else if (arg === "--repo" && next) {
+            args.repo = next;
+            i++;
+        }
+        else if (arg === "--base" && next) {
+            args.baseBranch = next;
+            i++;
+        }
+        else if (arg === "--model" && next) {
+            args.model = next;
+            i++;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    // Default: operate on all active specs lacking tests
+    if (!args.specId)
+        args.all = true;
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook testgen — generate Vitest integration tests from merged specs
+
+Runs over active specs that lack test files and produces a single draft PR
+containing:
+  - tests/integration/story-N.test.ts  (Vitest, HTTP-style integration)
+  - .brewing/manifests/story-N.json    (the frozen test manifest for N)
+
+If any spec has \`supersedes: [X, Y]\`, the old tests/manifests for X and Y
+are removed in the same PR; \`override-freeze\` is auto-applied because the
+supersede chain in the spec provides the audit trail.
+
+Usage:
+  slowcook testgen [--spec <id>] [--all] [options]
+
+Options:
+  --spec <id>      Generate tests for a specific story id (re-runs even if
+                   tests exist).
+  --all            Generate tests for every active spec that lacks them.
+                   (Default when --spec is not set.)
+  --cwd <path>     Repo working directory (default: .)
+  --owner <login>  Repo owner (default: from \`git remote get-url origin\`)
+  --repo <name>    Repo name (default: from \`git remote get-url origin\`)
+  --base <branch>  Base branch for the tests PR (default: main)
+  --model <id>     LLM model (default: claude-opus-4-7)
+  --help, -h       Show this help
+
+Environment:
+  ANTHROPIC_API_KEY   (required)  Anthropic API key
+  GITHUB_TOKEN        (required)  GitHub token with contents/pull-requests write
+
+Exit codes:
+  0   outcome reached (PR opened, or nothing to generate)
+  2   script error (bad args, missing env, network failure)
+`);
+}
+function detectOwnerRepo(cwd) {
+    try {
+        const url = execSync("git remote get-url origin", {
+            cwd,
+            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;
+}
+export async function testgen(argv, cliVersion) {
+    const args = parseArgs(argv);
+    const anthropicKey = process.env["ANTHROPIC_API_KEY"];
+    if (!anthropicKey) {
+        console.error("ANTHROPIC_API_KEY environment variable is not set.");
+        process.exit(2);
+    }
+    const githubToken = process.env["GITHUB_TOKEN"];
+    if (!githubToken) {
+        console.error("GITHUB_TOKEN environment variable is not set.");
+        process.exit(2);
+    }
+    let owner = args.owner;
+    let repo = args.repo;
+    if (!owner || !repo) {
+        const detected = detectOwnerRepo(args.repoRoot);
+        if (!detected) {
+            console.error("Could not detect owner/repo from git remote. Pass --owner and --repo explicitly.");
+            process.exit(2);
+        }
+        owner = owner ?? detected.owner;
+        repo = repo ?? detected.repo;
+    }
+    const forge = new GitHubAdapter({ owner, repo, token: githubToken });
+    const llm = new AnthropicClient(anthropicKey);
+    const branchName = args.specId
+        ? `slowcook/tests/story-${args.specId}`
+        : `slowcook/tests/batch-${Date.now()}`;
+    const ctx = {
+        repoRoot: args.repoRoot,
+        forge,
+        llm,
+        model: args.model,
+        cliVersion,
+        baseBranch: args.baseBranch,
+        all: args.all,
+        specId: args.specId,
+        branchName,
+        now: new Date(),
+    };
+    console.log(`slowcook testgen · ${args.specId ? `story-${args.specId}` : "all active specs"} on ${owner}/${repo}`);
+    try {
+        const outcome = await runTestgen(ctx);
+        switch (outcome.kind) {
+            case "tests-emitted":
+                console.log(`Tests written for ${outcome.storyIds.map((s) => `story-${s}`).join(", ")}`);
+                if (outcome.removedStoryIds.length > 0) {
+                    console.log(`Removed superseded tests: ${outcome.removedStoryIds.map((s) => `story-${s}`).join(", ")}`);
+                }
+                console.log(`Draft PR: ${outcome.prUrl}`);
+                break;
+            case "nothing-to-generate":
+                console.log(`Noop: ${outcome.reason}.`);
+                break;
+            case "pr-creation-blocked":
+                console.log(`Tests committed and pushed to branch '${outcome.branchName}', but PR creation was blocked (403). Enable "Allow GitHub Actions to create and approve pull requests" and re-run, or open the PR manually.`);
+                process.exit(2);
+        }
+    }
+    catch (e) {
+        console.error(`testgen failed: ${e.message}`);
+        if (process.env["SLOWCOOK_DEBUG"]) {
+            console.error(e);
+        }
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * System prompt for the test-gen agent. Takes a frozen spec as input; emits a
+ * single Vitest integration test file.
+ *
+ * The agent does NOT read the consumer's src/. It tests the spec's contract,
+ * not the implementation. HTTP-style integration tests (fetch the API, assert
+ * on the response) are preferred because they don't need the implementation
+ * to exist at test-collection time — they fail at runtime if the endpoint is
+ * missing, which is exactly the "red test" state brewing wants.
+ */
+export declare const TESTGEN_SYSTEM: (projectContext: string) => string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/commands/testgen/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,WA0CwK,CAAC"}

package/dist/commands/testgen/prompts.js

@@ -0,0 +1,54 @@
+/**
+ * System prompt for the test-gen agent. Takes a frozen spec as input; emits a
+ * single Vitest integration test file.
+ *
+ * The agent does NOT read the consumer's src/. It tests the spec's contract,
+ * not the implementation. HTTP-style integration tests (fetch the API, assert
+ * on the response) are preferred because they don't need the implementation
+ * to exist at test-collection time — they fail at runtime if the endpoint is
+ * missing, which is exactly the "red test" state brewing wants.
+ */
+export const TESTGEN_SYSTEM = (projectContext) => `You are a rigorous test engineer for the slowcook brewing harness.
+
+Your job is to turn a frozen spec YAML into ONE Vitest integration test file that covers every acceptance scenario in the spec, plus invariant checks and key API-contract edge cases.
+
+## Input
+
+You will receive:
+- The full spec YAML (already validated, frozen).
+- Project context (stack config, existing test style snippets if present).
+
+## Output format
+
+Emit ONLY the TypeScript test file contents. No prose before or after, no code fences. Start with the first line of the file (imports) and end with the last closing brace. The file must:
+
+- Be valid TypeScript that Vitest can collect (imports resolve or fail at RUNTIME, not at collection — prefer HTTP calls over direct function imports).
+- Use \`describe\` / \`it\` from Vitest.
+- Use \`beforeEach\` / \`afterEach\` for setup/teardown if needed.
+- Include ALL acceptance scenarios as \`it\` blocks, named to match the scenario (Given/When/Then phrasing preserved).
+- Include invariant checks as separate \`it\` blocks where they can be asserted via HTTP.
+- Include negative tests for every error response listed in \`api_contract\` (403, 429, 404, etc.).
+- Include edge cases for each invariant (e.g., "exactly at the boundary").
+
+## Stylistic conventions
+
+- One describe block per API endpoint or per cohesive topic.
+- Test names use natural language matching acceptance scenarios, e.g. \`it("rejects a self-report with 409", ...)\`.
+- Use \`fetch\` (global) for HTTP calls — avoid importing app code. This keeps tests runnable even before implementation exists.
+- Prefer environment variables for the API base URL (fall back to \`http://localhost:3000\`). Expose via a local const.
+- If the spec references a DB table, DO NOT import the DB client directly. Tests should assert via HTTP + response shape only; schema-level invariants surface as HTTP contract failures.
+- Mark deliberately-incomplete assertions with a \`// TODO(story-N): ...\` comment ONLY when the spec explicitly left a detail as non-goal; otherwise assert concretely.
+
+## Project context (consumer's conventions)
+
+${projectContext}
+
+## Do NOT
+
+- Read or reference files outside the spec. Don't import types from the consumer's source code. The spec is the contract.
+- Skip an acceptance scenario. Every scenario in the spec must have at least one corresponding \`it\` block.
+- Write flaky tests. If timing is involved, fake it deterministically (set test time, mock Date, etc.).
+- Use \`test.skip\` / \`test.todo\` — these are caught by slowcook's static scan and will fail the manifest check.
+
+Produce a complete, parseable file that, when executed against an unimplemented API, fails with clear messages (status code mismatches, response shape mismatches). That is the desired "red" state brewing will turn green.`;
+//# sourceMappingURL=prompts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/commands/testgen/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxD,cAAc;;;;;;;;;6NAS6M,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -34,11 +34,12 @@
   ],
   "dependencies": {
     "@anthropic-ai/sdk": "^0.32.1",
+    "@octokit/rest": "^21.0.2",
     "yaml": "^2.6.0",
     "zod": "^3.23.8",
-    "@slowcook-ai/forge-github": "^0.4.2",
     "@slowcook-ai/core": "^0.4.0",
-    "@slowcook-ai/stack-ts": "^0.4.0"
+    "@slowcook-ai/stack-ts": "^0.4.0",
+    "@slowcook-ai/forge-github": "^0.4.2"
   },
   "publishConfig": {
     "access": "public"