@metaobjectsdev/cli 0.5.0-rc.1

package/dist/src/lib/output.js

@@ -0,0 +1,96 @@
+// Output formatters for meta gen and meta migrate.
+//
+// TTY-gated glyphs: unicode (✓ ↺ ✗ = ⚠) when stdout is a TTY, plain words
+// (NEW MERGED CONFLICT UNCHANGED REFUSED) otherwise. Per SP5 §5.1.
+const GEN_GLYPHS = {
+    new: "✓",
+    merged: "↺",
+    conflict: "✗",
+    unchanged: "=",
+    refused: "⚠",
+};
+const GEN_WORDS = {
+    new: "NEW",
+    merged: "MERGED",
+    conflict: "CONFLICT",
+    unchanged: "UNCHANGED",
+    refused: "REFUSED",
+};
+export function formatGenResult(result, opts) {
+    const symbols = opts.isTTY ? GEN_GLYPHS : GEN_WORDS;
+    const header = `meta gen${result.dryRun ? " --dry-run" : ""} — ${result.dialect}, ${result.outDir}`;
+    if (result.files.length === 0) {
+        return `${header}\n\n  No entities to generate.\n`;
+    }
+    const lines = [header, ""];
+    const maxPathLen = Math.max(...result.files.map((f) => f.path.length));
+    for (const file of result.files) {
+        const sym = symbols[file.status];
+        const pathPadded = file.path.padEnd(maxPathLen);
+        const infoSegment = file.info.length > 0 ? `  (${file.info})` : "";
+        if (opts.isTTY) {
+            lines.push(`  ${sym}  ${pathPadded}  ${file.status}${infoSegment}`);
+        }
+        else {
+            lines.push(`  ${sym.padEnd(9)}  ${pathPadded}${infoSegment}`);
+        }
+    }
+    const counts = result.files.reduce((acc, f) => {
+        acc[f.status] = (acc[f.status] ?? 0) + 1;
+        return acc;
+    }, { new: 0, merged: 0, conflict: 0, unchanged: 0, refused: 0 });
+    const parts = [];
+    if (counts.new > 0)
+        parts.push(`${counts.new} written`);
+    if (counts.merged > 0)
+        parts.push(`${counts.merged} merged`);
+    if (counts.conflict > 0)
+        parts.push(`${counts.conflict} conflict`);
+    if (counts.unchanged > 0)
+        parts.push(`${counts.unchanged} unchanged`);
+    if (counts.refused > 0)
+        parts.push(`${counts.refused} refused`);
+    lines.push("", `  ${parts.join(", ")}`, "");
+    if (result.warnings.length > 0) {
+        lines.push("Warnings:", ...result.warnings.map((w) => `  - ${w}`), "");
+    }
+    return lines.join("\n");
+}
+export function formatMigrateResult(result, _opts) {
+    const header = `meta migrate${result.dryRun ? " --dry-run" : ""} — ${result.dialect}, ${result.displayUrl}`;
+    const lines = [header, ""];
+    const changeEntries = Object.entries(result.changeCounts).filter(([, v]) => v > 0);
+    if (changeEntries.length === 0 && result.blocked.length === 0 && result.ambiguous.length === 0) {
+        return `${header}\n\n  No schema changes.\n`;
+    }
+    if (changeEntries.length > 0) {
+        const summary = changeEntries.map(([k, v]) => `${v} ${k}`).join(", ");
+        lines.push(`  Changes: ${summary}`, "");
+    }
+    if (result.blocked.length > 0) {
+        lines.push("  Blocked (re-run with --allow):");
+        for (const b of result.blocked) {
+            lines.push(`    ${b.kind}  ${b.description}  (--allow ${b.allowFlag})`);
+        }
+        lines.push("");
+    }
+    if (result.ambiguous.length > 0) {
+        lines.push("  Ambiguous (re-run with --on-ambiguous):");
+        for (const a of result.ambiguous) {
+            lines.push(`    ${a.kind}  ${a.description}  (${a.hint})`);
+        }
+        lines.push("");
+    }
+    if (result.writtenPaths.length > 0) {
+        lines.push("  Written:");
+        for (const p of result.writtenPaths) {
+            lines.push(`    ${p}`);
+        }
+        lines.push("");
+    }
+    else if (result.blocked.length > 0 || result.ambiguous.length > 0) {
+        lines.push("  No migration written. Resolve flags and re-run.", "");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=output.js.map

package/dist/src/lib/output.js.map

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

package/dist/src/lib/projection-migrations.d.ts

@@ -0,0 +1,34 @@
+import { type MetaData } from "@metaobjectsdev/metadata";
+import { type ViewMigrationsResult } from "@metaobjectsdev/migrate-ts";
+/** view-name → set of source-table names the view's SELECT depends on. */
+export type ProjectionViewDependencies = ReadonlyMap<string, ReadonlySet<string>>;
+export interface ProjectionMigrationsOpts {
+    readonly metadata: MetaData;
+    readonly dialect: "postgres" | "sqlite";
+    readonly allowBreaking?: boolean;
+    /** Column naming strategy forwarded to extractViewSpec. Defaults to "snake_case". */
+    readonly columnNamingStrategy?: "snake_case" | "literal" | "kebab-case";
+    /**
+     * Existing view SQL keyed by view name (from sqlite_master.sql or
+     * pg_views.definition). When provided, projections whose emitted CREATE
+     * SQL matches the existing definition (whitespace-normalized) are skipped
+     * — no DROP+CREATE noise for unchanged views.
+     */
+    readonly existingViewSql?: ReadonlyMap<string, string>;
+}
+/**
+ * Walk all projection entities in metadata, extract their ViewSpec, emit CREATE
+ * VIEW DDL, and compute view migration SQL via computeViewMigrations.
+ *
+ * Currently treats every projection as a new view (no previous-shape tracking).
+ * Future: introspect existing views from the live DB to do safe-append/replace
+ * detection.
+ */
+export declare function computeProjectionMigrations(opts: ProjectionMigrationsOpts): ViewMigrationsResult;
+/**
+ * For each projection view, compute the set of source table names that the
+ * view's SELECT depends on (base entity + all joined entities). Used by the
+ * CLI to pre-drop only the views whose source tables are being recreated.
+ */
+export declare function computeProjectionViewDependencies(opts: Pick<ProjectionMigrationsOpts, "metadata" | "columnNamingStrategy">): ProjectionViewDependencies;
+//# sourceMappingURL=projection-migrations.d.ts.map

package/dist/src/lib/projection-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-migrations.d.ts","sourceRoot":"","sources":["../../../src/lib/projection-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAEpC,0EAA0E;AAC1E,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;IACxE;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxD;AAOD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,wBAAwB,GAC7B,oBAAoB,CAoEtB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,UAAU,GAAG,sBAAsB,CAAC,GACxE,0BAA0B,CAgC5B"}

package/dist/src/lib/projection-migrations.js

@@ -0,0 +1,112 @@
+import { resolveTableName, MetaRoot, } from "@metaobjectsdev/metadata";
+import { isProjection, extractViewSpec, emitViewDdl, } from "@metaobjectsdev/codegen-ts";
+import { computeViewMigrations, } from "@metaobjectsdev/migrate-ts";
+/** Collapse whitespace + strip trailing ";" for textual view-SQL comparison. */
+function normalizeViewSql(sql) {
+    return sql.replace(/\s+/g, " ").replace(/;\s*$/, "").trim();
+}
+/**
+ * Walk all projection entities in metadata, extract their ViewSpec, emit CREATE
+ * VIEW DDL, and compute view migration SQL via computeViewMigrations.
+ *
+ * Currently treats every projection as a new view (no previous-shape tracking).
+ * Future: introspect existing views from the live DB to do safe-append/replace
+ * detection.
+ */
+export function computeProjectionMigrations(opts) {
+    // loadMemory now returns MetaRoot; guard here also covers callers that pass a
+    // plain MetaData (e.g. test helpers or external callers with non-MetaRoot roots).
+    if (!(opts.metadata instanceof MetaRoot)) {
+        throw new Error("computeProjectionMigrations: opts.metadata must be a loaded MetaRoot.");
+    }
+    const root = opts.metadata;
+    const columnNamingStrategy = opts.columnNamingStrategy ?? "snake_case";
+    // Collect all writable entities for table name resolution.
+    const joinTables = {};
+    for (const obj of root.objects()) {
+        joinTables[obj.name] = resolveTableName(obj);
+    }
+    // Find projection entities.
+    const projections = root.objects().filter(isProjection);
+    if (projections.length === 0) {
+        return { migrations: [], errors: [] };
+    }
+    const views = [];
+    for (const projection of projections) {
+        const spec = extractViewSpec(projection, root, { columnNamingStrategy });
+        const baseTableName = joinTables[spec.joinTree.baseEntity];
+        if (!baseTableName) {
+            return {
+                migrations: [],
+                errors: [
+                    `Projection ${projection.name}: base entity "${spec.joinTree.baseEntity}" has no resolvable table name.`,
+                ],
+            };
+        }
+        const createSql = emitViewDdl(spec, {
+            dialect: opts.dialect,
+            baseTableName,
+            joinTables,
+        });
+        // Skip if the existing DB view's CREATE SQL matches what we'd emit.
+        // Avoids the "every migration re-creates every view" noise when nothing
+        // about the view's body actually changed.
+        const existing = opts.existingViewSql?.get(spec.viewName);
+        if (existing !== undefined && normalizeViewSql(existing) === normalizeViewSql(createSql)) {
+            continue;
+        }
+        views.push({
+            viewName: spec.viewName,
+            // prevShape intentionally absent — treated as "safe-append" by
+            // computeViewMigrations (source-aware-diff.ts line 32). On Postgres
+            // this rewrites the emitted "CREATE VIEW" to "CREATE OR REPLACE VIEW",
+            // so re-running migrate is idempotent.
+            nextShape: {
+                columns: spec.selectSpec.columns.map((c) => c.dbColAlias),
+            },
+            createSql,
+        });
+    }
+    return computeViewMigrations({
+        dialect: opts.dialect,
+        allowBreaking: opts.allowBreaking ?? false,
+        views,
+    });
+}
+/**
+ * For each projection view, compute the set of source table names that the
+ * view's SELECT depends on (base entity + all joined entities). Used by the
+ * CLI to pre-drop only the views whose source tables are being recreated.
+ */
+export function computeProjectionViewDependencies(opts) {
+    if (!(opts.metadata instanceof MetaRoot)) {
+        throw new Error("computeProjectionViewDependencies: opts.metadata must be a loaded MetaRoot.");
+    }
+    const root = opts.metadata;
+    const columnNamingStrategy = opts.columnNamingStrategy ?? "snake_case";
+    const tableByEntity = {};
+    for (const obj of root.objects()) {
+        tableByEntity[obj.name] = resolveTableName(obj);
+    }
+    const result = new Map();
+    const projections = root.objects().filter(isProjection);
+    for (const projection of projections) {
+        const spec = extractViewSpec(projection, root, { columnNamingStrategy });
+        const tables = new Set();
+        const baseTable = tableByEntity[spec.joinTree.baseEntity];
+        if (baseTable)
+            tables.add(baseTable);
+        const walk = (joins) => {
+            for (const j of joins) {
+                const t = tableByEntity[j.targetEntity];
+                if (t)
+                    tables.add(t);
+                walk(j.children);
+            }
+        };
+        walk(spec.joinTree.joins);
+        result.set(spec.viewName, tables);
+    }
+    return result;
+}
+//# sourceMappingURL=projection-migrations.js.map

package/dist/src/lib/projection-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-migrations.js","sourceRoot":"","sources":["../../../src/lib/projection-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,QAAQ,GAET,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AAoBpC,gFAAgF;AAChF,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAA8B;IAE9B,8EAA8E;IAC9E,kFAAkF;IAClF,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,YAAY,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,IAAI,YAAY,CAAC;IAEvE,2DAA2D;IAC3D,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACjC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAExD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAEzE,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;gBACL,UAAU,EAAE,EAAE;gBACd,MAAM,EAAE;oBACN,cAAc,UAAU,CAAC,IAAI,kBAAkB,IAAI,CAAC,QAAQ,CAAC,UAAU,iCAAiC;iBACzG;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE;YAClC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa;YACb,UAAU;SACX,CAAC,CAAC;QAEH,oEAAoE;QACpE,wEAAwE;QACxE,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,QAAQ,KAAK,SAAS,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzF,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,+DAA+D;YAC/D,oEAAoE;YACpE,uEAAuE;YACvE,uCAAuC;YACvC,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;aAC1D;YACD,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,qBAAqB,CAAC;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;QAC1C,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAAyE;IAEzE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,YAAY,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,IAAI,YAAY,CAAC;IAEvE,MAAM,aAAa,GAA2B,EAAE,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACjC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAExD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,KAAoD,EAAQ,EAAE;YAC1E,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;gBACxC,IAAI,CAAC;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@metaobjectsdev/cli",
+  "version": "0.5.0-rc.1",
+  "description": "CLI for MetaObjects: scaffold, codegen, migrate, and drift-detection commands.",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "bin": {
+    "meta": "./dist/bin/meta.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": ["dist", "src", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc -p tsconfig.typecheck.json"
+  },
+  "license": "Apache-2.0",
+  "author": "Doug Mealing <doug@dougmealing.com>",
+  "homepage": "https://metaobjects.dev",
+  "bugs": {
+  "url": "https://github.com/metaobjectsdev/metaobjects/issues"
+},
+"repository": {
+  "type": "git",
+  "url": "https://github.com/metaobjectsdev/metaobjects.git",
+  "directory": "server/typescript/packages/cli"
+},
+"keywords": ["metaobjects", "cli", "scaffold", "codegen", "drift-detection"],
+"dependencies": {
+  "@metaobjectsdev/sdk": "0.5.0",
+  "@metaobjectsdev/metadata": "0.5.0",
+  "@metaobjectsdev/codegen-ts": "0.5.0",
+  "@metaobjectsdev/codegen-ts-react": "0.5.0",
+  "@metaobjectsdev/codegen-ts-tanstack": "0.5.0",
+  "@metaobjectsdev/migrate-ts": "0.5.0",
+  "jiti": "^2.4.0"
+},
+"peerDependencies": {
+  "kysely": ">=0.27.0",
+  "pg": ">=8.0.0",
+  "@libsql/kysely-libsql": ">=0.4.0"
+},
+"peerDependenciesMeta": {
+  "pg": {
+  "optional": true
+},
+"@libsql/kysely-libsql": {
+"optional": true
+}
+},
+"devDependencies": {
+  "bun-types": "latest",
+  "typescript": "^5.6.0",
+  "@types/node": "^22.0.0",
+  "@libsql/kysely-libsql": "^0.4.1",
+  "@libsql/client": "^0.14.0",
+  "kysely": "^0.27.0",
+  "pg": "^8.0.0",
+  "@types/pg": "^8.0.0",
+  "pg-mem": "^3.0.4"
+}
+}

package/src/commands/export.ts

@@ -0,0 +1,50 @@
+import { resolve, join } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { parseExportArgs } from "../lib/args.js";
+import { log } from "../lib/log.js";
+import { loadAndExportJson } from "@metaobjectsdev/metadata/core";
+import { TypeRegistry, registerCoreTypes } from "@metaobjectsdev/metadata";
+import { DEFAULT_METADATA_DIR, registerForgeTypes } from "@metaobjectsdev/sdk";
+
+export async function exportCommand(args: string[], cwd: string): Promise<number> {
+  let flags;
+  try {
+    flags = parseExportArgs(args);
+  } catch (err) {
+    log.error((err as Error).message);
+    return 2;
+  }
+
+  const projectRoot = cwd;
+  const metadataDir = join(projectRoot, DEFAULT_METADATA_DIR);
+
+  // Build a registry with core + forge types so metadata that includes
+  // descriptive types (decision, principle, etc.) loads without errors.
+  const registry = new TypeRegistry();
+  registerCoreTypes(registry);
+  registerForgeTypes(registry);
+
+  const result = await loadAndExportJson(metadataDir, { registry });
+
+  for (const w of result.warnings) {
+    log.warn(w);
+  }
+
+  if (result.errors.length > 0) {
+    for (const err of result.errors) {
+      log.error(err.message);
+    }
+    return 1;
+  }
+
+  if (flags.out !== undefined) {
+    const outPath = resolve(projectRoot, flags.out);
+    await writeFile(outPath, result.json, "utf8");
+    const byteCount = Buffer.byteLength(result.json, "utf8");
+    log.info(`meta export — wrote ${outPath} (${byteCount} bytes)`);
+  } else {
+    process.stdout.write(result.json);
+  }
+
+  return 0;
+}

package/src/commands/gen.ts

@@ -0,0 +1,88 @@
+import { relative } from "node:path";
+import { parseGenArgs } from "../lib/args.js";
+import { resolveGenConfig } from "../lib/config.js";
+import { loadMetaobjectsConfig } from "../lib/load-metaobjects-config.js";
+import { formatGenResult, type GenFileEntry, type GenFileStatus } from "../lib/output.js";
+import { log } from "../lib/log.js";
+import { loadMemory } from "@metaobjectsdev/sdk";
+import { runGen } from "@metaobjectsdev/codegen-ts";
+import type { WriteStatus } from "@metaobjectsdev/codegen-ts";
+
+function mapStatus(s: WriteStatus): GenFileStatus {
+  switch (s) {
+    case "new":
+    case "overwrite": return "new";
+    case "skipped":   return "unchanged";
+    case "refused":   return "refused";
+  }
+}
+
+export async function genCommand(args: string[], cwd: string): Promise<number> {
+  let flags;
+  try { flags = parseGenArgs(args); }
+  catch (err) { log.error((err as Error).message); return 2; }
+
+  const projectRoot = cwd;
+  const cliConfig = resolveGenConfig(flags);
+
+  let forgeConfig;
+  try {
+    forgeConfig = await loadMetaobjectsConfig(projectRoot);
+  } catch (err) {
+    log.error((err as Error).message);
+    return 2;
+  }
+
+  let metadata;
+  try {
+    metadata = await loadMemory(projectRoot);
+  } catch (err) {
+    const msg = (err as Error).message;
+    if (msg.includes("ENOENT") || msg.includes("no such") || msg.includes("cannot read")) {
+      log.error(`no metaobjects/ found in ${projectRoot}; run 'meta init' to scaffold`);
+    } else {
+      log.error(`failed to load metadata: ${msg}`);
+    }
+    return 2;
+  }
+
+  let result;
+  try {
+    result = await runGen({
+      config: forgeConfig,
+      metadata,
+      ...(cliConfig.entities.length > 0 ? { entityFilter: cliConfig.entities } : {}),
+    });
+  } catch (err) {
+    log.error(`gen failed: ${(err as Error).message}`);
+    return 1;
+  }
+
+  for (const w of result.warnings) { log.warn(w); }
+
+  // result.files[].path is the absolute full path from decideAndWrite. With
+  // per-target output, show each path relative to the project root so files in
+  // different targets are distinguishable.
+  const files: GenFileEntry[] = result.files.map((f) => ({
+    path: relative(projectRoot, f.path),
+    status: mapStatus(f.status),
+    info: "",
+  }));
+
+  const targetDirs = Array.from(new Set(
+    (forgeConfig.targets ? Object.values(forgeConfig.targets).map((t) => t.outDir) : [])
+      .concat([forgeConfig.outDir]),
+  ));
+  const output = formatGenResult({
+    files,
+    outDir: targetDirs.length > 1 ? targetDirs.join(", ") : forgeConfig.outDir,
+    dialect: forgeConfig.dialect,
+    dryRun: cliConfig.dryRun,
+    warnings: [],
+  }, { isTTY: !!process.stdout.isTTY });
+
+  log.info(output);
+
+  const hasFailure = files.some((f) => f.status === "conflict" || f.status === "refused");
+  return hasFailure ? 1 : 0;
+}