@slowcook-ai/cli 0.19.0-alpha.14 → 0.19.0-alpha.17

package/dist/commands/map/emit-typeorm.js

@@ -0,0 +1,341 @@
+/**
+ * 0.19.0+ (slowcook#36) — TypeORM entity-graph extractor. Walks all
+ * `**\/*.entity.ts` files containing `@Entity(...)` decorators and emits
+ * a Mermaid ERD + per-entity summary table to
+ * `.brewing/diagrams/entities.md`.
+ *
+ * Why: slowcook's existing `emitSchemaDiagram` only knows about
+ * `supabase/migrations/*.sql`. Consumers on TypeORM (delgoosh, plus
+ * any NestJS monorepo) get nothing from the brownfield-extract step,
+ * leaving their slowcook agents (vibe / recipe / brew / chef /
+ * investigate) without entity grounding. Hand-curated entities.md
+ * is the workaround — this module replaces it with auto-extraction.
+ *
+ * Detection signal: any `*.entity.ts` file with `@Entity(` decorator.
+ * (Skips `node_modules`, `dist`, `.next`, `coverage`.)
+ *
+ * Parser is regex-based — TypeORM decorators have a strict shape
+ * across the ecosystem. Same approach as `ddlToMermaidErd` in
+ * refine/mermaid.ts; no AST tooling needed.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, basename } from "node:path";
+/** Skip these directories on the recursive walk. */
+const EXCLUDED_DIRS = new Set([
+    "node_modules",
+    "dist",
+    ".next",
+    ".turbo",
+    "coverage",
+    ".git",
+    "build",
+]);
+/**
+ * Recursive walk under `root` collecting absolute file paths matching
+ * the predicate. Skips EXCLUDED_DIRS at any depth.
+ */
+function walk(root, predicate) {
+    const out = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (EXCLUDED_DIRS.has(entry))
+                continue;
+            const path = join(dir, entry);
+            let st;
+            try {
+                st = statSync(path);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                stack.push(path);
+            }
+            else if (st.isFile() && predicate(path)) {
+                out.push(path);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Find all `*.entity.ts` files under `repoRoot` whose content contains
+ * an `@Entity(` decorator. Returns paths sorted alphabetically for
+ * deterministic output.
+ */
+export function findEntityFiles(repoRoot) {
+    const candidates = walk(repoRoot, (p) => p.endsWith(".entity.ts"));
+    const real = candidates.filter((p) => {
+        try {
+            const src = readFileSync(p, "utf8");
+            return /@Entity\s*\(/.test(src);
+        }
+        catch {
+            return false;
+        }
+    });
+    real.sort();
+    return real;
+}
+/**
+ * Parse one TypeORM entity source file. Returns null if no `@Entity`
+ * decorator is found (defense-in-depth — findEntityFiles already
+ * filtered).
+ */
+export function parseEntityFile(source, sourcePath) {
+    // Class name + extends BaseEntity check.
+    const classMatch = source.match(/export\s+class\s+(\w+)(?:\s+extends\s+(\w+))?/);
+    if (!classMatch)
+        return null;
+    const className = classMatch[1];
+    const extendsBaseEntity = classMatch[2] === "BaseEntity";
+    // Table name from @Entity('snake_case_plural'). Fallback to className.
+    const entityMatch = source.match(/@Entity\s*\(\s*['"]([^'"]+)['"]\s*\)/);
+    const tableName = entityMatch?.[1] ??
+        className
+            .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+            .toLowerCase();
+    // JSDoc above the class (TABLE-DESCRIPTION: ...).
+    const tableDescMatch = source.match(/TABLE-DESCRIPTION:\s*([^\n*]+?)(?:\s*\*\/|\s*\n\s*\*\s*TABLE-)/);
+    const description = tableDescMatch?.[1]?.trim();
+    // Columns: @Column(...) followed by `[public ]<property>: <type>`.
+    // The decorator may span multiple lines; we capture the args block in
+    // a balanced way using a permissive `[^@]*?` lookahead — fine because
+    // the next `@` always opens the next decorator or the property.
+    const columns = [];
+    const columnRe = /@Column\s*\(\s*(\{[\s\S]*?\})\s*\)\s*(?:public\s+|readonly\s+)?(\w+)\s*[?!]?\s*:\s*([^;]+);/g;
+    let cm;
+    while ((cm = columnRe.exec(source)) !== null) {
+        const [, args, property, tsType] = cm;
+        columns.push({
+            property: property,
+            columnName: args.match(/name:\s*['"]([^'"]+)['"]/)?.[1],
+            columnType: args.match(/type:\s*['"]([^'"]+)['"]/)?.[1],
+            nullable: /nullable:\s*true/.test(args),
+            tsType: tsType.trim(),
+        });
+    }
+    // Also catch bare `@Column()` (no args) — TypeORM allows this.
+    const bareColumnRe = /@Column\s*\(\s*\)\s*(?:public\s+|readonly\s+)?(\w+)\s*[?!]?\s*:\s*([^;]+);/g;
+    while ((cm = bareColumnRe.exec(source)) !== null) {
+        const [, property, tsType] = cm;
+        columns.push({
+            property: property,
+            tsType: tsType.trim(),
+        });
+    }
+    // Relations: @ManyToOne / @OneToOne / @OneToMany / @ManyToMany.
+    const relations = [];
+    const relRe = /@(ManyToOne|OneToOne|OneToMany|ManyToMany)\s*\(\s*\(\)\s*=>\s*(\w+)[\s\S]*?\)\s*(?:@JoinColumn\s*\(\s*\{?\s*(?:name:\s*['"]([^'"]+)['"])?[^}]*\}?\s*\)\s*)?(?:public\s+|readonly\s+)?(\w+)/g;
+    let rm;
+    while ((rm = relRe.exec(source)) !== null) {
+        const [, kind, target, joinColumn, property] = rm;
+        relations.push({
+            property: property,
+            kind: kind,
+            target: target,
+            joinColumn,
+        });
+    }
+    return {
+        className,
+        tableName,
+        extendsBaseEntity,
+        sourcePath,
+        description,
+        columns,
+        relations,
+    };
+}
+/**
+ * Mermaid relation shape per TypeORM kind.
+ *   ManyToOne   N owners → 1 target          → `}o--||`
+ *   OneToOne    1 owner  → 1 target          → `||--o|`
+ *   OneToMany   1 owner  → 0..N targets      → `||--o{`
+ *   ManyToMany  N owners → N targets         → `}o--o{`
+ */
+const RELATION_SHAPES = {
+    ManyToOne: "}o--||",
+    OneToOne: "||--o|",
+    OneToMany: "||--o{",
+    ManyToMany: "}o--o{",
+};
+/**
+ * Render one Mermaid `erDiagram` covering all entities + their
+ * relations. For very large graphs (>40 entities) the diagram is hard
+ * to read — but splitting by domain requires semantic knowledge we
+ * don't have. We render one big ERD; consumers can grep for entities
+ * they care about + use the per-entity table below for details.
+ */
+export function entitiesToMermaidErd(entities) {
+    if (entities.length === 0) {
+        return "```mermaid\nerDiagram\n  %% No @Entity decorators found.\n```";
+    }
+    const lines = ["```mermaid", "erDiagram"];
+    const known = new Set(entities.map((e) => e.className));
+    for (const e of entities) {
+        for (const r of e.relations) {
+            // Skip relations whose target isn't a known entity (e.g. enum types).
+            if (!known.has(r.target))
+                continue;
+            const label = r.property.replace(/"/g, "");
+            lines.push(`  ${e.className} ${RELATION_SHAPES[r.kind]} ${r.target} : "${label}"`);
+        }
+    }
+    // Always render entity boxes even with no columns (helps when a
+    // class only has relations, e.g. junction tables).
+    for (const e of entities) {
+        lines.push(`  ${e.className} {`);
+        // Show only NOTABLE columns: anything that looks like an FK or
+        // status enum or has a tableName (the rest belong in the per-
+        // entity table below). Cap at 6 to keep diagram readable.
+        const notable = e.columns
+            .filter((c) => c.columnName?.endsWith("_id") || c.columnType === "enum")
+            .slice(0, 6);
+        if (notable.length === 0) {
+            // Show the first ~3 columns so the box isn't empty.
+            for (const c of e.columns.slice(0, 3)) {
+                lines.push(`    ${c.columnType ?? "any"} ${c.columnName ?? c.property}`);
+            }
+        }
+        else {
+            for (const c of notable) {
+                const t = c.columnType ?? "any";
+                lines.push(`    ${t} ${c.columnName ?? c.property}`);
+            }
+        }
+        lines.push(`  }`);
+    }
+    lines.push("```");
+    return lines.join("\n");
+}
+/**
+ * Render the per-entity summary table for the entities.md artifact.
+ * Pairs with the Mermaid ERD above to give agents structured access
+ * to the entity vocabulary.
+ */
+export function entitiesToSummaryTable(entities) {
+    const lines = [];
+    lines.push("| Entity | Table | Purpose | Key relations | Notable columns |");
+    lines.push("|---|---|---|---|---|");
+    for (const e of entities) {
+        const purpose = (e.description ?? "—").replace(/\|/g, "\\|");
+        const relations = e.relations
+            .slice(0, 4)
+            .map((r) => `${r.kind} ${r.target}`)
+            .join("; ") || "—";
+        const notableCols = e.columns
+            .filter((c) => c.columnName?.endsWith("_id") || c.columnType === "enum")
+            .slice(0, 5)
+            .map((c) => c.columnName ?? c.property)
+            .join(", ") || "—";
+        lines.push(`| ${e.className} | \`${e.tableName}\` | ${purpose} | ${relations} | ${notableCols} |`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Full entities.md document body. Static header + conventions section
+ * (drawn from delgoosh dogfood — these are the same conventions every
+ * NestJS+TypeORM consumer follows) + the ERD + summary table.
+ */
+export function renderEntitiesMarkdown(entities) {
+    const baseEntityHits = entities.filter((e) => e.extendsBaseEntity).length;
+    const baseEntityHint = baseEntityHits > 0
+        ? `${baseEntityHits} of ${entities.length} entities \`extend BaseEntity\` — assume the same UUID-id + soft-delete pattern when adding new entities.`
+        : "No `BaseEntity` parent class detected — entities define their own primary keys.";
+    return `# Entity graph (auto-generated by \`slowcook extract --entities\`)
+
+> **Auto-generated; do not hand-edit.** Regenerate by running \`slowcook extract --entities\`.
+> Source: \`*.entity.ts\` files containing an \`@Entity(\` decorator.
+
+This artifact is consumed by slowcook agents (vibe / recipe / brew / chef / investigate) to ground their work in the existing entity vocabulary. Without it agents hallucinate table shapes and column names.
+
+## Quick stats
+
+- **${entities.length} entities** discovered
+- **${entities.reduce((n, e) => n + e.relations.length, 0)} relations** declared
+- ${baseEntityHint}
+
+## Conventions (inferred from the codebase)
+
+- Tables follow snake_case_plural (e.g. \`@Entity('patients')\`).
+- TS properties are camelCase; SQL columns are snake_case via \`@Column({ name: 'snake_case' })\`.
+- Foreign keys follow the \`<foreign_table_singular>_id\` pattern.
+- Enum columns reference \`@Column({ type: 'enum', enum: <EnumFromRepoEnums> })\`.
+- Relations are declared via \`@ManyToOne\` / \`@OneToOne\` / \`@OneToMany\` / \`@ManyToMany\` + \`@JoinColumn\`.
+
+## Entity-relationship diagram
+
+${entitiesToMermaidErd(entities)}
+
+## Per-entity summary
+
+${entitiesToSummaryTable(entities)}
+
+## Source paths
+
+${entities.map((e) => `- \`${e.sourcePath}\` — \`${e.className}\``).join("\n")}
+`;
+}
+/**
+ * Public entry — walks the repo, parses entities, returns the rendered
+ * markdown body PLUS counts for the caller (which writes the file).
+ * Skipped silently if no .entity.ts files with @Entity are found —
+ * consumer probably uses Prisma / Drizzle / Supabase / raw SQL.
+ */
+export function buildEntitiesArtifact(repoRoot) {
+    const files = findEntityFiles(repoRoot);
+    if (files.length === 0) {
+        return {
+            written: false,
+            skippedReason: "no `*.entity.ts` files with `@Entity(...)` decorator found (TypeORM signal absent)",
+        };
+    }
+    const entities = [];
+    for (const f of files) {
+        try {
+            const src = readFileSync(f, "utf8");
+            const repoRelative = f.startsWith(repoRoot)
+                ? f.slice(repoRoot.length + 1)
+                : f;
+            const e = parseEntityFile(src, repoRelative);
+            if (e)
+                entities.push(e);
+        }
+        catch {
+            // Skip unreadable files silently.
+        }
+    }
+    if (entities.length === 0) {
+        return {
+            written: false,
+            skippedReason: `${files.length} candidate file(s) found but none parsed cleanly`,
+        };
+    }
+    return {
+        written: true,
+        body: renderEntitiesMarkdown(entities),
+        entityCount: entities.length,
+        relationCount: entities.reduce((n, e) => n + e.relations.length, 0),
+        fileCount: files.length,
+    };
+}
+// Test-only helper. Avoids exporting internals to the public surface.
+export const __testOnly__ = {
+    parseEntityFile,
+    walk,
+    entitiesToMermaidErd,
+    entitiesToSummaryTable,
+};
+// Avoid unused-import warning on `basename` if not used above.
+void basename;
+//# sourceMappingURL=emit-typeorm.js.map

package/dist/commands/map/emit-typeorm.js.map

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

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

@@ -1,5 +1,23 @@
 import type { CodeMap } from "./scan.js";
 export { emitTokensCatalog } from "./emit-tokens.js";
+export { buildEntitiesArtifact } from "./emit-typeorm.js";
+/**
+ * 0.19.0+ (slowcook#36) — TypeORM entity-graph emitter. Mirrors
+ * `emitSchemaDiagram`'s shape for the (different) Supabase-migration
+ * source. Skipped silently when no `*.entity.ts` files with `@Entity(`
+ * decorators are found — not every consumer uses TypeORM.
+ *
+ * Output: `.brewing/diagrams/entities.md` (Mermaid ERD + per-entity
+ * summary + agent-facing conventions header). Tracked in git by
+ * default per the updated init gitignore template (slowcook#38).
+ */
+export declare function emitEntitiesDiagram(repoRoot: string): {
+    written: boolean;
+    entityCount?: number;
+    relationCount?: number;
+    fileCount?: number;
+    skippedReason?: string;
+};
 export declare function map(argv: string[], cliVersion: string): Promise<void>;
 export declare function writeFreshMap(repoRoot: string, outJson: string, outMd: string, fresh: CodeMap): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/map/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAuFrD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E3E;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GACb,IAAI,CAMN;AAWD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAuBA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/map/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAeA;AAuFD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E3E;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GACb,IAAI,CAMN;AAWD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAuBA"}

package/dist/commands/map/index.js

@@ -4,7 +4,35 @@ import { generateMap } from "./scan.js";
 import { renderJson, renderMarkdown, mapsEqual, CODE_MAP_JSON_PATH, CODE_MAP_MD_PATH, } from "./render.js";
 import { ddlToMermaidErd } from "../refine/mermaid.js";
 import { emitTokensCatalog } from "./emit-tokens.js";
+import { buildEntitiesArtifact } from "./emit-typeorm.js";
 export { emitTokensCatalog } from "./emit-tokens.js";
+export { buildEntitiesArtifact } from "./emit-typeorm.js";
+/**
+ * 0.19.0+ (slowcook#36) — TypeORM entity-graph emitter. Mirrors
+ * `emitSchemaDiagram`'s shape for the (different) Supabase-migration
+ * source. Skipped silently when no `*.entity.ts` files with `@Entity(`
+ * decorators are found — not every consumer uses TypeORM.
+ *
+ * Output: `.brewing/diagrams/entities.md` (Mermaid ERD + per-entity
+ * summary + agent-facing conventions header). Tracked in git by
+ * default per the updated init gitignore template (slowcook#38).
+ */
+export function emitEntitiesDiagram(repoRoot) {
+    const r = buildEntitiesArtifact(repoRoot);
+    if (!r.written || !r.body) {
+        return { written: false, skippedReason: r.skippedReason };
+    }
+    const outDir = join(repoRoot, ".brewing/diagrams");
+    mkdirSync(outDir, { recursive: true });
+    const outPath = join(outDir, "entities.md");
+    writeFileSync(outPath, r.body, "utf8");
+    return {
+        written: true,
+        entityCount: r.entityCount,
+        relationCount: r.relationCount,
+        fileCount: r.fileCount,
+    };
+}
 function parseArgs(argv) {
     const args = {
         subcommand: "generate",

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/map/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,UAAU,EACV,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAuBrD,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAY;QACpB,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;QACvB,GAAG,EAAE,kBAAkB;QACvB,EAAE,EAAE,gBAAgB;QACpB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,KAAK;KAClB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;SAAM,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;QAC9C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,OAAO,IAAI,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YAAC,CAAC,EAAE,CAAC;QAAC,CAAC;aACpD,IAAI,CAAC,KAAK,OAAO,IAAI,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;YAAC,CAAC,EAAE,CAAC;QAAC,CAAC;aACpD,IAAI,CAAC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;YAAC,CAAC,EAAE,CAAC;QAAC,CAAC;aAClD,IAAI,CAAC,KAAK,eAAe,EAAE,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAAC,CAAC;aACtD,IAAI,CAAC,KAAK,eAAe,EAAE,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAAC,CAAC;aACtD,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAAC,SAAS,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,UAAkB;IAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,WAAW,CAAC;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,eAAe,EAAE,UAAU;KAC5B,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACnC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CACT,uCAAuC,YAAY,CAAC,WAAW,cAAc,YAAY,CAAC,eAAe,sBAAsB,CAChI,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,wBAAwB,YAAY,CAAC,aAAa,EAAE,CACrD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CACT,sCAAsC,YAAY,CAAC,UAAU,WAAW,YAAY,CAAC,SAAS,UAAU,YAAY,CAAC,UAAU,YAAY,YAAY,CAAC,YAAY,wBAAwB,CAC7L,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,wBAAwB,YAAY,CAAC,aAAa,EAAE,CACrD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;IAED,0DAA0D;IAC1D,EAAE;IACF,iEAAiE;IACjE,6DAA6D;IAC7D,gEAAgE;IAChE,kEAAkE;IAClE,8DAA8D;IAC9D,8DAA8D;IAC9D,WAAW;IACX,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CACT,yBAAyB,IAAI,CAAC,GAAG,+CAA+C;YAC9E,+FAA+F,CAClG,CAAC;QACF,OAAO;IACT,CAAC;IACD,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAY,CAAC;IACvE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,qCAAqC,IAAI,CAAC,GAAG,MAAO,CAAW,CAAC,OAAO,6CAA6C,CACrH,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,wBAAwB,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CACX,mCAAmC,IAAI,CAAC,GAAG,6EAA6E;QACtH,gBAAgB,aAAa,CAAC,QAAQ,CAAC,IAAI;QAC3C,gBAAgB,aAAa,CAAC,KAAK,CAAC,MAAM;QAC1C,iEAAiE;QACjE,mEAAmE;QACnE,uHAAuH,CAC1H,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,OAAe,EACf,KAAa,EACb,KAAc;IAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACnD,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,kBAAkB,MAAM,gBAAgB,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,KAAK,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,YAAY,CAAC,CAAC,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC,UAAU,CAAC,MAAM,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC3J,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAMhD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,mCAAmC,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,+BAA+B,EAAE,CAAC;IAC5E,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,uDAAuD;IACvD,gEAAgE;IAChE,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAExE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACnD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,MAAM,MAAM,GACV,0FAA0F;QAC1F,gBAAgB,KAAK,CAAC,MAAM,wDAAwD,CAAC;IACvF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AACvE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/map/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/run-mock/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/run-mock/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AA+HH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6KhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/run-mock/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAqJH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyPhF"}

package/dist/commands/run-mock/index.js

@@ -45,6 +45,7 @@ function parseArgs(argv) {
         pollSeconds: 15,
         skipInstall: false,
         branchOverride: null,
+        garnish: false,
     };
     // Positional first arg is story id (consumer convenience).
     if (argv.length > 0 && argv[0] && !argv[0].startsWith("-")) {
@@ -76,6 +77,9 @@ function parseArgs(argv) {
         else if (a === "--skip-install") {
             args.skipInstall = true;
         }
+        else if (a === "--garnish") {
+            args.garnish = true;
+        }
         else if (a === "--help" || a === "-h") {
             printHelp();
             process.exit(0);
@@ -109,6 +113,13 @@ Options:
   --poll-seconds <n>       Auto-pull interval (default 15; 0 disables).
   --no-poll                Disable auto-pull.
   --skip-install           Skip npm install even on lockfile drift.
+  --garnish                (0.19.0-α.16) DevTools Workspaces mode. Disables
+                           the review-overlay; instead prints Chrome
+                           Workspaces pairing instructions + watches
+                           mock/src/ for file saves. Each debounced batch
+                           runs vitest related + auto-commits via garnish
+                           on green (Tweaks-output-of: trailers recorded
+                           for learning signal).
 
 What it does:
   1. git fetch + git checkout the mockup branch
@@ -242,35 +253,61 @@ export async function runMock(argv, _cliVersion) {
     // without prompting the PM for a PAT. Uses `gh auth token` from the
     // local gh CLI; falls back silently when gh isn't installed or the
     // user hasn't logged in (overlay then uses its old PAT-prompt path).
+    //
+    // 0.19.0-α.16 — in --garnish mode the overlay is disabled, so we
+    // skip starting the proxy (saves a port + a couple of stderr lines).
     let proxy = null;
-    const ghToken = readGhToken();
-    if (ghToken) {
-        try {
-            proxy = await startGhProxy(ghToken);
-            console.log(`  proxy  gh-proxy on ${proxy.url} (no PAT prompt — uses 'gh auth token')`);
+    if (!args.garnish) {
+        const ghToken = readGhToken();
+        if (ghToken) {
+            try {
+                proxy = await startGhProxy(ghToken);
+                console.log(`  proxy  gh-proxy on ${proxy.url} (no PAT prompt — uses 'gh auth token')`);
+            }
+            catch (e) {
+                console.warn(`  proxy  gh-proxy failed to start (${e.message}); overlay will fall back to PAT prompt.`);
+            }
         }
-        catch (e) {
-            console.warn(`  proxy  gh-proxy failed to start (${e.message}); overlay will fall back to PAT prompt.`);
+        else {
+            console.warn(`  proxy  gh CLI not authenticated ('gh auth token' returned empty). Overlay will prompt for a PAT instead.`);
         }
     }
     else {
-        console.warn(`  proxy  gh CLI not authenticated ('gh auth token' returned empty). Overlay will prompt for a PAT instead.`);
+        console.log(`  proxy  skipped (--garnish mode; overlay disabled)`);
     }
     // Step 4: spawn next dev with env vars.
-    const env = {
-        ...process.env,
-        NEXT_PUBLIC_SLOWCOOK_REVIEW: "1",
-        NEXT_PUBLIC_SLOWCOOK_OWNER: detected.owner,
-        NEXT_PUBLIC_SLOWCOOK_REPO: detected.repo,
-        NEXT_PUBLIC_SLOWCOOK_PR_NUMBER: prNumber ? String(prNumber) : "0",
-        NEXT_PUBLIC_SLOWCOOK_STORY_ID: args.story,
-    };
-    if (proxy)
-        env["NEXT_PUBLIC_SLOWCOOK_GH_PROXY"] = proxy.url;
+    const env = { ...process.env };
+    if (!args.garnish) {
+        env["NEXT_PUBLIC_SLOWCOOK_REVIEW"] = "1";
+        env["NEXT_PUBLIC_SLOWCOOK_OWNER"] = detected.owner;
+        env["NEXT_PUBLIC_SLOWCOOK_REPO"] = detected.repo;
+        env["NEXT_PUBLIC_SLOWCOOK_PR_NUMBER"] = prNumber ? String(prNumber) : "0";
+        env["NEXT_PUBLIC_SLOWCOOK_STORY_ID"] = args.story;
+        if (proxy)
+            env["NEXT_PUBLIC_SLOWCOOK_GH_PROXY"] = proxy.url;
+    }
     console.log(`  npm    run dev (next dev :3100)`);
-    console.log(`         overlay env: REVIEW=1 OWNER=${detected.owner} REPO=${detected.repo} PR=${prNumber ?? "?"} STORY=${args.story}${proxy ? ` GH_PROXY=${proxy.url}` : ""}`);
-    if (!prNumber) {
-        console.warn(`         (no open mockup PR found for branch ${branch}; overlay submits will fail until one exists)`);
+    if (!args.garnish) {
+        console.log(`         overlay env: REVIEW=1 OWNER=${detected.owner} REPO=${detected.repo} PR=${prNumber ?? "?"} STORY=${args.story}${proxy ? ` GH_PROXY=${proxy.url}` : ""}`);
+        if (!prNumber) {
+            console.warn(`         (no open mockup PR found for branch ${branch}; overlay submits will fail until one exists)`);
+        }
+    }
+    else {
+        const srcDir = join(mockDir, "src");
+        console.log(`         (--garnish mode: overlay disabled; DevTools Workspaces pairing instructions below)`);
+        console.log(``);
+        console.log(`  ─── Chrome DevTools Workspaces ─────────────────────────────────────`);
+        console.log(`  Once-only setup (Chrome saves the workspace mapping after this):`);
+        console.log(`    1. Open the mock at  http://localhost:3100`);
+        console.log(`    2. F12 → Sources panel → Filesystem (left sidebar) → "+ Add folder"`);
+        console.log(`    3. Paste this path:  ${srcDir}`);
+        console.log(`    4. Approve the permission dialog Chrome shows`);
+        console.log(``);
+        console.log(`  After that, your DevTools Sources-panel edits save directly to`);
+        console.log(`  the mock app's source files. slowcook watches them + auto-commits.`);
+        console.log(`  ─────────────────────────────────────────────────────────────────────`);
+        console.log(``);
     }
     const dev = spawn("npm", ["run", "dev"], { cwd: mockDir, env, stdio: "inherit" });
     // Step 5: background poll for branch updates.
@@ -299,6 +336,66 @@ export async function runMock(argv, _cliVersion) {
             }
         }, args.pollSeconds * 1000);
     }
+    // Step 5b: --garnish mode — watch mock/src/ for file saves +
+    // auto-commit via the shared runGarnish core. Debounced so a flurry
+    // of saves (Chrome DevTools sometimes saves twice in quick succession;
+    // editors can too) collapses to one commit.
+    let watcher = null;
+    let watcherDebounceTimer = null;
+    let garnishInFlight = false;
+    if (args.garnish) {
+        const { watch } = await import("node:fs");
+        const { runGarnish } = await import("../garnish/index.js");
+        const watchTarget = join(mockDir, "src");
+        console.log(`[run-mock] watching ${watchTarget.replace(args.repoRoot + "/", "")} for file saves (debounce 1.5s)`);
+        const onSaveBatch = async () => {
+            if (garnishInFlight)
+                return; // skip overlapping runs
+            garnishInFlight = true;
+            try {
+                console.log(`\n[run-mock] file save detected; running tests + garnishing...`);
+                const result = await runGarnish({
+                    repoRoot: args.repoRoot,
+                    push: false,
+                });
+                if (result.kind === "no-changes") {
+                    console.log(`[run-mock] no committable changes (test files or transient saves).`);
+                }
+                else if (result.kind === "tests-failed") {
+                    console.log(`[run-mock] ✗ tests failed; not committing. Leave the file as-is + fix, slowcook will re-test on next save.`);
+                    const tail = result.outputTail.split("\n").slice(-12).join("\n");
+                    console.log(`  ${tail.replace(/\n/g, "\n  ")}`);
+                }
+                else {
+                    console.log(`[run-mock] ✓ garnished ${result.sha.slice(0, 7)} (${result.touchedFiles.length} file(s), ${result.agentRefCount} agent ref(s))`);
+                }
+            }
+            finally {
+                garnishInFlight = false;
+            }
+        };
+        try {
+            watcher = watch(watchTarget, { recursive: true }, (_eventType, filename) => {
+                if (!filename)
+                    return;
+                const f = filename.toString();
+                if (f.startsWith("node_modules/"))
+                    return;
+                if (f.startsWith(".next/"))
+                    return;
+                if (f.startsWith("scenarios/"))
+                    return; // vibe's output; tweaking these by hand is unusual
+                if (!/\.(tsx?|css|json)$/.test(f))
+                    return;
+                if (watcherDebounceTimer)
+                    clearTimeout(watcherDebounceTimer);
+                watcherDebounceTimer = setTimeout(() => { void onSaveBatch(); }, 1500);
+            });
+        }
+        catch (e) {
+            console.warn(`[run-mock] could not start file watcher (${e.message}); --garnish mode disabled.`);
+        }
+    }
     // Step 6: clean shutdown on Ctrl-C / dev exit. Pop any stash we
     // pushed in step 1 so the user's working tree is restored to its
     // pre-run-mock state — same UX guarantee as `git stash pop` after
@@ -306,6 +403,16 @@ export async function runMock(argv, _cliVersion) {
     const cleanup = (signal) => {
         if (pollTimer)
             clearInterval(pollTimer);
+        if (watcher) {
+            try {
+                watcher.close();
+            }
+            catch { /* ignore */ }
+        }
+        if (watcherDebounceTimer) {
+            clearTimeout(watcherDebounceTimer);
+            watcherDebounceTimer = null;
+        }
         if (proxy) {
             try {
                 proxy.close();