@happyvertical/smrt-core 0.36.8 → 0.37.1

package/dist/migrations/differ.js

@@ -25,6 +25,50 @@ function resolveDatabaseUrl(db) {
   const dbWithConfig = db;
   return db.url || dbWithConfig.config?.url || "";
 }
+function normalizeIndexPredicate(where) {
+  if (!where) return "";
+  const stripped = where.trim().replace(/^WHERE\s+/i, "");
+  if (!stripped) return "";
+  let out = "";
+  let i = 0;
+  while (i < stripped.length) {
+    if (stripped[i] === "'") {
+      let literal = "'";
+      i++;
+      while (i < stripped.length) {
+        if (stripped[i] === "'") {
+          if (stripped[i + 1] === "'") {
+            literal += "''";
+            i += 2;
+            continue;
+          }
+          literal += "'";
+          i++;
+          break;
+        }
+        literal += stripped[i];
+        i++;
+      }
+      out += literal;
+    } else {
+      let run = "";
+      while (i < stripped.length && stripped[i] !== "'") {
+        run += stripped[i];
+        i++;
+      }
+      out += normalizeNonLiteralPredicateRun(run);
+    }
+  }
+  return out;
+}
+function normalizeNonLiteralPredicateRun(run) {
+  return run.replace(/::[A-Za-z_]\w*/g, "").replace(/[()]/g, "").toLowerCase().replace(/\s+/g, " ").replace(/\s*([=<>!]+)\s*/g, "$1").trim();
+}
+function extractIndexPredicate(createIndexSql) {
+  const match = createIndexSql.match(/\)\s*WHERE\s+([\s\S]+?)\s*;?\s*$/i);
+  if (!match) return "";
+  return normalizeIndexPredicate(match[1]);
+}
 class SchemaComparer {
   db;
   options;
@@ -89,7 +133,13 @@ class SchemaComparer {
     }
     const columnChanges = this.compareColumns(tableName, manifest, dbSchema);
     changes.push(...columnChanges);
-    const indexChanges = this.compareIndexes(tableName, manifest, dbSchema);
+    const dbIndexPredicates = await this.getDbIndexPredicates(tableName);
+    const indexChanges = this.compareIndexes(
+      tableName,
+      manifest,
+      dbSchema,
+      dbIndexPredicates
+    );
     changes.push(...indexChanges);
     return changes;
   }
@@ -190,7 +240,7 @@ class SchemaComparer {
   /**
    * Compare indexes between manifest and database
    *
-   * Three classes of drift the differ now detects:
+   * Four classes of drift the differ now detects:
    *
    * 1. **Missing index** — manifest has an index neither the DB has by name
    *    nor any equivalent-by-signature. Emit `add_index`. (Issue #741: the
@@ -198,11 +248,13 @@ class SchemaComparer {
    *    classes register indexes with different name prefixes.)
    *
    * 2. **Same-name shape drift** — DB has an index with the manifest's name,
-   *    but its columns or uniqueness flag differ. This is the failure mode
-   *    in issue #1165: `tenants_slug_context_meta_type_idx` exists but is
-   *    non-unique, while the manifest declares it unique. Emit
-   *    `drop_index` + `add_index` so the next migrate cycle recreates it
-   *    with the correct shape.
+   *    but its columns, uniqueness flag, or partial-index `WHERE` predicate
+   *    differ. This covers the uniqueness flip in issue #1165
+   *    (`tenants_slug_context_meta_type_idx` materialized non-unique while
+   *    the manifest declares it unique) and the predicate drift in issue
+   *    #1692 (a partial index whose `WHERE` clause was added, removed, or
+   *    altered). Emit `drop_index` + `add_index` so the next migrate cycle
+   *    recreates it with the correct shape.
    *
    * 3. **Orphan in DB** — DB has an index with no manifest counterpart by
    *    name and no signature equivalent. Emit `drop_index` *only* when the
@@ -210,15 +262,34 @@ class SchemaComparer {
    *    PostgreSQL implicit indexes (`*_pkey`, `*_key`) — those are owned by
    *    table-level constraints and need a separate `DROP CONSTRAINT` path
    *    that the differ does not emit yet.
+   *
+   * 4. **Partial-index predicate drift / collision** — two indexes on the
+   *    same column(s) and uniqueness that differ only by their `WHERE`
+   *    predicate (e.g. distinct STI child partial indexes) are no longer
+   *    collapsed to one signature, so the signature-equivalence path (b)
+   *    won't claim one for the other.
+   *
+   * @param dbIndexPredicates - Normalized `WHERE` predicate per DB index
+   *   name from {@link getDbIndexPredicates}. `null` means predicate
+   *   introspection was unavailable for this engine/adapter, in which case
+   *   the comparison falls back to predicate-unaware signatures (the prior
+   *   behavior) so existing partial indexes are never flagged as false drift.
    */
-  compareIndexes(tableName, manifest, dbSchema) {
+  compareIndexes(tableName, manifest, dbSchema, dbIndexPredicates = null) {
     const changes = [];
+    const predicateAware = dbIndexPredicates !== null;
+    const dbPredicateFor = (name) => predicateAware ? dbIndexPredicates?.get(name) ?? "" : "";
+    const manifestPredicateFor = (idx) => predicateAware ? normalizeIndexPredicate(idx.where) : "";
     const dbIndexesByName = /* @__PURE__ */ new Map();
     const dbIndexSignatures = /* @__PURE__ */ new Map();
     for (const idx of dbSchema.indexes) {
       const unique = idx.unique ?? false;
       dbIndexesByName.set(idx.name, { columns: idx.columns, unique });
-      const signature = this.getIndexSignature(idx.columns, unique);
+      const signature = this.getIndexSignature(
+        idx.columns,
+        unique,
+        dbPredicateFor(idx.name)
+      );
       let bucket = dbIndexSignatures.get(signature);
       if (!bucket) {
         bucket = /* @__PURE__ */ new Set();
@@ -228,11 +299,17 @@ class SchemaComparer {
     }
     const manifestSignatureSet = /* @__PURE__ */ new Set();
     for (const idx of manifest.indexes) {
-      manifestSignatureSet.add(this.getIndexSignature(idx));
+      manifestSignatureSet.add(
+        this.getIndexSignature(idx, void 0, manifestPredicateFor(idx))
+      );
     }
     const claimedDbIndexes = /* @__PURE__ */ new Set();
     for (const idx of manifest.indexes) {
-      const manifestSignature = this.getIndexSignature(idx);
+      const manifestSignature = this.getIndexSignature(
+        idx,
+        void 0,
+        manifestPredicateFor(idx)
+      );
       const dbByName = dbIndexesByName.get(idx.name);
       if (dbByName) {
         claimedDbIndexes.add(idx.name);
@@ -241,7 +318,8 @@ class SchemaComparer {
         }
         const dbSignature = this.getIndexSignature(
           dbByName.columns,
-          dbByName.unique
+          dbByName.unique,
+          dbPredicateFor(idx.name)
         );
         if (dbSignature === manifestSignature) {
           continue;
@@ -282,7 +360,8 @@ class SchemaComparer {
         if (isProtectedDbIndexName(idx.name)) continue;
         const idxSignature = this.getIndexSignature(
           idx.columns,
-          idx.unique ?? false
+          idx.unique ?? false,
+          dbPredicateFor(idx.name)
         );
         if (manifestSignatureSet.has(idxSignature)) continue;
         changes.push({
@@ -296,17 +375,21 @@ class SchemaComparer {
     return changes;
   }
   /**
-   * Generate a signature for an index based on its columns and uniqueness.
-   * Used for functional equivalence checking (Issue #741).
+   * Generate a signature for an index based on its columns, uniqueness, and
+   * (normalized) partial-index predicate. Used for functional equivalence
+   * checking (Issue #741) and predicate-drift detection (Issue #1692).
    *
    * Note: Column order is preserved because it is semantically significant for
    * composite indexes. An index on (a, b) is NOT equivalent to (b, a) - they
    * have different query performance characteristics.
    *
-   * Limitation: Partial indexes (with WHERE clauses) are not fully supported.
-   * The database introspection layer doesn't provide WHERE clause information,
-   * so two partial indexes with the same columns but different WHERE clauses
-   * cannot be distinguished and may be incorrectly treated as equivalent.
+   * The trailing predicate component distinguishes partial indexes that share
+   * columns and uniqueness but differ by their `WHERE` clause (e.g. distinct
+   * STI child partial indexes). Callers pass the already-normalized predicate
+   * so both the manifest (desired) and introspected (DB) sides compare equal
+   * for semantically-identical clauses. An empty string means "no predicate"
+   * (a non-partial index) and is also used on both sides when predicate
+   * introspection is unavailable, preserving the prior behavior.
    *
    * For JSON-path indexes (`@meta({ indexed: true })`) the signature is
    * derived from the JSON path instead of an empty column list, so the
@@ -314,17 +397,91 @@ class SchemaComparer {
    *
    * @param idxOrColumns - Either an IndexDefinition or a column array (legacy)
    * @param uniqueArg - Unique flag (used when first arg is a column array)
+   * @param predicateArg - Normalized partial-index predicate (default '')
    * @returns Signature string
    */
-  getIndexSignature(idxOrColumns, uniqueArg) {
+  getIndexSignature(idxOrColumns, uniqueArg, predicateArg = "") {
     if (Array.isArray(idxOrColumns)) {
-      return `${idxOrColumns.join(",")}:${Boolean(uniqueArg)}`;
+      return `${idxOrColumns.join(",")}:${Boolean(uniqueArg)}:${predicateArg}`;
     }
     const idx = idxOrColumns;
     if (isJsonPathIndex(idx) && idx.jsonPath) {
-      return `json:${idx.jsonPath.column}.${idx.jsonPath.path}:${Boolean(idx.unique)}`;
+      return `json:${idx.jsonPath.column}.${idx.jsonPath.path}:${Boolean(idx.unique)}:${predicateArg}`;
+    }
+    return `${(idx.columns ?? []).join(",")}:${Boolean(idx.unique)}:${predicateArg}`;
+  }
+  /**
+   * Whether the active engine supports partial indexes (`CREATE INDEX … WHERE`).
+   *
+   * SQLite and PostgreSQL do. DuckDB rejects them outright, and the JSON
+   * adapter is DuckDB-backed, so on those engines a "partial" index can only
+   * ever exist as a full index. Treating the predicate as significant there
+   * would (a) flag existing full indexes as false drift and (b) emit
+   * `CREATE INDEX … WHERE` DDL the engine rejects, breaking the migration.
+   * Gating on this keeps both the comparison and the generated DDL aligned
+   * with what the engine actually accepts (a partial index degrades to a
+   * full index), matching the pre-#1692 behavior on those engines.
+   */
+  supportsPartialIndexes() {
+    return this.engine === "sqlite" || this.engine === "postgres";
+  }
+  /**
+   * Introspect partial-index predicates for a table, keyed by index name.
+   *
+   * `getTableSchema()` (the @happyvertical/sql introspection) returns only
+   * name/columns/unique, so the `WHERE` predicate is read directly here:
+   *
+   * - PostgreSQL: `pg_indexes.indexdef` carries the full CREATE INDEX text.
+   * - SQLite: the `sqlite_master.sql` column carries the original CREATE INDEX
+   *   text.
+   *
+   * Engines that don't support partial indexes (DuckDB / the DuckDB-backed
+   * JSON adapter) short-circuit to `null` so the comparison stays
+   * predicate-unaware there — see {@link supportsPartialIndexes}.
+   *
+   * Non-partial indexes are omitted from the map (callers treat a missing
+   * entry as the empty predicate). Returns `null` when the catalog query
+   * fails — e.g. an adapter exposing neither catalog — so the index
+   * comparison can fall back to predicate-unaware behavior rather than
+   * flagging every existing partial index as false drift.
+   */
+  async getDbIndexPredicates(tableName) {
+    if (!this.supportsPartialIndexes()) {
+      return null;
+    }
+    const predicates = /* @__PURE__ */ new Map();
+    try {
+      if (this.engine === "postgres") {
+        const result2 = await this.db.query(
+          `SELECT indexname, indexdef FROM pg_indexes WHERE schemaname = 'public' AND tablename = ${this.quoteLiteral(
+            tableName
+          )}`
+        );
+        for (const row of result2.rows) {
+          if (!row.indexname || !row.indexdef) continue;
+          const predicate = extractIndexPredicate(row.indexdef);
+          if (predicate) predicates.set(row.indexname, predicate);
+        }
+        return predicates;
+      }
+      const result = await this.db.query(
+        `SELECT name, sql FROM sqlite_master WHERE type = 'index' AND tbl_name = ${this.quoteLiteral(
+          tableName
+        )} AND name NOT LIKE 'sqlite_%'`
+      );
+      for (const row of result.rows) {
+        if (!row.name || !row.sql) continue;
+        const predicate = extractIndexPredicate(row.sql);
+        if (predicate) predicates.set(row.name, predicate);
+      }
+      return predicates;
+    } catch (err) {
+      logger.debug(
+        `[SchemaComparer] Partial-index predicate introspection unavailable for ${tableName}; falling back to predicate-unaware index comparison`,
+        { error: err instanceof Error ? err.message : String(err) }
+      );
+      return null;
     }
-    return `${(idx.columns ?? []).join(",")}:${Boolean(idx.unique)}`;
   }
   /**
    * Get list of existing tables from database
@@ -547,12 +704,26 @@ class SchemaComparer {
     return `ALTER TABLE ${this.quoteIdentifier(tableName)} DROP COLUMN ${this.quoteIdentifier(colName)}`;
   }
   /**
-   * Generate SQL for adding an index
+   * Generate SQL for adding an index.
+   *
+   * On engines that support partial indexes (SQLite/PostgreSQL) this mirrors
+   * the canonical CREATE INDEX path in the DDL strategies: a partial index
+   * appends its `WHERE` predicate so a detected predicate add/alter (issue
+   * #1692) recreates the index with the correct partial condition rather than
+   * silently widening it to a full index. On DuckDB / the JSON adapter — which
+   * reject partial indexes — the predicate is dropped so the emitted DDL stays
+   * executable (a partial index degrades to a full index there). The predicate
+   * is trimmed and a redundant leading `WHERE` stripped for robustness.
    */
   generateAddIndexSQL(tableName, idx) {
     const uniqueStr = idx.unique ? "UNIQUE " : "";
     const target = renderIndexTarget(idx, this.engine);
-    return `CREATE ${uniqueStr}INDEX ${this.quoteIdentifier(idx.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;
+    let sql = `CREATE ${uniqueStr}INDEX ${this.quoteIdentifier(idx.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;
+    const where = idx.where?.trim().replace(/^WHERE\s+/i, "");
+    if (this.supportsPartialIndexes() && where) {
+      sql += ` WHERE ${where}`;
+    }
+    return sql;
   }
   /**
    * Generate SQL for dropping an index.
@@ -594,8 +765,10 @@ function getSQLFromDiff(diff) {
 }
 export {
   SchemaComparer,
+  extractIndexPredicate,
   generateSchemaDiff,
   getSQLFromDiff,
-  hasActionableChanges
+  hasActionableChanges,
+  normalizeIndexPredicate
 };
 //# sourceMappingURL=differ.js.map

package/dist/migrations/differ.js.map

@@ -1 +1 @@
-{"version":3,"file":"differ.js","sources":["../../src/migrations/differ.ts"],"sourcesContent":["/**\n * Schema Differ\n *\n * Compares manifest schemas to database schemas and generates\n * a SchemaDiff with the differences.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { detectEngine, getDDLStrategy } from '../schema/ddl/index.js';\nimport type { DatabaseEngine } from '../schema/ddl/types.js';\nimport type {\n  ColumnDefinition,\n  IndexDefinition,\n  SchemaChange,\n  SchemaDefinition,\n  SchemaDiff,\n  SQLDataType,\n} from '../schema/types.js';\nimport { isJsonPathIndex, renderIndexTarget } from '../schema/utils.js';\nimport type { DatabaseInterface, SqlTableSchemaInfo } from './types.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Valid SQLDataType values for validation\n */\nconst VALID_SQL_DATA_TYPES: Set<SQLDataType> = new Set([\n  'TEXT',\n  'INTEGER',\n  'REAL',\n  'BLOB',\n  'BOOLEAN',\n  'JSON',\n  'TIMESTAMP',\n  'UUID',\n]);\n\ninterface GeneratedTypeUpgradeSQL {\n  sql: string;\n  statements?: string[];\n}\n\n/**\n * Check if a string is a valid SQLDataType\n */\nfunction isValidSQLDataType(type: string): type is SQLDataType {\n  return VALID_SQL_DATA_TYPES.has(type as SQLDataType);\n}\n\n/**\n * Options for schema comparison\n */\nexport interface DiffOptions {\n  /** Include dropped tables in diff (default: false for safety) */\n  includeDroppedTables?: boolean;\n  /** Include dropped columns in diff (default: false for safety) */\n  includeDroppedColumns?: boolean;\n  /**\n   * Drop indexes that exist in the database but are absent from the manifest\n   * AND are not functionally equivalent to anything in the manifest. Default:\n   * false. The differ always skips primary-key indexes (`*_pkey`) and the\n   * implicit indexes that PostgreSQL creates from inline UNIQUE constraints\n   * (`*_key`) — those are owned by table-level constraints, not by the\n   * index list, and dropping them here would break the constraint.\n   */\n  includeDroppedIndexes?: boolean;\n  /** Ignore type mismatches (just log warnings) */\n  ignoreTypeMismatches?: boolean;\n  /**\n   * Explicit engine hint forwarded to `detectEngine` when picking the DDL\n   * strategy used for *existing-table* SQL (ALTER/CREATE INDEX/etc.). Use\n   * this when `db.url` is empty or ambiguous (e.g. JSON adapter, in-memory\n   * wrappers where the URL lives on `db.config?.url`). Without it the\n   * comparer falls back to URL-only detection, which can produce SQLite-\n   * flavored SQL on a connection whose caller meant Postgres or DuckDB.\n   */\n  engineHint?: string;\n}\n\n/**\n * Suffix patterns for indexes that the differ refuses to drop.\n * - `_pkey`: PostgreSQL primary key implicit index.\n * - `_key`: PostgreSQL implicit index for inline `UNIQUE (...)` table\n *   constraints. Dropping these by name does not drop the underlying\n *   constraint, and dropping the constraint requires a separate DDL path\n *   (`ALTER TABLE ... DROP CONSTRAINT`) the differ does not emit today.\n */\nconst PROTECTED_INDEX_SUFFIXES = ['_pkey', '_key'];\n\nfunction isProtectedDbIndexName(name: string): boolean {\n  return PROTECTED_INDEX_SUFFIXES.some((suffix) => name.endsWith(suffix));\n}\n\nfunction resolveDatabaseUrl(db: DatabaseInterface): string {\n  const dbWithConfig = db as DatabaseInterface & {\n    config?: { url?: string };\n  };\n  return db.url || dbWithConfig.config?.url || '';\n}\n\n/**\n * SchemaComparer class for comparing manifest schemas to database\n */\nexport class SchemaComparer {\n  private db: DatabaseInterface;\n  private options: DiffOptions;\n  private engine: DatabaseEngine;\n  private ddlStrategy: ReturnType<typeof getDDLStrategy>;\n\n  constructor(db: DatabaseInterface, options: DiffOptions = {}) {\n    this.db = db;\n    this.options = {\n      includeDroppedTables: false,\n      includeDroppedColumns: false,\n      includeDroppedIndexes: false,\n      ignoreTypeMismatches: false,\n      ...options,\n    };\n    // Use the shared detectEngine utility for consistent detection.\n    // Handles :memory:, .json, and other edge cases. The JSON adapter is\n    // detected structurally (it exposes `exportTable`) because its url can be\n    // empty; otherwise fall back to URL-based detection, where `engineHint`\n    // lets callers override when `db.url` is empty or points at an adapter\n    // whose engine isn't obvious from the URL alone (some in-memory wrappers).\n    this.engine =\n      typeof (this.db as { exportTable?: unknown }).exportTable === 'function'\n        ? 'json'\n        : detectEngine(resolveDatabaseUrl(this.db), this.options.engineHint);\n    this.ddlStrategy = getDDLStrategy(this.engine);\n  }\n\n  /**\n   * Compare manifest schemas to database and return differences\n   */\n  async compare(\n    manifestSchemas: Record<string, SchemaDefinition>,\n  ): Promise<SchemaDiff> {\n    const diff: SchemaDiff = {\n      added_tables: [],\n      dropped_tables: [],\n      changes: [],\n      has_changes: false,\n    };\n\n    // Get list of existing tables\n    const existingTables = await this.getExistingTables();\n\n    // Check each manifest schema against database\n    for (const [tableName, schema] of Object.entries(manifestSchemas)) {\n      if (!existingTables.has(tableName)) {\n        // Table doesn't exist - add to added_tables\n        diff.added_tables.push(schema);\n        diff.has_changes = true;\n      } else {\n        // Table exists - compare columns and indexes\n        const tableChanges = await this.compareTable(tableName, schema);\n        if (tableChanges.length > 0) {\n          diff.changes.push(...tableChanges);\n          diff.has_changes = true;\n        }\n      }\n    }\n\n    // Check for dropped tables (if enabled)\n    if (this.options.includeDroppedTables) {\n      for (const tableName of existingTables) {\n        // Skip system tables\n        if (tableName.startsWith('_smrt_') || tableName.startsWith('sqlite_')) {\n          continue;\n        }\n        if (!manifestSchemas[tableName]) {\n          diff.dropped_tables.push(tableName);\n          diff.has_changes = true;\n        }\n      }\n    }\n\n    return diff;\n  }\n\n  /**\n   * Compare a single table's schema to manifest\n   */\n  async compareTable(\n    tableName: string,\n    manifest: SchemaDefinition,\n  ): Promise<SchemaChange[]> {\n    const changes: SchemaChange[] = [];\n\n    // Get current table schema from database\n    const dbSchema = await this.db.getTableSchema?.(tableName);\n    if (!dbSchema) {\n      // Table doesn't exist - this is an add_table case\n      return changes;\n    }\n\n    // Compare columns\n    const columnChanges = this.compareColumns(tableName, manifest, dbSchema);\n    changes.push(...columnChanges);\n\n    // Compare indexes\n    const indexChanges = this.compareIndexes(tableName, manifest, dbSchema);\n    changes.push(...indexChanges);\n\n    return changes;\n  }\n\n  /**\n   * Compare columns between manifest and database\n   */\n  private compareColumns(\n    tableName: string,\n    manifest: SchemaDefinition,\n    dbSchema: SqlTableSchemaInfo,\n  ): SchemaChange[] {\n    const changes: SchemaChange[] = [];\n    const dbColumnNames = new Set(Object.keys(dbSchema.columns));\n\n    // Check for new and modified columns\n    for (const [colName, colDef] of Object.entries(manifest.columns)) {\n      if (!dbColumnNames.has(colName)) {\n        // Column doesn't exist - add it\n        changes.push({\n          type: 'add_column',\n          table: tableName,\n          name: colName,\n          column: colDef,\n          sql: this.generateAddColumnSQL(tableName, colName, colDef),\n        });\n      } else {\n        // Column exists - check for type mismatch\n        const dbCol = dbSchema.columns[colName];\n\n        // Map manifest's abstract type to engine-specific type\n        // e.g., JSON → TEXT for SQLite, JSON → JSONB for PostgreSQL\n        // Validate the manifest type before mapping\n        const manifestType = colDef.type;\n        if (!isValidSQLDataType(manifestType)) {\n          // Invalid manifest type - treat as TEXT (safest fallback)\n          logger.warn(\n            `[SchemaComparer] Invalid manifest type \"${manifestType}\" for ${tableName}.${colName}, treating as TEXT`,\n          );\n        }\n        const validatedType: SQLDataType = isValidSQLDataType(manifestType)\n          ? manifestType\n          : 'TEXT';\n        const expectedEngineType = this.ddlStrategy.mapType(validatedType);\n        const normalizedExpected = this.normalizeType(expectedEngineType);\n        const normalizedActual = this.normalizeType(dbCol.type);\n\n        // R11: native `uuid` and `text` are interchangeable for SMRT-owned\n        // identifiers/references, but not for arbitrary provenance text. Keep\n        // the tolerance directional:\n        //   - manifest UUID + DB text is tolerated for structural ID/ref\n        //     columns so old deployments are not forced into native UUID.\n        //   - manifest TEXT + DB uuid is tolerated only for structural ID/ref\n        //     columns that are intentionally UUID-compatible.\n        // Plain TEXT columns with DB uuid now surface as repairable drift.\n        const isUuidTextEquivalent = this.isUuidTextEquivalentColumn(\n          colName,\n          colDef,\n          normalizedExpected,\n          normalizedActual,\n        );\n\n        // #1335: native `json`/`jsonb` (DB) and `text` (manifest) are\n        // interchangeable for SMRT — the convention is to serialize JSON values\n        // into TEXT columns, and a native-json column already holds exactly that\n        // data. So the differ must NOT flag a json<->text difference in EITHER\n        // direction:\n        //   - manifest TEXT vs DB json   (native-json column, text-convention manifest)\n        //   - manifest JSON vs DB text   (the canary case: an enum/plain field\n        //     mis-inferred as JSON by a downstream scanner, sitting on a real\n        //     `text` column holding bare values like 'active')\n        // Generating an ALTER here is pure churn at best and data-destroying at\n        // worst: `status::jsonb` on a column holding 'active' raises\n        // \"invalid input syntax for type json\" and aborts the whole atomic\n        // migration. Like the uuid/text tolerance, this lives at the equality\n        // gate only (not in `normalizeType`) so `isCompatibleTypeUpgrade` still\n        // treats JSON and TEXT as distinct buckets for OTHER upgrade paths.\n        const isJsonTextEquivalent =\n          (normalizedExpected === 'JSON' && normalizedActual === 'TEXT') ||\n          (normalizedExpected === 'TEXT' && normalizedActual === 'JSON');\n\n        if (\n          normalizedExpected !== normalizedActual &&\n          !isUuidTextEquivalent &&\n          !isJsonTextEquivalent\n        ) {\n          // Check if this is a safe type upgrade that SMRT can handle\n          // Since SMRT owns the data lifecycle, we know the intent from the manifest\n          if (this.isCompatibleTypeUpgrade(colDef.type, dbCol.type)) {\n            // Generate type upgrade SQL\n            const generatedSQL = this.generateTypeUpgradeSQL(\n              tableName,\n              colName,\n              colDef,\n              dbCol.type,\n            );\n            changes.push({\n              type: 'type_upgrade',\n              table: tableName,\n              name: colName,\n              column: colDef,\n              mismatch: {\n                expected: colDef.type,\n                actual: dbCol.type,\n              },\n              sql: generatedSQL.sql,\n              ...(generatedSQL.statements\n                ? { sqlStatements: generatedSQL.statements }\n                : {}),\n            });\n          } else if (!this.options.ignoreTypeMismatches) {\n            changes.push({\n              type: 'type_mismatch',\n              table: tableName,\n              name: colName,\n              mismatch: {\n                expected: colDef.type,\n                actual: dbCol.type,\n              },\n            });\n          }\n        }\n      }\n    }\n\n    // Check for dropped columns (if enabled)\n    if (this.options.includeDroppedColumns) {\n      const manifestColumnNames = new Set(Object.keys(manifest.columns));\n      for (const colName of dbColumnNames) {\n        if (!manifestColumnNames.has(colName)) {\n          changes.push({\n            type: 'drop_column',\n            table: tableName,\n            name: colName,\n            sql: this.generateDropColumnSQL(tableName, colName),\n          });\n        }\n      }\n    }\n\n    return changes;\n  }\n\n  private isUuidTextEquivalentColumn(\n    columnName: string,\n    colDef: ColumnDefinition,\n    normalizedExpected: string,\n    normalizedActual: string,\n  ): boolean {\n    const expectedUuidActualText =\n      normalizedExpected === 'UUID' && normalizedActual === 'TEXT';\n    const expectedTextActualUuid =\n      normalizedExpected === 'TEXT' && normalizedActual === 'UUID';\n\n    if (!expectedUuidActualText && !expectedTextActualUuid) {\n      return false;\n    }\n\n    return this.isStructuralUuidCompatibleColumn(columnName, colDef);\n  }\n\n  private isStructuralUuidCompatibleColumn(\n    columnName: string,\n    colDef: ColumnDefinition,\n  ): boolean {\n    return (\n      colDef.primaryKey === true ||\n      Boolean(colDef.foreignKey) ||\n      colDef.referenceKind === 'id' ||\n      colDef.referenceKind === 'foreignKey' ||\n      colDef.referenceKind === 'crossPackageRef' ||\n      colDef.referenceKind === 'tenantId' ||\n      (columnName === 'id' && colDef.type === 'TEXT')\n    );\n  }\n\n  /**\n   * Compare indexes between manifest and database\n   *\n   * Three classes of drift the differ now detects:\n   *\n   * 1. **Missing index** — manifest has an index neither the DB has by name\n   *    nor any equivalent-by-signature. Emit `add_index`. (Issue #741: the\n   *    signature check protects against creating duplicates when STI child\n   *    classes register indexes with different name prefixes.)\n   *\n   * 2. **Same-name shape drift** — DB has an index with the manifest's name,\n   *    but its columns or uniqueness flag differ. This is the failure mode\n   *    in issue #1165: `tenants_slug_context_meta_type_idx` exists but is\n   *    non-unique, while the manifest declares it unique. Emit\n   *    `drop_index` + `add_index` so the next migrate cycle recreates it\n   *    with the correct shape.\n   *\n   * 3. **Orphan in DB** — DB has an index with no manifest counterpart by\n   *    name and no signature equivalent. Emit `drop_index` *only* when the\n   *    caller opts in via `includeDroppedIndexes`, and even then never for\n   *    PostgreSQL implicit indexes (`*_pkey`, `*_key`) — those are owned by\n   *    table-level constraints and need a separate `DROP CONSTRAINT` path\n   *    that the differ does not emit yet.\n   */\n  private compareIndexes(\n    tableName: string,\n    manifest: SchemaDefinition,\n    dbSchema: SqlTableSchemaInfo,\n  ): SchemaChange[] {\n    const changes: SchemaChange[] = [];\n\n    // Index DB indexes by name and by signature for fast lookup.\n    // dbIndexSignatures groups *all* DB index names sharing a signature so\n    // duplicates under different names all get claimed by a single matching\n    // manifest entry — otherwise the orphan sweep would drop the un-claimed\n    // siblings even though they are functionally equivalent to the manifest.\n    const dbIndexesByName = new Map<\n      string,\n      { columns: string[]; unique: boolean }\n    >();\n    const dbIndexSignatures = new Map<string, Set<string>>();\n    for (const idx of dbSchema.indexes) {\n      const unique = idx.unique ?? false;\n      dbIndexesByName.set(idx.name, { columns: idx.columns, unique });\n      const signature = this.getIndexSignature(idx.columns, unique);\n      let bucket = dbIndexSignatures.get(signature);\n      if (!bucket) {\n        bucket = new Set();\n        dbIndexSignatures.set(signature, bucket);\n      }\n      bucket.add(idx.name);\n    }\n\n    // Manifest signatures — used during the orphan sweep to skip DB indexes\n    // that match a manifest entry's signature even if no specific manifest\n    // entry \"claimed\" them by name.\n    const manifestSignatureSet = new Set<string>();\n    for (const idx of manifest.indexes) {\n      manifestSignatureSet.add(this.getIndexSignature(idx));\n    }\n\n    // Track which DB indexes a manifest entry has claimed, so the orphan\n    // pass below doesn't re-flag indexes that match by signature alone.\n    const claimedDbIndexes = new Set<string>();\n\n    for (const idx of manifest.indexes) {\n      const manifestSignature = this.getIndexSignature(idx);\n\n      // (a) Same name in DB — verify shape matches.\n      const dbByName = dbIndexesByName.get(idx.name);\n      if (dbByName) {\n        claimedDbIndexes.add(idx.name);\n\n        // JSON-path indexes (`@meta({ indexed: true })`) cannot be reliably\n        // compared by DB introspection — SQLite expression indexes surface\n        // as `[null]` columns, so the signature would always mismatch and\n        // every diff run would emit drop+recreate. Trust the name match\n        // here; if the json path itself changes, the index name changes\n        // too (we encode the field name into it), so a name match is a\n        // stronger guarantee than the column list for this index family.\n        if (isJsonPathIndex(idx)) {\n          continue;\n        }\n\n        const dbSignature = this.getIndexSignature(\n          dbByName.columns,\n          dbByName.unique,\n        );\n        if (dbSignature === manifestSignature) {\n          continue; // Same name, same shape — nothing to do.\n        }\n\n        // Same name, drifted shape. Most often this is a uniqueness flip\n        // (issue #1165: 3-column index materialized non-unique). Recreate.\n        //\n        // Rollback caveat: the auto-generated DOWN script for the\n        // `add_index` half drops the (newly correct) index, and the\n        // `drop_index` half has no DOWN. Rolling back a recreate leaves\n        // the table without the index entirely instead of restoring the\n        // wrong-shape original. Capturing the original shape would\n        // require richer DB introspection than the differ currently has,\n        // so this asymmetry is accepted — the failure mode after an\n        // un-rolled-back recreate is \"missing index\" rather than\n        // \"permanently broken UPSERT,\" which is recoverable.\n        changes.push({\n          type: 'drop_index',\n          table: tableName,\n          name: idx.name,\n          sql: this.generateDropIndexSQL(idx.name),\n        });\n        changes.push({\n          type: 'add_index',\n          table: tableName,\n          name: idx.name,\n          index: idx,\n          sql: this.generateAddIndexSQL(tableName, idx),\n        });\n        continue;\n      }\n\n      // (b) Different name in DB but functionally equivalent — keep as-is.\n      // Claim *every* DB name sharing this signature so duplicate-shape\n      // indexes (e.g., a stale `<name>_idx` plus the implicit `<name>_key`\n      // from the same constraint) all survive the orphan sweep.\n      const equivalentIndexNames = dbIndexSignatures.get(manifestSignature);\n      if (equivalentIndexNames && equivalentIndexNames.size > 0) {\n        for (const name of equivalentIndexNames) {\n          claimedDbIndexes.add(name);\n        }\n        continue;\n      }\n\n      // (c) Genuinely missing — add it.\n      changes.push({\n        type: 'add_index',\n        table: tableName,\n        name: idx.name,\n        index: idx,\n        sql: this.generateAddIndexSQL(tableName, idx),\n      });\n    }\n\n    // Orphan-index sweep (opt-in via includeDroppedIndexes).\n    if (this.options.includeDroppedIndexes) {\n      for (const idx of dbSchema.indexes) {\n        if (claimedDbIndexes.has(idx.name)) continue;\n        if (isProtectedDbIndexName(idx.name)) continue;\n\n        // Belt-and-suspenders: even if a DB index wasn't formally claimed\n        // by a manifest entry (e.g., shape-drift recreate consumed the\n        // claim slot), don't drop it if its signature still matches\n        // something the manifest declares. That would contradict the\n        // option doc (\"not functionally equivalent to anything in the\n        // manifest\") and risk dropping a still-needed index.\n        const idxSignature = this.getIndexSignature(\n          idx.columns,\n          idx.unique ?? false,\n        );\n        if (manifestSignatureSet.has(idxSignature)) continue;\n\n        changes.push({\n          type: 'drop_index',\n          table: tableName,\n          name: idx.name,\n          sql: this.generateDropIndexSQL(idx.name),\n        });\n      }\n    }\n\n    return changes;\n  }\n\n  /**\n   * Generate a signature for an index based on its columns and uniqueness.\n   * Used for functional equivalence checking (Issue #741).\n   *\n   * Note: Column order is preserved because it is semantically significant for\n   * composite indexes. An index on (a, b) is NOT equivalent to (b, a) - they\n   * have different query performance characteristics.\n   *\n   * Limitation: Partial indexes (with WHERE clauses) are not fully supported.\n   * The database introspection layer doesn't provide WHERE clause information,\n   * so two partial indexes with the same columns but different WHERE clauses\n   * cannot be distinguished and may be incorrectly treated as equivalent.\n   *\n   * For JSON-path indexes (`@meta({ indexed: true })`) the signature is\n   * derived from the JSON path instead of an empty column list, so the\n   * differ can distinguish two jsonPath indexes against different paths.\n   *\n   * @param idxOrColumns - Either an IndexDefinition or a column array (legacy)\n   * @param uniqueArg - Unique flag (used when first arg is a column array)\n   * @returns Signature string\n   */\n  private getIndexSignature(\n    idxOrColumns: IndexDefinition | string[],\n    uniqueArg?: boolean,\n  ): string {\n    if (Array.isArray(idxOrColumns)) {\n      return `${idxOrColumns.join(',')}:${Boolean(uniqueArg)}`;\n    }\n    const idx = idxOrColumns;\n    if (isJsonPathIndex(idx) && idx.jsonPath) {\n      return `json:${idx.jsonPath.column}.${idx.jsonPath.path}:${Boolean(idx.unique)}`;\n    }\n    return `${(idx.columns ?? []).join(',')}:${Boolean(idx.unique)}`;\n  }\n\n  /**\n   * Get list of existing tables from database\n   */\n  private async getExistingTables(): Promise<Set<string>> {\n    let query: string;\n    if (this.engine === 'postgres') {\n      query = `SELECT table_name FROM information_schema.tables WHERE table_schema = 'public'`;\n    } else {\n      // SQLite and DuckDB\n      query = `SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'`;\n    }\n\n    const result = await this.db.query(query);\n    const rows = result.rows as { name?: string; table_name?: string }[];\n    return new Set(\n      rows.map((r) => r.name || r.table_name || '').filter(Boolean),\n    );\n  }\n\n  /**\n   * Normalize SQL types for comparison\n   */\n  private normalizeType(type: string): string {\n    const upper = type.toUpperCase().trim();\n\n    // Integer types\n    if (/^(INTEGER|INT|BIGINT|SMALLINT|TINYINT)$/i.test(upper)) {\n      return 'INTEGER';\n    }\n\n    // Text types\n    if (/^(TEXT|CLOB|STRING|VARCHAR|CHAR)/i.test(upper)) {\n      return 'TEXT';\n    }\n\n    // UUID normalizes to its own bucket — deliberately NOT folded into TEXT.\n    // The text<->uuid drift tolerance (R11) is applied at the equality gate\n    // in `compare()` only, so that `isCompatibleTypeUpgrade` (which also\n    // calls normalizeType) still treats `uuid` as distinct from text and\n    // won't mis-classify e.g. `uuid`->`timestamp` as a compatible\n    // \"TEXT->TIMESTAMP\" upgrade.\n    if (/^UUID$/i.test(upper)) {\n      return 'UUID';\n    }\n\n    // Decimal types\n    if (/^(REAL|FLOAT|DOUBLE|DECIMAL|NUMERIC|NUMBER)/i.test(upper)) {\n      return 'REAL';\n    }\n\n    // Boolean types\n    if (/^(BOOLEAN|BOOL)/i.test(upper)) {\n      return 'BOOLEAN';\n    }\n\n    // Date/time types\n    if (/^(DATETIME|TIMESTAMP|DATE|TIME)/i.test(upper)) {\n      return 'TIMESTAMP';\n    }\n\n    // Blob types\n    if (/^(BLOB|BINARY|BYTEA)/i.test(upper)) {\n      return 'BLOB';\n    }\n\n    // JSON types\n    if (/^(JSON|JSONB)/i.test(upper)) {\n      return 'JSON';\n    }\n\n    return upper;\n  }\n\n  /**\n   * Check if a type change is a safe upgrade that can be auto-migrated.\n   *\n   * SMRT controls the data lifecycle for these columns, so we know:\n   * - TEXT→JSON: The column stores JSON data serialized as text (arrays, objects)\n   * - TEXT/JSON→TIMESTAMP: Legacy system columns stored timestamp strings\n   *   before newer manifests normalized the column type.\n   * - INTEGER→REAL: Safe widening of integer to floating point\n   * - TEXT/REAL→INTEGER on PostgreSQL: explicit data-checked repairs for\n   *   legacy integer columns that were previously stored as text/real.\n   *\n   * @param manifestType - The abstract type from the manifest (e.g., 'JSON')\n   * @param dbType - The actual type in the database (e.g., 'TEXT')\n   * @returns true if the change from dbType to manifestType is a safe upgrade\n   */\n  private isCompatibleTypeUpgrade(\n    manifestType: string,\n    dbType: string,\n  ): boolean {\n    const manifest = this.normalizeType(manifestType);\n    const db = this.normalizeType(dbType);\n\n    // TEXT → JSON is safe: SMRT serializes arrays/objects as JSON text\n    // When the manifest says JSON, the data is already valid JSON in TEXT column\n    if (manifest === 'JSON' && db === 'TEXT') {\n      return true;\n    }\n\n    // JSON → TEXT is also safe (downgrade, but data is preserved as-is)\n    if (manifest === 'TEXT' && db === 'JSON') {\n      return true;\n    }\n\n    // UUID → TEXT is safe for plain text/provenance fields that were\n    // mistakenly materialized as native uuid: the stored UUID value can be\n    // rendered losslessly as text.\n    if (manifest === 'TEXT' && db === 'UUID') {\n      return true;\n    }\n\n    // INTEGER → REAL is safe (widening)\n    if (manifest === 'REAL' && db === 'INTEGER') {\n      return true;\n    }\n\n    // PostgreSQL can safely repair legacy integer columns when the generated\n    // migration validates that every existing value is already an integer.\n    if (\n      this.engine === 'postgres' &&\n      manifest === 'INTEGER' &&\n      (db === 'TEXT' || db === 'REAL')\n    ) {\n      return true;\n    }\n\n    // TEXT/JSON → TIMESTAMP is a legacy-drift repair. Invalid values fail\n    // explicitly during migration rather than being silently coerced.\n    if (manifest === 'TIMESTAMP' && (db === 'TEXT' || db === 'JSON')) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Generate SQL for a type upgrade migration.\n   *\n   * Engine-specific SQL:\n   * - SQLite: TEXT and JSON are equivalent, no-op or comment\n   * - DuckDB: ALTER COLUMN TYPE (native type conversion)\n   * - PostgreSQL: ALTER COLUMN TYPE with USING clause\n   */\n  private generateTypeUpgradeSQL(\n    tableName: string,\n    colName: string,\n    colDef: ColumnDefinition,\n    dbType: string,\n  ): GeneratedTypeUpgradeSQL {\n    const quotedTable = this.quoteIdentifier(tableName);\n    const quotedCol = this.quoteIdentifier(colName);\n    const manifestType = colDef.type;\n\n    // Validate manifestType before mapping\n    const validatedType: SQLDataType = isValidSQLDataType(manifestType)\n      ? manifestType\n      : 'TEXT';\n    const targetType = this.ddlStrategy.mapType(validatedType);\n\n    switch (this.engine) {\n      case 'sqlite':\n        // SQLite has dynamic typing - TEXT and JSON are functionally equivalent\n        // For SQLite, we just return a comment since no actual change is needed\n        if (\n          this.normalizeType(manifestType) === 'JSON' &&\n          this.normalizeType(dbType) === 'TEXT'\n        ) {\n          return {\n            sql: `-- SQLite: ${quotedCol} already stores JSON as TEXT (no change needed)`,\n          };\n        }\n        // For other type upgrades, SQLite requires recreating the table\n        return {\n          sql: `-- SQLite: Type upgrade for ${quotedCol} requires table recreation`,\n        };\n\n      case 'postgres': {\n        // PostgreSQL defaults must be dropped/reset around some type changes\n        // so drift repairs can succeed even when an existing default cannot\n        // be cast automatically to the target type.\n        const manifestNormalized = this.normalizeType(manifestType);\n        const dbNormalized = this.normalizeType(dbType);\n        const preflightSQL =\n          manifestNormalized === 'INTEGER' &&\n          (dbNormalized === 'TEXT' || dbNormalized === 'REAL')\n            ? this.generatePostgresIntegerPreflightSQL(\n                quotedTable,\n                quotedCol,\n                tableName,\n                colName,\n                dbNormalized,\n              )\n            : null;\n        const clauses: string[] = [];\n\n        if (colDef.defaultValue !== undefined) {\n          clauses.push(`ALTER COLUMN ${quotedCol} DROP DEFAULT`);\n        }\n\n        let typeClause = `ALTER COLUMN ${quotedCol} TYPE ${targetType}`;\n        if (manifestNormalized === 'JSON' && dbNormalized === 'TEXT') {\n          // #1335: a bare `${col}::jsonb` cast raises \"invalid input syntax for\n          // type json\" on any row whose text is not already valid JSON (e.g. a\n          // legacy enum column holding 'active'). `to_jsonb(col)` instead wraps\n          // ANY text value as a JSON string and never errors, so a genuine\n          // TEXT->JSON widening survives non-JSON legacy data. (Note: with the\n          // json<->text equality tolerance added in this fix, the normal\n          // compare path no longer reaches here; this keeps the SQL safe for\n          // callers that construct a type_upgrade directly.)\n          typeClause += ` USING to_jsonb(${quotedCol})`;\n        } else if (manifestNormalized === 'TEXT' && dbNormalized === 'JSON') {\n          // #1335: a native-json column cast back to text is value-preserving\n          // (`::text` renders the stored JSON as its text form), so this arm is\n          // safe. (Note: like the TEXT->JSON arm above, the json<->text equality\n          // tolerance means the normal compare path no longer reaches here; this\n          // keeps the SQL safe for callers that construct a type_upgrade\n          // directly.)\n          typeClause += ` USING ${quotedCol}::text`;\n        } else if (manifestNormalized === 'TEXT' && dbNormalized === 'UUID') {\n          typeClause += ` USING ${quotedCol}::text`;\n        } else if (\n          manifestNormalized === 'INTEGER' &&\n          dbNormalized === 'TEXT'\n        ) {\n          typeClause += ` USING trim(${quotedCol}::text)::integer`;\n        } else if (\n          manifestNormalized === 'INTEGER' &&\n          dbNormalized === 'REAL'\n        ) {\n          typeClause += ` USING ${quotedCol}::integer`;\n        } else if (\n          manifestNormalized === 'TIMESTAMP' &&\n          (dbNormalized === 'TEXT' || dbNormalized === 'JSON')\n        ) {\n          typeClause += ` USING NULLIF(NULLIF(trim(both '\"' from ${quotedCol}::text), ''), 'null')::timestamp`;\n        }\n\n        clauses.push(typeClause);\n\n        if (colDef.defaultValue !== undefined) {\n          const formattedDefault = this.ddlStrategy.formatDefaultValue(\n            colDef.defaultValue,\n            validatedType,\n          );\n          const defaultSql =\n            manifestNormalized === 'JSON'\n              ? `${formattedDefault}::${targetType.toLowerCase()}`\n              : formattedDefault;\n          clauses.push(`ALTER COLUMN ${quotedCol} SET DEFAULT ${defaultSql}`);\n        }\n\n        const alterSql = `ALTER TABLE ${quotedTable} ${clauses.join(', ')}`;\n\n        return preflightSQL\n          ? { sql: alterSql, statements: [preflightSQL, alterSql] }\n          : { sql: alterSql };\n      }\n\n      case 'duckdb':\n        // DuckDB supports ALTER COLUMN TYPE for type conversions\n        return {\n          sql: `ALTER TABLE ${quotedTable} ALTER COLUMN ${quotedCol} TYPE ${targetType}`,\n        };\n\n      default: {\n        // Escape special characters in type names for safe comment generation\n        const safeDbType = dbType.replace(/[^\\w]/g, '_');\n        const safeManifestType = manifestType.replace(/[^\\w]/g, '_');\n        return {\n          sql: `-- Type upgrade for ${quotedCol}: ${safeDbType} → ${safeManifestType}`,\n        };\n      }\n    }\n  }\n\n  /**\n   * Quote a SQL identifier\n   */\n  private quoteIdentifier(name: string): string {\n    return `\"${name.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  /**\n   * Generate a PostgreSQL preflight guard for narrowing legacy columns to\n   * INTEGER. PostgreSQL's REAL→INTEGER cast rounds fractional values, so the\n   * generated migration must fail before the ALTER can silently change data.\n   */\n  private generatePostgresIntegerPreflightSQL(\n    quotedTable: string,\n    quotedCol: string,\n    tableName: string,\n    colName: string,\n    dbNormalized: string,\n  ): string {\n    const invalidCondition =\n      dbNormalized === 'REAL'\n        ? `${quotedCol} IS NOT NULL AND ${quotedCol} <> trunc(${quotedCol})`\n        : `${quotedCol} IS NOT NULL AND trim(${quotedCol}::text) !~ '^[+-]?[0-9]+$'`;\n    const message = `Cannot convert ${tableName}.${colName} to INTEGER: found non-integer values`;\n\n    return `DO $$ BEGIN IF EXISTS (SELECT 1 FROM ${quotedTable} WHERE ${invalidCondition}) THEN RAISE EXCEPTION ${this.quoteLiteral(message)}; END IF; END $$`;\n  }\n\n  private quoteLiteral(value: string): string {\n    return `'${value.replace(/'/g, \"''\")}'`;\n  }\n\n  /**\n   * Generate SQL for adding a column\n   */\n  private generateAddColumnSQL(\n    tableName: string,\n    colName: string,\n    colDef: ColumnDefinition,\n  ): string {\n    // Build the ADD COLUMN definition inline (main) rather than delegating to\n    // the DDL strategy's generateColumnDefinition: that builder is for CREATE\n    // TABLE and would emit `PRIMARY KEY` (invalid in ALTER ... ADD COLUMN) and\n    // suppress single-column UNIQUE on engines that require inline unique at\n    // table-create time (DuckDB) — but an ADD COLUMN has no inline-constraint\n    // pass, so the UNIQUE must be emitted here. mapType still maps abstract\n    // types per dialect (UUID→native uuid / TEXT — R11); invalid types fall\n    // back to TEXT, matching the compareColumns guard.\n    const validatedType: SQLDataType = isValidSQLDataType(colDef.type)\n      ? colDef.type\n      : 'TEXT';\n    if (!isValidSQLDataType(colDef.type)) {\n      logger.warn(\n        `[SchemaComparer] Invalid manifest type \"${colDef.type}\" for ${tableName}.${colName}, treating as TEXT`,\n      );\n    }\n\n    const parts: string[] = [\n      this.quoteIdentifier(colName),\n      this.ddlStrategy.mapType(validatedType),\n    ];\n\n    if (colDef.notNull) {\n      parts.push('NOT NULL');\n    }\n    if (colDef.unique) {\n      parts.push('UNIQUE');\n    }\n    if (colDef.defaultValue !== undefined) {\n      const defaultVal = this.ddlStrategy.formatDefaultValue(\n        colDef.defaultValue,\n        validatedType,\n      );\n      parts.push(`DEFAULT ${defaultVal}`);\n    }\n    if (colDef.check) {\n      parts.push(`CHECK (${colDef.check})`);\n    }\n\n    const columnDefinition = parts.join(' ');\n\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD COLUMN ${columnDefinition}`;\n  }\n\n  /**\n   * Generate SQL for dropping a column\n   */\n  private generateDropColumnSQL(tableName: string, colName: string): string {\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} DROP COLUMN ${this.quoteIdentifier(colName)}`;\n  }\n\n  /**\n   * Generate SQL for adding an index\n   */\n  private generateAddIndexSQL(tableName: string, idx: IndexDefinition): string {\n    const uniqueStr = idx.unique ? 'UNIQUE ' : '';\n    const target = renderIndexTarget(idx, this.engine);\n    return `CREATE ${uniqueStr}INDEX ${this.quoteIdentifier(idx.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;\n  }\n\n  /**\n   * Generate SQL for dropping an index.\n   *\n   * This SQL is consumed by the manifest-driven execution path:\n   *\n   * - `db:migrate` runs the SQL we put in `change.sql` directly, with the\n   *   tracker's `executePostgresStatements` adding CONCURRENTLY when\n   *   `--postgres-safe` is on.\n   *\n   * PostgreSQL ends up with `CONCURRENTLY` when it should.\n   * Keeping this method engine-agnostic also means the diff preview text\n   * stays readable (no engine-specific noise) for engines like SQLite\n   * where CONCURRENTLY isn't a thing.\n   */\n  private generateDropIndexSQL(indexName: string): string {\n    return `DROP INDEX IF EXISTS ${this.quoteIdentifier(indexName)}`;\n  }\n}\n\n/**\n * Generate a SchemaDiff from manifest and database\n */\nexport async function generateSchemaDiff(\n  db: DatabaseInterface,\n  manifestSchemas: Record<string, SchemaDefinition>,\n  options: DiffOptions = {},\n): Promise<SchemaDiff> {\n  const comparer = new SchemaComparer(db, options);\n  return comparer.compare(manifestSchemas);\n}\n\n/**\n * Check if a diff has any actionable changes (excluding type mismatches)\n */\nexport function hasActionableChanges(diff: SchemaDiff): boolean {\n  if (diff.added_tables.length > 0) return true;\n  if (diff.dropped_tables.length > 0) return true;\n  return diff.changes.some((c) => c.type !== 'type_mismatch');\n}\n\n/**\n * Get SQL statements from a diff for execution\n */\nexport function getSQLFromDiff(diff: SchemaDiff): string[] {\n  const statements: string[] = [];\n\n  // Add table creation (requires full DDL generation - not included here)\n  // This is typically handled by ensureSchema()\n\n  // Add column and index changes\n  for (const change of diff.changes) {\n    if (change.type !== 'type_mismatch') {\n      statements.push(\n        ...(change.sqlStatements ?? (change.sql ? [change.sql] : [])),\n      );\n    }\n  }\n\n  return statements;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"differ.js","sources":["../../src/migrations/differ.ts"],"sourcesContent":["/**\n * Schema Differ\n *\n * Compares manifest schemas to database schemas and generates\n * a SchemaDiff with the differences.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { detectEngine, getDDLStrategy } from '../schema/ddl/index.js';\nimport type { DatabaseEngine } from '../schema/ddl/types.js';\nimport type {\n  ColumnDefinition,\n  IndexDefinition,\n  SchemaChange,\n  SchemaDefinition,\n  SchemaDiff,\n  SQLDataType,\n} from '../schema/types.js';\nimport { isJsonPathIndex, renderIndexTarget } from '../schema/utils.js';\nimport type { DatabaseInterface, SqlTableSchemaInfo } from './types.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Valid SQLDataType values for validation\n */\nconst VALID_SQL_DATA_TYPES: Set<SQLDataType> = new Set([\n  'TEXT',\n  'INTEGER',\n  'REAL',\n  'BLOB',\n  'BOOLEAN',\n  'JSON',\n  'TIMESTAMP',\n  'UUID',\n]);\n\ninterface GeneratedTypeUpgradeSQL {\n  sql: string;\n  statements?: string[];\n}\n\n/**\n * Check if a string is a valid SQLDataType\n */\nfunction isValidSQLDataType(type: string): type is SQLDataType {\n  return VALID_SQL_DATA_TYPES.has(type as SQLDataType);\n}\n\n/**\n * Options for schema comparison\n */\nexport interface DiffOptions {\n  /** Include dropped tables in diff (default: false for safety) */\n  includeDroppedTables?: boolean;\n  /** Include dropped columns in diff (default: false for safety) */\n  includeDroppedColumns?: boolean;\n  /**\n   * Drop indexes that exist in the database but are absent from the manifest\n   * AND are not functionally equivalent to anything in the manifest. Default:\n   * false. The differ always skips primary-key indexes (`*_pkey`) and the\n   * implicit indexes that PostgreSQL creates from inline UNIQUE constraints\n   * (`*_key`) — those are owned by table-level constraints, not by the\n   * index list, and dropping them here would break the constraint.\n   */\n  includeDroppedIndexes?: boolean;\n  /** Ignore type mismatches (just log warnings) */\n  ignoreTypeMismatches?: boolean;\n  /**\n   * Explicit engine hint forwarded to `detectEngine` when picking the DDL\n   * strategy used for *existing-table* SQL (ALTER/CREATE INDEX/etc.). Use\n   * this when `db.url` is empty or ambiguous (e.g. JSON adapter, in-memory\n   * wrappers where the URL lives on `db.config?.url`). Without it the\n   * comparer falls back to URL-only detection, which can produce SQLite-\n   * flavored SQL on a connection whose caller meant Postgres or DuckDB.\n   */\n  engineHint?: string;\n}\n\n/**\n * Suffix patterns for indexes that the differ refuses to drop.\n * - `_pkey`: PostgreSQL primary key implicit index.\n * - `_key`: PostgreSQL implicit index for inline `UNIQUE (...)` table\n *   constraints. Dropping these by name does not drop the underlying\n *   constraint, and dropping the constraint requires a separate DDL path\n *   (`ALTER TABLE ... DROP CONSTRAINT`) the differ does not emit today.\n */\nconst PROTECTED_INDEX_SUFFIXES = ['_pkey', '_key'];\n\nfunction isProtectedDbIndexName(name: string): boolean {\n  return PROTECTED_INDEX_SUFFIXES.some((suffix) => name.endsWith(suffix));\n}\n\nfunction resolveDatabaseUrl(db: DatabaseInterface): string {\n  const dbWithConfig = db as DatabaseInterface & {\n    config?: { url?: string };\n  };\n  return db.url || dbWithConfig.config?.url || '';\n}\n\n/**\n * Normalize a partial-index `WHERE` predicate so semantically-identical\n * clauses from different sources compare equal (issue #1692).\n *\n * The manifest stores predicates roughly as written (`_meta_type = 'Article'`),\n * SQLite/DuckDB echo the original CREATE INDEX text verbatim, and PostgreSQL\n * re-renders them with type casts and extra parentheses\n * (`((_meta_type)::text = 'Article'::text)`). Normalization:\n *\n * - strips a leading `WHERE` keyword,\n * - removes PostgreSQL `::type` casts (single-word type names — the only kind\n *   SMRT-generated partial predicates produce, e.g. `_meta_type::text`),\n * - removes parentheses (SMRT only emits simple `col = 'literal'` predicates,\n *   so grouping carries no meaning here),\n * - lowercases everything OUTSIDE single-quoted string literals (SQL keywords\n *   and identifiers are case-insensitive; literals such as STI discriminator\n *   class names are case-sensitive, so they are preserved verbatim),\n * - collapses whitespace and tightens spacing around comparison operators.\n *\n * Returns '' for an absent/empty predicate (i.e. a non-partial index).\n */\nexport function normalizeIndexPredicate(where?: string | null): string {\n  if (!where) return '';\n  const stripped = where.trim().replace(/^WHERE\\s+/i, '');\n  if (!stripped) return '';\n\n  let out = '';\n  let i = 0;\n  while (i < stripped.length) {\n    if (stripped[i] === \"'\") {\n      // Consume a single-quoted string literal verbatim, honoring the SQL\n      // `''` escape for an embedded quote.\n      let literal = \"'\";\n      i++;\n      while (i < stripped.length) {\n        if (stripped[i] === \"'\") {\n          if (stripped[i + 1] === \"'\") {\n            literal += \"''\";\n            i += 2;\n            continue;\n          }\n          literal += \"'\";\n          i++;\n          break;\n        }\n        literal += stripped[i];\n        i++;\n      }\n      out += literal;\n    } else {\n      let run = '';\n      while (i < stripped.length && stripped[i] !== \"'\") {\n        run += stripped[i];\n        i++;\n      }\n      out += normalizeNonLiteralPredicateRun(run);\n    }\n  }\n  return out;\n}\n\n/**\n * Normalize the non-literal portion of a predicate (everything outside a\n * single-quoted string literal). Type casts and parentheses are dropped,\n * keywords/identifiers are lowercased, and whitespace is canonicalized.\n */\nfunction normalizeNonLiteralPredicateRun(run: string): string {\n  return run\n    .replace(/::[A-Za-z_]\\w*/g, '') // drop single-word PostgreSQL type casts\n    .replace(/[()]/g, '') // drop parentheses\n    .toLowerCase()\n    .replace(/\\s+/g, ' ')\n    .replace(/\\s*([=<>!]+)\\s*/g, '$1') // tighten comparison operators\n    .trim();\n}\n\n/**\n * Extract the normalized partial-index predicate from a `CREATE INDEX`\n * statement — the `WHERE` tail that follows the column-list close paren.\n * Works for both SQLite/DuckDB `sqlite_master.sql` text and PostgreSQL\n * `pg_indexes.indexdef`. Returns '' for a non-partial index.\n */\nexport function extractIndexPredicate(createIndexSql: string): string {\n  // The predicate is the tail after the column-list ')': `... (cols) WHERE x`.\n  // Anchoring on `) WHERE` (rather than a bare `WHERE`) avoids matching a\n  // column literally named \"where\" inside the indexed column list.\n  const match = createIndexSql.match(/\\)\\s*WHERE\\s+([\\s\\S]+?)\\s*;?\\s*$/i);\n  if (!match) return '';\n  return normalizeIndexPredicate(match[1]);\n}\n\n/**\n * SchemaComparer class for comparing manifest schemas to database\n */\nexport class SchemaComparer {\n  private db: DatabaseInterface;\n  private options: DiffOptions;\n  private engine: DatabaseEngine;\n  private ddlStrategy: ReturnType<typeof getDDLStrategy>;\n\n  constructor(db: DatabaseInterface, options: DiffOptions = {}) {\n    this.db = db;\n    this.options = {\n      includeDroppedTables: false,\n      includeDroppedColumns: false,\n      includeDroppedIndexes: false,\n      ignoreTypeMismatches: false,\n      ...options,\n    };\n    // Use the shared detectEngine utility for consistent detection.\n    // Handles :memory:, .json, and other edge cases. The JSON adapter is\n    // detected structurally (it exposes `exportTable`) because its url can be\n    // empty; otherwise fall back to URL-based detection, where `engineHint`\n    // lets callers override when `db.url` is empty or points at an adapter\n    // whose engine isn't obvious from the URL alone (some in-memory wrappers).\n    this.engine =\n      typeof (this.db as { exportTable?: unknown }).exportTable === 'function'\n        ? 'json'\n        : detectEngine(resolveDatabaseUrl(this.db), this.options.engineHint);\n    this.ddlStrategy = getDDLStrategy(this.engine);\n  }\n\n  /**\n   * Compare manifest schemas to database and return differences\n   */\n  async compare(\n    manifestSchemas: Record<string, SchemaDefinition>,\n  ): Promise<SchemaDiff> {\n    const diff: SchemaDiff = {\n      added_tables: [],\n      dropped_tables: [],\n      changes: [],\n      has_changes: false,\n    };\n\n    // Get list of existing tables\n    const existingTables = await this.getExistingTables();\n\n    // Check each manifest schema against database\n    for (const [tableName, schema] of Object.entries(manifestSchemas)) {\n      if (!existingTables.has(tableName)) {\n        // Table doesn't exist - add to added_tables\n        diff.added_tables.push(schema);\n        diff.has_changes = true;\n      } else {\n        // Table exists - compare columns and indexes\n        const tableChanges = await this.compareTable(tableName, schema);\n        if (tableChanges.length > 0) {\n          diff.changes.push(...tableChanges);\n          diff.has_changes = true;\n        }\n      }\n    }\n\n    // Check for dropped tables (if enabled)\n    if (this.options.includeDroppedTables) {\n      for (const tableName of existingTables) {\n        // Skip system tables\n        if (tableName.startsWith('_smrt_') || tableName.startsWith('sqlite_')) {\n          continue;\n        }\n        if (!manifestSchemas[tableName]) {\n          diff.dropped_tables.push(tableName);\n          diff.has_changes = true;\n        }\n      }\n    }\n\n    return diff;\n  }\n\n  /**\n   * Compare a single table's schema to manifest\n   */\n  async compareTable(\n    tableName: string,\n    manifest: SchemaDefinition,\n  ): Promise<SchemaChange[]> {\n    const changes: SchemaChange[] = [];\n\n    // Get current table schema from database\n    const dbSchema = await this.db.getTableSchema?.(tableName);\n    if (!dbSchema) {\n      // Table doesn't exist - this is an add_table case\n      return changes;\n    }\n\n    // Compare columns\n    const columnChanges = this.compareColumns(tableName, manifest, dbSchema);\n    changes.push(...columnChanges);\n\n    // Partial-index predicates are not surfaced by `getTableSchema()` (the\n    // @happyvertical/sql introspection returns only name/columns/unique), so\n    // introspect them separately. Without this, two indexes on the same\n    // column(s) that differ only by their WHERE clause — e.g. distinct STI\n    // child partial indexes — would compare equal and the differ would miss\n    // adds/drops/changes of the predicate (issue #1692).\n    const dbIndexPredicates = await this.getDbIndexPredicates(tableName);\n\n    // Compare indexes\n    const indexChanges = this.compareIndexes(\n      tableName,\n      manifest,\n      dbSchema,\n      dbIndexPredicates,\n    );\n    changes.push(...indexChanges);\n\n    return changes;\n  }\n\n  /**\n   * Compare columns between manifest and database\n   */\n  private compareColumns(\n    tableName: string,\n    manifest: SchemaDefinition,\n    dbSchema: SqlTableSchemaInfo,\n  ): SchemaChange[] {\n    const changes: SchemaChange[] = [];\n    const dbColumnNames = new Set(Object.keys(dbSchema.columns));\n\n    // Check for new and modified columns\n    for (const [colName, colDef] of Object.entries(manifest.columns)) {\n      if (!dbColumnNames.has(colName)) {\n        // Column doesn't exist - add it\n        changes.push({\n          type: 'add_column',\n          table: tableName,\n          name: colName,\n          column: colDef,\n          sql: this.generateAddColumnSQL(tableName, colName, colDef),\n        });\n      } else {\n        // Column exists - check for type mismatch\n        const dbCol = dbSchema.columns[colName];\n\n        // Map manifest's abstract type to engine-specific type\n        // e.g., JSON → TEXT for SQLite, JSON → JSONB for PostgreSQL\n        // Validate the manifest type before mapping\n        const manifestType = colDef.type;\n        if (!isValidSQLDataType(manifestType)) {\n          // Invalid manifest type - treat as TEXT (safest fallback)\n          logger.warn(\n            `[SchemaComparer] Invalid manifest type \"${manifestType}\" for ${tableName}.${colName}, treating as TEXT`,\n          );\n        }\n        const validatedType: SQLDataType = isValidSQLDataType(manifestType)\n          ? manifestType\n          : 'TEXT';\n        const expectedEngineType = this.ddlStrategy.mapType(validatedType);\n        const normalizedExpected = this.normalizeType(expectedEngineType);\n        const normalizedActual = this.normalizeType(dbCol.type);\n\n        // R11: native `uuid` and `text` are interchangeable for SMRT-owned\n        // identifiers/references, but not for arbitrary provenance text. Keep\n        // the tolerance directional:\n        //   - manifest UUID + DB text is tolerated for structural ID/ref\n        //     columns so old deployments are not forced into native UUID.\n        //   - manifest TEXT + DB uuid is tolerated only for structural ID/ref\n        //     columns that are intentionally UUID-compatible.\n        // Plain TEXT columns with DB uuid now surface as repairable drift.\n        const isUuidTextEquivalent = this.isUuidTextEquivalentColumn(\n          colName,\n          colDef,\n          normalizedExpected,\n          normalizedActual,\n        );\n\n        // #1335: native `json`/`jsonb` (DB) and `text` (manifest) are\n        // interchangeable for SMRT — the convention is to serialize JSON values\n        // into TEXT columns, and a native-json column already holds exactly that\n        // data. So the differ must NOT flag a json<->text difference in EITHER\n        // direction:\n        //   - manifest TEXT vs DB json   (native-json column, text-convention manifest)\n        //   - manifest JSON vs DB text   (the canary case: an enum/plain field\n        //     mis-inferred as JSON by a downstream scanner, sitting on a real\n        //     `text` column holding bare values like 'active')\n        // Generating an ALTER here is pure churn at best and data-destroying at\n        // worst: `status::jsonb` on a column holding 'active' raises\n        // \"invalid input syntax for type json\" and aborts the whole atomic\n        // migration. Like the uuid/text tolerance, this lives at the equality\n        // gate only (not in `normalizeType`) so `isCompatibleTypeUpgrade` still\n        // treats JSON and TEXT as distinct buckets for OTHER upgrade paths.\n        const isJsonTextEquivalent =\n          (normalizedExpected === 'JSON' && normalizedActual === 'TEXT') ||\n          (normalizedExpected === 'TEXT' && normalizedActual === 'JSON');\n\n        if (\n          normalizedExpected !== normalizedActual &&\n          !isUuidTextEquivalent &&\n          !isJsonTextEquivalent\n        ) {\n          // Check if this is a safe type upgrade that SMRT can handle\n          // Since SMRT owns the data lifecycle, we know the intent from the manifest\n          if (this.isCompatibleTypeUpgrade(colDef.type, dbCol.type)) {\n            // Generate type upgrade SQL\n            const generatedSQL = this.generateTypeUpgradeSQL(\n              tableName,\n              colName,\n              colDef,\n              dbCol.type,\n            );\n            changes.push({\n              type: 'type_upgrade',\n              table: tableName,\n              name: colName,\n              column: colDef,\n              mismatch: {\n                expected: colDef.type,\n                actual: dbCol.type,\n              },\n              sql: generatedSQL.sql,\n              ...(generatedSQL.statements\n                ? { sqlStatements: generatedSQL.statements }\n                : {}),\n            });\n          } else if (!this.options.ignoreTypeMismatches) {\n            changes.push({\n              type: 'type_mismatch',\n              table: tableName,\n              name: colName,\n              mismatch: {\n                expected: colDef.type,\n                actual: dbCol.type,\n              },\n            });\n          }\n        }\n      }\n    }\n\n    // Check for dropped columns (if enabled)\n    if (this.options.includeDroppedColumns) {\n      const manifestColumnNames = new Set(Object.keys(manifest.columns));\n      for (const colName of dbColumnNames) {\n        if (!manifestColumnNames.has(colName)) {\n          changes.push({\n            type: 'drop_column',\n            table: tableName,\n            name: colName,\n            sql: this.generateDropColumnSQL(tableName, colName),\n          });\n        }\n      }\n    }\n\n    return changes;\n  }\n\n  private isUuidTextEquivalentColumn(\n    columnName: string,\n    colDef: ColumnDefinition,\n    normalizedExpected: string,\n    normalizedActual: string,\n  ): boolean {\n    const expectedUuidActualText =\n      normalizedExpected === 'UUID' && normalizedActual === 'TEXT';\n    const expectedTextActualUuid =\n      normalizedExpected === 'TEXT' && normalizedActual === 'UUID';\n\n    if (!expectedUuidActualText && !expectedTextActualUuid) {\n      return false;\n    }\n\n    return this.isStructuralUuidCompatibleColumn(columnName, colDef);\n  }\n\n  private isStructuralUuidCompatibleColumn(\n    columnName: string,\n    colDef: ColumnDefinition,\n  ): boolean {\n    return (\n      colDef.primaryKey === true ||\n      Boolean(colDef.foreignKey) ||\n      colDef.referenceKind === 'id' ||\n      colDef.referenceKind === 'foreignKey' ||\n      colDef.referenceKind === 'crossPackageRef' ||\n      colDef.referenceKind === 'tenantId' ||\n      (columnName === 'id' && colDef.type === 'TEXT')\n    );\n  }\n\n  /**\n   * Compare indexes between manifest and database\n   *\n   * Four classes of drift the differ now detects:\n   *\n   * 1. **Missing index** — manifest has an index neither the DB has by name\n   *    nor any equivalent-by-signature. Emit `add_index`. (Issue #741: the\n   *    signature check protects against creating duplicates when STI child\n   *    classes register indexes with different name prefixes.)\n   *\n   * 2. **Same-name shape drift** — DB has an index with the manifest's name,\n   *    but its columns, uniqueness flag, or partial-index `WHERE` predicate\n   *    differ. This covers the uniqueness flip in issue #1165\n   *    (`tenants_slug_context_meta_type_idx` materialized non-unique while\n   *    the manifest declares it unique) and the predicate drift in issue\n   *    #1692 (a partial index whose `WHERE` clause was added, removed, or\n   *    altered). Emit `drop_index` + `add_index` so the next migrate cycle\n   *    recreates it with the correct shape.\n   *\n   * 3. **Orphan in DB** — DB has an index with no manifest counterpart by\n   *    name and no signature equivalent. Emit `drop_index` *only* when the\n   *    caller opts in via `includeDroppedIndexes`, and even then never for\n   *    PostgreSQL implicit indexes (`*_pkey`, `*_key`) — those are owned by\n   *    table-level constraints and need a separate `DROP CONSTRAINT` path\n   *    that the differ does not emit yet.\n   *\n   * 4. **Partial-index predicate drift / collision** — two indexes on the\n   *    same column(s) and uniqueness that differ only by their `WHERE`\n   *    predicate (e.g. distinct STI child partial indexes) are no longer\n   *    collapsed to one signature, so the signature-equivalence path (b)\n   *    won't claim one for the other.\n   *\n   * @param dbIndexPredicates - Normalized `WHERE` predicate per DB index\n   *   name from {@link getDbIndexPredicates}. `null` means predicate\n   *   introspection was unavailable for this engine/adapter, in which case\n   *   the comparison falls back to predicate-unaware signatures (the prior\n   *   behavior) so existing partial indexes are never flagged as false drift.\n   */\n  private compareIndexes(\n    tableName: string,\n    manifest: SchemaDefinition,\n    dbSchema: SqlTableSchemaInfo,\n    dbIndexPredicates: Map<string, string> | null = null,\n  ): SchemaChange[] {\n    const changes: SchemaChange[] = [];\n\n    // Only fold predicates into signatures when we actually read them back\n    // from the live DB. If introspection was unavailable both sides use the\n    // empty predicate, which reproduces the prior column+unique-only behavior\n    // and cannot manufacture false positives on existing partial indexes.\n    const predicateAware = dbIndexPredicates !== null;\n    const dbPredicateFor = (name: string): string =>\n      predicateAware ? (dbIndexPredicates?.get(name) ?? '') : '';\n    const manifestPredicateFor = (idx: IndexDefinition): string =>\n      predicateAware ? normalizeIndexPredicate(idx.where) : '';\n\n    // Index DB indexes by name and by signature for fast lookup.\n    // dbIndexSignatures groups *all* DB index names sharing a signature so\n    // duplicates under different names all get claimed by a single matching\n    // manifest entry — otherwise the orphan sweep would drop the un-claimed\n    // siblings even though they are functionally equivalent to the manifest.\n    const dbIndexesByName = new Map<\n      string,\n      { columns: string[]; unique: boolean }\n    >();\n    const dbIndexSignatures = new Map<string, Set<string>>();\n    for (const idx of dbSchema.indexes) {\n      const unique = idx.unique ?? false;\n      dbIndexesByName.set(idx.name, { columns: idx.columns, unique });\n      const signature = this.getIndexSignature(\n        idx.columns,\n        unique,\n        dbPredicateFor(idx.name),\n      );\n      let bucket = dbIndexSignatures.get(signature);\n      if (!bucket) {\n        bucket = new Set();\n        dbIndexSignatures.set(signature, bucket);\n      }\n      bucket.add(idx.name);\n    }\n\n    // Manifest signatures — used during the orphan sweep to skip DB indexes\n    // that match a manifest entry's signature even if no specific manifest\n    // entry \"claimed\" them by name.\n    const manifestSignatureSet = new Set<string>();\n    for (const idx of manifest.indexes) {\n      manifestSignatureSet.add(\n        this.getIndexSignature(idx, undefined, manifestPredicateFor(idx)),\n      );\n    }\n\n    // Track which DB indexes a manifest entry has claimed, so the orphan\n    // pass below doesn't re-flag indexes that match by signature alone.\n    const claimedDbIndexes = new Set<string>();\n\n    for (const idx of manifest.indexes) {\n      const manifestSignature = this.getIndexSignature(\n        idx,\n        undefined,\n        manifestPredicateFor(idx),\n      );\n\n      // (a) Same name in DB — verify shape matches.\n      const dbByName = dbIndexesByName.get(idx.name);\n      if (dbByName) {\n        claimedDbIndexes.add(idx.name);\n\n        // JSON-path indexes (`@meta({ indexed: true })`) cannot be reliably\n        // compared by DB introspection — SQLite expression indexes surface\n        // as `[null]` columns, so the signature would always mismatch and\n        // every diff run would emit drop+recreate. Trust the name match\n        // here; if the json path itself changes, the index name changes\n        // too (we encode the field name into it), so a name match is a\n        // stronger guarantee than the column list for this index family.\n        if (isJsonPathIndex(idx)) {\n          continue;\n        }\n\n        const dbSignature = this.getIndexSignature(\n          dbByName.columns,\n          dbByName.unique,\n          dbPredicateFor(idx.name),\n        );\n        if (dbSignature === manifestSignature) {\n          continue; // Same name, same shape — nothing to do.\n        }\n\n        // Same name, drifted shape. Most often this is a uniqueness flip\n        // (issue #1165: 3-column index materialized non-unique). Recreate.\n        //\n        // Rollback caveat: the auto-generated DOWN script for the\n        // `add_index` half drops the (newly correct) index, and the\n        // `drop_index` half has no DOWN. Rolling back a recreate leaves\n        // the table without the index entirely instead of restoring the\n        // wrong-shape original. Capturing the original shape would\n        // require richer DB introspection than the differ currently has,\n        // so this asymmetry is accepted — the failure mode after an\n        // un-rolled-back recreate is \"missing index\" rather than\n        // \"permanently broken UPSERT,\" which is recoverable.\n        changes.push({\n          type: 'drop_index',\n          table: tableName,\n          name: idx.name,\n          sql: this.generateDropIndexSQL(idx.name),\n        });\n        changes.push({\n          type: 'add_index',\n          table: tableName,\n          name: idx.name,\n          index: idx,\n          sql: this.generateAddIndexSQL(tableName, idx),\n        });\n        continue;\n      }\n\n      // (b) Different name in DB but functionally equivalent — keep as-is.\n      // Claim *every* DB name sharing this signature so duplicate-shape\n      // indexes (e.g., a stale `<name>_idx` plus the implicit `<name>_key`\n      // from the same constraint) all survive the orphan sweep.\n      const equivalentIndexNames = dbIndexSignatures.get(manifestSignature);\n      if (equivalentIndexNames && equivalentIndexNames.size > 0) {\n        for (const name of equivalentIndexNames) {\n          claimedDbIndexes.add(name);\n        }\n        continue;\n      }\n\n      // (c) Genuinely missing — add it.\n      changes.push({\n        type: 'add_index',\n        table: tableName,\n        name: idx.name,\n        index: idx,\n        sql: this.generateAddIndexSQL(tableName, idx),\n      });\n    }\n\n    // Orphan-index sweep (opt-in via includeDroppedIndexes).\n    if (this.options.includeDroppedIndexes) {\n      for (const idx of dbSchema.indexes) {\n        if (claimedDbIndexes.has(idx.name)) continue;\n        if (isProtectedDbIndexName(idx.name)) continue;\n\n        // Belt-and-suspenders: even if a DB index wasn't formally claimed\n        // by a manifest entry (e.g., shape-drift recreate consumed the\n        // claim slot), don't drop it if its signature still matches\n        // something the manifest declares. That would contradict the\n        // option doc (\"not functionally equivalent to anything in the\n        // manifest\") and risk dropping a still-needed index.\n        const idxSignature = this.getIndexSignature(\n          idx.columns,\n          idx.unique ?? false,\n          dbPredicateFor(idx.name),\n        );\n        if (manifestSignatureSet.has(idxSignature)) continue;\n\n        changes.push({\n          type: 'drop_index',\n          table: tableName,\n          name: idx.name,\n          sql: this.generateDropIndexSQL(idx.name),\n        });\n      }\n    }\n\n    return changes;\n  }\n\n  /**\n   * Generate a signature for an index based on its columns, uniqueness, and\n   * (normalized) partial-index predicate. Used for functional equivalence\n   * checking (Issue #741) and predicate-drift detection (Issue #1692).\n   *\n   * Note: Column order is preserved because it is semantically significant for\n   * composite indexes. An index on (a, b) is NOT equivalent to (b, a) - they\n   * have different query performance characteristics.\n   *\n   * The trailing predicate component distinguishes partial indexes that share\n   * columns and uniqueness but differ by their `WHERE` clause (e.g. distinct\n   * STI child partial indexes). Callers pass the already-normalized predicate\n   * so both the manifest (desired) and introspected (DB) sides compare equal\n   * for semantically-identical clauses. An empty string means \"no predicate\"\n   * (a non-partial index) and is also used on both sides when predicate\n   * introspection is unavailable, preserving the prior behavior.\n   *\n   * For JSON-path indexes (`@meta({ indexed: true })`) the signature is\n   * derived from the JSON path instead of an empty column list, so the\n   * differ can distinguish two jsonPath indexes against different paths.\n   *\n   * @param idxOrColumns - Either an IndexDefinition or a column array (legacy)\n   * @param uniqueArg - Unique flag (used when first arg is a column array)\n   * @param predicateArg - Normalized partial-index predicate (default '')\n   * @returns Signature string\n   */\n  private getIndexSignature(\n    idxOrColumns: IndexDefinition | string[],\n    uniqueArg?: boolean,\n    predicateArg = '',\n  ): string {\n    if (Array.isArray(idxOrColumns)) {\n      return `${idxOrColumns.join(',')}:${Boolean(uniqueArg)}:${predicateArg}`;\n    }\n    const idx = idxOrColumns;\n    if (isJsonPathIndex(idx) && idx.jsonPath) {\n      return `json:${idx.jsonPath.column}.${idx.jsonPath.path}:${Boolean(idx.unique)}:${predicateArg}`;\n    }\n    return `${(idx.columns ?? []).join(',')}:${Boolean(idx.unique)}:${predicateArg}`;\n  }\n\n  /**\n   * Whether the active engine supports partial indexes (`CREATE INDEX … WHERE`).\n   *\n   * SQLite and PostgreSQL do. DuckDB rejects them outright, and the JSON\n   * adapter is DuckDB-backed, so on those engines a \"partial\" index can only\n   * ever exist as a full index. Treating the predicate as significant there\n   * would (a) flag existing full indexes as false drift and (b) emit\n   * `CREATE INDEX … WHERE` DDL the engine rejects, breaking the migration.\n   * Gating on this keeps both the comparison and the generated DDL aligned\n   * with what the engine actually accepts (a partial index degrades to a\n   * full index), matching the pre-#1692 behavior on those engines.\n   */\n  private supportsPartialIndexes(): boolean {\n    return this.engine === 'sqlite' || this.engine === 'postgres';\n  }\n\n  /**\n   * Introspect partial-index predicates for a table, keyed by index name.\n   *\n   * `getTableSchema()` (the @happyvertical/sql introspection) returns only\n   * name/columns/unique, so the `WHERE` predicate is read directly here:\n   *\n   * - PostgreSQL: `pg_indexes.indexdef` carries the full CREATE INDEX text.\n   * - SQLite: the `sqlite_master.sql` column carries the original CREATE INDEX\n   *   text.\n   *\n   * Engines that don't support partial indexes (DuckDB / the DuckDB-backed\n   * JSON adapter) short-circuit to `null` so the comparison stays\n   * predicate-unaware there — see {@link supportsPartialIndexes}.\n   *\n   * Non-partial indexes are omitted from the map (callers treat a missing\n   * entry as the empty predicate). Returns `null` when the catalog query\n   * fails — e.g. an adapter exposing neither catalog — so the index\n   * comparison can fall back to predicate-unaware behavior rather than\n   * flagging every existing partial index as false drift.\n   */\n  private async getDbIndexPredicates(\n    tableName: string,\n  ): Promise<Map<string, string> | null> {\n    if (!this.supportsPartialIndexes()) {\n      return null;\n    }\n    const predicates = new Map<string, string>();\n    try {\n      if (this.engine === 'postgres') {\n        const result = await this.db.query(\n          `SELECT indexname, indexdef FROM pg_indexes WHERE schemaname = 'public' AND tablename = ${this.quoteLiteral(\n            tableName,\n          )}`,\n        );\n        for (const row of result.rows as {\n          indexname?: string;\n          indexdef?: string;\n        }[]) {\n          if (!row.indexname || !row.indexdef) continue;\n          const predicate = extractIndexPredicate(row.indexdef);\n          if (predicate) predicates.set(row.indexname, predicate);\n        }\n        return predicates;\n      }\n\n      // SQLite exposes the `sqlite_master` catalog whose `sql` column preserves\n      // the original CREATE INDEX text. Implicit indexes carry a NULL `sql` and\n      // are skipped. (DuckDB / JSON already short-circuited above.)\n      const result = await this.db.query(\n        `SELECT name, sql FROM sqlite_master WHERE type = 'index' AND tbl_name = ${this.quoteLiteral(\n          tableName,\n        )} AND name NOT LIKE 'sqlite_%'`,\n      );\n      for (const row of result.rows as {\n        name?: string;\n        sql?: string | null;\n      }[]) {\n        if (!row.name || !row.sql) continue;\n        const predicate = extractIndexPredicate(row.sql);\n        if (predicate) predicates.set(row.name, predicate);\n      }\n      return predicates;\n    } catch (err) {\n      logger.debug(\n        `[SchemaComparer] Partial-index predicate introspection unavailable for ${tableName}; falling back to predicate-unaware index comparison`,\n        { error: err instanceof Error ? err.message : String(err) },\n      );\n      return null;\n    }\n  }\n\n  /**\n   * Get list of existing tables from database\n   */\n  private async getExistingTables(): Promise<Set<string>> {\n    let query: string;\n    if (this.engine === 'postgres') {\n      query = `SELECT table_name FROM information_schema.tables WHERE table_schema = 'public'`;\n    } else {\n      // SQLite and DuckDB both expose the SQLite-compatible `sqlite_master`\n      // catalog — DuckDB ships it as a built-in compatibility view, so a single\n      // introspection query covers both engines. Verified against a live DuckDB\n      // v1.4.3 (json mode): `SELECT name FROM sqlite_master WHERE type='table'`\n      // returns user tables with the expected `name` column (#1579).\n      query = `SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'`;\n    }\n\n    const result = await this.db.query(query);\n    const rows = result.rows as { name?: string; table_name?: string }[];\n    return new Set(\n      rows.map((r) => r.name || r.table_name || '').filter(Boolean),\n    );\n  }\n\n  /**\n   * Normalize SQL types for comparison\n   */\n  private normalizeType(type: string): string {\n    const upper = type.toUpperCase().trim();\n\n    // Integer types\n    if (/^(INTEGER|INT|BIGINT|SMALLINT|TINYINT)$/i.test(upper)) {\n      return 'INTEGER';\n    }\n\n    // Text types\n    if (/^(TEXT|CLOB|STRING|VARCHAR|CHAR)/i.test(upper)) {\n      return 'TEXT';\n    }\n\n    // UUID normalizes to its own bucket — deliberately NOT folded into TEXT.\n    // The text<->uuid drift tolerance (R11) is applied at the equality gate\n    // in `compare()` only, so that `isCompatibleTypeUpgrade` (which also\n    // calls normalizeType) still treats `uuid` as distinct from text and\n    // won't mis-classify e.g. `uuid`->`timestamp` as a compatible\n    // \"TEXT->TIMESTAMP\" upgrade.\n    if (/^UUID$/i.test(upper)) {\n      return 'UUID';\n    }\n\n    // Decimal types\n    if (/^(REAL|FLOAT|DOUBLE|DECIMAL|NUMERIC|NUMBER)/i.test(upper)) {\n      return 'REAL';\n    }\n\n    // Boolean types\n    if (/^(BOOLEAN|BOOL)/i.test(upper)) {\n      return 'BOOLEAN';\n    }\n\n    // Date/time types\n    if (/^(DATETIME|TIMESTAMP|DATE|TIME)/i.test(upper)) {\n      return 'TIMESTAMP';\n    }\n\n    // Blob types\n    if (/^(BLOB|BINARY|BYTEA)/i.test(upper)) {\n      return 'BLOB';\n    }\n\n    // JSON types\n    if (/^(JSON|JSONB)/i.test(upper)) {\n      return 'JSON';\n    }\n\n    return upper;\n  }\n\n  /**\n   * Check if a type change is a safe upgrade that can be auto-migrated.\n   *\n   * SMRT controls the data lifecycle for these columns, so we know:\n   * - TEXT→JSON: The column stores JSON data serialized as text (arrays, objects)\n   * - TEXT/JSON→TIMESTAMP: Legacy system columns stored timestamp strings\n   *   before newer manifests normalized the column type.\n   * - INTEGER→REAL: Safe widening of integer to floating point\n   * - TEXT/REAL→INTEGER on PostgreSQL: explicit data-checked repairs for\n   *   legacy integer columns that were previously stored as text/real.\n   *\n   * @param manifestType - The abstract type from the manifest (e.g., 'JSON')\n   * @param dbType - The actual type in the database (e.g., 'TEXT')\n   * @returns true if the change from dbType to manifestType is a safe upgrade\n   */\n  private isCompatibleTypeUpgrade(\n    manifestType: string,\n    dbType: string,\n  ): boolean {\n    const manifest = this.normalizeType(manifestType);\n    const db = this.normalizeType(dbType);\n\n    // TEXT → JSON is safe: SMRT serializes arrays/objects as JSON text\n    // When the manifest says JSON, the data is already valid JSON in TEXT column\n    if (manifest === 'JSON' && db === 'TEXT') {\n      return true;\n    }\n\n    // JSON → TEXT is also safe (downgrade, but data is preserved as-is)\n    if (manifest === 'TEXT' && db === 'JSON') {\n      return true;\n    }\n\n    // UUID → TEXT is safe for plain text/provenance fields that were\n    // mistakenly materialized as native uuid: the stored UUID value can be\n    // rendered losslessly as text.\n    if (manifest === 'TEXT' && db === 'UUID') {\n      return true;\n    }\n\n    // INTEGER → REAL is safe (widening)\n    if (manifest === 'REAL' && db === 'INTEGER') {\n      return true;\n    }\n\n    // PostgreSQL can safely repair legacy integer columns when the generated\n    // migration validates that every existing value is already an integer.\n    if (\n      this.engine === 'postgres' &&\n      manifest === 'INTEGER' &&\n      (db === 'TEXT' || db === 'REAL')\n    ) {\n      return true;\n    }\n\n    // TEXT/JSON → TIMESTAMP is a legacy-drift repair. Invalid values fail\n    // explicitly during migration rather than being silently coerced.\n    if (manifest === 'TIMESTAMP' && (db === 'TEXT' || db === 'JSON')) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Generate SQL for a type upgrade migration.\n   *\n   * Engine-specific SQL:\n   * - SQLite: TEXT and JSON are equivalent, no-op or comment\n   * - DuckDB: ALTER COLUMN TYPE (native type conversion)\n   * - PostgreSQL: ALTER COLUMN TYPE with USING clause\n   */\n  private generateTypeUpgradeSQL(\n    tableName: string,\n    colName: string,\n    colDef: ColumnDefinition,\n    dbType: string,\n  ): GeneratedTypeUpgradeSQL {\n    const quotedTable = this.quoteIdentifier(tableName);\n    const quotedCol = this.quoteIdentifier(colName);\n    const manifestType = colDef.type;\n\n    // Validate manifestType before mapping\n    const validatedType: SQLDataType = isValidSQLDataType(manifestType)\n      ? manifestType\n      : 'TEXT';\n    const targetType = this.ddlStrategy.mapType(validatedType);\n\n    switch (this.engine) {\n      case 'sqlite':\n        // SQLite has dynamic typing - TEXT and JSON are functionally equivalent\n        // For SQLite, we just return a comment since no actual change is needed\n        if (\n          this.normalizeType(manifestType) === 'JSON' &&\n          this.normalizeType(dbType) === 'TEXT'\n        ) {\n          return {\n            sql: `-- SQLite: ${quotedCol} already stores JSON as TEXT (no change needed)`,\n          };\n        }\n        // For other type upgrades, SQLite requires recreating the table\n        return {\n          sql: `-- SQLite: Type upgrade for ${quotedCol} requires table recreation`,\n        };\n\n      case 'postgres': {\n        // PostgreSQL defaults must be dropped/reset around some type changes\n        // so drift repairs can succeed even when an existing default cannot\n        // be cast automatically to the target type.\n        const manifestNormalized = this.normalizeType(manifestType);\n        const dbNormalized = this.normalizeType(dbType);\n        const preflightSQL =\n          manifestNormalized === 'INTEGER' &&\n          (dbNormalized === 'TEXT' || dbNormalized === 'REAL')\n            ? this.generatePostgresIntegerPreflightSQL(\n                quotedTable,\n                quotedCol,\n                tableName,\n                colName,\n                dbNormalized,\n              )\n            : null;\n        const clauses: string[] = [];\n\n        if (colDef.defaultValue !== undefined) {\n          clauses.push(`ALTER COLUMN ${quotedCol} DROP DEFAULT`);\n        }\n\n        let typeClause = `ALTER COLUMN ${quotedCol} TYPE ${targetType}`;\n        if (manifestNormalized === 'JSON' && dbNormalized === 'TEXT') {\n          // #1335: a bare `${col}::jsonb` cast raises \"invalid input syntax for\n          // type json\" on any row whose text is not already valid JSON (e.g. a\n          // legacy enum column holding 'active'). `to_jsonb(col)` instead wraps\n          // ANY text value as a JSON string and never errors, so a genuine\n          // TEXT->JSON widening survives non-JSON legacy data. (Note: with the\n          // json<->text equality tolerance added in this fix, the normal\n          // compare path no longer reaches here; this keeps the SQL safe for\n          // callers that construct a type_upgrade directly.)\n          typeClause += ` USING to_jsonb(${quotedCol})`;\n        } else if (manifestNormalized === 'TEXT' && dbNormalized === 'JSON') {\n          // #1335: a native-json column cast back to text is value-preserving\n          // (`::text` renders the stored JSON as its text form), so this arm is\n          // safe. (Note: like the TEXT->JSON arm above, the json<->text equality\n          // tolerance means the normal compare path no longer reaches here; this\n          // keeps the SQL safe for callers that construct a type_upgrade\n          // directly.)\n          typeClause += ` USING ${quotedCol}::text`;\n        } else if (manifestNormalized === 'TEXT' && dbNormalized === 'UUID') {\n          typeClause += ` USING ${quotedCol}::text`;\n        } else if (\n          manifestNormalized === 'INTEGER' &&\n          dbNormalized === 'TEXT'\n        ) {\n          typeClause += ` USING trim(${quotedCol}::text)::integer`;\n        } else if (\n          manifestNormalized === 'INTEGER' &&\n          dbNormalized === 'REAL'\n        ) {\n          typeClause += ` USING ${quotedCol}::integer`;\n        } else if (\n          manifestNormalized === 'TIMESTAMP' &&\n          (dbNormalized === 'TEXT' || dbNormalized === 'JSON')\n        ) {\n          typeClause += ` USING NULLIF(NULLIF(trim(both '\"' from ${quotedCol}::text), ''), 'null')::timestamp`;\n        }\n\n        clauses.push(typeClause);\n\n        if (colDef.defaultValue !== undefined) {\n          const formattedDefault = this.ddlStrategy.formatDefaultValue(\n            colDef.defaultValue,\n            validatedType,\n          );\n          const defaultSql =\n            manifestNormalized === 'JSON'\n              ? `${formattedDefault}::${targetType.toLowerCase()}`\n              : formattedDefault;\n          clauses.push(`ALTER COLUMN ${quotedCol} SET DEFAULT ${defaultSql}`);\n        }\n\n        const alterSql = `ALTER TABLE ${quotedTable} ${clauses.join(', ')}`;\n\n        return preflightSQL\n          ? { sql: alterSql, statements: [preflightSQL, alterSql] }\n          : { sql: alterSql };\n      }\n\n      case 'duckdb':\n        // DuckDB supports ALTER COLUMN TYPE for type conversions\n        return {\n          sql: `ALTER TABLE ${quotedTable} ALTER COLUMN ${quotedCol} TYPE ${targetType}`,\n        };\n\n      default: {\n        // Escape special characters in type names for safe comment generation\n        const safeDbType = dbType.replace(/[^\\w]/g, '_');\n        const safeManifestType = manifestType.replace(/[^\\w]/g, '_');\n        return {\n          sql: `-- Type upgrade for ${quotedCol}: ${safeDbType} → ${safeManifestType}`,\n        };\n      }\n    }\n  }\n\n  /**\n   * Quote a SQL identifier\n   */\n  private quoteIdentifier(name: string): string {\n    return `\"${name.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  /**\n   * Generate a PostgreSQL preflight guard for narrowing legacy columns to\n   * INTEGER. PostgreSQL's REAL→INTEGER cast rounds fractional values, so the\n   * generated migration must fail before the ALTER can silently change data.\n   */\n  private generatePostgresIntegerPreflightSQL(\n    quotedTable: string,\n    quotedCol: string,\n    tableName: string,\n    colName: string,\n    dbNormalized: string,\n  ): string {\n    const invalidCondition =\n      dbNormalized === 'REAL'\n        ? `${quotedCol} IS NOT NULL AND ${quotedCol} <> trunc(${quotedCol})`\n        : `${quotedCol} IS NOT NULL AND trim(${quotedCol}::text) !~ '^[+-]?[0-9]+$'`;\n    const message = `Cannot convert ${tableName}.${colName} to INTEGER: found non-integer values`;\n\n    return `DO $$ BEGIN IF EXISTS (SELECT 1 FROM ${quotedTable} WHERE ${invalidCondition}) THEN RAISE EXCEPTION ${this.quoteLiteral(message)}; END IF; END $$`;\n  }\n\n  private quoteLiteral(value: string): string {\n    return `'${value.replace(/'/g, \"''\")}'`;\n  }\n\n  /**\n   * Generate SQL for adding a column\n   */\n  private generateAddColumnSQL(\n    tableName: string,\n    colName: string,\n    colDef: ColumnDefinition,\n  ): string {\n    // Build the ADD COLUMN definition inline (main) rather than delegating to\n    // the DDL strategy's generateColumnDefinition: that builder is for CREATE\n    // TABLE and would emit `PRIMARY KEY` (invalid in ALTER ... ADD COLUMN) and\n    // suppress single-column UNIQUE on engines that require inline unique at\n    // table-create time (DuckDB) — but an ADD COLUMN has no inline-constraint\n    // pass, so the UNIQUE must be emitted here. mapType still maps abstract\n    // types per dialect (UUID→native uuid / TEXT — R11); invalid types fall\n    // back to TEXT, matching the compareColumns guard.\n    const validatedType: SQLDataType = isValidSQLDataType(colDef.type)\n      ? colDef.type\n      : 'TEXT';\n    if (!isValidSQLDataType(colDef.type)) {\n      logger.warn(\n        `[SchemaComparer] Invalid manifest type \"${colDef.type}\" for ${tableName}.${colName}, treating as TEXT`,\n      );\n    }\n\n    const parts: string[] = [\n      this.quoteIdentifier(colName),\n      this.ddlStrategy.mapType(validatedType),\n    ];\n\n    if (colDef.notNull) {\n      parts.push('NOT NULL');\n    }\n    if (colDef.unique) {\n      parts.push('UNIQUE');\n    }\n    if (colDef.defaultValue !== undefined) {\n      const defaultVal = this.ddlStrategy.formatDefaultValue(\n        colDef.defaultValue,\n        validatedType,\n      );\n      parts.push(`DEFAULT ${defaultVal}`);\n    }\n    if (colDef.check) {\n      parts.push(`CHECK (${colDef.check})`);\n    }\n\n    const columnDefinition = parts.join(' ');\n\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD COLUMN ${columnDefinition}`;\n  }\n\n  /**\n   * Generate SQL for dropping a column\n   */\n  private generateDropColumnSQL(tableName: string, colName: string): string {\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} DROP COLUMN ${this.quoteIdentifier(colName)}`;\n  }\n\n  /**\n   * Generate SQL for adding an index.\n   *\n   * On engines that support partial indexes (SQLite/PostgreSQL) this mirrors\n   * the canonical CREATE INDEX path in the DDL strategies: a partial index\n   * appends its `WHERE` predicate so a detected predicate add/alter (issue\n   * #1692) recreates the index with the correct partial condition rather than\n   * silently widening it to a full index. On DuckDB / the JSON adapter — which\n   * reject partial indexes — the predicate is dropped so the emitted DDL stays\n   * executable (a partial index degrades to a full index there). The predicate\n   * is trimmed and a redundant leading `WHERE` stripped for robustness.\n   */\n  private generateAddIndexSQL(tableName: string, idx: IndexDefinition): string {\n    const uniqueStr = idx.unique ? 'UNIQUE ' : '';\n    const target = renderIndexTarget(idx, this.engine);\n    let sql = `CREATE ${uniqueStr}INDEX ${this.quoteIdentifier(idx.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;\n    const where = idx.where?.trim().replace(/^WHERE\\s+/i, '');\n    if (this.supportsPartialIndexes() && where) {\n      sql += ` WHERE ${where}`;\n    }\n    return sql;\n  }\n\n  /**\n   * Generate SQL for dropping an index.\n   *\n   * This SQL is consumed by the manifest-driven execution path:\n   *\n   * - `db:migrate` runs the SQL we put in `change.sql` directly, with the\n   *   tracker's `executePostgresStatements` adding CONCURRENTLY when\n   *   `--postgres-safe` is on.\n   *\n   * PostgreSQL ends up with `CONCURRENTLY` when it should.\n   * Keeping this method engine-agnostic also means the diff preview text\n   * stays readable (no engine-specific noise) for engines like SQLite\n   * where CONCURRENTLY isn't a thing.\n   */\n  private generateDropIndexSQL(indexName: string): string {\n    return `DROP INDEX IF EXISTS ${this.quoteIdentifier(indexName)}`;\n  }\n}\n\n/**\n * Generate a SchemaDiff from manifest and database\n */\nexport async function generateSchemaDiff(\n  db: DatabaseInterface,\n  manifestSchemas: Record<string, SchemaDefinition>,\n  options: DiffOptions = {},\n): Promise<SchemaDiff> {\n  const comparer = new SchemaComparer(db, options);\n  return comparer.compare(manifestSchemas);\n}\n\n/**\n * Check if a diff has any actionable changes (excluding type mismatches)\n */\nexport function hasActionableChanges(diff: SchemaDiff): boolean {\n  if (diff.added_tables.length > 0) return true;\n  if (diff.dropped_tables.length > 0) return true;\n  return diff.changes.some((c) => c.type !== 'type_mismatch');\n}\n\n/**\n * Get SQL statements from a diff for execution\n */\nexport function getSQLFromDiff(diff: SchemaDiff): string[] {\n  const statements: string[] = [];\n\n  // Add table creation (requires full DDL generation - not included here)\n  // This is typically handled by ensureSchema()\n\n  // Add column and index changes\n  for (const change of diff.changes) {\n    if (change.type !== 'type_mismatch') {\n      statements.push(\n        ...(change.sqlStatements ?? (change.sql ? [change.sql] : [])),\n      );\n    }\n  }\n\n  return statements;\n}\n"],"names":["result"],"mappings":"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"}

package/dist/node_modules/.pnpm/{minimatch@10.2.3 → minimatch@10.2.5}/node_modules/minimatch/dist/esm/assert-valid-pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert-valid-pattern.js","sources":["../../../../../../../../../../node_modules/.pnpm/minimatch@10.2.3/node_modules/minimatch/dist/esm/assert-valid-pattern.js"],"sourcesContent":["const MAX_PATTERN_LENGTH = 1024 * 64;\nexport const assertValidPattern = (pattern) => {\n    if (typeof pattern !== 'string') {\n        throw new TypeError('invalid pattern');\n    }\n    if (pattern.length > MAX_PATTERN_LENGTH) {\n        throw new TypeError('pattern is too long');\n    }\n};\n//# sourceMappingURL=assert-valid-pattern.js.map"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,OAAO;AACtB,MAAC,qBAAqB,CAAC,YAAY;AAC3C,MAAI,OAAO,YAAY,UAAU;AAC7B,UAAM,IAAI,UAAU,iBAAiB;AAAA,EACzC;AACA,MAAI,QAAQ,SAAS,oBAAoB;AACrC,UAAM,IAAI,UAAU,qBAAqB;AAAA,EAC7C;AACJ;","x_google_ignoreList":[0]}
+{"version":3,"file":"assert-valid-pattern.js","sources":["../../../../../../../../../../node_modules/.pnpm/minimatch@10.2.5/node_modules/minimatch/dist/esm/assert-valid-pattern.js"],"sourcesContent":["const MAX_PATTERN_LENGTH = 1024 * 64;\nexport const assertValidPattern = (pattern) => {\n    if (typeof pattern !== 'string') {\n        throw new TypeError('invalid pattern');\n    }\n    if (pattern.length > MAX_PATTERN_LENGTH) {\n        throw new TypeError('pattern is too long');\n    }\n};\n//# sourceMappingURL=assert-valid-pattern.js.map"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,OAAO;AACtB,MAAC,qBAAqB,CAAC,YAAY;AAC3C,MAAI,OAAO,YAAY,UAAU;AAC7B,UAAM,IAAI,UAAU,iBAAiB;AAAA,EACzC;AACA,MAAI,QAAQ,SAAS,oBAAoB;AACrC,UAAM,IAAI,UAAU,qBAAqB;AAAA,EAC7C;AACJ;","x_google_ignoreList":[0]}