@slowcook-ai/cli 0.19.4 → 0.19.6

package/dist/commands/stories/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `slowcook stories <subcommand>` — 0.19.5-α (sc#146 #6).
+ *
+ * Subcommands:
+ *   - `status` — per-story stage table (refine / testgen / vibe / brew / chef)
+ *
+ * Future subcommands tracked in sc#146:
+ *   - `release` — release a story-id after supersede (parked, needs design)
+ *
+ * Stage detection delegates to the pure helper in `./status.ts`. This
+ * file is just the IO wrapper: read `specs/_index.yaml`, query the
+ * forge for PRs, render.
+ */
+export declare function stories(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/stories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/stories/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3D"}

package/dist/commands/stories/index.js

@@ -0,0 +1,280 @@
+/**
+ * `slowcook stories <subcommand>` — 0.19.5-α (sc#146 #6).
+ *
+ * Subcommands:
+ *   - `status` — per-story stage table (refine / testgen / vibe / brew / chef)
+ *
+ * Future subcommands tracked in sc#146:
+ *   - `release` — release a story-id after supersede (parked, needs design)
+ *
+ * Stage detection delegates to the pure helper in `./status.ts`. This
+ * file is just the IO wrapper: read `specs/_index.yaml`, query the
+ * forge for PRs, render.
+ */
+import { execSync } from "node:child_process";
+import { readIndex } from "../refine/spec-yaml.js";
+import { GitHubAdapter } from "@slowcook-ai/forge-github";
+import { buildStoriesStatus, renderStoriesStatusTable, } from "./status.js";
+import { Octokit } from "@octokit/rest";
+export async function stories(argv) {
+    const sub = argv[0];
+    switch (sub) {
+        case "status":
+            return runStatus(argv.slice(1));
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            printHelp();
+            return;
+        default:
+            console.error(`Unknown stories subcommand: ${sub}`);
+            printHelp();
+            process.exit(64);
+    }
+}
+async function runStatus(argv) {
+    const args = parseArgs(argv);
+    const index = readIndex(args.repoRoot);
+    const stories = index.stories ?? {};
+    const storyIds = Object.keys(stories);
+    if (storyIds.length === 0) {
+        console.log("(no stories in specs/_index.yaml)");
+        return;
+    }
+    // Resolve owner/repo from git remote if not passed.
+    const { owner, repo } = resolveOwnerRepo(args);
+    let prs = [];
+    const token = process.env["GITHUB_TOKEN"] ?? process.env["GH_TOKEN"];
+    if (owner && repo && token) {
+        try {
+            prs = await fetchAllRelevantPRs({ owner, repo, token });
+        }
+        catch (e) {
+            console.error(`Warning: failed to fetch PRs (${e.message}). Status table will report all stages as absent.`);
+            prs = [];
+        }
+    }
+    else if (!token) {
+        console.error("Warning: GITHUB_TOKEN / GH_TOKEN not set. Status table will report all stages as absent.\n" +
+            "  Set the env var to query the forge; story metadata still renders from specs/_index.yaml.");
+    }
+    const rows = buildStoriesStatus(index, prs);
+    if (args.format === "json") {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    process.stdout.write(renderStoriesStatusTable(rows));
+}
+/**
+ * Fetch every PR that's relevant to the slowcook pipeline for this
+ * consumer. Two sources, unioned by PR number:
+ *
+ * 1. **Branch-prefix search** (`head:slowcook/`) — catches all slowcook-
+ *    shaped branches whether or not the PR carries slowcook-* labels.
+ *    This is the primary source — local-pipeline PRs (per
+ *    `docs/local-pipeline-role.md`) frequently lack labels but always
+ *    use the branch convention.
+ * 2. **Label scan** — catches any slowcook PRs (bot or human) that
+ *    DID get labelled but happen to NOT live on a slowcook/ branch
+ *    (e.g. a Bijan-cumulative branch with a slowcook-spec label).
+ *
+ * The branch search uses GitHub's search API (single endpoint, single
+ * page for most consumers). The label scan uses the issues endpoint
+ * per-label (one paginated request per label).
+ */
+async function fetchAllRelevantPRs(args) {
+    const octokit = new Octokit({
+        auth: args.token,
+        userAgent: "slowcook-ai/cli",
+    });
+    const byNumber = new Map();
+    // 1. Branch-prefix search.
+    try {
+        const q = `is:pr repo:${args.owner}/${args.repo} head:slowcook/`;
+        const found = await octokit.paginate(octokit.search.issuesAndPullRequests, {
+            q,
+            per_page: 100,
+        });
+        for (const item of found) {
+            if (!item.pull_request)
+                continue;
+            const labels = (item.labels ?? [])
+                .map((l) => (typeof l === "string" ? l : l.name ?? ""))
+                .filter((s) => typeof s === "string" && s.length > 0);
+            // search API result doesn't give us head.ref or merged_at — need a
+            // pulls.get to fill these in. Batch via Promise.all later if perf
+            // becomes a concern.
+            let headBranch = "";
+            let merged = false;
+            try {
+                const { data: pr } = await octokit.pulls.get({
+                    owner: args.owner,
+                    repo: args.repo,
+                    pull_number: item.number,
+                });
+                headBranch = pr.head?.ref ?? "";
+                merged = Boolean(pr.merged_at);
+            }
+            catch {
+                // Best-effort — keep title/state from the search result.
+            }
+            byNumber.set(item.number, {
+                number: item.number,
+                title: item.title,
+                labels,
+                headBranch,
+                state: item.state === "closed" ? "closed" : "open",
+                merged,
+            });
+        }
+    }
+    catch (e) {
+        console.error(`Warning: branch-prefix search failed (${e.message}). Continuing with label scan only.`);
+    }
+    // 2. Label scan — catches any slowcook PR that lacks a slowcook/
+    //    branch but DID get labelled.
+    const labels = [
+        "slowcook-spec",
+        "slowcook-tests",
+        "slowcook-mockup",
+        "slowcook-brew",
+        "slowcook-chef",
+    ];
+    for (const label of labels) {
+        try {
+            const issues = await octokit.paginate(octokit.issues.listForRepo, {
+                owner: args.owner,
+                repo: args.repo,
+                state: "all",
+                labels: label,
+                per_page: 100,
+            });
+            for (const issue of issues) {
+                if (!issue.pull_request)
+                    continue;
+                if (byNumber.has(issue.number)) {
+                    // Already counted — merge labels in case we missed one.
+                    const existing = byNumber.get(issue.number);
+                    if (!existing.labels.includes(label))
+                        existing.labels.push(label);
+                    continue;
+                }
+                let headBranch = "";
+                let merged = false;
+                try {
+                    const { data: pr } = await octokit.pulls.get({
+                        owner: args.owner,
+                        repo: args.repo,
+                        pull_number: issue.number,
+                    });
+                    headBranch = pr.head?.ref ?? "";
+                    merged = Boolean(pr.merged_at);
+                }
+                catch {
+                    // Best-effort.
+                }
+                byNumber.set(issue.number, {
+                    number: issue.number,
+                    title: issue.title,
+                    labels: (issue.labels ?? [])
+                        .map((l) => (typeof l === "string" ? l : l.name ?? ""))
+                        .filter((s) => typeof s === "string" && s.length > 0),
+                    headBranch,
+                    state: issue.state === "closed" ? "closed" : "open",
+                    merged,
+                });
+            }
+        }
+        catch {
+            // Label may not exist on the repo (e.g. consumer never used vibe).
+            // Skip silently — fine to be missing some categories.
+        }
+    }
+    return Array.from(byNumber.values());
+}
+function parseArgs(argv) {
+    const out = {
+        repoRoot: process.cwd(),
+        owner: undefined,
+        repo: undefined,
+        format: "table",
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--cwd" && next) {
+            out.repoRoot = next;
+            i++;
+        }
+        else if (a === "--owner" && next) {
+            out.owner = next;
+            i++;
+        }
+        else if (a === "--repo" && next) {
+            out.repo = next;
+            i++;
+        }
+        else if (a === "--json") {
+            out.format = "json";
+        }
+        else if (a === "--help" || a === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return out;
+}
+function resolveOwnerRepo(args) {
+    if (args.owner && args.repo)
+        return { owner: args.owner, repo: args.repo };
+    // Detect from git remote.
+    try {
+        const url = execSync("git remote get-url origin", {
+            cwd: args.repoRoot,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const m = url.match(/github\.com[:/]([^/]+)\/([^/.]+)(?:\.git)?$/);
+        if (m) {
+            return { owner: args.owner ?? m[1], repo: args.repo ?? m[2] };
+        }
+    }
+    catch {
+        // not a git repo, or no origin — fine
+    }
+    return { owner: args.owner, repo: args.repo };
+}
+// Silence the unused-import warning when stories status doesn't need
+// the adapter directly. Keep the import handy for future subcommands
+// (e.g. `stories close --pr N` could use addIssueLabels).
+void GitHubAdapter;
+function printHelp() {
+    console.log(`
+slowcook stories — per-story status across the slowcook pipeline (0.19.5-α)
+
+Usage:
+  slowcook stories status [--cwd <path>] [--owner <login>] [--repo <name>] [--json]
+
+Subcommands:
+  status   Render a table of story id × pipeline stage (refine / testgen
+           / vibe / brew / chef). Reads specs/_index.yaml + queries the
+           forge for PRs labelled with the slowcook-* stage labels.
+
+           Cell semantics:
+             ✓ — merged PR exists for this stage
+             → — open PR exists for this stage
+             ✗ — PR was opened but closed unmerged
+             — — no PR found for this stage
+
+           With --json, emits the same data as machine-readable JSON.
+
+Environment:
+  GITHUB_TOKEN | GH_TOKEN  Required to query the forge. Without it,
+                           the table renders from specs/_index.yaml
+                           only and reports all stages as absent.
+
+Refs: aminazar/slowcook#146 finding 6.
+`);
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/stories/status.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `slowcook stories status` pure helper — 0.19.5-α (sc#146 #6).
+ *
+ * Cross-references the consumer's `specs/_index.yaml` against PR/label
+ * facts to produce a per-story stage table. Pure function — no fs, no
+ * network. The CLI wrapper (`./index.ts`) gathers the inputs.
+ *
+ * Stage mapping (per slowcook conventions):
+ *
+ * | Stage   | Slowcook label evidence       |
+ * |---------|-------------------------------|
+ * | refine  | a `slowcook-spec` PR exists   |
+ * | testgen | a `slowcook-tests` PR exists  |
+ * | vibe    | a `slowcook-mockup` PR exists |
+ * | brew    | a `slowcook-brew` PR exists   |
+ * | chef    | a `slowcook-chef` PR exists   |
+ *
+ * Per-stage cell semantics:
+ *
+ * - `✓`  — a PR with the matching label exists AND is merged
+ * - `→`  — a PR with the matching label exists AND is open
+ * - `✗`  — a PR was opened but closed unmerged
+ * - `—`  — no PR found for this stage
+ *
+ * For consumers running the local-pipeline pattern (see
+ * `docs/local-pipeline-role.md`), the slowcook labels may not be
+ * applied to human-driven PRs. In that case the helper falls back
+ * to matching by PR-branch-name (`slowcook/<kind>/story-N` →
+ * stage=<kind>).
+ *
+ * Gantt-style stage-by-stage output is parked for a follow-up
+ * (sc#146 #6 acceptance: "Defer the Gantt-style output to a follow-up.
+ * Just ship the underlying table first.").
+ */
+import type { SpecIndex, SpecIndexEntry } from "@slowcook-ai/core";
+export type StoriesStatusCell = "merged" | "open" | "closed_unmerged" | "absent";
+export interface StoriesStatusRow {
+    storyId: string;
+    title: string;
+    status: SpecIndexEntry["status"];
+    sourceIssue: string | undefined;
+    /** Per-stage status. Stages: refine / testgen / vibe / brew / chef. */
+    stages: Record<"refine" | "testgen" | "vibe" | "brew" | "chef", StoriesStatusCell>;
+}
+export interface PullRequestFact {
+    number: number;
+    title: string;
+    /** Source-of-truth labels on the PR. */
+    labels: string[];
+    /** Branch name; used as the fallback signal when labels are absent. */
+    headBranch: string;
+    /** "open" | "closed". */
+    state: "open" | "closed";
+    /** True iff the PR is closed AND was merged. */
+    merged: boolean;
+}
+/**
+ * Build the status table for every story in the index.
+ *
+ * @param specIndex - the parsed `specs/_index.yaml` content
+ * @param pullRequests - all PRs in the repo (merged + open + closed-unmerged).
+ *                       The CLI wrapper passes the union of label-matched
+ *                       results; pass an empty array if GH access is
+ *                       unavailable + the row will report all stages as
+ *                       absent (still useful for spec-only summary).
+ */
+export declare function buildStoriesStatus(specIndex: SpecIndex, pullRequests: PullRequestFact[]): StoriesStatusRow[];
+/**
+ * Render a status row set as an ASCII-art table. Used by the CLI
+ * wrapper's stdout. Pure function — no colour codes, no terminal
+ * width detection.
+ */
+export declare function renderStoriesStatusTable(rows: StoriesStatusRow[]): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/stories/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/stories/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;CACjB;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,eAAe,EAAE,GAC9B,gBAAgB,EAAE,CAsBpB;AAiCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAuDzE"}

package/dist/commands/stories/status.js

@@ -0,0 +1,176 @@
+/**
+ * `slowcook stories status` pure helper — 0.19.5-α (sc#146 #6).
+ *
+ * Cross-references the consumer's `specs/_index.yaml` against PR/label
+ * facts to produce a per-story stage table. Pure function — no fs, no
+ * network. The CLI wrapper (`./index.ts`) gathers the inputs.
+ *
+ * Stage mapping (per slowcook conventions):
+ *
+ * | Stage   | Slowcook label evidence       |
+ * |---------|-------------------------------|
+ * | refine  | a `slowcook-spec` PR exists   |
+ * | testgen | a `slowcook-tests` PR exists  |
+ * | vibe    | a `slowcook-mockup` PR exists |
+ * | brew    | a `slowcook-brew` PR exists   |
+ * | chef    | a `slowcook-chef` PR exists   |
+ *
+ * Per-stage cell semantics:
+ *
+ * - `✓`  — a PR with the matching label exists AND is merged
+ * - `→`  — a PR with the matching label exists AND is open
+ * - `✗`  — a PR was opened but closed unmerged
+ * - `—`  — no PR found for this stage
+ *
+ * For consumers running the local-pipeline pattern (see
+ * `docs/local-pipeline-role.md`), the slowcook labels may not be
+ * applied to human-driven PRs. In that case the helper falls back
+ * to matching by PR-branch-name (`slowcook/<kind>/story-N` →
+ * stage=<kind>).
+ *
+ * Gantt-style stage-by-stage output is parked for a follow-up
+ * (sc#146 #6 acceptance: "Defer the Gantt-style output to a follow-up.
+ * Just ship the underlying table first.").
+ */
+const STAGE_LABEL_MAP = {
+    refine: "slowcook-spec",
+    testgen: "slowcook-tests",
+    vibe: "slowcook-mockup",
+    brew: "slowcook-brew",
+    chef: "slowcook-chef",
+};
+/**
+ * Branch-name → stage map, used when labels are absent (the
+ * local-pipeline pattern doesn't always apply labels to human PRs).
+ *
+ * `slowcook/<kind>/story-N` → kind.
+ */
+const BRANCH_KIND_TO_STAGE = {
+    spec: "refine",
+    tests: "testgen",
+    mockup: "vibe",
+    brew: "brew",
+    chef: "chef",
+};
+/**
+ * Build the status table for every story in the index.
+ *
+ * @param specIndex - the parsed `specs/_index.yaml` content
+ * @param pullRequests - all PRs in the repo (merged + open + closed-unmerged).
+ *                       The CLI wrapper passes the union of label-matched
+ *                       results; pass an empty array if GH access is
+ *                       unavailable + the row will report all stages as
+ *                       absent (still useful for spec-only summary).
+ */
+export function buildStoriesStatus(specIndex, pullRequests) {
+    const rows = [];
+    const stories = specIndex.stories ?? {};
+    for (const [storyId, entry] of Object.entries(stories)) {
+        rows.push({
+            storyId,
+            title: entry.title,
+            status: entry.status,
+            sourceIssue: entry.source_issue,
+            stages: {
+                refine: stageStateForStory(storyId, "refine", pullRequests),
+                testgen: stageStateForStory(storyId, "testgen", pullRequests),
+                vibe: stageStateForStory(storyId, "vibe", pullRequests),
+                brew: stageStateForStory(storyId, "brew", pullRequests),
+                chef: stageStateForStory(storyId, "chef", pullRequests),
+            },
+        });
+    }
+    // Sort by story id ascending (lexicographic — works because ids are
+    // zero-padded strings in the convention).
+    rows.sort((a, b) => a.storyId.localeCompare(b.storyId));
+    return rows;
+}
+function stageStateForStory(storyId, stage, prs) {
+    const label = STAGE_LABEL_MAP[stage];
+    // Story id appears in PR title (slowcook bot convention) OR in branch
+    // name (slowcook/<kind>/story-N pattern).
+    const storyTitleRe = new RegExp(`\\bstory-${escapeRegex(storyId)}\\b`);
+    const storyBranchRe = new RegExp(`/story-${escapeRegex(storyId)}(?:-|$|/)`);
+    const matches = prs.filter((pr) => {
+        const titleMatches = storyTitleRe.test(pr.title);
+        const branchMatches = storyBranchRe.test(pr.headBranch);
+        if (!titleMatches && !branchMatches)
+            return false;
+        // Stage match: label OR branch-kind fallback.
+        if (pr.labels.includes(label))
+            return true;
+        // Fallback: branch shaped slowcook/<kind>/story-N — derive stage.
+        const branchKind = pr.headBranch.match(/^slowcook\/([a-z]+)\//)?.[1];
+        if (branchKind && BRANCH_KIND_TO_STAGE[branchKind] === stage)
+            return true;
+        return false;
+    });
+    if (matches.length === 0)
+        return "absent";
+    if (matches.some((m) => m.merged))
+        return "merged";
+    if (matches.some((m) => m.state === "open"))
+        return "open";
+    return "closed_unmerged";
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Render a status row set as an ASCII-art table. Used by the CLI
+ * wrapper's stdout. Pure function — no colour codes, no terminal
+ * width detection.
+ */
+export function renderStoriesStatusTable(rows) {
+    if (rows.length === 0)
+        return "(no stories in specs/_index.yaml)\n";
+    const cellGlyph = {
+        merged: "✓",
+        open: "→",
+        closed_unmerged: "✗",
+        absent: "—",
+    };
+    // Column widths (story id, title — truncate title at 50 chars).
+    const storyW = Math.max(5, ...rows.map((r) => r.storyId.length));
+    const titleW = Math.min(50, Math.max(5, ...rows.map((r) => Math.min(50, r.title.length))));
+    const stageW = 8; // "testgen" is widest header (7 chars) — add 1 for spacing
+    const sep = (w) => "─".repeat(w);
+    const header = pad("Story", storyW) +
+        "  " +
+        pad("Title", titleW) +
+        "  " +
+        "refine".padEnd(stageW) +
+        "testgen".padEnd(stageW) +
+        "vibe".padEnd(stageW) +
+        "brew".padEnd(stageW) +
+        "chef".padEnd(stageW);
+    const divider = sep(storyW) +
+        "  " +
+        sep(titleW) +
+        "  " +
+        sep(stageW - 1) + " " +
+        sep(stageW - 1) + " " +
+        sep(stageW - 1) + " " +
+        sep(stageW - 1) + " " +
+        sep(stageW - 1);
+    const lines = [header, divider];
+    for (const row of rows) {
+        const truncatedTitle = row.title.length > titleW ? row.title.slice(0, titleW - 1) + "…" : row.title;
+        lines.push(pad(row.storyId, storyW) +
+            "  " +
+            pad(truncatedTitle, titleW) +
+            "  " +
+            cellGlyph[row.stages.refine].padEnd(stageW) +
+            cellGlyph[row.stages.testgen].padEnd(stageW) +
+            cellGlyph[row.stages.vibe].padEnd(stageW) +
+            cellGlyph[row.stages.brew].padEnd(stageW) +
+            cellGlyph[row.stages.chef].padEnd(stageW));
+    }
+    lines.push("");
+    lines.push("Legend: ✓ merged · → open · ✗ closed-unmerged · — absent");
+    return lines.join("\n") + "\n";
+}
+function pad(s, w) {
+    return s.length >= w ? s : s + " ".repeat(w - s.length);
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/stories/status.js.map

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

package/dist/commands/upsert-agent-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upsert-agent-docs.d.ts","sourceRoot":"","sources":["../../src/commands/upsert-agent-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAmBH,wBAAgB,iBAAiB,IAAI,MAAM,CAoH1C;AAmGD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;IACtF,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,WAAW,CAAC;IAClD,SAAS,EAAE,OAAO,GAAG,iBAAiB,GAAG,cAAc,CAAC;CACzD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,qBAAqB,CAsB5G;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnE"}
+{"version":3,"file":"upsert-agent-docs.d.ts","sourceRoot":"","sources":["../../src/commands/upsert-agent-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAmBH,wBAAgB,iBAAiB,IAAI,MAAM,CA8J1C;AAmGD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;IACtF,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,WAAW,CAAC;IAClD,SAAS,EAAE,OAAO,GAAG,iBAAiB,GAAG,cAAc,CAAC;CACzD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,qBAAqB,CAsB5G;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnE"}

package/dist/commands/upsert-agent-docs.js

@@ -95,6 +95,48 @@ The slowcook pipeline opens one branch per stage (\`slowcook/<kind>/story-N\`).
 - Slowcook agents stay on \`slowcook/<kind>/story-N\` branches; non-slowcook agents should use \`<your-name>/<short-description>\`.
 - Don't \`--force-push\` to shared branches. The human PM holds admin bypass for emergencies; agents don't.
 
+### When introducing a new package dependency in testgen
+
+If your testgen scaffolds a file that NEEDS a not-yet-installed package (e.g. a WebSocket gateway needs \`@nestjs/websockets\` + \`socket.io\` before \`nest build\` will compile any file that imports them), follow the **no-import stub** pattern:
+
+- **Do** add the dep to \`package.json\`. Brew runs \`pnpm install\` first and needs them present.
+- **Don't** import the package in the stubbed file. \`nest build\` (or any test compile) runs at testgen time and will fail with "Cannot find module '<dep>'" until brew installs.
+- **Do** scaffold the file as a no-import stub: a plain \`@Injectable()\` (or equivalent) with the decorators / types substituted by \`unknown\`-typed shims. Mark the file with \`@slowcook-stub\` on line 1.
+- **Don't** skip the file entirely. Tests that reference the symbol need the declaration to exist for type-check; the runtime throw is fine, but the export must be importable.
+
+Brew then \`pnpm install\`s the dep, swaps the no-import stub for the real decorators, and removes the \`@slowcook-stub\` marker.
+
+Recorded sc#151 finding 2 — delgoosh story-006 added \`@nestjs/websockets\` for the peer-chat gateway. Initial testgen attempted the real decorators, \`nest build\` failed during the testgen PR's CI, and the workaround above was applied.
+
+### Combined testgen+brew for small stories
+
+The default pipeline cadence (testgen PR → merge → brew PR → merge) is sized for medium/large stories where the test contract benefits from independent human review before brew touches it. For stories where \`spec.estimate === 'small'\` AND brew is expected to touch < ~10 files, a **combined testgen+brew PR** is acceptable:
+
+- Branch: \`slowcook/brew/story-N-<ts>\` (single branch — skip the separate \`slowcook/tests/story-N\` step)
+- Commit: ONE commit containing both the failing test scaffold AND the impl. Title clearly states "combined testgen+brew" so reviewers know what they're looking at.
+- PR body: explain why combined was chosen (small estimate, narrow surface). Reviewers can still red-line the test contract before approving — the diff just isn't split across two PRs.
+
+When NOT to combine: any story with \`estimate: medium\` or \`large\`, any story that introduces a new dependency that brew will install, any story where the test contract reasonably might change during impl. When in doubt, split.
+
+Recorded sc#151 finding 6 — the combined-PR variant was used for delgoosh story-017 (mirror of story-006) and shipped cleanly in one PR.
+
+### Pattern: local pipeline (driving slowcook from your IDE)
+
+The "local pipeline" pattern: a Claude Code (or similar IDE-bound) session drives the slowcook pipeline locally — emitting refine / testgen / vibe / plate / brew / chef artefacts on slowcook-shaped branches — WITHOUT calling \`slowcook brew\` / \`slowcook refine\` etc. Same artefact shapes the bots emit, but the LLM call is the human's IDE-bound agent rather than slowcook's worker.
+
+When to use: API spend matters, you want to red-line every stage before it lands, or you're testing slowcook changes against a live consumer. When NOT: routine stories on a healthy bot pipeline, multiple parallel stories, anything where agent autonomy is the point.
+
+Conventions:
+- Branch names match the bot conventions (\`slowcook/<kind>/story-N\`); reviewers shouldn't have to tell.
+- One PR per stage by default; combined small-story PR per the section above is allowed.
+- Run \`slowcook cost log\` at the end of every story so the session's IDE cost shows in the aggregator alongside bot costs.
+- After every slowcook PR you ship lands + version-bumps, re-run \`slowcook check spec specs/story-*.yaml\` against your consumer so new gates catch existing drift.
+- DON'T run \`slowcook brew\` or any LLM-dispatch slowcook command from the local pipeline — that's a parallel agent you didn't authorise.
+
+Full doc: [\`docs/local-pipeline-role.md\`](https://github.com/aminazar/slowcook/blob/main/docs/local-pipeline-role.md) in the slowcook repo.
+
+Recorded sc#145 finding 6 — pattern emerged from the delgoosh dogfood (2026-05) and shipped 5 batches of slowcook feedback as a side effect.
+
 ### Working alongside other agents (multi-agent choreography)
 
 When your work depends on another agent's still-open PR — common when one agent owns the app shell + another owns a feature inside it — follow this: