@metaobjectsdev/cli 1.0.9-rc.4 → 1.0.9-rc.6

package/dist/src/lib/runtime-eject.js

@@ -0,0 +1,212 @@
+// ADR-0034 Amendment 3 (2026-09-24 ruling) — ejecting a helper hands over ALL of its code.
+//
+// `meta eject routes` used to copy a generator whose OUTPUT still imported the HTTP adapter
+// from `@metaobjectsdev/runtime-ts` — the mount helpers, filter parser, error envelopes and
+// pagination, which is where most route defects have lived. Owning the generator while the
+// code it emits calls into a package is half of owning it: a defect in the adapter still
+// waits on an upstream release.
+//
+// So eject also copies the adapter SOURCE the output depends on — the transitive closure of
+// relative imports from the entry module each generator's output names — into
+// `codegen/runtime/`, laid out exactly as the package's own `src/` so every relative import
+// in it resolves unchanged. Package imports are left as they are: what the closure reaches
+// outside the package is `@metaobjectsdev/metadata` (core: the filter-op vocabulary and the
+// canonical serializer) and third-party libraries (drizzle-orm, fastify, hono, zod, qs).
+//
+// The copies are VERBATIM. That is what makes "is my copy still the package's?" a byte
+// comparison and "what did upstream change?" a plain `diff -r` against the installed
+// package's `src/`, with no header to strip first.
+import { createRequire } from "node:module";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, relative, sep } from "node:path";
+import { HTTP_RUNTIME_MODULES, HTTP_RUNTIME_PACKAGE, OWNED_RUNTIME_DIR, } from "@metaobjectsdev/codegen-ts";
+import { compareOwnedCopy } from "./owned-copy.js";
+import { cliVersion } from "./version.js";
+/**
+ * The ejectable generators whose OUTPUT imports the adapter tier, and the adapter modules
+ * it imports. `entity` is here for its allowlist TYPES only, which is one file.
+ */
+export const RUNTIME_ENTRIES = {
+    routes: ["drizzle-fastify"],
+    "routes-hono": ["hono"],
+    entity: ["allowlists"],
+};
+/** True iff ejecting `name` also copies adapter source. */
+export function ejectsRuntime(name) {
+    return Object.hasOwn(RUNTIME_ENTRIES, name);
+}
+/**
+ * The installed `@metaobjectsdev/runtime-ts`: its `src/` and its manifest.
+ *
+ * Resolves the package ENTRY and walks up to the manifest that names it, never
+ * `"<pkg>/package.json"`: the exports map does not export that subpath, and under real Node
+ * asking for it throws ERR_PACKAGE_PATH_NOT_EXPORTED (see `install-set.ts`). `src/` ships
+ * in the published package (`files: ["dist", "src", ...]`).
+ */
+export function resolveRuntimePackage() {
+    const req = createRequire(import.meta.url);
+    let dir = dirname(req.resolve(HTTP_RUNTIME_PACKAGE));
+    for (let hops = 0; hops < 8; hops++) {
+        const candidate = join(dir, "package.json");
+        if (existsSync(candidate)) {
+            const manifest = JSON.parse(readFileSync(candidate, "utf8"));
+            if (manifest.name === HTTP_RUNTIME_PACKAGE) {
+                const srcRoot = join(dir, "src");
+                if (!existsSync(srcRoot)) {
+                    throw new Error(`${HTTP_RUNTIME_PACKAGE} at ${dir} ships no src/ — cannot copy the adapter source.`);
+                }
+                return { srcRoot, manifest };
+            }
+        }
+        const up = dirname(dir);
+        if (up === dir)
+            break;
+        dir = up;
+    }
+    throw new Error(`could not locate the installed ${HTTP_RUNTIME_PACKAGE} package.`);
+}
+/** Relative (`./`, `../`) and bare module specifiers a source file imports or re-exports. */
+function specifiersOf(source) {
+    const out = [];
+    // `import … from "x"` and the re-export forms (`export { … } from`, `export * from`) only —
+    // a bare `export function f() { return Array.from("…") }` must not read as an import.
+    const STATEMENT = /(?:^|\n)\s*(?:import\s+[^;"']*?\s+from|export\s+(?:type\s+)?(?:\*(?:\s+as\s+\w+)?|\{[^}]*\})\s*from)\s*["']([^"']+)["']/g;
+    for (const m of source.matchAll(STATEMENT)) {
+        if (m[1] !== undefined)
+            out.push(m[1]);
+    }
+    for (const m of source.matchAll(/(?:^|\n)\s*import\s*["']([^"']+)["']/g)) {
+        if (m[1] !== undefined)
+            out.push(m[1]);
+    }
+    return out;
+}
+/** `@scope/name/sub` → `@scope/name`; `name/sub` → `name`. */
+function packageNameOf(spec) {
+    const parts = spec.split("/");
+    return spec.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+}
+function toPosix(p) {
+    return p.split(sep).join("/");
+}
+/** Every file the given adapter modules reach through relative imports, and what else they import. */
+export function runtimeClosure(srcRoot, modules) {
+    const files = new Set();
+    const packages = new Set();
+    const queue = modules.map((m) => `${HTTP_RUNTIME_MODULES[m].file}.ts`);
+    while (queue.length > 0) {
+        const rel = queue.shift();
+        if (files.has(rel))
+            continue;
+        const abs = join(srcRoot, rel);
+        if (!existsSync(abs)) {
+            throw new Error(`${HTTP_RUNTIME_PACKAGE}: ${rel} is imported but not shipped in src/.`);
+        }
+        files.add(rel);
+        for (const spec of specifiersOf(readFileSync(abs, "utf8"))) {
+            if (spec.startsWith("./") || spec.startsWith("../")) {
+                const target = toPosix(join(dirname(rel), spec)).replace(/\.js$/, ".ts");
+                queue.push(target.endsWith(".ts") ? target : `${target}.ts`);
+            }
+            else if (!spec.startsWith("node:")) {
+                packages.add(packageNameOf(spec));
+            }
+        }
+    }
+    return { files: [...files].sort(), packages: [...packages].sort() };
+}
+/**
+ * Copy the adapter source `names` emit imports of into `<cwd>/codegen/runtime/`.
+ * Never overwrites a file without `force`, the same rule the generator copy keeps.
+ */
+export async function ejectRuntime(cwd, names, force) {
+    const modules = [...new Set(names.flatMap((n) => RUNTIME_ENTRIES[n] ?? []))];
+    if (modules.length === 0)
+        return { files: [], packages: [] };
+    const { srcRoot } = resolveRuntimePackage();
+    const closure = runtimeClosure(srcRoot, modules);
+    const files = [];
+    for (const rel of closure.files) {
+        const source = await readFile(join(srcRoot, rel), "utf8");
+        const path = `${OWNED_RUNTIME_DIR}/${rel}`;
+        const abs = join(cwd, path);
+        const existing = existsSync(abs) ? await readFile(abs, "utf8") : undefined;
+        const comparison = existing === undefined ? undefined : await compareOwnedCopy(existing, source);
+        if (existing !== undefined && !force) {
+            files.push({ path, status: "preserved", comparison });
+            continue;
+        }
+        await mkdir(dirname(abs), { recursive: true });
+        await writeFile(abs, source, "utf8");
+        files.push({ path, status: existing === undefined ? "created" : "replaced", comparison });
+    }
+    return { files, packages: closure.packages };
+}
+/**
+ * The install lines the copied source needs, with ranges read from the runtime package's
+ * own manifest (never restated here). A `@metaobjectsdev/*` package moves with the CLI.
+ * A package that ships no types of its own gets its `@types/*` sibling as a dev dependency
+ * when the runtime package itself develops against one.
+ */
+export function runtimeInstall(packages) {
+    const { manifest } = resolveRuntimePackage();
+    const known = { ...manifest.peerDependencies, ...manifest.dependencies };
+    const runtime = new Map();
+    const dev = new Map();
+    for (const p of packages) {
+        runtime.set(p, p.startsWith("@metaobjectsdev/") ? `^${cliVersion()}` : known[p]);
+        const typesPkg = `@types/${p.replace(/^@/, "").replace("/", "__")}`;
+        const typesRange = manifest.devDependencies?.[typesPkg];
+        if (typesRange !== undefined)
+            dev.set(typesPkg, typesRange);
+    }
+    return { runtime, dev };
+}
+function listTs(dir) {
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        const abs = join(dir, entry);
+        if (statSync(abs).isDirectory())
+            out.push(...listTs(abs));
+        else if (entry.endsWith(".ts"))
+            out.push(abs);
+    }
+    return out;
+}
+/**
+ * Every file under `<cwd>/codegen/runtime/`, compared to the installed package's source.
+ * Empty when the project owns no adapter copy. `not-in-package` is a file the package does
+ * not ship — your own addition, or one upstream deleted or renamed.
+ */
+export async function runtimeCopyStatus(cwd) {
+    const root = join(cwd, OWNED_RUNTIME_DIR);
+    if (!existsSync(root))
+        return [];
+    let srcRoot;
+    try {
+        srcRoot = resolveRuntimePackage().srcRoot;
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const abs of listTs(root).sort()) {
+        const rel = toPosix(relative(root, abs));
+        const path = `${OWNED_RUNTIME_DIR}/${rel}`;
+        const upstream = join(srcRoot, rel);
+        if (!existsSync(upstream)) {
+            rows.push({ path, verdict: "not-in-package", localOnly: 0, referenceOnly: 0 });
+            continue;
+        }
+        const cmp = await compareOwnedCopy(readFileSync(abs, "utf8"), readFileSync(upstream, "utf8"));
+        rows.push({ path, verdict: cmp.verdict, localOnly: cmp.localOnly, referenceOnly: cmp.referenceOnly });
+    }
+    return rows;
+}
+/** The command that shows exactly how one owned file differs from the installed package's. */
+export function runtimeDiffCommand(path) {
+    const rel = path.startsWith(`${OWNED_RUNTIME_DIR}/`) ? path.slice(OWNED_RUNTIME_DIR.length + 1) : path;
+    return `diff -u node_modules/${HTTP_RUNTIME_PACKAGE}/src/${rel} ${OWNED_RUNTIME_DIR}/${rel}`;
+}
+//# sourceMappingURL=runtime-eject.js.map

package/dist/src/lib/runtime-eject.js.map

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

package/dist/src/lib/unknown-attr-warnings.d.ts

@@ -0,0 +1,18 @@
+import { type LoadMemoryOptions } from "@metaobjectsdev/sdk";
+/**
+ * The trailing advice on every unknown-attribute warning `meta gen` prints. `gen` has no
+ * `--strict` flag of its own — `meta verify` is the strict door (ADR-0023), so that is what
+ * the warning names.
+ */
+export declare const UNKNOWN_ATTR_GEN_ADVICE: string;
+/**
+ * `meta gen`'s unknown-attribute warnings: one line per ADR-0023 finding a STRICT load of
+ * the same collection raises, naming the attribute, the node and the file. Empty when the
+ * model is clean; the caller prints {@link UNKNOWN_ATTR_GEN_ADVICE} once after them.
+ *
+ * `gen` itself keeps loading leniently and keeps its exit code; this only ends the silence
+ * between it and `meta verify`, which fails on the very same file. Files are printed
+ * relative to `projectRoot` when the loader recorded an absolute path.
+ */
+export declare function unknownAttrWarnings(configDir: string, options: LoadMemoryOptions, projectRoot: string): Promise<string[]>;
+//# sourceMappingURL=unknown-attr-warnings.d.ts.map

package/dist/src/lib/unknown-attr-warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-attr-warnings.d.ts","sourceRoot":"","sources":["../../../src/lib/unknown-attr-warnings.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAGG,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB"}

package/dist/src/lib/unknown-attr-warnings.js

@@ -0,0 +1,43 @@
+import { relative, isAbsolute } from "node:path";
+import { unknownAttributeFindings } from "@metaobjectsdev/sdk";
+/**
+ * The trailing advice on every unknown-attribute warning `meta gen` prints. `gen` has no
+ * `--strict` flag of its own — `meta verify` is the strict door (ADR-0023), so that is what
+ * the warning names.
+ */
+export const UNKNOWN_ATTR_GEN_ADVICE = "meta gen loads leniently and generated anyway, but `meta verify` rejects this metadata " +
+    "(ADR-0023): fix or remove the attribute — a typo'd one (`isAbstrakt`, `@requird`) " +
+    "silently changes what is generated.";
+/**
+ * `meta gen`'s unknown-attribute warnings: one line per ADR-0023 finding a STRICT load of
+ * the same collection raises, naming the attribute, the node and the file. Empty when the
+ * model is clean; the caller prints {@link UNKNOWN_ATTR_GEN_ADVICE} once after them.
+ *
+ * `gen` itself keeps loading leniently and keeps its exit code; this only ends the silence
+ * between it and `meta verify`, which fails on the very same file. Files are printed
+ * relative to `projectRoot` when the loader recorded an absolute path.
+ */
+export async function unknownAttrWarnings(configDir, options, projectRoot) {
+    let findings;
+    try {
+        findings = await unknownAttributeFindings(configDir, options);
+    }
+    catch {
+        // The lenient load already succeeded; a strict re-load that cannot even complete has
+        // nothing more precise to say, and must never turn an advisory into a failure.
+        return [];
+    }
+    return findings.map((f) => {
+        const source = f.source;
+        const files = (source.files ?? [])
+            .filter((p) => p.length > 0)
+            .map((p) => (isAbsolute(p) ? relative(projectRoot, p) : p));
+        const where = [
+            files.length > 0 ? files.join(", ") : undefined,
+            source.jsonPath !== undefined && source.jsonPath.length > 0 ? `at ${source.jsonPath}` : undefined,
+        ].filter((w) => w !== undefined).join(" ");
+        const head = `${f.code}: ${f.message}`;
+        return where.length > 0 ? `${head}\n  in ${where}` : head;
+    });
+}
+//# sourceMappingURL=unknown-attr-warnings.js.map

package/dist/src/lib/unknown-attr-warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-attr-warnings.js","sourceRoot":"","sources":["../../../src/lib/unknown-attr-warnings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAA0B,MAAM,qBAAqB,CAAC;AAEvF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,yFAAyF;IACzF,oFAAoF;IACpF,qCAAqC,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,OAA0B,EAC1B,WAAmB;IAEnB,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,qFAAqF;QACrF,+EAA+E;QAC/E,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,MAA0D,CAAC;QAC5E,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;aAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG;YACZ,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAC/C,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;SAClG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/cli",
-  "version": "1.0.9-rc.4",
+  "version": "1.0.9-rc.6",
   "description": "CLI for MetaObjects: scaffold, codegen, migrate, and drift-detection commands.",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -51,15 +51,15 @@
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.4",
     "@libsql/kysely-libsql": "^0.4.0",
-    "@metaobjectsdev/codegen-ts": "1.0.9-rc.4",
-    "@metaobjectsdev/codegen-ts-react": "1.0.9-rc.4",
-    "@metaobjectsdev/codegen-ts-tanstack": "1.0.9-rc.4",
-    "@metaobjectsdev/docs-site": "1.0.9-rc.4",
-    "@metaobjectsdev/metadata": "1.0.9-rc.4",
-    "@metaobjectsdev/migrate-ts": "1.0.9-rc.4",
-    "@metaobjectsdev/render": "1.0.9-rc.4",
-    "@metaobjectsdev/runtime-ts": "1.0.9-rc.4",
-    "@metaobjectsdev/sdk": "1.0.9-rc.4",
+    "@metaobjectsdev/codegen-ts": "1.0.9-rc.6",
+    "@metaobjectsdev/codegen-ts-react": "1.0.9-rc.6",
+    "@metaobjectsdev/codegen-ts-tanstack": "1.0.9-rc.6",
+    "@metaobjectsdev/docs-site": "1.0.9-rc.6",
+    "@metaobjectsdev/metadata": "1.0.9-rc.6",
+    "@metaobjectsdev/migrate-ts": "1.0.9-rc.6",
+    "@metaobjectsdev/render": "1.0.9-rc.6",
+    "@metaobjectsdev/runtime-ts": "1.0.9-rc.6",
+    "@metaobjectsdev/sdk": "1.0.9-rc.6",
     "@toon-format/toon": "^2.3.0",
     "jiti": "^2.4.0"
   },

package/src/commands/eject.ts

@@ -25,7 +25,12 @@ import { log } from "../lib/log.js";
 import { declaredDependencyNames, readPackageManifest } from "../lib/package-manifest.js";
 import { compareOwnedCopy, type OwnedComparison } from "../lib/owned-copy.js";
 import { composeCatalog, packageOf } from "../lib/catalog.js";
-import { installSetFor, type InstallSet } from "../lib/install-set.js";
+import { installSetFor, type InstallSet, type OwnedRuntimeInstall } from "../lib/install-set.js";
+import {
+  ejectRuntime, ejectsRuntime, runtimeCopyStatus, runtimeDiffCommand, runtimeInstall,
+  type RuntimeEjectResult, type RuntimeFileResult,
+} from "../lib/runtime-eject.js";
+import { HTTP_RUNTIME_PACKAGE, OWNED_RUNTIME_DIR } from "@metaobjectsdev/codegen-ts";
 import { emitStructured, type OutputFormat } from "../lib/format.js";
 import {
   ejectLibrary, ejectableLibraryNames, isLibraryName, libraryStaleness,
@@ -159,6 +164,12 @@ export interface EjectResult {
    * cheapest thing that makes that condition observable.
    */
   comparison?: OwnedComparison | undefined;
+  /**
+   * ADR-0034 Amendment 3 (2026-09-24): the HTTP-adapter source this generator's OUTPUT
+   * imports, copied into `codegen/runtime/` so the adopter owns that too. Absent for a
+   * generator whose output imports no adapter.
+   */
+  runtime?: RuntimeEjectResult | undefined;
 }
 
 /** The `@metaobjectsdev/*` packages an ejected template imports, read from the file
@@ -241,8 +252,15 @@ export async function ejectGenerator(opts: EjectOptions): Promise<EjectResult> {
   const comparison =
     existing === undefined ? undefined : await compareOwnedCopy(existing, templateSource);
 
+  // The adapter source the OUTPUT imports is part of what is handed over — copied whether
+  // or not the generator file itself was already here, and under the same never-clobber
+  // rule, so re-running eject fills in a missing copy without touching a kept one.
+  const runtime = ejectsRuntime(opts.name)
+    ? await ejectRuntime(opts.cwd, [opts.name], opts.force === true)
+    : undefined;
+
   if (!opts.force && existing !== undefined) {
-    return { ...common, status: "preserved", comparison };
+    return { ...common, status: "preserved", comparison, runtime };
   }
 
   await mkdir(join(opts.cwd, OWNED_GENERATORS_DIR), { recursive: true });
@@ -251,9 +269,45 @@ export async function ejectGenerator(opts: EjectOptions): Promise<EjectResult> {
     ...common,
     status: existing === undefined ? "created" : "replaced",
     comparison,
+    runtime,
   };
 }
 
+/**
+ * The owned HTTP-adapter copy under `codegen/runtime/`, file by file, against the installed
+ * `@metaobjectsdev/runtime-ts` it was copied from. Shared by `meta eject --list` and
+ * `meta gen --list`. Empty when the project owns no adapter copy.
+ *
+ * `identical` says an upgrade can be taken by re-copying (`meta eject <name> --force`);
+ * `DIFFERS` says the copy is yours in a way the package is not — your fix, or upstream's —
+ * and names the diff that tells which.
+ */
+export async function runtimeCopyLines(cwd: string): Promise<string[]> {
+  const rows = await runtimeCopyStatus(cwd);
+  if (rows.length === 0) return [];
+  const lines: string[] = [
+    `HTTP adapter source this project owns (${OWNED_RUNTIME_DIR}/), against the installed ${HTTP_RUNTIME_PACKAGE}:`,
+  ];
+  const differing: string[] = [];
+  for (const r of rows) {
+    if (r.verdict === "identical") lines.push(`  ${r.path}  [identical to the package]`);
+    else if (r.verdict === "reformatted") lines.push(`  ${r.path}  [same content as the package, your formatting]`);
+    else if (r.verdict === "not-in-package") lines.push(`  ${r.path}  [not in the package — yours, or removed upstream]`);
+    else {
+      differing.push(r.path);
+      lines.push(
+        `  ${r.path}  [DIFFERS: ${r.referenceOnly} line(s) only in the package, ${r.localOnly} line(s) only in yours]`,
+      );
+    }
+  }
+  if (differing.length > 0) {
+    lines.push("  See the difference (upstream fix, or your own?) before taking an upgrade:");
+    for (const p of differing) lines.push(`    ${runtimeDiffCommand(p)}`);
+  }
+  lines.push("");
+  return lines;
+}
+
 /**
  * `--list` doubles as the staleness report for what this project ALREADY owns.
  *
@@ -315,6 +369,7 @@ async function listOutput(cwd: string): Promise<string> {
     );
     lines.push("");
   }
+  lines.push(...(await runtimeCopyLines(cwd)));
   // FR-043 — the shipped libraries, and how far this project's copies have drifted.
   lines.push("Shipped libraries (copy one into your own sources and own it):");
   for (const name of ejectableLibraryNames()) lines.push(`  ${name}`);
@@ -369,6 +424,8 @@ interface EjectedRow {
   /** The two edits an adopter makes in `metaobjects.config.ts`. */
   wire: { import: string; entry: string };
   requires: readonly string[];
+  /** The adapter source copied beside it (ADR-0034 Amendment 3). Absent when none. */
+  runtime?: RuntimeFileResult[];
 }
 
 interface EjectPayload {
@@ -518,6 +575,33 @@ function reportOne(result: EjectResult, name: string): void {
     "AND the entry.",
   );
   for (const line of result.dependencyNotes) log.info(line);
+  if (result.runtime !== undefined && result.runtime.files.length > 0) reportRuntime(result.runtime.files);
+}
+
+/** What the adapter copy handed over, and how the emitted code reaches it. */
+function reportRuntime(files: readonly RuntimeFileResult[]): void {
+  const written = files.filter((f) => f.status !== "preserved");
+  // A kept file that already matches the package is not news (ejecting `entity routes`
+  // copies the shared allowlist file once, then finds it) — only a kept file that differs is.
+  const kept = files.filter((f) => f.status === "preserved" && f.comparison?.verdict !== "identical");
+  log.info(
+    `The code this generator emits imports its HTTP adapter from ${OWNED_RUNTIME_DIR}/, not from ` +
+      `${HTTP_RUNTIME_PACKAGE}: the adapter, filter parser, error envelopes and pagination are yours too.`,
+  );
+  if (written.length > 0) {
+    log.info(`  Copied ${written.length} file(s) into ${OWNED_RUNTIME_DIR}/ (verbatim from the installed package).`);
+  }
+  const keptDiffering = kept.filter((f) => f.comparison?.verdict === "differs");
+  if (kept.length > 0) {
+    log.info(
+      `  ${kept.length} file(s) were already there and were left untouched` +
+        (keptDiffering.length > 0 ? `, ${keptDiffering.length} of them differing from the package` : "") +
+        " (--force replaces them). `meta eject --list` compares each one.",
+    );
+  }
+  log.info(
+    `  To import the package instead, pass \`runtimeImport: "${HTTP_RUNTIME_PACKAGE}"\` to the generator.`,
+  );
 }
 
 export async function ejectCommand(
@@ -575,6 +659,9 @@ export async function ejectCommand(
   const rows: EjectedRow[] = [];
   const libraries: LibraryEjectResult[] = [];
   const templatePackages = new Set<string>();
+  // ADR-0034 Amendment 3: the generators whose adapter source was copied, and what it imports.
+  const runtimeGenerators = new Set<string>();
+  const runtimePackages = new Set<string>();
   try {
     for (const name of flags.names) {
       if (isLibraryName(name)) {
@@ -585,12 +672,17 @@ export async function ejectCommand(
       }
       const result = await ejectGenerator({ cwd, name, force: flags.force });
       for (const p of result.templatePackages) templatePackages.add(p);
+      if (result.runtime !== undefined) {
+        runtimeGenerators.add(name);
+        for (const p of result.runtime.packages) runtimePackages.add(p);
+      }
       rows.push({
         name,
         path: result.path,
         status: result.status,
         wire: { import: result.importLine, entry: `${result.exportName}()` },
         requires: catalog[name]?.requires ?? [],
+        ...(result.runtime !== undefined ? { runtime: result.runtime.files } : {}),
       });
       if (fmt === "text") reportOne(result, name);
     }
@@ -610,7 +702,15 @@ export async function ejectCommand(
     .filter((n) => !isLibraryName(n))
     .map((n) => catalog[n])
     .filter((e) => e !== undefined);
-  const install = installSetFor(entries, [...templatePackages]);
+  // The copied adapter source imports its own dependencies (qs, the framework, the core
+  // `@metaobjectsdev/metadata`), and the generated code no longer imports the runtime
+  // package — so the install line trades one for the other.
+  let ownedRuntime: OwnedRuntimeInstall | undefined;
+  if (runtimeGenerators.size > 0) {
+    const { runtime, dev } = runtimeInstall([...runtimePackages]);
+    ownedRuntime = { generators: runtimeGenerators, runtime, dev };
+  }
+  const install = installSetFor(entries, [...templatePackages], ownedRuntime);
   const configKeys = [...new Set(entries.flatMap((e) => e.configKeys ?? []))].sort();
 
   if (fmt === "text") {

package/src/commands/gen.ts

@@ -22,6 +22,7 @@ import { packageOfResolutionKey } from "@metaobjectsdev/metadata";
 import type { MetaRoot } from "@metaobjectsdev/metadata";
 import type { Collection } from "@metaobjectsdev/sdk";
 import { reportLoadError } from "../lib/load-error.js";
+import { UNKNOWN_ATTR_GEN_ADVICE, unknownAttrWarnings } from "../lib/unknown-attr-warnings.js";
 import {
   buildCatalogListing, renderCatalogText, wiredGeneratorNames, ownedGeneratorNames,
   declaredDepsOf,
@@ -140,16 +141,27 @@ export async function genCommand(args: string[], cwd: string, fmt: OutputFormat
   }
 
   let metadata;
+  const loadOptions = {
+    ...collectionLoadOptions(genCollection),
+    ...loadMemoryOptionsFrom(forgeConfig),
+  };
   try {
-    metadata = await loadMemory(genCollection.configDir, {
-      ...collectionLoadOptions(genCollection),
-      ...loadMemoryOptionsFrom(forgeConfig),
-    });
+    metadata = await loadMemory(genCollection.configDir, loadOptions);
   } catch (err) {
     reportLoadError(log, "failed to load metadata", err);
     return 2;
   }
 
+  // ADR-0023: gen loads leniently, so an unknown attribute (`isAbstrakt: true`, a
+  // misspelt `@required`) used to pass without a word while `meta verify` rejected the
+  // same file — and the typo changed what was generated. Say so, naming attribute, node
+  // and file. Advisory: the exit code is unchanged.
+  const unknownAttrFindings = await unknownAttrWarnings(genCollection.configDir, loadOptions, projectRoot);
+  const unknownAttrs = unknownAttrFindings.length > 0
+    ? [...unknownAttrFindings, UNKNOWN_ATTR_GEN_ADVICE]
+    : [];
+  for (const w of unknownAttrs) log.warn(`warning: ${w}`);
+
   // FR-023 §11.1 item 2 — refuse a positional that names ONLY objects imported
   // from a dependency and excluded from output by the default exclusion rule.
   // Distinct from the runner's existing "no entities matched" WARNING
@@ -252,7 +264,8 @@ export async function genCommand(args: string[], cwd: string, fmt: OutputFormat
     outDir: targetDirs.length > 1 ? targetDirs.join(", ") : forgeConfig.outDir,
     dialect: forgeConfig.dialect,
     dryRun: cliConfig.dryRun,
-    warnings: [],
+    // Text mode already printed these to stderr above; the structured forms carry them.
+    warnings: fmt === "text" ? [] : unknownAttrs,
     antiPatterns,
     generatorCount: forgeConfig.generators?.length ?? 0,
     ...(migrateAdvice !== undefined ? { migrateAdvice } : {}),

package/src/commands/generator-help.ts

@@ -0,0 +1,47 @@
+// The dependency-free half of `meta generator` — its flags and help text — so the CLI entry
+// point can print `meta generator --help` without loading the codegen packages the command
+// itself needs.
+
+/** Where owned generators live — the directory `meta init` scaffolds and `meta eject` fills. */
+export const OWNED_GENERATORS_DIR = "codegen/generators";
+export const CONFIG_FILE = "metaobjects.config.ts";
+
+export const GENERATOR_SCOPES = ["entity", "package", "model"] as const;
+export type GeneratorScope = (typeof GENERATOR_SCOPES)[number];
+
+export const GENERATOR_OPTIONS = {
+  "scope": { type: "string", default: "entity" },
+  "force": { type: "boolean", default: false },
+  "no-wire": { type: "boolean", default: false },
+} as const;
+
+export const GENERATOR_HELP = `meta generator — write a generator of your own
+
+USAGE:
+  meta generator new <name> [--scope entity|package|model] [--force] [--no-wire]
+
+Writes ${OWNED_GENERATORS_DIR}/<name>.ts — a small, commented, WORKING generator — and
+adds its import and entry to ${CONFIG_FILE}, so \`meta gen\` runs it and
+\`meta verify --codegen\` gates its output straight away. Then edit the emit to produce
+what you need: OpenAPI, JSON Schema, a client, DTOs, docs — anything the model describes.
+
+This is the primary way to get an output MetaObjects does not ship. Reach for
+\`meta eject <name>\` instead only when a reference generator already emits something
+close to what you want (\`meta gen --list\` is the catalog).
+
+<name> is kebab-case (json-schema, openapi, service-layer). It names the file, the
+generator's \`name\` in diagnostics, and the exported factory (jsonSchemaGenerator).
+
+FLAGS:
+  --scope <scope>   What the generator walks, one file per unit (default: entity):
+                      entity   one file per object in the model
+                      package  one file per metadata package
+                      model    one file for the whole model
+  --force           Overwrite an existing ${OWNED_GENERATORS_DIR}/<name>.ts
+  --no-wire         Write the file only; print the import and entry to add yourself
+  --help, -h        Print this help
+
+Every port's shape, and JSON Schema + OpenAPI 3.1 examples to copy: the guide
+docs/recipes/write-your-own-generator.md in the MetaObjects repository
+(github.com/metaobjectsdev), and the metaobjects-codegen skill \`meta init\` installs.
+`;