@intelligo-dev/cli 1.0.0-beta.1 → 1.0.0-beta.14

package/dist/commands/migrate-check.js

@@ -15,11 +15,42 @@
  * schema but no rows there at all, which this reports distinctly:
  * "unmanaged" is a different problem from "behind", and baselining is
  * the fix (see the migrations README).
+ *
+ * The framework's chain is one baseline. A database that ran the pre-1.0
+ * chain holds its hashes, which `legacy-chain.json` (next to the
+ * journal) lists: they are reported as `legacy`, not as unknown, and a
+ * database holding all of them is `adoptable` — its schema is the
+ * baseline's, so `migrate` records the baseline without running it.
+ *
+ * The exit code is 1 whenever anything is pending or the database is
+ * ahead, which a brand-new database and a stale one share. A deploy
+ * gate that must tell them apart reads `migrate --check --json`: one
+ * JSON object on stdout, same exit code, whose `state` is
+ *
+ *   - `up_to_date` — every migration is applied;
+ *   - `pending`    — a migrated database is behind this checkout;
+ *   - `fresh`      — no migration records and none of the framework's
+ *                    tables: an empty database, `migrate` applies the chain;
+ *   - `unmanaged`  — the tables exist with no records (`db:push`);
+ *   - `ahead`      — applied migrations this checkout does not contain;
+ *   - `legacy`     — the pre-1.0 chain; `adoptable` says whether
+ *                    `migrate` can take it over.
+ *
+ * Beside `state` it carries `exitCode`, `chain`, `applied`, `pending`,
+ * `unknown`, `legacy`, `legacyMissing` and `adoptable`.
  */
 import { createHash } from "node:crypto";
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { readMigrationChain } from "../migrations.js";
+/** The pre-1.0 chain's tags and hashes, if this checkout ships them. */
+export function readLegacyChain(migrationsDir) {
+    const file = path.join(migrationsDir, "legacy-chain.json");
+    if (!existsSync(file))
+        return [];
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    return parsed.entries ?? [];
+}
 /** Drizzle hashes the file contents with sha256. */
 export function hashMigration(sql) {
     return createHash("sha256").update(sql).digest("hex");
@@ -45,33 +76,70 @@ export async function migrateCheck(migrationsDir, query) {
     catch {
         tableMissing = true;
     }
+    const legacyChain = readLegacyChain(migrationsDir);
+    // A migration can be recorded under more than one hash: npm's
+    // 1.0.0-beta.6 shipped different bytes for three of them.
+    const legacyByHash = new Map(legacyChain.flatMap((e) => [e.hash, ...(e.alternates ?? [])].map((h) => [h, e.tag])));
     const appliedHashes = new Set(rows.map((r) => r.hash));
     const applied = [];
     const unknown = [];
+    const legacy = [];
     for (const hash of appliedHashes) {
         const tag = hashToTag.get(hash);
+        const legacyTag = legacyByHash.get(hash);
         if (tag)
             applied.push(tag);
+        else if (legacyTag)
+            legacy.push(legacyTag);
         else
             unknown.push(hash.slice(0, 12));
     }
     const appliedTags = new Set(applied);
     const pending = chain.journalTags.filter((t) => !appliedTags.has(t));
+    const baseline = chain.journalTags[0];
     return {
         chain: chain.journalTags,
         applied,
         pending,
         unknown,
         unmanaged: tableMissing || appliedHashes.size === 0,
+        legacy,
+        legacyChainLength: legacyChain.length,
+        legacyMissing: legacy.length > 0
+            ? legacyChain.map((e) => e.tag).filter((t) => !legacy.includes(t))
+            : [],
+        adoptable: legacyChain.length > 0 &&
+            legacy.length === legacyChain.length &&
+            baseline !== undefined &&
+            !appliedTags.has(baseline),
     };
 }
-export function formatMigrateCheck(r) {
+/**
+ * `schemaExists` is whether the framework's tables are in the database
+ * (`SCHEMA_PROBE_SQL`). When the caller did not probe, a database with
+ * no records gets the cautious `db:push` wording.
+ */
+export function formatMigrateCheck(r, schemaExists) {
     const lines = [];
-    if (r.unmanaged) {
+    if (r.unmanaged && schemaExists === false) {
+        lines.push(`! This database is empty: no migration records and none of the ` +
+            `framework's tables. \`intelligo migrate\` applies all ` +
+            `${r.chain.length} migration(s).`);
+    }
+    else if (r.unmanaged) {
         lines.push(`! This database has no migration records. If it was provisioned with ` +
             `db:push, baseline it before running migrate — otherwise migrate will ` +
-            `try to apply all ${r.chain.length} migrations. See ` +
-            `packages/core/src/db/migrations/README.md`);
+            `try to apply all ${r.chain.length} migrations. See README.md in ` +
+            `@intelligo-dev/core's src/db/migrations.`);
+    }
+    if (r.adoptable) {
+        lines.push(`! This database ran the framework's pre-1.0 migration chain. migrate ` +
+            `records ${r.chain[0]} as applied without running it (the schema is ` +
+            `already there), then applies what follows. Tables the old chain ` +
+            `created that the framework no longer owns are left untouched.`);
+    }
+    else if (isPartialLegacy(r)) {
+        lines.push(`✗ ${partialLegacyMessage(r)}`);
     }
     if (r.unknown.length > 0) {
         lines.push(`✗ Database is ahead: ${r.unknown.length} applied migration(s) are not in ` +
@@ -89,4 +157,61 @@ export function formatMigrateCheck(r) {
 export function migrateCheckExitCode(r) {
     return r.pending.length > 0 || r.unknown.length > 0 ? 1 : 0;
 }
+/** A partial pre-1.0 chain: neither adoptable nor migratable from here. */
+export function isPartialLegacy(r) {
+    return r.legacy.length > 0 && r.legacy.length < r.legacyChainLength;
+}
+/**
+ * The last pre-1.0 migration any published `@intelligo-dev/core`
+ * carries: 1.0.0-beta.6 shipped the chain through it, and the versions
+ * that carried the rest were never published.
+ */
+export const LAST_PUBLISHED_LEGACY_TAG = "0042_sessions_active_organization_id";
+/**
+ * Why a partial pre-1.0 chain is refused and where the way forward is
+ * written down. No published version finishes the chain, so the
+ * message names what is missing and points at the README's options
+ * instead of at a version to install.
+ */
+export function partialLegacyMessage(r) {
+    const shown = r.legacyMissing.slice(0, 6);
+    const more = r.legacyMissing.length - shown.length;
+    return (`This database ran ${r.legacy.length} of the ${r.legacyChainLength} ` +
+        `pre-1.0 migrations; it has not run ${shown.join(", ")}` +
+        `${more > 0 ? ` and ${more} more` : ""}. No published ` +
+        `@intelligo-dev/core finishes that chain: 1.0.0-beta.6 ships it ` +
+        `through ${LAST_PUBLISHED_LEGACY_TAG}, and the versions that carried ` +
+        `the rest never reached npm. Apply the missing migrations' SQL from ` +
+        `your own copy of it, or bring the schema to the baseline and record ` +
+        `it as applied — see "Databases from before 1.0" in README.md in ` +
+        `@intelligo-dev/core's src/db/migrations.`);
+}
+/**
+ * One word for what the check found, most urgent first: a database that
+ * is ahead or on the pre-1.0 chain is that before it is anything else.
+ * `schemaExists` separates an empty database from a push-provisioned one.
+ */
+export function migrateState(r, schemaExists) {
+    if (r.unknown.length > 0)
+        return "ahead";
+    if (r.legacy.length > 0)
+        return "legacy";
+    if (r.unmanaged)
+        return schemaExists ? "unmanaged" : "fresh";
+    return r.pending.length > 0 ? "pending" : "up_to_date";
+}
+/** The `--json` report: `state` first, then the detail behind it. */
+export function formatMigrateCheckJson(r, schemaExists) {
+    return JSON.stringify({
+        state: migrateState(r, schemaExists),
+        exitCode: migrateCheckExitCode(r),
+        chain: r.chain,
+        applied: r.applied,
+        pending: r.pending,
+        unknown: r.unknown,
+        legacy: r.legacy,
+        legacyMissing: r.legacyMissing,
+        adoptable: r.adoptable,
+    });
+}
 //# sourceMappingURL=migrate-check.js.map

package/dist/commands/migrate-check.js.map

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

package/dist/commands/migrate.d.ts

@@ -0,0 +1,97 @@
+/**
+ * `intelligo migrate` — apply the framework's migration chain.
+ *
+ * A consumer application has two migration chains in one database:
+ * the framework's, shipped inside `@intelligo-dev/core` (its `.sql`
+ * files and journal are in the package's `files`), and its own, which
+ * drizzle-kit generates from the tables the application owns. They
+ * must not share a journal — drizzle-kit applies by timestamp, so a
+ * framework migration published after the consumer generated one of
+ * theirs would be silently skipped — and a consumer cannot write into
+ * `node_modules` anyway. So the framework chain is applied by this
+ * command, into drizzle's default `drizzle.__drizzle_migrations`
+ * table, and the consumer's chain by `drizzle-kit migrate` from their
+ * own `drizzle.config.ts`, into a table of its own (the scaffold sets
+ * `migrations.table` to `__app_migrations`).
+ *
+ * Migrations are selected by content hash (what `migrate --check`
+ * compares), not by drizzle's journal-timestamp rule, and are recorded
+ * in the same table drizzle's migrator writes — see
+ * `readPendingMigrations` for why.
+ *
+ * The one thing this refuses to do is guess. A database with the
+ * framework's tables but no migration records was provisioned with
+ * `db:push`; applying the whole chain to it would fail part-way (not
+ * every migration is `IF NOT EXISTS`-guarded) and leave the records
+ * half-written. Baselining is the fix, and it is deliberately a manual
+ * step — see `packages/core/src/db/migrations/README.md`.
+ */
+import { type MigrateCheckResult } from "./migrate-check.js";
+export type ApplyDecision = {
+    action: "apply";
+    pending: string[];
+    /** Recorded as applied without running: the schema is already there. */
+    adopted: string[];
+} | {
+    action: "noop";
+} | {
+    action: "refuse";
+    reason: string;
+};
+/**
+ * What to do with a database, given the check result and whether the
+ * framework's schema already exists in it. Pure, so the three states
+ * that matter — empty, push-provisioned, behind — are unit-testable
+ * without a database.
+ */
+export declare function decideApply(check: MigrateCheckResult, schemaExists: boolean): ApplyDecision;
+type QueryFn = (sql: string) => Promise<Array<Record<string, unknown>>>;
+/**
+ * One migration ready to run: its statements and the journal entry it
+ * will be recorded under. `createdAt` is the journal's `when`, which is
+ * what drizzle-kit writes to `created_at` too, so records made here and
+ * records made by drizzle's own migrator are indistinguishable.
+ */
+export type PendingMigration = {
+    tag: string;
+    hash: string;
+    createdAt: number;
+    statements: string[];
+};
+/**
+ * Read the pending migrations off disk, in journal order.
+ *
+ * The chain is applied by content hash — the same key `migrate --check`
+ * compares — and not by drizzle's rule of "every entry whose journal
+ * timestamp is greater than the last applied row's". That rule depends
+ * on `when` values increasing monotonically, which a hand-numbered
+ * journal does not guarantee: an entry numbered below an applied one is
+ * skipped silently while the check reports it pending. Selecting by hash makes "pending" mean exactly what the check says.
+ */
+export declare function readPendingMigrations(migrationsDir: string, pendingTags: string[]): PendingMigration[];
+/** The records table drizzle's migrator uses, created the way it creates it. */
+export declare const MIGRATIONS_TABLE_SQL: string[];
+export type ApplyMigrationsOptions = {
+    migrationsDir: string;
+    /** Runs a read-only query and returns its rows. */
+    query: QueryFn;
+    /**
+     * Applies the given migrations in order, all in one transaction,
+     * recording each in `drizzle.__drizzle_migrations` as it goes.
+     */
+    run: (pending: PendingMigration[]) => Promise<void>;
+};
+export type ApplyMigrationsResult = ApplyDecision & {
+    /** After the run, for the summary line and for `noop` detection. */
+    chainLength: number;
+};
+/**
+ * `users` is the first table the framework creates (auth), so its
+ * presence with no migration records is the push-provisioned signature.
+ */
+export declare const SCHEMA_PROBE_SQL = "SELECT to_regclass('public.users') AS rel";
+export declare function applyMigrations(options: ApplyMigrationsOptions): Promise<ApplyMigrationsResult>;
+export declare function formatApplyResult(r: ApplyMigrationsResult): string;
+export declare function applyExitCode(r: ApplyMigrationsResult): number;
+export {};
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,aAAa,GACrB;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GACD;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,kBAAkB,EACzB,YAAY,EAAE,OAAO,GACpB,aAAa,CAuCf;AAED,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB,gBAAgB,EAAE,CAqBpB;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,UAGhC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,GAAG,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG;IAClD,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,8CAA8C,CAAC;AAE5E,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAwBhC;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAgBlE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAE9D"}

package/dist/commands/migrate.js

@@ -0,0 +1,141 @@
+/**
+ * `intelligo migrate` — apply the framework's migration chain.
+ *
+ * A consumer application has two migration chains in one database:
+ * the framework's, shipped inside `@intelligo-dev/core` (its `.sql`
+ * files and journal are in the package's `files`), and its own, which
+ * drizzle-kit generates from the tables the application owns. They
+ * must not share a journal — drizzle-kit applies by timestamp, so a
+ * framework migration published after the consumer generated one of
+ * theirs would be silently skipped — and a consumer cannot write into
+ * `node_modules` anyway. So the framework chain is applied by this
+ * command, into drizzle's default `drizzle.__drizzle_migrations`
+ * table, and the consumer's chain by `drizzle-kit migrate` from their
+ * own `drizzle.config.ts`, into a table of its own (the scaffold sets
+ * `migrations.table` to `__app_migrations`).
+ *
+ * Migrations are selected by content hash (what `migrate --check`
+ * compares), not by drizzle's journal-timestamp rule, and are recorded
+ * in the same table drizzle's migrator writes — see
+ * `readPendingMigrations` for why.
+ *
+ * The one thing this refuses to do is guess. A database with the
+ * framework's tables but no migration records was provisioned with
+ * `db:push`; applying the whole chain to it would fail part-way (not
+ * every migration is `IF NOT EXISTS`-guarded) and leave the records
+ * half-written. Baselining is the fix, and it is deliberately a manual
+ * step — see `packages/core/src/db/migrations/README.md`.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { hashMigration, isPartialLegacy, migrateCheck, partialLegacyMessage, } from "./migrate-check.js";
+/**
+ * What to do with a database, given the check result and whether the
+ * framework's schema already exists in it. Pure, so the three states
+ * that matter — empty, push-provisioned, behind — are unit-testable
+ * without a database.
+ */
+export function decideApply(check, schemaExists) {
+    if (check.unknown.length > 0) {
+        return {
+            action: "refuse",
+            reason: `Database is ahead: ${check.unknown.length} applied migration(s) are ` +
+                `not in this checkout (${check.unknown.join(", ")}). Upgrade ` +
+                `@intelligo-dev/core before migrating, or restore the database.`,
+        };
+    }
+    if (isPartialLegacy(check)) {
+        return { action: "refuse", reason: partialLegacyMessage(check) };
+    }
+    if (check.adoptable) {
+        const [baseline, ...rest] = check.pending;
+        return {
+            action: "apply",
+            adopted: baseline ? [baseline] : [],
+            pending: rest,
+        };
+    }
+    if (check.unmanaged && schemaExists) {
+        return {
+            action: "refuse",
+            reason: `This database has the framework's tables but no migration records — ` +
+                `it was provisioned with db:push. Baseline it before running migrate, ` +
+                `otherwise all ${check.chain.length} migrations would be applied to ` +
+                `tables that already exist. See README.md in @intelligo-dev/core's ` +
+                `src/db/migrations.`,
+        };
+    }
+    if (check.pending.length === 0)
+        return { action: "noop" };
+    return { action: "apply", pending: check.pending, adopted: [] };
+}
+/**
+ * Read the pending migrations off disk, in journal order.
+ *
+ * The chain is applied by content hash — the same key `migrate --check`
+ * compares — and not by drizzle's rule of "every entry whose journal
+ * timestamp is greater than the last applied row's". That rule depends
+ * on `when` values increasing monotonically, which a hand-numbered
+ * journal does not guarantee: an entry numbered below an applied one is
+ * skipped silently while the check reports it pending. Selecting by hash makes "pending" mean exactly what the check says.
+ */
+export function readPendingMigrations(migrationsDir, pendingTags) {
+    const journal = JSON.parse(readFileSync(path.join(migrationsDir, "meta", "_journal.json"), "utf8"));
+    const byTag = new Map((journal.entries ?? []).map((e) => [e.tag, e]));
+    return pendingTags.map((tag) => {
+        const entry = byTag.get(tag);
+        if (!entry)
+            throw new Error(`${tag} is pending but not in the journal`);
+        const sql = readFileSync(path.join(migrationsDir, `${tag}.sql`), "utf8");
+        const statements = (entry.breakpoints === false
+            ? [sql]
+            : sql.split("--> statement-breakpoint"))
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        return { tag, hash: hashMigration(sql), createdAt: entry.when, statements };
+    });
+}
+/** The records table drizzle's migrator uses, created the way it creates it. */
+export const MIGRATIONS_TABLE_SQL = [
+    `CREATE SCHEMA IF NOT EXISTS "drizzle"`,
+    `CREATE TABLE IF NOT EXISTS "drizzle"."__drizzle_migrations" (id SERIAL PRIMARY KEY, hash text NOT NULL, created_at bigint)`,
+];
+/**
+ * `users` is the first table the framework creates (auth), so its
+ * presence with no migration records is the push-provisioned signature.
+ */
+export const SCHEMA_PROBE_SQL = `SELECT to_regclass('public.users') AS rel`;
+export async function applyMigrations(options) {
+    const check = await migrateCheck(options.migrationsDir, async (sql) => (await options.query(sql)));
+    const probe = await options.query(SCHEMA_PROBE_SQL);
+    const schemaExists = probe.length > 0 && probe[0].rel != null;
+    const decision = decideApply(check, schemaExists);
+    if (decision.action === "apply") {
+        // An adopted migration is recorded with no statements: its schema is
+        // already in the database.
+        const adopted = readPendingMigrations(options.migrationsDir, decision.adopted).map((m) => ({ ...m, statements: [] }));
+        await options.run([
+            ...adopted,
+            ...readPendingMigrations(options.migrationsDir, decision.pending),
+        ]);
+    }
+    return { ...decision, chainLength: check.chain.length };
+}
+export function formatApplyResult(r) {
+    switch (r.action) {
+        case "refuse":
+            return `✗ ${r.reason}`;
+        case "noop":
+            return `✓ Nothing to apply (${r.chainLength}/${r.chainLength} applied)`;
+        case "apply":
+            return [
+                ...r.adopted.map((tag) => `✓ Adopted ${tag}: this database ran the pre-1.0 chain, so its schema is already there`),
+                `✓ Applied ${r.pending.length} migration(s):`,
+                ...r.pending.map((tag) => `    ${tag}`),
+            ].join("\n");
+    }
+}
+export function applyExitCode(r) {
+    return r.action === "refuse" ? 1 : 0;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

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

package/dist/commands/sync-messages.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Message files under `intelligo sync`: the registry's keys an app's
+ * copy lacks, the merge that keeps the app's values, and the other
+ * locales checked against the app's English copy.
+ */
+export type Json = Record<string, unknown>;
+/** Dotted paths of every leaf in `registry` that `app` lacks. */
+export declare function missingMessageKeys(registry: Json, app: Json, prefix?: string): string[];
+/**
+ * The registry's messages with the app's copy laid over them: every key
+ * the registry has is present, every value the app set wins, and keys
+ * only the app has (its own nav entries, product copy) are kept.
+ */
+export declare function mergeMessages(registry: Json, app: Json): Json;
+export declare const isMessages: (target: string) => boolean;
+/**
+ * The app's locales, from `locales: [...]` in i18n/routing.ts — the
+ * source locale alone when there is no such file or list.
+ */
+export declare function appLocales(appRoot: string): string[];
+export type LocaleEntry = {
+    item: string;
+    path: string;
+    state: "current" | "locale-behind";
+    missingKeys?: string[];
+};
+/**
+ * Every other locale's copy of the namespaces the registry ships,
+ * against the app's English file on disk — the merged copy, product
+ * keys included, which is what the other locales translate. A missing
+ * file lacks every key.
+ */
+export declare function localeEntries(appRoot: string, files: readonly {
+    item: string;
+    target: string;
+}[]): LocaleEntry[];
+//# sourceMappingURL=sync-messages.d.ts.map

package/dist/commands/sync-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-messages.d.ts","sourceRoot":"","sources":["../../src/commands/sync-messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAK3C,iEAAiE;AACjE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,IAAI,EACd,GAAG,EAAE,IAAI,EACT,MAAM,SAAK,GACV,MAAM,EAAE,CASV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAe7D;AAED,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,YACmB,CAAC;AAK7D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,eAAe,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GACjD,WAAW,EAAE,CAyBf"}

package/dist/commands/sync-messages.js

@@ -0,0 +1,88 @@
+/**
+ * Message files under `intelligo sync`: the registry's keys an app's
+ * copy lacks, the merge that keeps the app's values, and the other
+ * locales checked against the app's English copy.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** Dotted paths of every leaf in `registry` that `app` lacks. */
+export function missingMessageKeys(registry, app, prefix = "") {
+    return Object.entries(registry).flatMap(([key, value]) => {
+        const at = prefix ? `${prefix}.${key}` : key;
+        if (!(key in app))
+            return [at];
+        const mine = app[key];
+        return isObject(value) && isObject(mine)
+            ? missingMessageKeys(value, mine, at)
+            : [];
+    });
+}
+/**
+ * The registry's messages with the app's copy laid over them: every key
+ * the registry has is present, every value the app set wins, and keys
+ * only the app has (its own nav entries, product copy) are kept.
+ */
+export function mergeMessages(registry, app) {
+    const out = {};
+    for (const [key, value] of Object.entries(registry)) {
+        const mine = app[key];
+        out[key] =
+            key in app
+                ? isObject(value) && isObject(mine)
+                    ? mergeMessages(value, mine)
+                    : mine
+                : value;
+    }
+    for (const [key, value] of Object.entries(app)) {
+        if (!(key in out))
+            out[key] = value;
+    }
+    return out;
+}
+export const isMessages = (target) => target.startsWith("messages/") && target.endsWith(".json");
+/** The locale the registry ships messages in. */
+const SOURCE_LOCALE = "en";
+/**
+ * The app's locales, from `locales: [...]` in i18n/routing.ts — the
+ * source locale alone when there is no such file or list.
+ */
+export function appLocales(appRoot) {
+    const file = path.join(appRoot, "i18n", "routing.ts");
+    if (!existsSync(file))
+        return [SOURCE_LOCALE];
+    const list = /\blocales\s*:\s*\[([^\]]*)\]/.exec(readFileSync(file, "utf8"));
+    const locales = [...(list?.[1] ?? "").matchAll(/["'`]([^"'`]+)["'`]/g)].map((m) => m[1]);
+    return locales.length > 0 ? locales : [SOURCE_LOCALE];
+}
+/**
+ * Every other locale's copy of the namespaces the registry ships,
+ * against the app's English file on disk — the merged copy, product
+ * keys included, which is what the other locales translate. A missing
+ * file lacks every key.
+ */
+export function localeEntries(appRoot, files) {
+    const others = appLocales(appRoot).filter((l) => l !== SOURCE_LOCALE);
+    if (others.length === 0)
+        return [];
+    const prefix = `messages/${SOURCE_LOCALE}/`;
+    const entries = [];
+    for (const { item, target } of files) {
+        if (!target.startsWith(prefix) || !target.endsWith(".json"))
+            continue;
+        const english = path.join(appRoot, target);
+        if (!existsSync(english))
+            continue;
+        const source = JSON.parse(readFileSync(english, "utf8"));
+        for (const locale of others) {
+            const rel = `messages/${locale}/${target.slice(prefix.length)}`;
+            const abs = path.join(appRoot, rel);
+            const missingKeys = missingMessageKeys(source, existsSync(abs) ? JSON.parse(readFileSync(abs, "utf8")) : {});
+            entries.push(missingKeys.length > 0
+                ? { item, path: rel, state: "locale-behind", missingKeys }
+                : { item, path: rel, state: "current" });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=sync-messages.js.map

package/dist/commands/sync-messages.js.map

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

package/dist/commands/sync-scaffold.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Scaffold files a registry install replaces. `intelligo create`
+ * writes app/globals.css, the theme provider and lib/utils.ts; the
+ * design-system base and the items overwrite them, and the scaffold's
+ * record has to let go of them or `upgrade --check` reports them as
+ * the app's own edits forever.
+ */
+/** The `intelligo create` feature whose files an install may replace. */
+export declare const SCAFFOLD_FEATURE = "app-scaffold";
+/**
+ * The scaffold files an install has made the registry's: a file an
+ * installed item ships, the Tailwind stylesheet once the design-system
+ * base is in (it rewrites the tokens), or any scaffold file the install
+ * changed (shadcn's own `utils`, `sonner`). Seams stay the app's, and
+ * so do the files shadcn only extends. Left in the scaffold's record,
+ * each would read `customized` in `upgrade --check` forever.
+ */
+export declare function scaffoldHandover(input: {
+    scaffold: readonly string[];
+    changed: ReadonlySet<string>;
+    shipped: ReadonlySet<string>;
+    seams: Readonly<Record<string, string>>;
+    css: string | null;
+}): string[];
+/**
+ * The scaffold's recorded files as they are before an install, and
+ * afterwards the ones the install made the registry's.
+ */
+export declare function snapshotScaffold(appRoot: string): {
+    handedOver: (input: {
+        shipped: ReadonlySet<string>;
+        seams: Readonly<Record<string, string>>;
+        css: string | null;
+    }) => string[];
+};
+//# sourceMappingURL=sync-scaffold.d.ts.map

package/dist/commands/sync-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/sync-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAY/C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,GAAG,MAAM,EAAE,CAOX;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,UAAU,EAAE,CAAC,KAAK,EAAE;QAClB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACpB,KAAK,MAAM,EAAE,CAAC;CAChB,CAmBA"}