@slowcook-ai/cli 0.19.0-alpha.11 → 0.19.0-alpha.16

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

@@ -0,0 +1,56 @@
+/**
+ * `slowcook garnish` — 0.19.0-α.15.
+ *
+ * Local commit-gate for human (or other-agent) tweaks layered on top
+ * of an agent's work. The PM (or engineer) edits files in the working
+ * tree — by hand, via DevTools Workspaces, via any editor — then runs
+ * `slowcook garnish`. The cli:
+ *
+ *   1. Detects uncommitted changes in the working tree.
+ *   2. For each changed file, identifies the agent (if any) whose last
+ *      commit touched the file. Files last touched by humans get no
+ *      trailer entry (no learning signal for an agent).
+ *   3. Runs the relevant tests scoped to the changed files (or the
+ *      caller-provided test glob via --scope).
+ *   4. If tests pass: commits the staged changes with a subject naming
+ *      the touched files + `Tweaks-output-of:` trailer lines marking
+ *      each agent-authored file the tweak touched. Optionally pushes.
+ *   5. If tests fail: prints the failure summary + exits non-zero
+ *      without committing.
+ *
+ * The trailer lines are the load-bearing piece — a future `slowcook
+ * reflect` command mines them to surface learning signal for the
+ * upstream agent (eval-set fixtures, prompt-amendment candidates).
+ */
+/**
+ * 0.19.0-α.16 — runGarnish, the reusable core. Other commands
+ * (run-mock --garnish, for one) call this in-process on debounced
+ * file-save batches; doing it as a subprocess invocation would
+ * re-pay node startup every time.
+ *
+ * Returns a structured result; never calls process.exit. Caller
+ * decides what to do on each kind.
+ */
+export interface RunGarnishOptions {
+    repoRoot: string;
+    scope?: string | null;
+    message?: string | null;
+    push?: boolean;
+    silent?: boolean;
+}
+export type RunGarnishResult = {
+    kind: "no-changes";
+} | {
+    kind: "tests-failed";
+    touchedFiles: string[];
+    outputTail: string;
+} | {
+    kind: "committed";
+    sha: string;
+    touchedFiles: string[];
+    agentRefCount: number;
+    pushed: boolean;
+};
+export declare function runGarnish(opts: RunGarnishOptions): Promise<RunGarnishResult>;
+export declare function garnish(argv: string[], _cliVersion: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/garnish/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAsJH;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpE;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEN,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmEnF;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDhF"}

package/dist/commands/garnish/index.js

@@ -0,0 +1,281 @@
+/**
+ * `slowcook garnish` — 0.19.0-α.15.
+ *
+ * Local commit-gate for human (or other-agent) tweaks layered on top
+ * of an agent's work. The PM (or engineer) edits files in the working
+ * tree — by hand, via DevTools Workspaces, via any editor — then runs
+ * `slowcook garnish`. The cli:
+ *
+ *   1. Detects uncommitted changes in the working tree.
+ *   2. For each changed file, identifies the agent (if any) whose last
+ *      commit touched the file. Files last touched by humans get no
+ *      trailer entry (no learning signal for an agent).
+ *   3. Runs the relevant tests scoped to the changed files (or the
+ *      caller-provided test glob via --scope).
+ *   4. If tests pass: commits the staged changes with a subject naming
+ *      the touched files + `Tweaks-output-of:` trailer lines marking
+ *      each agent-authored file the tweak touched. Optionally pushes.
+ *   5. If tests fail: prints the failure summary + exits non-zero
+ *      without committing.
+ *
+ * The trailer lines are the load-bearing piece — a future `slowcook
+ * reflect` command mines them to surface learning signal for the
+ * upstream agent (eval-set fixtures, prompt-amendment candidates).
+ */
+import { execSync, spawnSync } from "node:child_process";
+import { existsSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { composeCommitMessage, agentFromAuthor, } from "./trailer.js";
+function parseArgs(argv) {
+    const args = {
+        repoRoot: process.cwd(),
+        scope: null,
+        push: false,
+        message: null,
+        dryRun: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (a === "--scope" && next) {
+            args.scope = next;
+            i++;
+        }
+        else if (a === "--push") {
+            args.push = true;
+        }
+        else if (a === "--message" && next) {
+            args.message = next;
+            i++;
+        }
+        else if (a === "-m" && next) {
+            args.message = next;
+            i++;
+        }
+        else if (a === "--dry-run") {
+            args.dryRun = true;
+        }
+        else if (a === "--help" || a === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook garnish — commit a human (or other-agent) tweak on top of agent work
+
+Detects uncommitted changes, runs the relevant tests, and (if green) commits
+with \`Tweaks-output-of:\` trailers marking which upstream agent's work was
+tweaked. A future \`slowcook reflect\` mines these trailers for learning signal.
+
+Usage:
+  slowcook garnish [options]
+
+Options:
+  --cwd <path>         Repo root (default: cwd).
+  --scope <glob>       Pass through to vitest (\`vitest run <glob>\`). Default:
+                       run vitest related to the changed files.
+  --message <text>     Optional commit body. Default: subject-only.
+  -m <text>            Short form of --message.
+  --push               Push to origin after committing.
+  --dry-run            Print what would happen; do not run tests or commit.
+
+Examples:
+  # Edit some files via DevTools Workspaces / by hand, then:
+  slowcook garnish
+
+  # Force a specific test scope:
+  slowcook garnish --scope 'tests/integration/story-018-*'
+
+  # Commit + push:
+  slowcook garnish -m "Tightened the spacing on the Pin button." --push
+`);
+}
+function gitChangedFiles(repoRoot) {
+    const out = execSync(`git -C "${repoRoot}" status --porcelain`, {
+        encoding: "utf8",
+    });
+    const lines = out.split("\n").filter((l) => l.length > 0);
+    return lines
+        .map((line) => {
+        // Format: "XY path" or "XY path-old -> path-new" for renames.
+        // Take the rightmost path; safe enough for our use.
+        const status = line.slice(0, 2).trim();
+        const rest = line.slice(3).trim();
+        const path = rest.includes(" -> ") ? rest.split(" -> ")[1] : rest;
+        return { path, status };
+    })
+        .filter((f) => f.status !== "??"); // skip untracked-only (user can `git add` first)
+}
+function lastTouchingCommit(repoRoot, file) {
+    try {
+        const sha = execSync(`git -C "${repoRoot}" log -n 1 --format=%H -- "${file}"`, { encoding: "utf8" }).trim();
+        if (!sha)
+            return null;
+        const author = execSync(`git -C "${repoRoot}" show -s --format=%an "${sha}"`, { encoding: "utf8" }).trim();
+        return { sha, author };
+    }
+    catch {
+        return null;
+    }
+}
+function resolveUpstreamRefs(repoRoot, files) {
+    const refs = [];
+    const humanFiles = [];
+    for (const file of files) {
+        const upstream = lastTouchingCommit(repoRoot, file);
+        if (!upstream) {
+            // File doesn't exist in history yet — must be newly-added by this tweak.
+            humanFiles.push(file);
+            continue;
+        }
+        const agent = agentFromAuthor(upstream.author);
+        if (agent) {
+            refs.push({ agent, sha: upstream.sha, file });
+        }
+        else {
+            humanFiles.push(file);
+        }
+    }
+    return { refs, humanFiles };
+}
+function runTests(repoRoot, files, scopeOverride) {
+    const cmd = scopeOverride
+        ? `npx vitest run ${scopeOverride}`
+        : `npx vitest related ${files.map((f) => `"${f}"`).join(" ")}`;
+    const result = spawnSync(cmd, {
+        cwd: repoRoot,
+        shell: true,
+        encoding: "utf8",
+        maxBuffer: 4 * 1024 * 1024,
+    });
+    const output = (result.stdout || "") + (result.stderr || "");
+    const ok = result.status === 0;
+    return { ok, output };
+}
+export async function runGarnish(opts) {
+    const repoRoot = opts.repoRoot;
+    const scope = opts.scope ?? null;
+    const log = opts.silent ? () => undefined : (msg) => console.log(msg);
+    const warn = opts.silent ? () => undefined : (msg) => console.warn(msg);
+    const changed = gitChangedFiles(repoRoot);
+    if (changed.length === 0) {
+        return { kind: "no-changes" };
+    }
+    const touchedFiles = changed.map((c) => c.path);
+    const { refs, humanFiles } = resolveUpstreamRefs(repoRoot, touchedFiles);
+    if (!opts.silent) {
+        log(`  ${touchedFiles.length} file(s) with uncommitted changes:`);
+        for (const f of touchedFiles)
+            log(`    ${f}`);
+        log(`  upstream: ${refs.length} agent-authored, ${humanFiles.length} human/new`);
+        if (refs.length > 0) {
+            const byAgent = {};
+            for (const r of refs)
+                byAgent[r.agent] = (byAgent[r.agent] ?? 0) + 1;
+            const summary = Object.entries(byAgent).map(([a, n]) => `${a}=${n}`).join(", ");
+            log(`    (${summary})`);
+        }
+        log("\n  running tests" + (scope ? ` (--scope ${scope})` : " (vitest related)") + "...");
+    }
+    const tests = runTests(repoRoot, touchedFiles, scope);
+    if (!tests.ok) {
+        const tail = tests.output.split("\n").slice(-40).join("\n");
+        return { kind: "tests-failed", touchedFiles, outputTail: tail };
+    }
+    log("  ✓ tests passed.");
+    const message = composeCommitMessage({
+        touchedFiles,
+        upstreamRefs: refs,
+        userMessage: opts.message ?? undefined,
+    });
+    const msgFile = join(repoRoot, ".brewing/.garnish-commit-msg.tmp");
+    if (!existsSync(join(repoRoot, ".brewing"))) {
+        execSync(`mkdir -p "${join(repoRoot, ".brewing")}"`);
+    }
+    writeFileSync(msgFile, message, "utf8");
+    for (const f of touchedFiles) {
+        try {
+            execSync(`git -C "${repoRoot}" add -- "${f}"`, { stdio: "ignore" });
+        }
+        catch { /* deleted file; ignore */ }
+    }
+    try {
+        execSync(`git -C "${repoRoot}" commit -F "${msgFile}"`, {
+            stdio: opts.silent ? "ignore" : "inherit",
+        });
+    }
+    catch (e) {
+        warn(`  garnish commit failed: ${e.message.slice(0, 200)}`);
+        return { kind: "tests-failed", touchedFiles, outputTail: e.message };
+    }
+    const sha = execSync(`git -C "${repoRoot}" rev-parse HEAD`, { encoding: "utf8" }).trim();
+    let pushed = false;
+    if (opts.push) {
+        try {
+            execSync(`git -C "${repoRoot}" push`, { stdio: opts.silent ? "ignore" : "inherit" });
+            pushed = true;
+        }
+        catch (e) {
+            warn(`  warn: push failed: ${e.message.slice(0, 200)}`);
+        }
+    }
+    return { kind: "committed", sha, touchedFiles, agentRefCount: refs.length, pushed };
+}
+export async function garnish(argv, _cliVersion) {
+    const args = parseArgs(argv);
+    console.log(`slowcook garnish · cwd: ${args.repoRoot.replace(process.cwd() + "/", ".")}`);
+    if (args.dryRun) {
+        const changed = gitChangedFiles(args.repoRoot);
+        if (changed.length === 0) {
+            console.log("  no uncommitted changes; nothing to garnish.");
+            return;
+        }
+        const touchedFiles = changed.map((c) => c.path);
+        const { refs, humanFiles } = resolveUpstreamRefs(args.repoRoot, touchedFiles);
+        console.log(`  ${touchedFiles.length} file(s) with uncommitted changes:`);
+        for (const f of touchedFiles)
+            console.log(`    ${f}`);
+        console.log(`  upstream: ${refs.length} agent-authored, ${humanFiles.length} human/new`);
+        if (refs.length > 0) {
+            const byAgent = {};
+            for (const r of refs)
+                byAgent[r.agent] = (byAgent[r.agent] ?? 0) + 1;
+            const summary = Object.entries(byAgent).map(([a, n]) => `${a}=${n}`).join(", ");
+            console.log(`    (${summary})`);
+        }
+        console.log("\n  [dry-run] would run tests + commit; skipping.");
+        const message = composeCommitMessage({
+            touchedFiles,
+            upstreamRefs: refs,
+            userMessage: args.message ?? undefined,
+        });
+        console.log("\n  commit message would be:\n");
+        for (const line of message.split("\n"))
+            console.log(`    ${line}`);
+        return;
+    }
+    const result = await runGarnish({
+        repoRoot: args.repoRoot,
+        scope: args.scope,
+        message: args.message,
+        push: args.push,
+    });
+    if (result.kind === "no-changes") {
+        console.log("  no uncommitted changes; nothing to garnish.");
+        return;
+    }
+    if (result.kind === "tests-failed") {
+        console.error("\n  ✗ tests failed. Garnish blocked; working tree unchanged.\n");
+        console.error(result.outputTail);
+        process.exit(1);
+    }
+    console.log(`\n  ✓ garnished: ${result.sha.slice(0, 7)} (${result.agentRefCount} agent ref(s) recorded)${result.pushed ? " · pushed" : ""}`);
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/garnish/trailer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 0.19.0-α.15 — `slowcook garnish` trailer helpers.
+ *
+ * When a human (or another agent) commits a tweak on top of an agent's
+ * work, we mark the commit with `Tweaks-output-of:` git trailer lines —
+ * one per file the tweak touched, naming the upstream agent + sha. A
+ * future `slowcook reflect` command mines these trailers to surface
+ * learning signal for the upstream agent (eval-set fixtures, prompt
+ * amendment candidates, drift catalogs).
+ *
+ * Trailer format (one line per file):
+ *
+ *   Tweaks-output-of: agent=<name> sha=<commit-sha> file=<repo-relative-path>
+ *
+ * Examples:
+ *   Tweaks-output-of: agent=vibe sha=a7df238 file=mock/src/components/Foo.tsx
+ *   Tweaks-output-of: agent=plate sha=00905ae file=mock/src/components/Bar.tsx
+ *
+ * Pure module — no IO. Caller composes the trailer lines into the commit
+ * message and runs git separately.
+ */
+export interface UpstreamRef {
+    /** Upstream agent name (vibe / plate / brew / chef / etc). */
+    agent: string;
+    /** Upstream commit SHA (short or full; renderer trims to 7). */
+    sha: string;
+    /** Repo-relative file path the tweak touched. */
+    file: string;
+}
+/**
+ * Format a list of upstream refs into trailer lines (one per ref).
+ * Pure: returns a single string with `\n` separators, no leading or
+ * trailing newline. Caller appends to the commit-message body.
+ */
+export declare function formatTrailer(refs: UpstreamRef[]): string;
+/**
+ * Parse a single trailer line, returning the parsed ref or null if the
+ * line doesn't match the expected shape. Tolerates leading/trailing
+ * whitespace + the optional "  " indent some `git interpret-trailers`
+ * outputs add.
+ */
+export declare function parseTrailerLine(line: string): UpstreamRef | null;
+/**
+ * Parse all `Tweaks-output-of:` trailers from a full commit-message
+ * body (multi-line). Returns refs in the order they appeared.
+ */
+export declare function parseTrailers(commitBody: string): UpstreamRef[];
+/**
+ * Inspect a git author line + return the upstream agent name, if the
+ * author follows slowcook's agent convention. Otherwise null.
+ *
+ * Conventions detected:
+ *   slowcook-vibe[bot]       → "vibe"
+ *   slowcook-plate[bot]      → "plate"
+ *   slowcook-brew[bot]       → "brew"
+ *   slowcook-chef[bot]       → "chef"
+ *   slowcook-refine[bot]     → "refine"
+ *   slowcook-testgen[bot]    → "testgen"
+ *   slowcook-recipe[bot]     → "recipe"
+ *   anything else            → null (human or unrelated bot)
+ *
+ * Pure: no IO. Caller pipes git author through it.
+ */
+export declare function agentFromAuthor(author: string): string | null;
+/**
+ * Compose the full commit message body for a garnish commit: a one-line
+ * subject naming the touched files, a blank line, optional user-provided
+ * body, a blank line, then the trailer block.
+ *
+ * Pure: caller passes the staged-file list + the parsed upstream refs +
+ * the optional user message. Returns the body string ready for `git
+ * commit -F`.
+ */
+export declare function composeCommitMessage(args: {
+    touchedFiles: string[];
+    upstreamRefs: UpstreamRef[];
+    userMessage?: string;
+}): string;
+//# sourceMappingURL=trailer.d.ts.map

package/dist/commands/garnish/trailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailer.d.ts","sourceRoot":"","sources":["../../../src/commands/garnish/trailer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAYjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,CAO/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAUT"}

package/dist/commands/garnish/trailer.js

@@ -0,0 +1,118 @@
+/**
+ * 0.19.0-α.15 — `slowcook garnish` trailer helpers.
+ *
+ * When a human (or another agent) commits a tweak on top of an agent's
+ * work, we mark the commit with `Tweaks-output-of:` git trailer lines —
+ * one per file the tweak touched, naming the upstream agent + sha. A
+ * future `slowcook reflect` command mines these trailers to surface
+ * learning signal for the upstream agent (eval-set fixtures, prompt
+ * amendment candidates, drift catalogs).
+ *
+ * Trailer format (one line per file):
+ *
+ *   Tweaks-output-of: agent=<name> sha=<commit-sha> file=<repo-relative-path>
+ *
+ * Examples:
+ *   Tweaks-output-of: agent=vibe sha=a7df238 file=mock/src/components/Foo.tsx
+ *   Tweaks-output-of: agent=plate sha=00905ae file=mock/src/components/Bar.tsx
+ *
+ * Pure module — no IO. Caller composes the trailer lines into the commit
+ * message and runs git separately.
+ */
+/**
+ * Format a list of upstream refs into trailer lines (one per ref).
+ * Pure: returns a single string with `\n` separators, no leading or
+ * trailing newline. Caller appends to the commit-message body.
+ */
+export function formatTrailer(refs) {
+    return refs
+        .map((r) => `Tweaks-output-of: agent=${r.agent} sha=${r.sha.slice(0, 7)} file=${r.file}`)
+        .join("\n");
+}
+/**
+ * Parse a single trailer line, returning the parsed ref or null if the
+ * line doesn't match the expected shape. Tolerates leading/trailing
+ * whitespace + the optional "  " indent some `git interpret-trailers`
+ * outputs add.
+ */
+export function parseTrailerLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("Tweaks-output-of:"))
+        return null;
+    const body = trimmed.slice("Tweaks-output-of:".length).trim();
+    // body looks like: "agent=vibe sha=abc1234 file=mock/src/X.tsx"
+    // file= may contain spaces in the rare case of weird paths; capture
+    // greedily as the last field.
+    const m = body.match(/^agent=(\S+)\s+sha=(\S+)\s+file=(.+)$/);
+    if (!m)
+        return null;
+    const [, agent, sha, file] = m;
+    if (!agent || !sha || !file)
+        return null;
+    return { agent, sha, file };
+}
+/**
+ * Parse all `Tweaks-output-of:` trailers from a full commit-message
+ * body (multi-line). Returns refs in the order they appeared.
+ */
+export function parseTrailers(commitBody) {
+    const out = [];
+    for (const line of commitBody.split("\n")) {
+        const ref = parseTrailerLine(line);
+        if (ref)
+            out.push(ref);
+    }
+    return out;
+}
+/**
+ * Inspect a git author line + return the upstream agent name, if the
+ * author follows slowcook's agent convention. Otherwise null.
+ *
+ * Conventions detected:
+ *   slowcook-vibe[bot]       → "vibe"
+ *   slowcook-plate[bot]      → "plate"
+ *   slowcook-brew[bot]       → "brew"
+ *   slowcook-chef[bot]       → "chef"
+ *   slowcook-refine[bot]     → "refine"
+ *   slowcook-testgen[bot]    → "testgen"
+ *   slowcook-recipe[bot]     → "recipe"
+ *   anything else            → null (human or unrelated bot)
+ *
+ * Pure: no IO. Caller pipes git author through it.
+ */
+export function agentFromAuthor(author) {
+    const m = author.match(/^slowcook-([a-z][\w-]*)\[bot\]$/);
+    if (!m)
+        return null;
+    return m[1];
+}
+/**
+ * Compose the full commit message body for a garnish commit: a one-line
+ * subject naming the touched files, a blank line, optional user-provided
+ * body, a blank line, then the trailer block.
+ *
+ * Pure: caller passes the staged-file list + the parsed upstream refs +
+ * the optional user message. Returns the body string ready for `git
+ * commit -F`.
+ */
+export function composeCommitMessage(args) {
+    const subject = `[garnish] ${formatTouchedFilesSummary(args.touchedFiles)}`;
+    const parts = [subject, ""];
+    if (args.userMessage && args.userMessage.trim().length > 0) {
+        parts.push(args.userMessage.trim(), "");
+    }
+    if (args.upstreamRefs.length > 0) {
+        parts.push(formatTrailer(args.upstreamRefs));
+    }
+    return parts.join("\n");
+}
+function formatTouchedFilesSummary(files) {
+    if (files.length === 0)
+        return "(no files)";
+    if (files.length === 1)
+        return files[0];
+    if (files.length === 2)
+        return `${files[0]} + ${files[1]}`;
+    return `${files[0]} + ${files.length - 1} more`;
+}
+//# sourceMappingURL=trailer.js.map

package/dist/commands/garnish/trailer.js.map

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

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

@@ -52,7 +52,7 @@ export interface ReconResult {
     history_index_components: number;
     warnings: string[];
 }
-export declare function recon(argv: string[], _cliVersion: string): Promise<void>;
+export declare function recon(argv: string[], cliVersion: string): Promise<void>;
 export declare function findStoryTestFiles(repoRoot: string, story: string): string[];
 export declare function extractImports(body: string): string[];
 export declare function extractTestids(body: string): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/recon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAyClF,UAAU,cAAc;IACtB,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,mBAAmB,GAAG,eAAe,GAAG,qBAAqB,GAAG,wBAAwB,CAAC;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,UAAU,CAAC;IAC/C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA0FD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0J9E;AAID,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAU5E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB1E;AAyBD,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/recon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AA0ClF,UAAU,cAAc;IACtB,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,mBAAmB,GAAG,eAAe,GAAG,qBAAqB,GAAG,wBAAwB,CAAC;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,UAAU,CAAC;IAC/C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA0FD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0J7E;AAID,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAU5E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB1E;AAyBD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/commands/recon/index.js

@@ -25,6 +25,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSy
 import { dirname, join, relative } from "node:path";
 import { buildHistoryIndex } from "../refine/history-index.js";
 import { extractShape, synthesiseShapeTestFile, findMockFilesForStory } from "./shape-preserve.js";
+import { isReadOnlyMode } from "../../lib/read-only.js";
 function parseArgs(argv) {
     const args = {
         story: "",
@@ -150,14 +151,14 @@ Exit codes:
   2  status=escalate (STORY_HISTORY_CONFLICT or VIBE_RECIPE_NAME_DRIFT)
 `);
 }
-export async function recon(argv, _cliVersion) {
+export async function recon(argv, cliVersion) {
     const args = parseArgs(argv);
     if (args.reuseScan) {
         await runReuseScan(args);
         return;
     }
     if (args.stubScan) {
-        await runStubScan(args);
+        await runStubScan(args, cliVersion);
         return;
     }
     console.log(`slowcook recon · story-${args.story} · cwd: ${relative(process.cwd(), args.repoRoot) || "."}`);
@@ -479,7 +480,7 @@ function walkTsFiles(root, out) {
  * reports stale ones + (when --stub-escalate) posts PM comment on each
  * stub's source issue.
  */
-async function runStubScan(args) {
+async function runStubScan(args, cliVersion) {
     const { execSync } = await import("node:child_process");
     const { detectStubMarker, daysBetween, classifyStubAge, buildStaleStubComment, } = await import("./stale-stubs.js");
     console.log(`slowcook recon --stub-scan · root: ${args.stubRoot} · grace: ${args.stubMaxAgeDays} days · cwd: ${relative(process.cwd(), args.repoRoot) || "."}`);
@@ -539,7 +540,10 @@ async function runStubScan(args) {
         const story = s.storyId ? `story-${s.storyId}` : "(no story id)";
         console.log(`  ${tag}  ${ageStr}  ${story.padEnd(14)}  ${s.path}`);
     }
-    if (args.stubEscalate && stale.length > 0) {
+    if (args.stubEscalate && stale.length > 0 && isReadOnlyMode()) {
+        console.log(`\n  [SLOWCOOK_READ_ONLY=1] --stub-escalate set but read-only mode is on; would post comments on ${stale.length} source issues. Skipping.`);
+    }
+    else if (args.stubEscalate && stale.length > 0) {
         console.log("\n  --stub-escalate set; posting PM comments on source issues...");
         let repoSlug = "";
         try {
@@ -570,7 +574,7 @@ async function runStubScan(args) {
                     continue;
                 }
                 const issueNumber = parseInt(issueMatch[1], 10);
-                const body = buildStaleStubComment(s, args.stubMaxAgeDays);
+                const body = buildStaleStubComment(s, args.stubMaxAgeDays, cliVersion);
                 const tmp = "/tmp/slowcook-stale-stub-comment.md";
                 writeFileSync(tmp, body, "utf8");
                 try {