Several catalogsCopy page

schema() compiles public. The Postgres schema comes from defineConfig({ namespace }). Each catalog has its own namespace, its own ownership, and its own okm_meta.

external(users) marks a table the other catalog exported. The plan does not create, alter, or drop it. A managed table in the same database may reference it. A key that points at another database is OKM1842.

okm catalog export writes the column snapshot (names, types, nullability). The dependent lists that file in external. okm check and okm migrate check compare the declaration and the database with the file. A stale or missing snapshot is OKM1841. okm check lists a cross-catalog foreign key as coupling. The full catalog JSON is describe(schema), not the export.

connect() reads okm_meta in that namespace. okm build writes .okm/namespace when the name is not public. A missing table still skips the check. A hash that does not match is OKM1520.

owning catalog

import { schema, table, t } from "okmodel/pg";

export const users = table("users", {
  id: t.uuid().primaryKey(),
  email: t.text(),
});

export default schema({ tables: [users] });

import { defineConfig } from "okmodel/migrate";

export default defineConfig({
  schema: "./schema.ts",
  database: process.env.DATABASE_URL,
  namespace: "identity",
});

okm generate init
okm migrate apply
okm catalog export --out identity.okm.json

dependent catalog

import { external, schema, table, t } from "okmodel/pg";
import { users } from "../identity/schema.ts";

const invoices = table("invoices", {
  id: t.uuid().primaryKey(),
  userId: t.uuid().references("users"),
});

export default schema({ tables: [external(users), invoices] });

import { defineConfig } from "okmodel/migrate";

export default defineConfig({
  schema: "./schema.ts",
  database: process.env.DATABASE_URL,
  namespace: "billing",
  external: ["../identity/identity.okm.json"],
});

okm generate init
okm migrate apply
okm check
okm migrate check

The invoices migration references "identity"."users". It does not create that table. Both commands pass while the snapshot matches the database. Drop email in the identity catalog and skip okm catalog export: the billing check fails with OKM1841.