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

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/init/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/init/templates.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE;AAaD,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,gCAAgC,0CAA0C,CAAC;AACxF,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AAMpF,eAAO,MAAM,+BAA+B,2CAA2C,CAAC;AACxF,eAAO,MAAM,6BAA6B,yCAAyC,CAAC;AAEpF,wBAAgB,eAAe,IAAI,MAAM,CAoCxC;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAmD1C;AAED,wBAAgB,aAAa,IAAI,MAAM,CA0CtC;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAehE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQjE;AAED,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,MAAM,CA2CtC;AAED;;;;;;GAMG;AACH;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAsDvC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAgBzC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/init/templates.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE;AAaD,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,gCAAgC,0CAA0C,CAAC;AACxF,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AAMpF,eAAO,MAAM,+BAA+B,2CAA2C,CAAC;AACxF,eAAO,MAAM,6BAA6B,yCAAyC,CAAC;AAEpF,wBAAgB,eAAe,IAAI,MAAM,CAoCxC;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAmD1C;AAED,wBAAgB,aAAa,IAAI,MAAM,CA0CtC;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAehE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQjE;AAED,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,MAAM,CA2CtC;AAED;;;;;;GAMG;AACH;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAsDvC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAwBzC"}

package/dist/commands/init/templates.js

@@ -320,10 +320,18 @@ export function gitignoreSection() {
 .brewing/code-map.json
 .brewing/code-map.md
 .brewing/code-map.target.md
-# 0.13.5+ — brownfield extracts (schema.mmd, tokens.md). Same
-# rationale: regenerated each refine/investigate workflow run via
-# \`slowcook extract\`. Live as derived state, not in source control.
-.brewing/diagrams/
+# 0.13.5+ — brownfield extracts under .brewing/diagrams/. Ephemeral
+# files (schema.mmd, tokens.md) are regenerated each refine/investigate
+# workflow run via \`slowcook extract\` and SHOULD NOT be committed.
+# Hand-curated artifacts (entities.md, architecture.md, etc.) are
+# source-of-truth and SHOULD be tracked — \`!\` exceptions below
+# whitelist them. The \`/*\` form (vs trailing slash) is required for
+# the !-overrides to take effect.
+.brewing/diagrams/*
+!.brewing/diagrams/entities.md
+!.brewing/diagrams/architecture.md
+!.brewing/diagrams/sequence-*.md
+!.brewing/diagrams/.gitkeep
 ${SLOWCOOK_GITIGNORE_MARKER_END}
 `;
 }

package/dist/commands/init/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/init/templates.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sDAAsD;AAEtD,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,UAAU,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;;;0HAGiG,CAAC;AAS3H,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAuC,CAAC;AACxF,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AAEpF,sEAAsE;AACtE,oEAAoE;AACpE,mEAAmE;AACnE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,+BAA+B,GAAG,wCAAwC,CAAC;AACxF,MAAM,CAAC,MAAM,6BAA6B,GAAG,sCAAsC,CAAC;AAEpF,MAAM,UAAU,eAAe;IAC7B,OAAO,CACL,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,4BAA4B;QACrC,IAAI,EACF,qFAAqF;YACrF,6FAA6F;YAC7F,iEAAiE;QACnE,WAAW,EAAE;YACX,QAAQ;YACR,iBAAiB;YACjB,gBAAgB;YAChB,qBAAqB;SACtB;QACD,KAAK,EAAE;YACL,kBAAkB;YAClB,mBAAmB;YACnB,kBAAkB;YAClB,4BAA4B;YAC5B,qBAAqB;YACrB,qBAAqB;YACrB,gCAAgC;YAChC,4CAA4C;YAC5C,wCAAwC;SACzC;QACD,OAAO,EAAE;YACP,cAAc,EAAE;gBACd,gBAAgB,EAAE,CAAC,cAAc,EAAE,oBAAoB,CAAC;aACzD;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCR,CAAC;AACF,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,OAAO,GAAG,gCAAgC;;;;kCAIV,MAAM,CAAC,KAAK;kCACZ,MAAM,CAAC,KAAK;kCACZ,MAAM,CAAC,KAAK;kCACZ,MAAM,CAAC,KAAK;8CACA,MAAM,CAAC,KAAK;8CACZ,MAAM,CAAC,KAAK;8CACZ,MAAM,CAAC,KAAK;8CACZ,MAAM,CAAC,KAAK;EACxD,8BAA8B;CAC/B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,qEAAqE;IACrE,OAAO;;;;;EAKP,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCR,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;EAazC,6BAA6B;CAC9B,CAAC;AACF,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/init/templates.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sDAAsD;AAEtD,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,UAAU,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;;;0HAGiG,CAAC;AAS3H,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAuC,CAAC;AACxF,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AAEpF,sEAAsE;AACtE,oEAAoE;AACpE,mEAAmE;AACnE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,+BAA+B,GAAG,wCAAwC,CAAC;AACxF,MAAM,CAAC,MAAM,6BAA6B,GAAG,sCAAsC,CAAC;AAEpF,MAAM,UAAU,eAAe;IAC7B,OAAO,CACL,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,4BAA4B;QACrC,IAAI,EACF,qFAAqF;YACrF,6FAA6F;YAC7F,iEAAiE;QACnE,WAAW,EAAE;YACX,QAAQ;YACR,iBAAiB;YACjB,gBAAgB;YAChB,qBAAqB;SACtB;QACD,KAAK,EAAE;YACL,kBAAkB;YAClB,mBAAmB;YACnB,kBAAkB;YAClB,4BAA4B;YAC5B,qBAAqB;YACrB,qBAAqB;YACrB,gCAAgC;YAChC,4CAA4C;YAC5C,wCAAwC;SACzC;QACD,OAAO,EAAE;YACP,cAAc,EAAE;gBACd,gBAAgB,EAAE,CAAC,cAAc,EAAE,oBAAoB,CAAC;aACzD;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCR,CAAC;AACF,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,OAAO,GAAG,gCAAgC;;;;kCAIV,MAAM,CAAC,KAAK;kCACZ,MAAM,CAAC,KAAK;kCACZ,MAAM,CAAC,KAAK;kCACZ,MAAM,CAAC,KAAK;8CACA,MAAM,CAAC,KAAK;8CACZ,MAAM,CAAC,KAAK;8CACZ,MAAM,CAAC,KAAK;8CACZ,MAAM,CAAC,KAAK;EACxD,8BAA8B;CAC/B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,qEAAqE;IACrE,OAAO;;;;;EAKP,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCR,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;EAqBzC,6BAA6B;CAC9B,CAAC;AACF,CAAC"}

package/dist/commands/map/emit-typeorm.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 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.
+ */
+export interface TypeOrmColumn {
+    /** TS property name (camelCase). */
+    property: string;
+    /** SQL column name (snake_case, from `@Column({ name: 'snake_case' })`). */
+    columnName?: string;
+    /** TypeORM column type ('uuid', 'text', 'enum', 'jsonb', etc.). */
+    columnType?: string;
+    /** Whether the column is nullable. */
+    nullable?: boolean;
+    /** TS type from the property declaration (for context). */
+    tsType?: string;
+    /** JSDoc COLUMN-DESCRIPTION text, if present. */
+    description?: string;
+}
+export interface TypeOrmRelation {
+    /** TS property name on the entity. */
+    property: string;
+    /** Relation kind. */
+    kind: "ManyToOne" | "OneToOne" | "OneToMany" | "ManyToMany";
+    /** Target entity class name (the `() => User` part). */
+    target: string;
+    /** Optional foreign-key column name from @JoinColumn. */
+    joinColumn?: string;
+}
+export interface TypeOrmEntity {
+    /** Class name (PascalCase). */
+    className: string;
+    /** SQL table name from `@Entity('table_name')`. Falls back to class name in snake_case if missing. */
+    tableName: string;
+    /** Whether the class `extends BaseEntity`. */
+    extendsBaseEntity: boolean;
+    /** Repo-relative path to the source file. */
+    sourcePath: string;
+    /** JSDoc TABLE-DESCRIPTION text, if present. */
+    description?: string;
+    columns: TypeOrmColumn[];
+    relations: TypeOrmRelation[];
+}
+/**
+ * Recursive walk under `root` collecting absolute file paths matching
+ * the predicate. Skips EXCLUDED_DIRS at any depth.
+ */
+declare function walk(root: string, predicate: (path: string) => boolean): string[];
+/**
+ * Find all `*.entity.ts` files under `repoRoot` whose content contains
+ * an `@Entity(` decorator. Returns paths sorted alphabetically for
+ * deterministic output.
+ */
+export declare function findEntityFiles(repoRoot: string): string[];
+/**
+ * Parse one TypeORM entity source file. Returns null if no `@Entity`
+ * decorator is found (defense-in-depth — findEntityFiles already
+ * filtered).
+ */
+export declare function parseEntityFile(source: string, sourcePath: string): TypeOrmEntity | null;
+/**
+ * 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 declare function entitiesToMermaidErd(entities: TypeOrmEntity[]): string;
+/**
+ * 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 declare function entitiesToSummaryTable(entities: TypeOrmEntity[]): string;
+/**
+ * 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 declare function renderEntitiesMarkdown(entities: TypeOrmEntity[]): string;
+/**
+ * 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 declare function buildEntitiesArtifact(repoRoot: string): {
+    written: boolean;
+    body?: string;
+    entityCount?: number;
+    relationCount?: number;
+    fileCount?: number;
+    skippedReason?: string;
+};
+export declare const __testOnly__: {
+    parseEntityFile: typeof parseEntityFile;
+    walk: typeof walk;
+    entitiesToMermaidErd: typeof entitiesToMermaidErd;
+    entitiesToSummaryTable: typeof entitiesToSummaryTable;
+};
+export {};
+//# sourceMappingURL=emit-typeorm.d.ts.map

package/dist/commands/map/emit-typeorm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-typeorm.d.ts","sourceRoot":"","sources":["../../../src/commands/map/emit-typeorm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;IAC5D,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,EAAE,CA4B1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,aAAa,GAAG,IAAI,CA4EtB;AAgBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAuCtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAwBxE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAwCxE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAmCA;AAGD,eAAO,MAAM,YAAY;;;;;CAKxB,CAAC"}