@metaobjectsdev/codegen-ts 0.7.0-rc.9 → 0.8.0-rc.1

package/dist/overwrite-policy.d.ts

@@ -1,8 +1,45 @@
-export type WriteStatus = "new" | "overwrite" | "refused" | "skipped";
+export type WriteStatus = "new" | "unchanged" | "overwrite" | "merged" | "conflict" | "refused" | "skipped";
+/**
+ * "overwrite" — default; three-way merge if .gen-state exists, else write-if-
+ *   different / first-time-existing flow.
+ * "skip-existing" — never write over an existing file; status "skipped".
+ *   Useful for `meta gen --dry-run` style flows.
+ */
 export type MergeStrategy = "overwrite" | "skip-existing";
+/** "default" — the standard three-way merge flow described in the file header.
+ *  "fresh" — opt-in via `meta gen --baseline=fresh`. When .gen-state is absent
+ *  but the file exists, OVERWRITE with fresh content and seed .gen-state from
+ *  the fresh content (caveat 3 escape hatch). */
+export type BaselineMode = "default" | "fresh";
+export interface DecideAndWriteOpts {
+    strategy?: MergeStrategy;
+    /** Absolute path to the .gen-state/ root for this project. When undefined,
+     *  we fall back to a process-isolated tmpdir — fine for tests but the CLI
+     *  always supplies the real project value via runGen(). */
+    genStateDir?: string;
+    /** Path the snapshot is keyed by — usually the path relative to the
+     *  project root, but ANY stable identifier works. When undefined, derived
+     *  from `path` (so unit tests can call without supplying it). */
+    outputRelPath?: string;
+    /** First-time-existing-file behavior. */
+    baseline?: BaselineMode;
+}
 export interface WriteResult {
     path: string;
     status: WriteStatus;
+    /** Present when status is "conflict" — human-readable hint identifying the
+     *  file the user must resolve. */
+    conflictHint?: string;
+}
+/** Thrown when git is unavailable. Surfaces as a clear CLI error rather than
+ *  a generic ENOENT halfway through a regen. */
+export declare class GitMissingError extends Error {
+    constructor();
 }
-export declare function decideAndWrite(path: string, content: string, strategy?: MergeStrategy): WriteResult;
+/**
+ * The main entry point. Backward-compatible with the rc.11 signature: passing
+ * a `MergeStrategy` string as the third argument continues to work; passing
+ * an options object opts into three-way merge.
+ */
+export declare function decideAndWrite(path: string, content: string, optsOrStrategy?: DecideAndWriteOpts | MergeStrategy): WriteResult;
 //# sourceMappingURL=overwrite-policy.d.ts.map

package/dist/overwrite-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overwrite-policy.d.ts","sourceRoot":"","sources":["../src/overwrite-policy.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,eAAe,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAA2B,GACpC,WAAW,CAmBb"}
+{"version":3,"file":"overwrite-policy.d.ts","sourceRoot":"","sources":["../src/overwrite-policy.ts"],"names":[],"mappings":"AAqCA,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,WAAW,GACX,WAAW,GACX,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,eAAe,CAAC;AAE1D;;;iDAGiD;AACjD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;+DAE2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;qEAEiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB;sCACkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAoED;gDACgD;AAChD,qBAAa,eAAgB,SAAQ,KAAK;;CAQzC;AAsFD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,kBAAkB,GAAG,aAAkB,GACtD,WAAW,CAgGb"}

package/dist/overwrite-policy.js

@@ -1,23 +1,243 @@
-// Overwrite policy: drives the per-file write decision based on the @generated header.
-// Per design §8 — read-only generated files; refuse to clobber hand-written code.
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { dirname } from "node:path";
-import { GENERATED_HEADER } from "./constants.js";
-export function decideAndWrite(path, content, strategy = "overwrite") {
-    // 'skip-existing' only skips overwrites, not new files.
+// Overwrite policy: per-file write decision using three-way merge against a
+// canonical snapshot kept under `.metaobjects/.gen-state/`.
+//
+// Replaces the rc.11 marker-based clobber-or-refuse policy (strategy (a) from
+// spike 002) with strategy (b) — git-merge-file-driven three-way merge. The
+// `@generated` marker becomes purely informational (templates may still emit
+// it for human readers); the policy no longer consults it.
+//
+// Per-file flow:
+//
+//   1. Render fresh content to a tmpfile.
+//   2. If the output doesn't exist → write + copy to .gen-state/.
+//   3. If .gen-state/<relPath> exists → run `git merge-file --diff3` against
+//      (current, .gen-state snapshot, fresh tmpfile). Exit 0 → clean merge,
+//      advance .gen-state to fresh content. Exit > 0 → leave conflict markers
+//      in the output file, do NOT advance .gen-state; status "conflict".
+//   4. If .gen-state/<relPath> is absent but the file exists ("first-time
+//      regen on an existing file") → write-if-different against the existing
+//      file as the baseline (no merge, no clobber). The `baseline: "fresh"`
+//      flag opts into "overwrite from fresh and re-baseline".
+//
+// Integrity (caveat 2 from the spike): we keep a sha-256 of each canonical
+// snapshot at `.gen-state/.hashes.json`. On load, mismatch → fall back to
+// first-time semantics and warn naming the file so the user can investigate.
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, } from "node:fs";
+import { dirname, join, isAbsolute, relative, resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+import { tmpdir } from "node:os";
+import { createHash, randomBytes } from "node:crypto";
+const HASHES_FILE = ".hashes.json";
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function loadHashes(genStateDir) {
+    const f = join(genStateDir, HASHES_FILE);
+    if (!existsSync(f))
+        return {};
+    try {
+        const txt = readFileSync(f, "utf-8");
+        const parsed = JSON.parse(txt);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+function saveHashes(genStateDir, hashes) {
+    mkdirSync(genStateDir, { recursive: true });
+    writeFileSync(join(genStateDir, HASHES_FILE), JSON.stringify(hashes, null, 2) + "\n");
+}
+function snapshotPath(genStateDir, relPath) {
+    // `.hashes.json` is reserved at the top of .gen-state/; relPath must never
+    // collide with it. Output paths derived from entity names ("Post.ts" etc.)
+    // are JS-identifier-shape so this is a non-issue in practice.
+    return join(genStateDir, relPath);
+}
+/** Synchronously copy `src` content into the snapshot at `<genStateDir>/<relPath>`
+ *  and refresh the hash for `relPath`. */
+function advanceSnapshot(genStateDir, relPath, content) {
+    const dest = snapshotPath(genStateDir, relPath);
+    mkdirSync(dirname(dest), { recursive: true });
+    writeFileSync(dest, content);
+    const hashes = loadHashes(genStateDir);
+    hashes[relPath] = sha256(content);
+    saveHashes(genStateDir, hashes);
+}
+/** Return the snapshot text iff present AND the hash matches; else undefined. */
+function readSnapshotChecked(genStateDir, relPath) {
+    const path = snapshotPath(genStateDir, relPath);
+    if (!existsSync(path))
+        return undefined;
+    const text = readFileSync(path, "utf-8");
+    const hashes = loadHashes(genStateDir);
+    const expected = hashes[relPath];
+    if (expected !== undefined && expected !== sha256(text)) {
+        return undefined;
+    }
+    return { text };
+}
+/** Thrown when git is unavailable. Surfaces as a clear CLI error rather than
+ *  a generic ENOENT halfway through a regen. */
+export class GitMissingError extends Error {
+    constructor() {
+        super("meta gen: `git` binary not found on PATH. Three-way-merge regen " +
+            "requires git (any modern version). Install git and re-run.");
+        this.name = "GitMissingError";
+    }
+}
+/** Run `git merge-file --diff3 -L<...> <out> <base> <fresh>`. The output is
+ *  written in-place into `outPath`. Returns the exit code (0 = clean, > 0 =
+ *  conflicts) and the resulting file contents.
+ *
+ *  The git binary is "git" by default; set `META_GEN_GIT` in the environment
+ *  to a different path (useful for tests that simulate "git not installed"). */
+function runGitMergeFile(outPath, basePath, freshPath) {
+    const gitBin = process.env.META_GEN_GIT ?? "git";
+    let res;
+    try {
+        res = spawnSync(gitBin, [
+            "merge-file",
+            "--diff3",
+            "-L",
+            "your edits",
+            "-L",
+            "last generated",
+            "-L",
+            "fresh from meta gen",
+            outPath,
+            basePath,
+            freshPath,
+        ], { encoding: "utf-8" });
+    }
+    catch (err) {
+        const msg = err.message ?? "";
+        if (msg.includes("ENOENT"))
+            throw new GitMissingError();
+        throw err;
+    }
+    if (res.error) {
+        const code = res.error.code;
+        if (code === "ENOENT")
+            throw new GitMissingError();
+        throw res.error;
+    }
+    // `git merge-file` returns the conflict count (0 = clean, > 0 = conflicts,
+    // < 0 = error). Negative is unexpected — surface verbatim.
+    const exitCode = res.status ?? 0;
+    if (exitCode < 0) {
+        throw new Error(`git merge-file failed for ${outPath}: ${res.stderr || res.stdout}`);
+    }
+    const mergedContent = readFileSync(outPath, "utf-8");
+    return { exitCode, stderr: res.stderr ?? "", mergedContent };
+}
+/** Write `content` to a freshly-named tmpfile under the OS tmpdir; return the
+ *  path. Caller is responsible for cleanup (acceptable for codegen — tmpdir
+ *  is process-scoped). */
+function writeTmpfile(content) {
+    const dir = join(tmpdir(), "meta-gen-merge");
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${Date.now()}-${randomBytes(6).toString("hex")}.tmp`);
+    writeFileSync(path, content);
+    return path;
+}
+/** Resolve the snapshot key for a given output path. Falls back to a stable
+ *  hash-of-path so unit tests that pass arbitrary tmpdir outputs still get a
+ *  consistent .gen-state key. */
+function defaultOutputRelPath(outputPath) {
+    // Use sha256 of the absolute path → hex; lets tests work without supplying
+    // an explicit relPath. NOT used by the runner — runGen always passes the
+    // real project-relative path.
+    return sha256(resolve(outputPath)).slice(0, 32);
+}
+/**
+ * The main entry point. Backward-compatible with the rc.11 signature: passing
+ * a `MergeStrategy` string as the third argument continues to work; passing
+ * an options object opts into three-way merge.
+ */
+export function decideAndWrite(path, content, optsOrStrategy = {}) {
+    const opts = typeof optsOrStrategy === "string"
+        ? { strategy: optsOrStrategy }
+        : optsOrStrategy;
+    const strategy = opts.strategy ?? "overwrite";
+    const baseline = opts.baseline ?? "default";
+    const genStateDir = opts.genStateDir !== undefined
+        ? (isAbsolute(opts.genStateDir)
+            ? opts.genStateDir
+            : resolve(opts.genStateDir))
+        : join(tmpdir(), "meta-gen-state-fallback");
+    const relPath = opts.outputRelPath ?? defaultOutputRelPath(path);
+    // 1. First-time write — file doesn't exist.
     if (!existsSync(path)) {
         mkdirSync(dirname(path), { recursive: true });
         writeFileSync(path, content);
+        advanceSnapshot(genStateDir, relPath, content);
         return { path, status: "new" };
     }
-    const current = readFileSync(path, "utf-8");
-    if (!current.includes(GENERATED_HEADER)) {
-        return { path, status: "refused" };
-    }
     if (strategy === "skip-existing") {
         return { path, status: "skipped" };
     }
-    writeFileSync(path, content);
-    return { path, status: "overwrite" };
+    // 2. File exists. Load the canonical snapshot if any.
+    const snapshot = readSnapshotChecked(genStateDir, relPath);
+    // 3. First-time regen on a pre-existing file (no snapshot).
+    if (snapshot === undefined) {
+        const current = readFileSync(path, "utf-8");
+        if (baseline === "fresh") {
+            // Opt-in escape hatch: overwrite and seed the snapshot from fresh.
+            if (current === content) {
+                advanceSnapshot(genStateDir, relPath, content);
+                return { path, status: "unchanged" };
+            }
+            writeFileSync(path, content);
+            advanceSnapshot(genStateDir, relPath, content);
+            return { path, status: "overwrite" };
+        }
+        // Default: write-if-different. The EXISTING file is treated as the
+        // canonical baseline so subsequent runs do real three-way merges. If
+        // fresh output is identical, just seed the snapshot. If different, write
+        // the fresh content + seed snapshot — there's no marker policy left to
+        // refuse on, but this is the contract documented in the runbook (no
+        // marker check; users with hand-written files should never have the
+        // codegen output path colliding with them).
+        if (current === content) {
+            advanceSnapshot(genStateDir, relPath, current);
+            return { path, status: "unchanged" };
+        }
+        writeFileSync(path, content);
+        advanceSnapshot(genStateDir, relPath, content);
+        return { path, status: "overwrite" };
+    }
+    // 4. Snapshot exists — real three-way merge.
+    const current = readFileSync(path, "utf-8");
+    // Fast path: nothing changed.
+    if (current === content && snapshot.text === content) {
+        return { path, status: "unchanged" };
+    }
+    const baseTmp = writeTmpfile(snapshot.text);
+    const freshTmp = writeTmpfile(content);
+    const outcome = runGitMergeFile(path, baseTmp, freshTmp);
+    if (outcome.exitCode === 0) {
+        // Clean merge — advance the canonical snapshot to fresh.
+        advanceSnapshot(genStateDir, relPath, content);
+        // Distinguish "user had no changes vs canonical" from "merge integrated
+        // edits". The fresh equals snapshot case happened above (fast path) — so
+        // if outcome.mergedContent equals fresh we report a plain overwrite,
+        // otherwise it's a merge that pulled in user edits.
+        if (outcome.mergedContent === content) {
+            return { path, status: "overwrite" };
+        }
+        return { path, status: "merged" };
+    }
+    // Conflict — do NOT advance the snapshot. The output now contains diff3
+    // markers from git merge-file.
+    return {
+        path,
+        status: "conflict",
+        conflictHint: "merge conflict — resolve `<<<<<<<` markers and re-run `meta gen` to " +
+            "advance the canonical state.",
+    };
 }
 //# sourceMappingURL=overwrite-policy.js.map

package/dist/overwrite-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"overwrite-policy.js","sourceRoot":"","sources":["../src/overwrite-policy.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,kFAAkF;AAElF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAUlD,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAe,EACf,WAA0B,WAAW;IAErC,wDAAwD;IACxD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"overwrite-policy.js","sourceRoot":"","sources":["../src/overwrite-policy.ts"],"names":[],"mappings":"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"}

package/dist/render-context.d.ts

@@ -35,6 +35,8 @@ export interface RenderContext {
     columnNamingStrategy: ColumnNamingStrategy;
     /** Path prefix applied to generated route registrations + hook fetch URLs. Defaults to "". */
     apiPrefix: string;
+    /** Whether abstract entities emit their shape artifact (type-only interface / value-object file). Defaults to true. Instance/write artifacts are never emitted for abstract entities regardless. */
+    emitAbstractShapes: boolean;
     /** Output layout mode: "flat" (default) — all files in outDir; "package" — sub-paths from entity metadata package. */
     outputLayout: OutputLayout;
     /** The target THIS generator emits to (drives path layout + same-target imports). */
@@ -48,11 +50,12 @@ export interface RenderContext {
     packageOf: Map<string, string | undefined>;
 }
 /** Optional shape — `extStyle`, `omImport`, `columnNamingStrategy`, `apiPrefix`, `outputLayout`, and `packageOf` default if omitted. `packageOf` defaults to an empty Map (correct for flat layout; `runGen` always provides the real map). */
-export type RenderContextInput = Omit<RenderContext, "extStyle" | "omImport" | "columnNamingStrategy" | "apiPrefix" | "outputLayout" | "packageOf" | "selfTarget" | "entityModuleTarget"> & {
+export type RenderContextInput = Omit<RenderContext, "extStyle" | "omImport" | "columnNamingStrategy" | "apiPrefix" | "emitAbstractShapes" | "outputLayout" | "packageOf" | "selfTarget" | "entityModuleTarget"> & {
     extStyle?: ExtStyle;
     omImport?: string;
     columnNamingStrategy?: ColumnNamingStrategy;
     apiPrefix?: string;
+    emitAbstractShapes?: boolean;
     outputLayout?: OutputLayout;
     packageOf?: Map<string, string | undefined>;
     selfTarget?: ResolvedTarget;

package/dist/render-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,QAAQ,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,QAAQ,CAAC;IACnB,gGAAgG;IAChG,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC;IAClB,sHAAsH;IACtH,YAAY,EAAE,YAAY,CAAC;IAC3B,qFAAqF;IACrF,UAAU,EAAE,cAAc,CAAC;IAC3B,oEAAoE;IACpE,kBAAkB,EAAE,cAAc,CAAC;IACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,iEAAiE;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB,uGAAuG;IACvG,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5C;AAED,+OAA+O;AAC/O,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,UAAU,GAAG,sBAAsB,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,oBAAoB,CAAC,GAAG;IAC1L,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,kBAAkB,CAAC,EAAE,cAAc,CAAC;CACrC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE7D;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAoBzE"}
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,QAAQ,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,QAAQ,CAAC;IACnB,gGAAgG;IAChG,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC;IAClB,oMAAoM;IACpM,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sHAAsH;IACtH,YAAY,EAAE,YAAY,CAAC;IAC3B,qFAAqF;IACrF,UAAU,EAAE,cAAc,CAAC;IAC3B,oEAAoE;IACpE,kBAAkB,EAAE,cAAc,CAAC;IACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,iEAAiE;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB,uGAAuG;IACvG,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5C;AAED,+OAA+O;AAC/O,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,UAAU,GAAG,sBAAsB,GAAG,WAAW,GAAG,oBAAoB,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,oBAAoB,CAAC,GAAG;IACjN,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,kBAAkB,CAAC,EAAE,cAAc,CAAC;CACrC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE7D;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAqBzE"}

package/dist/render-context.js

@@ -19,6 +19,7 @@ export function makeRenderContext(opts) {
         omImport: opts.omImport ?? "../index",
         columnNamingStrategy: opts.columnNamingStrategy ?? "snake_case",
         apiPrefix: opts.apiPrefix ?? "",
+        emitAbstractShapes: opts.emitAbstractShapes ?? true,
         outputLayout,
         packageOf: opts.packageOf ?? new Map(),
         selfTarget: defaultTarget,

package/dist/render-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAkEhE,0EAA0E;AAC1E,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAe;IACnD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IACjD,MAAM,aAAa,GAAmB,IAAI,CAAC,UAAU,IAAI;QACvD,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,SAAS;QACrB,YAAY;QACZ,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;IACF,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,UAAU;QACrC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,YAAY;QAC/D,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,YAAY;QACZ,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,GAAG,EAAE;QACtC,UAAU,EAAE,aAAa;QACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,aAAa;KAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAqEhE,0EAA0E;AAC1E,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAe;IACnD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IACjD,MAAM,aAAa,GAAmB,IAAI,CAAC,UAAU,IAAI;QACvD,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,SAAS;QACrB,YAAY;QACZ,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;IACF,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,UAAU;QACrC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,YAAY;QAC/D,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,IAAI;QACnD,YAAY;QACZ,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,GAAG,EAAE;QACtC,UAAU,EAAE,aAAa;QACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,aAAa;KAC7D,CAAC;AACJ,CAAC"}

package/dist/render-engine/framework-provider.d.ts

@@ -0,0 +1,28 @@
+import type { Provider } from "@metaobjectsdev/render";
+/** Provider backed by an arbitrary on-disk template directory. References
+ *  resolve as `<dir>/<ref>.mustache`. Used by both the framework default
+ *  and adopter override paths. */
+export declare class FileSystemProvider implements Provider {
+    private readonly root;
+    constructor(root: string);
+    resolve(ref: string): string | undefined;
+}
+/** The framework defaults provider — resolves refs against codegen-ts's own
+ *  `templates/` directory. */
+export declare const frameworkTemplatesProvider: Provider;
+/** Compose providers: first match wins. Adopters typically chain
+ *  `[projectProvider, frameworkTemplatesProvider]` so their own templates
+ *  override the framework defaults. */
+export declare class ProviderChain implements Provider {
+    private readonly providers;
+    constructor(providers: readonly Provider[]);
+    resolve(ref: string): string | undefined;
+}
+/** Build a project-scoped Provider: layers an optional project `templates/`
+ *  directory over the framework defaults. Returns just the framework provider
+ *  when `projectRoot` is undefined / its `templates/` dir doesn't exist. */
+export declare function projectProvider(projectRoot?: string): Provider;
+/** Exposed for tests that want to inspect / clear the resolved framework
+ *  templates directory (don't use outside tests). */
+export declare const __frameworkTemplatesDirForTests: string;
+//# sourceMappingURL=framework-provider.d.ts.map

package/dist/render-engine/framework-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-provider.d.ts","sourceRoot":"","sources":["../../src/render-engine/framework-provider.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA6CvD;;kCAEkC;AAClC,qBAAa,kBAAmB,YAAW,QAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAKzC;AAED;8BAC8B;AAC9B,eAAO,MAAM,0BAA0B,EAAE,QAExC,CAAC;AAEF;;uCAEuC;AACvC,qBAAa,aAAc,YAAW,QAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS,QAAQ,EAAE;IAC3D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAOzC;AAED;;4EAE4E;AAC5E,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAQ9D;AAED;qDACqD;AACrD,eAAO,MAAM,+BAA+B,QAA0B,CAAC"}

package/dist/render-engine/framework-provider.js

@@ -0,0 +1,104 @@
+// FrameworkTemplateProvider — resolves template refs (e.g. "docs/entity-page.md")
+// against the codegen-ts package's `templates/` directory. Adopters who want
+// to override a framework template create their own `templates/<ref>.mustache`
+// file in their project; `ProviderChain` (below) consults the project first
+// and falls back to the framework defaults.
+//
+// Decision D1 from the template-driven-codegen design — hybrid: framework
+// ships defaults, adopters override by file-system convention.
+//
+// The framework Provider is filesystem-backed so it works identically whether
+// codegen-ts runs from source (bun, dev) or from `dist/` (npm install). The
+// `templates/` directory is included in the published tarball via
+// package.json `files: ["dist", "src", "templates", ...]`.
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+/** Canonical shipped template — used to verify a candidate framework
+ *  templates directory actually contains our defaults. Without this check a
+ *  hoisted-install layout (pnpm/bun workspaces) can walk up to a CONSUMER
+ *  package.json and silently return a templates dir that doesn't exist. */
+const CANONICAL_TEMPLATE_REL = "docs/entity-page.md.mustache";
+/** Walk up from `start` until we find a `package.json` whose neighbour
+ *  `templates/` directory contains our canonical shipped template (i.e., the
+ *  codegen-ts package root). Works the same way from
+ *  `src/render-engine/framework-provider.ts` (during dev) and
+ *  `dist/render-engine/framework-provider.js` (after `npm install`). */
+function findFrameworkTemplatesDir(start) {
+    let dir = start;
+    while (true) {
+        const pkgJson = join(dir, "package.json");
+        if (existsSync(pkgJson)) {
+            const templatesDir = join(dir, "templates");
+            // Assert we landed at the codegen-ts package root, not a consumer's.
+            if (existsSync(join(templatesDir, CANONICAL_TEMPLATE_REL))) {
+                return templatesDir;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`framework templates dir unresolved: walked up from ${start} without finding a package.json ` +
+        `whose templates/${CANONICAL_TEMPLATE_REL} exists. This usually means codegen-ts was installed ` +
+        `via a hoisted layout (pnpm/bun workspaces) into an unexpected location, or the published ` +
+        `tarball is missing the templates/ directory.`);
+}
+// In ESM (CLAUDE.md: "ESM only. No CommonJS."), `import.meta.url` is
+// guaranteed to be a file: URL; no defensive try/catch needed.
+const SELF_DIR = dirname(fileURLToPath(import.meta.url));
+const FRAMEWORK_TEMPLATES_DIR = findFrameworkTemplatesDir(SELF_DIR);
+/** Provider backed by an arbitrary on-disk template directory. References
+ *  resolve as `<dir>/<ref>.mustache`. Used by both the framework default
+ *  and adopter override paths. */
+export class FileSystemProvider {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    resolve(ref) {
+        const path = join(this.root, `${ref}.mustache`);
+        if (!existsSync(path))
+            return undefined;
+        return readFileSync(path, "utf-8");
+    }
+}
+/** The framework defaults provider — resolves refs against codegen-ts's own
+ *  `templates/` directory. */
+export const frameworkTemplatesProvider = new FileSystemProvider(FRAMEWORK_TEMPLATES_DIR);
+/** Compose providers: first match wins. Adopters typically chain
+ *  `[projectProvider, frameworkTemplatesProvider]` so their own templates
+ *  override the framework defaults. */
+export class ProviderChain {
+    providers;
+    constructor(providers) {
+        this.providers = providers;
+    }
+    resolve(ref) {
+        for (const p of this.providers) {
+            const text = p.resolve(ref);
+            if (text !== undefined)
+                return text;
+        }
+        return undefined;
+    }
+}
+/** Build a project-scoped Provider: layers an optional project `templates/`
+ *  directory over the framework defaults. Returns just the framework provider
+ *  when `projectRoot` is undefined / its `templates/` dir doesn't exist. */
+export function projectProvider(projectRoot) {
+    if (projectRoot === undefined)
+        return frameworkTemplatesProvider;
+    const projTemplates = resolve(projectRoot, "templates");
+    if (!existsSync(projTemplates))
+        return frameworkTemplatesProvider;
+    return new ProviderChain([
+        new FileSystemProvider(projTemplates),
+        frameworkTemplatesProvider,
+    ]);
+}
+/** Exposed for tests that want to inspect / clear the resolved framework
+ *  templates directory (don't use outside tests). */
+export const __frameworkTemplatesDirForTests = FRAMEWORK_TEMPLATES_DIR;
+//# sourceMappingURL=framework-provider.js.map

package/dist/render-engine/framework-provider.js.map

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

package/dist/runner.d.ts

@@ -1,6 +1,6 @@
 import type { MetaData } from "@metaobjectsdev/metadata";
 import type { MetaobjectsGenConfig } from "./metaobjects-config.js";
-import { type WriteResult, type MergeStrategy } from "./overwrite-policy.js";
+import { type WriteResult, type MergeStrategy, type BaselineMode } from "./overwrite-policy.js";
 export interface RunGenOpts {
     config: MetaobjectsGenConfig;
     metadata: MetaData;
@@ -8,10 +8,24 @@ export interface RunGenOpts {
     entityFilter?: string[];
     /** Overwrite strategy passed to decideAndWrite. Defaults to "overwrite". */
     mergeStrategy?: MergeStrategy;
+    /** Project root (used to derive the .gen-state/ snapshot directory and to
+     *  key snapshots by project-relative output path). When omitted, falls back
+     *  to process.cwd(). */
+    projectRoot?: string;
+    /** Override the snapshot directory location. Defaults to
+     *  `<projectRoot>/.metaobjects/.gen-state/`. */
+    genStateDir?: string;
+    /** First-time-on-existing-file behavior. Defaults to "default" (write-if-
+     *  different). "fresh" → overwrite and re-baseline (the `--baseline=fresh`
+     *  CLI flag). */
+    baseline?: BaselineMode;
 }
 export interface RunGenResult {
     files: WriteResult[];
     warnings: string[];
+    /** Subset of `files` with status "conflict" — surfaced separately so the
+     *  CLI can print the end-of-run summary. */
+    conflicts: WriteResult[];
 }
 export declare function runGen(opts: RunGenOpts): Promise<RunGenResult>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,0BAA0B,CAAC;AAGrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAMpE,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM7F,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAmJpE"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,0BAA0B,CAAC;AAGrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAMpE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;4BAEwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;oDACgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;qBAEiB;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;gDAC4C;IAC5C,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CA2LpE"}