@memberjunction/metadata-sync 2.129.0 → 2.130.1

package/README.md

@@ -779,7 +779,37 @@ MetadataSync preserves the original order of keys in your JSON files. When you r
 
 ## Resolution Tracking with `__mj_sync_notes`
 
-When you use `@lookup` or `@parent` references in your metadata files, MetadataSync automatically tracks how these references were resolved during push operations. This information is written to a `__mj_sync_notes` key in each record, providing transparency into the resolution process.
+When you use `@lookup` or `@parent` references in your metadata files, MetadataSync can track how these references were resolved during push operations. This information is written to a `__mj_sync_notes` key in each record, providing transparency into the resolution process.
+
+**Note:** This feature is **disabled by default** to keep metadata files clean. Enable it when you need to debug lookup resolutions or understand how references are being resolved.
+
+### Enabling Resolution Tracking
+
+To enable `__mj_sync_notes`, add the `emitSyncNotes` setting to your `.mj-sync.json` configuration:
+
+**Root-level configuration** (applies to all entity directories):
+```json
+{
+  "version": "1.0",
+  "emitSyncNotes": true,
+  "directoryOrder": ["..."]
+}
+```
+
+**Entity-level override** (in an entity directory's `.mj-sync.json`):
+```json
+{
+  "entity": "AI Prompts",
+  "emitSyncNotes": true
+}
+```
+
+The inheritance works as follows:
+- Entity-level `emitSyncNotes` takes precedence if explicitly set
+- If not set at entity level, inherits from root `.mj-sync.json`
+- Defaults to `false` if not set anywhere
+
+This allows you to enable tracking globally and disable it for specific entities, or vice versa.
 
 ### Purpose
 
@@ -845,9 +875,9 @@ Each resolution note contains:
 ### System-Managed Key
 
 The `__mj_sync_notes` key uses a double underscore prefix (`__`) to clearly indicate it is system-managed:
-- **Do not manually edit** this section - it is regenerated on each push
-- **Do not delete** it - it will be recreated automatically
-- The key is automatically removed if a record has no `@lookup` or `@parent` references
+- **Do not manually edit** this section - it is regenerated on each push when `emitSyncNotes` is enabled
+- When `emitSyncNotes` is disabled (the default), existing `__mj_sync_notes` keys are automatically removed on push
+- When enabled, the key is automatically removed if a record has no `@lookup` or `@parent` references
 - Key ordering is preserved - `__mj_sync_notes` appears after `sync` in the file
 
 ### Example: Parent Reference Resolution

package/dist/config.d.ts

@@ -119,6 +119,12 @@ export interface SyncConfig {
         /** Whether to allow users without any roles (defaults to false) */
         allowUsersWithoutRoles?: boolean;
     };
+    /**
+     * Whether to emit __mj_sync_notes in record files during push operations.
+     * When enabled, resolution information for @lookup and @parent references is written to files.
+     * Defaults to false. Entity-level .mj-sync.json files can override this setting.
+     */
+    emitSyncNotes?: boolean;
 }
 /**
  * Configuration for related entity synchronization
@@ -249,6 +255,12 @@ export interface EntityConfig {
         /** Whether to ignore virtual fields during pull (defaults to false) */
         ignoreVirtualFields?: boolean;
     };
+    /**
+     * Whether to emit __mj_sync_notes in record files during push operations.
+     * When enabled, resolution information for @lookup and @parent references is written to files.
+     * If not specified, inherits from root .mj-sync.json. Defaults to false if not set anywhere.
+     */
+    emitSyncNotes?: boolean;
 }
 /**
  * Folder-level configuration

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;AAGH,gDAAwB;AACxB,wDAA0B;AAC1B,yDAAqD;AAkQrD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY;IAC1B,OAAO,8BAAa,CAAC,YAAY,EAAE,CAAC;AACtC,CAAC;AAFD,oCAEC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,wCAaC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAfD,4CAeC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,4CAaC","sourcesContent":["/**\n * @fileoverview Configuration types and loaders for MetadataSync\n * @module config\n * \n * This module defines configuration interfaces and provides utilities for loading\n * various configuration files used by the MetadataSync tool. It supports:\n * - MemberJunction database configuration (mj.config.cjs)\n * - Sync configuration (.mj-sync.json)\n * - Entity-specific configuration (.mj-sync.json with entity field)\n * - Folder-level defaults (.mj-folder.json)\n */\n\nimport { cosmiconfigSync } from 'cosmiconfig';\nimport path from 'path';\nimport fs from 'fs-extra';\nimport { configManager } from './lib/config-manager';\n\n/**\n * MemberJunction database configuration\n * \n * Defines connection parameters and settings for connecting to the MemberJunction\n * database. Typically loaded from mj.config.cjs in the project root.\n */\nexport interface MJConfig {\n  /** Database server hostname or IP address */\n  dbHost: string;\n  /** Database server port (defaults to 1433 for SQL Server) */\n  dbPort?: number;\n  /** Database name to connect to */\n  dbDatabase: string;\n  /** Database authentication username */\n  dbUsername: string;\n  /** Database authentication password */\n  dbPassword: string;\n  /** Whether to trust the server certificate (Y/N) */\n  dbTrustServerCertificate?: string;\n  /** Whether to encrypt the connection (Y/N, auto-detected for Azure SQL) */\n  dbEncrypt?: string;\n  /** SQL Server instance name (for named instances) */\n  dbInstanceName?: string;\n  /** Schema name for MemberJunction core tables (defaults to __mj) */\n  mjCoreSchema?: string;\n  /** Allow additional properties for extensibility */\n  [key: string]: any;\n}\n\n/**\n * Global sync configuration\n * \n * Defines settings that apply to the entire sync process, including push/pull\n * behaviors and watch mode configuration. Stored in .mj-sync.json at the root.\n */\nexport interface SyncConfig {\n  /** Version of the sync configuration format */\n  version: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** \n   * Directory processing order (only applies to root-level config, not inherited by subdirectories)\n   * Specifies the order in which subdirectories should be processed to handle dependencies.\n   * Directories not listed in this array will be processed after the ordered ones in alphabetical order.\n   */\n  directoryOrder?: string[];\n  /** \n   * Directories to ignore during processing\n   * Can be directory names or glob patterns relative to the location of the .mj-sync.json file\n   * Cumulative: subdirectories inherit and add to parent ignoreDirectories\n   * Examples: [\"output\", \"examples\", \"temp\"]\n   */\n  ignoreDirectories?: string[];\n  /** Push command configuration */\n  push?: {\n    /** Whether to validate records before pushing to database */\n    validateBeforePush?: boolean;\n    /** Whether to require user confirmation before push */\n    requireConfirmation?: boolean;\n    /** \n     * Whether to automatically create new records when a primaryKey exists but record is not found\n     * Defaults to false - will warn instead of creating\n     */\n    autoCreateMissingRecords?: boolean;\n    /** \n     * When true, forces all records to be saved to database regardless of dirty state.\n     * This bypasses dirty checking and always performs database updates.\n     * Useful for ensuring complete synchronization or when dirty detection may miss changes.\n     * Defaults to false.\n     */\n    alwaysPush?: boolean;\n  };\n  /** SQL logging configuration (only applies to root-level config, not inherited by subdirectories) */\n  sqlLogging?: {\n    /** Whether to enable SQL logging during push operations */\n    enabled?: boolean;\n    /** Directory to output SQL log files (relative to command execution directory, defaults to './sql_logging') */\n    outputDirectory?: string;\n    /** Whether to format SQL as migration-ready files with Flyway schema placeholders */\n    formatAsMigration?: boolean;\n    /**\n     * Array of patterns to filter SQL statements.\n     * Supports both regex strings and simple wildcard patterns:\n     * - Regex: \"/spCreate.*Run/i\" (must start with \"/\" and optionally end with flags)\n     * - Simple: \"*spCreateAIPromptRun*\" (uses * as wildcard, case-insensitive by default)\n     * Examples: [\"*AIPrompt*\", \"/^EXEC sp_/i\", \"*EntityFieldValue*\"]\n     */\n    filterPatterns?: string[];\n    /**\n     * Determines how filterPatterns are applied:\n     * - 'exclude': If ANY pattern matches, the SQL is NOT logged (default)\n     * - 'include': If ANY pattern matches, the SQL IS logged\n     */\n    filterType?: 'exclude' | 'include';\n  };\n  /** Watch command configuration */\n  watch?: {\n    /** Milliseconds to wait before processing file changes */\n    debounceMs?: number;\n    /** File patterns to ignore during watch */\n    ignorePatterns?: string[];\n  };\n  /** User role validation configuration */\n  userRoleValidation?: {\n    /** Whether to enable user role validation for UserID fields */\n    enabled?: boolean;\n    /** List of role names that are allowed to be referenced in metadata */\n    allowedRoles?: string[];\n    /** Whether to allow users without any roles (defaults to false) */\n    allowUsersWithoutRoles?: boolean;\n  };\n}\n\n/**\n * Configuration for related entity synchronization\n * \n * Defines how to pull and push related entities that have foreign key relationships\n * with a parent entity. Supports nested relationships for deep object graphs.\n * NEW: Supports automatic recursive patterns for self-referencing entities.\n */\nexport interface RelatedEntityConfig {\n  /** Name of the related entity to sync */\n  entity: string;\n  /** Field name that contains the foreign key reference to parent (e.g., \"PromptID\") */\n  foreignKey: string;\n  /** Optional SQL filter to apply when pulling related records */\n  filter?: string;\n  /** \n   * Enable recursive fetching for self-referencing entities\n   * When true, automatically fetches all levels of the hierarchy until no more children found\n   */\n  recursive?: boolean;\n  /** \n   * Maximum depth for recursive fetching (optional, defaults to 10)\n   * Prevents infinite loops and controls memory usage\n   * Only applies when recursive is true\n   */\n  maxDepth?: number;\n  /** Fields to externalize to separate files for this related entity */\n  externalizeFields?: string[] | {\n    [fieldName: string]: {\n      /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n      extension?: string;\n    }\n  } | Array<{\n    /** Field name to externalize */\n    field: string;\n    /** Pattern for the output file. Supports placeholders from the entity */\n    pattern: string;\n  }>;\n  /** Fields to exclude from the pulled data for this related entity */\n  excludeFields?: string[];\n  /** Foreign key fields to convert to @lookup references for this related entity */\n  lookupFields?: {\n    [fieldName: string]: {\n      entity: string;\n      field: string;\n    };\n  };\n  /** Nested related entities for deep object graphs */\n  relatedEntities?: Record<string, RelatedEntityConfig>;\n}\n\n/**\n * Entity-specific configuration\n * \n * Defines settings for a specific entity type within a directory. Stored in\n * .mj-sync.json files that contain an \"entity\" field. Supports defaults,\n * file patterns, and related entity configuration.\n */\nexport interface EntityConfig {\n  /** Name of the entity this directory contains */\n  entity: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** Default field values applied to all records in this directory */\n  defaults?: Record<string, any>;\n  /** \n   * Directories to ignore during processing\n   * Can be directory names or glob patterns relative to the location of the .mj-sync.json file\n   * Cumulative: subdirectories inherit and add to parent ignoreDirectories\n   * Examples: [\"output\", \"examples\", \"temp\"]\n   */\n  ignoreDirectories?: string[];\n  /** Pull command specific configuration */\n  pull?: {\n    /** Glob pattern for finding existing files to update (defaults to filePattern) */\n    filePattern?: string;\n    /** Whether to create new files for records not found locally */\n    createNewFileIfNotFound?: boolean;\n    /** Filename for new records when createNewFileIfNotFound is true */\n    newFileName?: string;\n    /** Whether to append multiple new records to a single file */\n    appendRecordsToExistingFile?: boolean;\n    /** Whether to update existing records found in local files */\n    updateExistingRecords?: boolean;\n    /** Fields to preserve during updates (never overwrite these) */\n    preserveFields?: string[];\n    /** Strategy for merging updates: \"overwrite\" | \"merge\" | \"skip\" */\n    mergeStrategy?: 'overwrite' | 'merge' | 'skip';\n    /** Create backup files before updating existing files */\n    backupBeforeUpdate?: boolean;\n    /** Directory name for backup files (defaults to \".backups\") */\n    backupDirectory?: string;\n    /** SQL filter to apply when pulling records from database */\n    filter?: string;\n    /** Configuration for pulling related entities */\n    relatedEntities?: Record<string, RelatedEntityConfig>;\n    /** Fields to externalize to separate files with optional configuration */\n    externalizeFields?: string[] | {\n      [fieldName: string]: {\n        /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n        extension?: string;\n      }\n    } | Array<{\n      /** Field name to externalize */\n      field: string;\n      /** Pattern for the output file. Supports placeholders:\n       * - {Name}: Entity's name field value\n       * - {ID}: Entity's ID\n       * - {FieldName}: The field being externalized\n       * - Any other {FieldName} from the entity\n       * Example: \"@file:templates/{Name}.template.md\"\n       */\n      pattern: string;\n    }>;\n    /** Fields to exclude from the pulled data (e.g., [\"TemplateID\"]) */\n    excludeFields?: string[];\n    /** Foreign key fields to convert to @lookup references */\n    lookupFields?: {\n      /** Field name in this entity (e.g., \"CategoryID\") */\n      [fieldName: string]: {\n        /** Target entity name (e.g., \"AI Prompt Categories\") */\n        entity: string;\n        /** Field in target entity to use for lookup (e.g., \"Name\") */\n        field: string;\n      };\n    };\n    /** Whether to ignore null field values during pull (defaults to false) */\n    ignoreNullFields?: boolean;\n    /** Whether to ignore virtual fields during pull (defaults to false) */\n    ignoreVirtualFields?: boolean;\n  };\n}\n\n/**\n * Folder-level configuration\n * \n * Defines default values that cascade down to all subdirectories. Stored in\n * .mj-folder.json files. Child folders can override parent defaults.\n */\nexport interface FolderConfig {\n  /** Default field values that apply to all entities in this folder and subfolders */\n  defaults: Record<string, any>;\n}\n\n/**\n * Load MemberJunction configuration from the filesystem\n * \n * Searches for mj.config.cjs starting from the current directory and walking up\n * the directory tree. Uses cosmiconfig for flexible configuration loading.\n * \n * @returns MJConfig object if found, null if not found or invalid\n * \n * @example\n * ```typescript\n * const config = loadMJConfig();\n * if (config) {\n *   console.log(`Connecting to ${config.dbHost}:${config.dbPort || 1433}`);\n * }\n * ```\n */\nexport function loadMJConfig(): MJConfig | null {\n  return configManager.loadMJConfig();\n}\n\n/**\n * Load sync configuration from a directory\n * \n * Loads .mj-sync.json file from the specified directory. This file can contain\n * either global sync configuration (no entity field) or entity-specific\n * configuration (with entity field).\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to SyncConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const syncConfig = await loadSyncConfig('/path/to/project');\n * if (syncConfig?.push?.requireConfirmation) {\n *   // Show confirmation prompt\n * }\n * ```\n */\nexport async function loadSyncConfig(dir: string): Promise<SyncConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading sync config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load entity-specific configuration from a directory\n * \n * Loads .mj-sync.json file that contains an \"entity\" field, indicating this\n * directory contains data for a specific entity type. Returns null if the\n * file doesn't exist or doesn't contain an entity field.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to EntityConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const entityConfig = await loadEntityConfig('./ai-prompts');\n * if (entityConfig) {\n *   console.log(`Directory contains ${entityConfig.entity} records`);\n * }\n * ```\n */\nexport async function loadEntityConfig(dir: string): Promise<EntityConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      const config = await fs.readJson(configPath);\n      if (config.entity) {\n        return config;\n      }\n    } catch (error) {\n      console.error('Error loading entity config:', error);\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load folder-level configuration\n * \n * Loads .mj-folder.json file that contains default values to be applied to\n * all entities in this folder and its subfolders. Used for cascading defaults\n * in deep directory structures.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to FolderConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const folderConfig = await loadFolderConfig('./templates');\n * if (folderConfig?.defaults) {\n *   // Apply folder defaults to records\n * }\n * ```\n */\nexport async function loadFolderConfig(dir: string): Promise<FolderConfig | null> {\n  const configPath = path.join(dir, '.mj-folder.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading folder config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;AAGH,gDAAwB;AACxB,wDAA0B;AAC1B,yDAAqD;AA8QrD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY;IAC1B,OAAO,8BAAa,CAAC,YAAY,EAAE,CAAC;AACtC,CAAC;AAFD,oCAEC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,wCAaC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAfD,4CAeC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,4CAaC","sourcesContent":["/**\n * @fileoverview Configuration types and loaders for MetadataSync\n * @module config\n * \n * This module defines configuration interfaces and provides utilities for loading\n * various configuration files used by the MetadataSync tool. It supports:\n * - MemberJunction database configuration (mj.config.cjs)\n * - Sync configuration (.mj-sync.json)\n * - Entity-specific configuration (.mj-sync.json with entity field)\n * - Folder-level defaults (.mj-folder.json)\n */\n\nimport { cosmiconfigSync } from 'cosmiconfig';\nimport path from 'path';\nimport fs from 'fs-extra';\nimport { configManager } from './lib/config-manager';\n\n/**\n * MemberJunction database configuration\n * \n * Defines connection parameters and settings for connecting to the MemberJunction\n * database. Typically loaded from mj.config.cjs in the project root.\n */\nexport interface MJConfig {\n  /** Database server hostname or IP address */\n  dbHost: string;\n  /** Database server port (defaults to 1433 for SQL Server) */\n  dbPort?: number;\n  /** Database name to connect to */\n  dbDatabase: string;\n  /** Database authentication username */\n  dbUsername: string;\n  /** Database authentication password */\n  dbPassword: string;\n  /** Whether to trust the server certificate (Y/N) */\n  dbTrustServerCertificate?: string;\n  /** Whether to encrypt the connection (Y/N, auto-detected for Azure SQL) */\n  dbEncrypt?: string;\n  /** SQL Server instance name (for named instances) */\n  dbInstanceName?: string;\n  /** Schema name for MemberJunction core tables (defaults to __mj) */\n  mjCoreSchema?: string;\n  /** Allow additional properties for extensibility */\n  [key: string]: any;\n}\n\n/**\n * Global sync configuration\n * \n * Defines settings that apply to the entire sync process, including push/pull\n * behaviors and watch mode configuration. Stored in .mj-sync.json at the root.\n */\nexport interface SyncConfig {\n  /** Version of the sync configuration format */\n  version: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** \n   * Directory processing order (only applies to root-level config, not inherited by subdirectories)\n   * Specifies the order in which subdirectories should be processed to handle dependencies.\n   * Directories not listed in this array will be processed after the ordered ones in alphabetical order.\n   */\n  directoryOrder?: string[];\n  /** \n   * Directories to ignore during processing\n   * Can be directory names or glob patterns relative to the location of the .mj-sync.json file\n   * Cumulative: subdirectories inherit and add to parent ignoreDirectories\n   * Examples: [\"output\", \"examples\", \"temp\"]\n   */\n  ignoreDirectories?: string[];\n  /** Push command configuration */\n  push?: {\n    /** Whether to validate records before pushing to database */\n    validateBeforePush?: boolean;\n    /** Whether to require user confirmation before push */\n    requireConfirmation?: boolean;\n    /** \n     * Whether to automatically create new records when a primaryKey exists but record is not found\n     * Defaults to false - will warn instead of creating\n     */\n    autoCreateMissingRecords?: boolean;\n    /** \n     * When true, forces all records to be saved to database regardless of dirty state.\n     * This bypasses dirty checking and always performs database updates.\n     * Useful for ensuring complete synchronization or when dirty detection may miss changes.\n     * Defaults to false.\n     */\n    alwaysPush?: boolean;\n  };\n  /** SQL logging configuration (only applies to root-level config, not inherited by subdirectories) */\n  sqlLogging?: {\n    /** Whether to enable SQL logging during push operations */\n    enabled?: boolean;\n    /** Directory to output SQL log files (relative to command execution directory, defaults to './sql_logging') */\n    outputDirectory?: string;\n    /** Whether to format SQL as migration-ready files with Flyway schema placeholders */\n    formatAsMigration?: boolean;\n    /**\n     * Array of patterns to filter SQL statements.\n     * Supports both regex strings and simple wildcard patterns:\n     * - Regex: \"/spCreate.*Run/i\" (must start with \"/\" and optionally end with flags)\n     * - Simple: \"*spCreateAIPromptRun*\" (uses * as wildcard, case-insensitive by default)\n     * Examples: [\"*AIPrompt*\", \"/^EXEC sp_/i\", \"*EntityFieldValue*\"]\n     */\n    filterPatterns?: string[];\n    /**\n     * Determines how filterPatterns are applied:\n     * - 'exclude': If ANY pattern matches, the SQL is NOT logged (default)\n     * - 'include': If ANY pattern matches, the SQL IS logged\n     */\n    filterType?: 'exclude' | 'include';\n  };\n  /** Watch command configuration */\n  watch?: {\n    /** Milliseconds to wait before processing file changes */\n    debounceMs?: number;\n    /** File patterns to ignore during watch */\n    ignorePatterns?: string[];\n  };\n  /** User role validation configuration */\n  userRoleValidation?: {\n    /** Whether to enable user role validation for UserID fields */\n    enabled?: boolean;\n    /** List of role names that are allowed to be referenced in metadata */\n    allowedRoles?: string[];\n    /** Whether to allow users without any roles (defaults to false) */\n    allowUsersWithoutRoles?: boolean;\n  };\n  /**\n   * Whether to emit __mj_sync_notes in record files during push operations.\n   * When enabled, resolution information for @lookup and @parent references is written to files.\n   * Defaults to false. Entity-level .mj-sync.json files can override this setting.\n   */\n  emitSyncNotes?: boolean;\n}\n\n/**\n * Configuration for related entity synchronization\n * \n * Defines how to pull and push related entities that have foreign key relationships\n * with a parent entity. Supports nested relationships for deep object graphs.\n * NEW: Supports automatic recursive patterns for self-referencing entities.\n */\nexport interface RelatedEntityConfig {\n  /** Name of the related entity to sync */\n  entity: string;\n  /** Field name that contains the foreign key reference to parent (e.g., \"PromptID\") */\n  foreignKey: string;\n  /** Optional SQL filter to apply when pulling related records */\n  filter?: string;\n  /** \n   * Enable recursive fetching for self-referencing entities\n   * When true, automatically fetches all levels of the hierarchy until no more children found\n   */\n  recursive?: boolean;\n  /** \n   * Maximum depth for recursive fetching (optional, defaults to 10)\n   * Prevents infinite loops and controls memory usage\n   * Only applies when recursive is true\n   */\n  maxDepth?: number;\n  /** Fields to externalize to separate files for this related entity */\n  externalizeFields?: string[] | {\n    [fieldName: string]: {\n      /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n      extension?: string;\n    }\n  } | Array<{\n    /** Field name to externalize */\n    field: string;\n    /** Pattern for the output file. Supports placeholders from the entity */\n    pattern: string;\n  }>;\n  /** Fields to exclude from the pulled data for this related entity */\n  excludeFields?: string[];\n  /** Foreign key fields to convert to @lookup references for this related entity */\n  lookupFields?: {\n    [fieldName: string]: {\n      entity: string;\n      field: string;\n    };\n  };\n  /** Nested related entities for deep object graphs */\n  relatedEntities?: Record<string, RelatedEntityConfig>;\n}\n\n/**\n * Entity-specific configuration\n * \n * Defines settings for a specific entity type within a directory. Stored in\n * .mj-sync.json files that contain an \"entity\" field. Supports defaults,\n * file patterns, and related entity configuration.\n */\nexport interface EntityConfig {\n  /** Name of the entity this directory contains */\n  entity: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** Default field values applied to all records in this directory */\n  defaults?: Record<string, any>;\n  /** \n   * Directories to ignore during processing\n   * Can be directory names or glob patterns relative to the location of the .mj-sync.json file\n   * Cumulative: subdirectories inherit and add to parent ignoreDirectories\n   * Examples: [\"output\", \"examples\", \"temp\"]\n   */\n  ignoreDirectories?: string[];\n  /** Pull command specific configuration */\n  pull?: {\n    /** Glob pattern for finding existing files to update (defaults to filePattern) */\n    filePattern?: string;\n    /** Whether to create new files for records not found locally */\n    createNewFileIfNotFound?: boolean;\n    /** Filename for new records when createNewFileIfNotFound is true */\n    newFileName?: string;\n    /** Whether to append multiple new records to a single file */\n    appendRecordsToExistingFile?: boolean;\n    /** Whether to update existing records found in local files */\n    updateExistingRecords?: boolean;\n    /** Fields to preserve during updates (never overwrite these) */\n    preserveFields?: string[];\n    /** Strategy for merging updates: \"overwrite\" | \"merge\" | \"skip\" */\n    mergeStrategy?: 'overwrite' | 'merge' | 'skip';\n    /** Create backup files before updating existing files */\n    backupBeforeUpdate?: boolean;\n    /** Directory name for backup files (defaults to \".backups\") */\n    backupDirectory?: string;\n    /** SQL filter to apply when pulling records from database */\n    filter?: string;\n    /** Configuration for pulling related entities */\n    relatedEntities?: Record<string, RelatedEntityConfig>;\n    /** Fields to externalize to separate files with optional configuration */\n    externalizeFields?: string[] | {\n      [fieldName: string]: {\n        /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n        extension?: string;\n      }\n    } | Array<{\n      /** Field name to externalize */\n      field: string;\n      /** Pattern for the output file. Supports placeholders:\n       * - {Name}: Entity's name field value\n       * - {ID}: Entity's ID\n       * - {FieldName}: The field being externalized\n       * - Any other {FieldName} from the entity\n       * Example: \"@file:templates/{Name}.template.md\"\n       */\n      pattern: string;\n    }>;\n    /** Fields to exclude from the pulled data (e.g., [\"TemplateID\"]) */\n    excludeFields?: string[];\n    /** Foreign key fields to convert to @lookup references */\n    lookupFields?: {\n      /** Field name in this entity (e.g., \"CategoryID\") */\n      [fieldName: string]: {\n        /** Target entity name (e.g., \"AI Prompt Categories\") */\n        entity: string;\n        /** Field in target entity to use for lookup (e.g., \"Name\") */\n        field: string;\n      };\n    };\n    /** Whether to ignore null field values during pull (defaults to false) */\n    ignoreNullFields?: boolean;\n    /** Whether to ignore virtual fields during pull (defaults to false) */\n    ignoreVirtualFields?: boolean;\n  };\n  /**\n   * Whether to emit __mj_sync_notes in record files during push operations.\n   * When enabled, resolution information for @lookup and @parent references is written to files.\n   * If not specified, inherits from root .mj-sync.json. Defaults to false if not set anywhere.\n   */\n  emitSyncNotes?: boolean;\n}\n\n/**\n * Folder-level configuration\n * \n * Defines default values that cascade down to all subdirectories. Stored in\n * .mj-folder.json files. Child folders can override parent defaults.\n */\nexport interface FolderConfig {\n  /** Default field values that apply to all entities in this folder and subfolders */\n  defaults: Record<string, any>;\n}\n\n/**\n * Load MemberJunction configuration from the filesystem\n * \n * Searches for mj.config.cjs starting from the current directory and walking up\n * the directory tree. Uses cosmiconfig for flexible configuration loading.\n * \n * @returns MJConfig object if found, null if not found or invalid\n * \n * @example\n * ```typescript\n * const config = loadMJConfig();\n * if (config) {\n *   console.log(`Connecting to ${config.dbHost}:${config.dbPort || 1433}`);\n * }\n * ```\n */\nexport function loadMJConfig(): MJConfig | null {\n  return configManager.loadMJConfig();\n}\n\n/**\n * Load sync configuration from a directory\n * \n * Loads .mj-sync.json file from the specified directory. This file can contain\n * either global sync configuration (no entity field) or entity-specific\n * configuration (with entity field).\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to SyncConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const syncConfig = await loadSyncConfig('/path/to/project');\n * if (syncConfig?.push?.requireConfirmation) {\n *   // Show confirmation prompt\n * }\n * ```\n */\nexport async function loadSyncConfig(dir: string): Promise<SyncConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading sync config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load entity-specific configuration from a directory\n * \n * Loads .mj-sync.json file that contains an \"entity\" field, indicating this\n * directory contains data for a specific entity type. Returns null if the\n * file doesn't exist or doesn't contain an entity field.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to EntityConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const entityConfig = await loadEntityConfig('./ai-prompts');\n * if (entityConfig) {\n *   console.log(`Directory contains ${entityConfig.entity} records`);\n * }\n * ```\n */\nexport async function loadEntityConfig(dir: string): Promise<EntityConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      const config = await fs.readJson(configPath);\n      if (config.entity) {\n        return config;\n      }\n    } catch (error) {\n      console.error('Error loading entity config:', error);\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load folder-level configuration\n * \n * Loads .mj-folder.json file that contains default values to be applied to\n * all entities in this folder and its subfolders. Used for cascading defaults\n * in deep directory structures.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to FolderConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const folderConfig = await loadFolderConfig('./templates');\n * if (folderConfig?.defaults) {\n *   // Apply folder defaults to records\n * }\n * ```\n */\nexport async function loadFolderConfig(dir: string): Promise<FolderConfig | null> {\n  const configPath = path.join(dir, '.mj-folder.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading folder config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}"]}

package/dist/lib/record-dependency-analyzer.js

@@ -53,6 +53,12 @@ class RecordDependencyAnalyzer {
             const record = records[i];
             const recordId = `${entityName}_${this.recordCounter++}`;
             const path = pathPrefix ? `${pathPrefix}/${entityName}[${i}]` : `${entityName}[${i}]`;
+            // Validate that the record has a 'fields' property (required)
+            if (!record.fields) {
+                const hint = 'field' in record ? ' Did you mean "fields" instead of "field"?' : '';
+                throw new Error(`Record at ${path} is missing required "fields" property.${hint} ` +
+                    `Each record must have a "fields" object containing the entity field values.`);
+            }
             const flattenedRecord = {
                 record,
                 entityName,

package/dist/lib/record-dependency-analyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-dependency-analyzer.js","sourceRoot":"","sources":["../../src/lib/record-dependency-analyzer.ts"],"names":[],"mappings":"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","sourcesContent":["import { Metadata, EntityInfo } from '@memberjunction/core';\nimport { RecordData } from './sync-engine';\nimport { METADATA_KEYWORDS, isNonKeywordAtSymbol } from '../constants/metadata-keywords';\n\n/**\n * Represents a flattened record with its context and dependencies\n */\nexport interface FlattenedRecord {\n  record: RecordData;\n  entityName: string;\n  parentContext?: {\n    entityName: string;\n    record: RecordData;\n    recordIndex: number;\n  };\n  depth: number;\n  path: string; // Path to this record for debugging\n  dependencies: Set<string>; // Set of record IDs this record depends on\n  id: string; // Unique identifier for this record in the flattened list\n  originalIndex: number; // Original index in the source array\n}\n\n/**\n * Represents a reverse dependency relationship\n * (which records depend on a given record)\n */\nexport interface ReverseDependency {\n  recordId: string;           // The record being referenced\n  dependentId: string;        // The record that depends on it\n  entityName: string;         // Entity of the dependent\n  fieldName: string | null;   // Foreign key field name (if known)\n  filePath: string;           // Location of dependent record\n}\n\n/**\n * Result of dependency analysis\n */\nexport interface DependencyAnalysisResult {\n  sortedRecords: FlattenedRecord[];\n  circularDependencies: string[][];\n  dependencyGraph: Map<string, Set<string>>;\n  dependencyLevels?: FlattenedRecord[][]; // Records grouped by dependency level for parallel processing\n}\n\n/**\n * Analyzes and sorts records based on their dependencies\n */\nexport class RecordDependencyAnalyzer {\n  private metadata: Metadata;\n  private flattenedRecords: FlattenedRecord[] = [];\n  private recordIdMap: Map<string, FlattenedRecord> = new Map();\n  private entityInfoCache: Map<string, EntityInfo> = new Map();\n  private recordCounter: number = 0;\n\n  constructor() {\n    this.metadata = new Metadata();\n  }\n\n  /**\n   * Main entry point: analyzes all records in a file and returns them in dependency order\n   */\n  public async analyzeFileRecords(\n    records: RecordData[],\n    entityName: string\n  ): Promise<DependencyAnalysisResult> {\n    // Reset state\n    this.flattenedRecords = [];\n    this.recordIdMap.clear();\n    this.recordCounter = 0;\n\n    // Step 1: Flatten all records (including nested relatedEntities)\n    this.flattenRecords(records, entityName);\n\n    // Step 2: Analyze dependencies between all flattened records\n    this.analyzeDependencies();\n\n    // Step 3: Detect circular dependencies\n    const circularDeps = this.detectCircularDependencies();\n\n    // Step 4: Perform topological sort\n    const sortedRecords = this.topologicalSort();\n\n    // Step 5: Build dependency graph for debugging\n    const dependencyGraph = new Map<string, Set<string>>();\n    for (const record of this.flattenedRecords) {\n      dependencyGraph.set(record.id, record.dependencies);\n    }\n\n    // Step 6: Group records into dependency levels for parallel processing\n    const dependencyLevels = this.groupByDependencyLevels(sortedRecords, dependencyGraph);\n\n    return {\n      sortedRecords,\n      circularDependencies: circularDeps,\n      dependencyGraph,\n      dependencyLevels\n    };\n  }\n\n  /**\n   * Flattens all records including nested relatedEntities\n   */\n  private flattenRecords(\n    records: RecordData[],\n    entityName: string,\n    parentContext?: FlattenedRecord['parentContext'],\n    depth: number = 0,\n    pathPrefix: string = '',\n    parentRecordId?: string\n  ): void {\n    for (let i = 0; i < records.length; i++) {\n      const record = records[i];\n      const recordId = `${entityName}_${this.recordCounter++}`;\n      const path = pathPrefix ? `${pathPrefix}/${entityName}[${i}]` : `${entityName}[${i}]`;\n\n      const flattenedRecord: FlattenedRecord = {\n        record,\n        entityName,\n        parentContext,\n        depth,\n        path,\n        dependencies: new Set(),\n        id: recordId,\n        originalIndex: i\n      };\n\n      // If this has a parent, add dependency on the parent\n      if (parentRecordId) {\n        flattenedRecord.dependencies.add(parentRecordId);\n      }\n\n      this.flattenedRecords.push(flattenedRecord);\n      this.recordIdMap.set(recordId, flattenedRecord);\n\n      // Recursively flatten related entities\n      if (record.relatedEntities) {\n        for (const [relatedEntityName, relatedRecords] of Object.entries(record.relatedEntities)) {\n          this.flattenRecords(\n            relatedRecords,\n            relatedEntityName,\n            {\n              entityName,\n              record,\n              recordIndex: i\n            },\n            depth + 1,\n            path,\n            recordId  // Pass current record ID as parent for children\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Analyzes dependencies between all flattened records\n   */\n  private analyzeDependencies(): void {\n    for (const record of this.flattenedRecords) {\n      // Get entity info for foreign key relationships\n      const entityInfo = this.getEntityInfo(record.entityName);\n      if (!entityInfo) continue;\n\n      // Analyze field dependencies\n      if (record.record.fields) {\n        for (const [fieldName, fieldValue] of Object.entries(record.record.fields)) {\n          if (typeof fieldValue === 'string') {\n            // Handle @lookup references\n            if (fieldValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n              const dependency = this.findLookupDependency(fieldValue, record);\n              if (dependency) {\n                record.dependencies.add(dependency);\n              }\n            }\n            // Handle @root references - these create dependencies on the root record\n            else if (fieldValue.startsWith(METADATA_KEYWORDS.ROOT)) {\n              const rootDependency = this.findRootDependency(record);\n              if (rootDependency) {\n                record.dependencies.add(rootDependency);\n              }\n            }\n            // @parent references don't create explicit dependencies in our flattened structure\n            // because parent is guaranteed to be processed before children due to the way\n            // we flatten records (parent always comes before its children)\n          }\n        }\n      }\n\n      // Check foreign key dependencies\n      this.analyzeForeignKeyDependencies(record, entityInfo);\n    }\n  }\n\n  /**\n   * Analyzes foreign key dependencies based on EntityInfo\n   */\n  private analyzeForeignKeyDependencies(record: FlattenedRecord, entityInfo: EntityInfo): void {\n    // Check all foreign key fields\n    for (const field of entityInfo.ForeignKeys) {\n      const fieldValue = record.record.fields?.[field.Name];\n      if (fieldValue && typeof fieldValue === 'string' && !fieldValue.startsWith('@')) {\n        // This is a direct foreign key value, find the referenced record\n        const relatedEntityInfo = this.getEntityInfo(field.RelatedEntity);\n        if (relatedEntityInfo) {\n          const dependency = this.findRecordByPrimaryKey(\n            field.RelatedEntity,\n            fieldValue,\n            relatedEntityInfo\n          );\n          if (dependency) {\n            record.dependencies.add(dependency);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Finds a record that matches a @lookup reference\n   */\n  private findLookupDependency(lookupValue: string, currentRecord: FlattenedRecord): string | null {\n    // Parse lookup format: @lookup:EntityName.Field=Value or @lookup:Field=Value\n    const lookupStr = lookupValue.substring(8); // Remove '@lookup:'\n    \n    // Handle the ?create syntax by removing it\n    const cleanLookup = lookupStr.split('?')[0];\n    \n    // Parse entity name if present\n    let targetEntity: string;\n    let criteria: string;\n    \n    if (cleanLookup.includes('.')) {\n      const parts = cleanLookup.split('.');\n      targetEntity = parts[0];\n      criteria = parts.slice(1).join('.');\n    } else {\n      // Same entity if not specified\n      targetEntity = currentRecord.entityName;\n      criteria = cleanLookup;\n    }\n\n    // Parse criteria (can be multiple with &)\n    const criteriaMap = new Map<string, string>();\n    for (const pair of criteria.split('&')) {\n      const [field, value] = pair.split('=');\n      if (field && value) {\n        let resolvedValue = value.trim();\n        \n        // Special handling for nested @lookup references in lookup criteria\n        // This creates a dependency on the looked-up record\n        if (resolvedValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n          const nestedDependency = this.findLookupDependency(resolvedValue, currentRecord);\n          if (nestedDependency) {\n            // Add this as a dependency of the current record\n            currentRecord.dependencies.add(nestedDependency);\n            // Continue processing - we can't resolve the actual value here\n            // but we've recorded the dependency\n          }\n        }\n        // Special handling for @root references in lookup criteria\n        else if (resolvedValue.startsWith(METADATA_KEYWORDS.ROOT)) {\n          // Add dependency on root record\n          const rootDep = this.findRootDependency(currentRecord);\n          if (rootDep) {\n            currentRecord.dependencies.add(rootDep);\n          }\n          // Note: We can't resolve the actual value here, but we've recorded the dependency\n        }\n        // Special handling for @parent references in lookup criteria\n        // If the value is @parent:field, we need to resolve it from the parent context\n        else if (resolvedValue.startsWith(METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {\n          const parentField = resolvedValue.substring(METADATA_KEYWORDS.PARENT.length);\n          \n          // Try to resolve from parent context\n          const parentValue = currentRecord.parentContext.record.fields?.[parentField] ||\n                             currentRecord.parentContext.record.primaryKey?.[parentField];\n          \n          if (parentValue && typeof parentValue === 'string') {\n            // Check if parent value is also a @parent reference (nested parent refs)\n            if (parentValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n              // Find the parent record to get its parent context\n              const parentRecord = this.flattenedRecords.find(r =>\n                r.record === currentRecord.parentContext!.record &&\n                r.entityName === currentRecord.parentContext!.entityName\n              );\n\n              if (parentRecord && parentRecord.parentContext) {\n                const grandParentField = parentValue.substring(METADATA_KEYWORDS.PARENT.length);\n                const grandParentValue = parentRecord.parentContext.record.fields?.[grandParentField] ||\n                                        parentRecord.parentContext.record.primaryKey?.[grandParentField];\n                if (grandParentValue && typeof grandParentValue === 'string' && !grandParentValue.startsWith('@')) {\n                  resolvedValue = grandParentValue;\n                }\n              }\n            } else if (!parentValue.startsWith('@')) {\n              resolvedValue = parentValue;\n            }\n          }\n        }\n        \n        criteriaMap.set(field.trim(), resolvedValue);\n      }\n    }\n\n    // Find matching record in our flattened list\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== targetEntity) continue;\n      if (candidate.id === currentRecord.id) continue; // Skip self\n\n      // Check if all criteria match\n      let allMatch = true;\n      for (const [field, value] of criteriaMap) {\n        let candidateValue = candidate.record.fields?.[field] || \n                             candidate.record.primaryKey?.[field];\n        let lookupValue = value;\n        \n        // Resolve candidate value if it's a @parent reference\n        if (typeof candidateValue === 'string' && candidateValue.startsWith(METADATA_KEYWORDS.PARENT) && candidate.parentContext) {\n          const parentField = candidateValue.substring(METADATA_KEYWORDS.PARENT.length);\n          const parentRecord = candidate.parentContext.record;\n          candidateValue = parentRecord.fields?.[parentField] || parentRecord.primaryKey?.[parentField];\n\n          // If the parent field is also a @parent reference, resolve it recursively\n          if (typeof candidateValue === 'string' && candidateValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n            // Find the candidate's parent in our flattened list\n            const candidateParent = this.flattenedRecords.find(r => \n              r.record === candidate.parentContext!.record && \n              r.entityName === candidate.parentContext!.entityName\n            );\n            if (candidateParent?.parentContext) {\n              const grandParentField = candidateValue.substring(8);\n              candidateValue = candidateParent.parentContext.record.fields?.[grandParentField] || \n                              candidateParent.parentContext.record.primaryKey?.[grandParentField];\n            }\n          }\n        }\n        \n        // Resolve lookup value if it contains @parent reference\n        if (typeof lookupValue === 'string' && lookupValue.includes(METADATA_KEYWORDS.PARENT)) {\n          // Handle cases like \"@parent:AgentID\" or embedded references\n          if (lookupValue.startsWith(METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {\n            const parentField = lookupValue.substring(METADATA_KEYWORDS.PARENT.length);\n            lookupValue = currentRecord.parentContext.record.fields?.[parentField] ||\n                         currentRecord.parentContext.record.primaryKey?.[parentField];\n\n            // If still a reference, try to resolve from the parent's parent\n            if (typeof lookupValue === 'string' && lookupValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n              const currentParent = this.flattenedRecords.find(r =>\n                r.record === currentRecord.parentContext!.record &&\n                r.entityName === currentRecord.parentContext!.entityName\n              );\n              if (currentParent?.parentContext) {\n                const grandParentField = lookupValue.substring(METADATA_KEYWORDS.PARENT.length);\n                lookupValue = currentParent.parentContext.record.fields?.[grandParentField] ||\n                             currentParent.parentContext.record.primaryKey?.[grandParentField];\n              }\n            }\n          }\n        }\n\n        // Special case: if both values are @parent references pointing to the same parent field,\n        // and they have the same parent context, they match\n        if (value.startsWith(METADATA_KEYWORDS.PARENT) && candidateValue === value && \n            currentRecord.parentContext && candidate.parentContext) {\n          // Check if they share the same parent\n          if (currentRecord.parentContext.record === candidate.parentContext.record) {\n            // Same parent, same reference - they will resolve to the same value\n            continue; // This criterion matches\n          }\n        }\n        \n        if (candidateValue !== lookupValue) {\n          allMatch = false;\n          break;\n        }\n      }\n\n      if (allMatch) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Finds the root record for a given record\n   */\n  private findRootDependency(record: FlattenedRecord): string | null {\n    // If this record has no parent, it IS the root, no dependency\n    if (!record.parentContext) {\n      return null;\n    }\n    \n    // Walk up the parent chain to find the root\n    let current = record;\n    while (current.parentContext) {\n      // Try to find the parent record in our flattened list\n      const parentRecord = this.flattenedRecords.find(r => \n        r.record === current.parentContext!.record && \n        r.entityName === current.parentContext!.entityName\n      );\n      \n      if (!parentRecord) {\n        // Parent not found, something is wrong\n        return null;\n      }\n      \n      // If this parent has no parent, it's the root\n      if (!parentRecord.parentContext) {\n        return parentRecord.id;\n      }\n      \n      current = parentRecord;\n    }\n    \n    return null;\n  }\n\n  /**\n   * Finds a record by its primary key value\n   */\n  private findRecordByPrimaryKey(\n    entityName: string,\n    primaryKeyValue: string,\n    entityInfo: EntityInfo\n  ): string | null {\n    // Get primary key field name\n    const primaryKeyField = entityInfo.PrimaryKeys[0]?.Name;\n    if (!primaryKeyField) return null;\n\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== entityName) continue;\n\n      const candidateValue = candidate.record.primaryKey?.[primaryKeyField] ||\n                            candidate.record.fields?.[primaryKeyField];\n      if (candidateValue === primaryKeyValue) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets EntityInfo from cache or metadata\n   */\n  private getEntityInfo(entityName: string): EntityInfo | null {\n    if (!this.entityInfoCache.has(entityName)) {\n      const info = this.metadata.EntityByName(entityName);\n      if (info) {\n        this.entityInfoCache.set(entityName, info);\n      }\n    }\n    return this.entityInfoCache.get(entityName) || null;\n  }\n\n  /**\n   * Detects circular dependencies in the dependency graph\n   */\n  private detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const detectCycle = (recordId: string, path: string[]): boolean => {\n      visited.add(recordId);\n      recursionStack.add(recordId);\n      path.push(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        for (const depId of record.dependencies) {\n          if (!visited.has(depId)) {\n            if (detectCycle(depId, [...path])) {\n              return true;\n            }\n          } else if (recursionStack.has(depId)) {\n            // Found a cycle\n            const cycleStart = path.indexOf(depId);\n            const cycle = path.slice(cycleStart);\n            cycle.push(depId); // Complete the cycle\n            cycles.push(cycle);\n            return true;\n          }\n        }\n      }\n\n      recursionStack.delete(recordId);\n      return false;\n    };\n\n    // Check all records for cycles\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        detectCycle(record.id, []);\n      }\n    }\n\n    return cycles;\n  }\n\n  /**\n   * Performs topological sort on the dependency graph\n   */\n  private topologicalSort(): FlattenedRecord[] {\n    const result: FlattenedRecord[] = [];\n    const visited = new Set<string>();\n    const tempStack = new Set<string>();\n\n    const visit = (recordId: string): boolean => {\n      if (tempStack.has(recordId)) {\n        // Circular dependency - we've already detected these\n        return false;\n      }\n\n      if (visited.has(recordId)) {\n        return true;\n      }\n\n      tempStack.add(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        // Visit dependencies first\n        for (const depId of record.dependencies) {\n          visit(depId);\n        }\n      }\n\n      tempStack.delete(recordId);\n      visited.add(recordId);\n      \n      if (record) {\n        result.push(record);\n      }\n\n      return true;\n    };\n\n    // Process all records, starting with those that have no dependencies\n    // First, process records with no dependencies\n    for (const record of this.flattenedRecords) {\n      if (record.dependencies.size === 0 && !visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    // Then process any remaining records (handles disconnected components)\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Groups sorted records into dependency levels for parallel processing\n   * Records in the same level have no dependencies on each other and can be processed in parallel\n   */\n  private groupByDependencyLevels(\n    sortedRecords: FlattenedRecord[],\n    dependencyGraph: Map<string, Set<string>>\n  ): FlattenedRecord[][] {\n    const levels: FlattenedRecord[][] = [];\n    const recordLevels = new Map<string, number>();\n    \n    // Calculate the level for each record\n    for (const record of sortedRecords) {\n      let maxDependencyLevel = -1;\n      \n      // Find the maximum level of all dependencies\n      for (const depId of record.dependencies) {\n        const depLevel = recordLevels.get(depId);\n        if (depLevel !== undefined && depLevel > maxDependencyLevel) {\n          maxDependencyLevel = depLevel;\n        }\n      }\n      \n      // This record's level is one more than its highest dependency\n      const recordLevel = maxDependencyLevel + 1;\n      recordLevels.set(record.id, recordLevel);\n      \n      // Add to the appropriate level array\n      if (!levels[recordLevel]) {\n        levels[recordLevel] = [];\n      }\n      levels[recordLevel].push(record);\n    }\n    \n    return levels;\n  }\n\n  /**\n   * Build reverse dependency map from forward dependencies\n   * Maps: record ID -> list of records that depend on it\n   *\n   * This is essential for deletion ordering - we need to know what depends on a record\n   * before we can safely delete it.\n   */\n  public buildReverseDependencyMap(\n    records: FlattenedRecord[]\n  ): Map<string, ReverseDependency[]> {\n    const reverseMap = new Map<string, ReverseDependency[]>();\n\n    for (const record of records) {\n      // For each dependency this record has...\n      for (const depId of record.dependencies) {\n        // Add this record as a dependent of that dependency\n        if (!reverseMap.has(depId)) {\n          reverseMap.set(depId, []);\n        }\n\n        reverseMap.get(depId)!.push({\n          recordId: depId,\n          dependentId: record.id,\n          entityName: record.entityName,\n          fieldName: this.findForeignKeyFieldForDependency(record, depId),\n          filePath: record.path\n        });\n      }\n    }\n\n    return reverseMap;\n  }\n\n  /**\n   * Find the foreign key field that creates a dependency\n   * Used for better error reporting\n   */\n  private findForeignKeyFieldForDependency(\n    record: FlattenedRecord,\n    dependencyId: string\n  ): string | null {\n    const entityInfo = this.getEntityInfo(record.entityName);\n    if (!entityInfo) return null;\n\n    const dependentRecord = this.recordIdMap.get(dependencyId);\n    if (!dependentRecord) return null;\n\n    // Check all foreign key fields\n    for (const field of entityInfo.ForeignKeys) {\n      const fieldValue = record.record.fields?.[field.Name];\n\n      // Check if this field references the dependent record\n      if (fieldValue && typeof fieldValue === 'string') {\n        // Handle @lookup references\n        if (fieldValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n          const resolvedDep = this.findLookupDependency(fieldValue, record);\n          if (resolvedDep === dependencyId) {\n            return field.Name;\n          }\n        }\n        // Handle direct foreign key values\n        else if (!fieldValue.startsWith('@')) {\n          const relatedEntityInfo = this.getEntityInfo(field.RelatedEntity);\n          if (relatedEntityInfo) {\n            const dep = this.findRecordByPrimaryKey(\n              field.RelatedEntity,\n              fieldValue,\n              relatedEntityInfo\n            );\n            if (dep === dependencyId) {\n              return field.Name;\n            }\n          }\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Perform reverse topological sort for deletion order\n   * Returns records grouped by dependency level, with leaf nodes (highest dependency level) first\n   *\n   * For deletions, we want to delete in reverse order of creation:\n   * - Records at highest forward dependency levels (leaf nodes) delete FIRST\n   * - Records at level 0 (root nodes with no dependencies) delete LAST\n   *\n   * This is simply the reverse of the forward topological sort used for creates.\n   */\n  public reverseTopologicalSort(\n    records: FlattenedRecord[],\n    reverseDependencies: Map<string, ReverseDependency[]>\n  ): FlattenedRecord[][] {\n    // Calculate forward dependency levels (same as creation order)\n    const recordLevels = new Map<string, number>();\n\n    // Calculate the level for each record based on its FORWARD dependencies\n    for (const record of records) {\n      let maxDependencyLevel = -1;\n\n      // Find the maximum level of all dependencies (things this record depends ON)\n      for (const depId of record.dependencies) {\n        const depLevel = recordLevels.get(depId);\n        if (depLevel !== undefined && depLevel > maxDependencyLevel) {\n          maxDependencyLevel = depLevel;\n        }\n      }\n\n      // This record's level is one more than its highest dependency\n      const recordLevel = maxDependencyLevel + 1;\n      recordLevels.set(record.id, recordLevel);\n    }\n\n    // Group records by level\n    const forwardLevels: FlattenedRecord[][] = [];\n    for (const record of records) {\n      const level = recordLevels.get(record.id) || 0;\n\n      if (!forwardLevels[level]) {\n        forwardLevels[level] = [];\n      }\n      forwardLevels[level].push(record);\n    }\n\n    // Reverse the array for deletion order\n    // Forward level 0 (roots) becomes last to delete\n    // Forward level N (leaves) becomes first to delete\n    return forwardLevels.reverse();\n  }\n\n  /**\n   * Find all transitive dependents of a set of records\n   * This is useful for finding all records that must be deleted when deleting a parent\n   *\n   * @param recordIds Set of record IDs to find dependents for\n   * @param reverseDependencies Reverse dependency map\n   * @returns Set of all record IDs that depend on the input records (transitively)\n   */\n  public findTransitiveDependents(\n    recordIds: Set<string>,\n    reverseDependencies: Map<string, ReverseDependency[]>\n  ): Set<string> {\n    const dependents = new Set<string>();\n    const visited = new Set<string>();\n\n    // BFS to find all transitive dependents\n    const queue = Array.from(recordIds);\n\n    while (queue.length > 0) {\n      const recordId = queue.shift()!;\n      if (visited.has(recordId)) continue;\n      visited.add(recordId);\n\n      const deps = reverseDependencies.get(recordId) || [];\n\n      for (const dep of deps) {\n        // Add dependent to result set\n        dependents.add(dep.dependentId);\n\n        // Queue for processing its dependents\n        queue.push(dep.dependentId);\n      }\n    }\n\n    return dependents;\n  }\n}"]}
+{"version":3,"file":"record-dependency-analyzer.js","sourceRoot":"","sources":["../../src/lib/record-dependency-analyzer.ts"],"names":[],"mappings":";;;AAAA,+CAA4D;AAE5D,sEAAyF;AA0CzF;;GAEG;AACH,MAAa,wBAAwB;IAC3B,QAAQ,CAAW;IACnB,gBAAgB,GAAsB,EAAE,CAAC;IACzC,WAAW,GAAiC,IAAI,GAAG,EAAE,CAAC;IACtD,eAAe,GAA4B,IAAI,GAAG,EAAE,CAAC;IACrD,aAAa,GAAW,CAAC,CAAC;IAElC;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,kBAAkB,CAC7B,OAAqB,EACrB,UAAkB;QAElB,cAAc;QACd,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QAEvB,iEAAiE;QACjE,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEzC,6DAA6D;QAC7D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE3B,uCAAuC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAEvD,mCAAmC;QACnC,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAE7C,+CAA+C;QAC/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;QACvD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3C,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;QAED,uEAAuE;QACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QAEtF,OAAO;YACL,aAAa;YACb,oBAAoB,EAAE,YAAY;YAClC,eAAe;YACf,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,OAAqB,EACrB,UAAkB,EAClB,aAAgD,EAChD,QAAgB,CAAC,EACjB,aAAqB,EAAE,EACvB,cAAuB;QAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,GAAG,CAAC;YAEtF,8DAA8D;YAC9D,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnF,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,0CAA0C,IAAI,GAAG;oBAClE,6EAA6E,CAC9E,CAAC;YACJ,CAAC;YAED,MAAM,eAAe,GAAoB;gBACvC,MAAM;gBACN,UAAU;gBACV,aAAa;gBACb,KAAK;gBACL,IAAI;gBACJ,YAAY,EAAE,IAAI,GAAG,EAAE;gBACvB,EAAE,EAAE,QAAQ;gBACZ,aAAa,EAAE,CAAC;aACjB,CAAC;YAEF,qDAAqD;YACrD,IAAI,cAAc,EAAE,CAAC;gBACnB,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YAEhD,uCAAuC;YACvC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC3B,KAAK,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;oBACzF,IAAI,CAAC,cAAc,CACjB,cAAc,EACd,iBAAiB,EACjB;wBACE,UAAU;wBACV,MAAM;wBACN,WAAW,EAAE,CAAC;qBACf,EACD,KAAK,GAAG,CAAC,EACT,IAAI,EACJ,QAAQ,CAAE,gDAAgD;qBAC3D,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3C,gDAAgD;YAChD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACzD,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,6BAA6B;YAC7B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACzB,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3E,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;wBACnC,4BAA4B;wBAC5B,IAAI,UAAU,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;4BACpD,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;4BACjE,IAAI,UAAU,EAAE,CAAC;gCACf,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;4BACtC,CAAC;wBACH,CAAC;wBACD,yEAAyE;6BACpE,IAAI,UAAU,CAAC,UAAU,CAAC,qCAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;4BACvD,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;4BACvD,IAAI,cAAc,EAAE,CAAC;gCACnB,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;4BAC1C,CAAC;wBACH,CAAC;wBACD,mFAAmF;wBACnF,8EAA8E;wBAC9E,+DAA+D;oBACjE,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,IAAI,CAAC,6BAA6B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,6BAA6B,CAAC,MAAuB,EAAE,UAAsB;QACnF,+BAA+B;QAC/B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChF,iEAAiE;gBACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAClE,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAC5C,KAAK,CAAC,aAAa,EACnB,UAAU,EACV,iBAAiB,CAClB,CAAC;oBACF,IAAI,UAAU,EAAE,CAAC;wBACf,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBACtC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,WAAmB,EAAE,aAA8B;QAC9E,6EAA6E;QAC7E,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB;QAEhE,2CAA2C;QAC3C,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5C,+BAA+B;QAC/B,IAAI,YAAoB,CAAC;QACzB,IAAI,QAAgB,CAAC;QAErB,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,+BAA+B;YAC/B,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC;YACxC,QAAQ,GAAG,WAAW,CAAC;QACzB,CAAC;QAED,0CAA0C;QAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;gBACnB,IAAI,aAAa,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAEjC,oEAAoE;gBACpE,oDAAoD;gBACpD,IAAI,aAAa,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvD,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;oBACjF,IAAI,gBAAgB,EAAE,CAAC;wBACrB,iDAAiD;wBACjD,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;wBACjD,+DAA+D;wBAC/D,oCAAoC;oBACtC,CAAC;gBACH,CAAC;gBACD,2DAA2D;qBACtD,IAAI,aAAa,CAAC,UAAU,CAAC,qCAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1D,gCAAgC;oBAChC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;oBACvD,IAAI,OAAO,EAAE,CAAC;wBACZ,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC1C,CAAC;oBACD,kFAAkF;gBACpF,CAAC;gBACD,6DAA6D;gBAC7D,+EAA+E;qBAC1E,IAAI,aAAa,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,aAAa,EAAE,CAAC;oBAC3F,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,qCAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAE7E,qCAAqC;oBACrC,MAAM,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC;wBACzD,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC;oBAEhF,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;wBACnD,yEAAyE;wBACzE,IAAI,WAAW,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;4BACrD,mDAAmD;4BACnD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAClD,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,aAAc,CAAC,MAAM;gCAChD,CAAC,CAAC,UAAU,KAAK,aAAa,CAAC,aAAc,CAAC,UAAU,CACzD,CAAC;4BAEF,IAAI,YAAY,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;gCAC/C,MAAM,gBAAgB,GAAG,WAAW,CAAC,SAAS,CAAC,qCAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gCAChF,MAAM,gBAAgB,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC;oCAC7D,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAC;gCACzF,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oCAClG,aAAa,GAAG,gBAAgB,CAAC;gCACnC,CAAC;4BACH,CAAC;wBACH,CAAC;6BAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;4BACxC,aAAa,GAAG,WAAW,CAAC;wBAC9B,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,IAAI,SAAS,CAAC,UAAU,KAAK,YAAY;gBAAE,SAAS;YACpD,IAAI,SAAS,CAAC,EAAE,KAAK,aAAa,CAAC,EAAE;gBAAE,SAAS,CAAC,YAAY;YAE7D,8BAA8B;YAC9B,IAAI,QAAQ,GAAG,IAAI,CAAC;YACpB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;gBACzC,IAAI,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC;oBAChC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC1D,IAAI,WAAW,GAAG,KAAK,CAAC;gBAExB,sDAAsD;gBACtD,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;oBACzH,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,qCAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC9E,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC;oBACpD,cAAc,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC;oBAE9F,0EAA0E;oBAC1E,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC9F,oDAAoD;wBACpD,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACrD,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,aAAc,CAAC,MAAM;4BAC5C,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,aAAc,CAAC,UAAU,CACrD,CAAC;wBACF,IAAI,eAAe,EAAE,aAAa,EAAE,CAAC;4BACnC,MAAM,gBAAgB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;4BACrD,cAAc,GAAG,eAAe,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC;gCAChE,eAAe,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAC;wBACtF,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,wDAAwD;gBACxD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtF,6DAA6D;oBAC7D,IAAI,WAAW,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,aAAa,EAAE,CAAC;wBACpF,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,qCAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;wBAC3E,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC;4BACzD,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC;wBAE1E,gEAAgE;wBAChE,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;4BACxF,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACnD,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,aAAc,CAAC,MAAM;gCAChD,CAAC,CAAC,UAAU,KAAK,aAAa,CAAC,aAAc,CAAC,UAAU,CACzD,CAAC;4BACF,IAAI,aAAa,EAAE,aAAa,EAAE,CAAC;gCACjC,MAAM,gBAAgB,GAAG,WAAW,CAAC,SAAS,CAAC,qCAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gCAChF,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC;oCAC9D,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAC;4BACjF,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,yFAAyF;gBACzF,oDAAoD;gBACpD,IAAI,KAAK,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,IAAI,cAAc,KAAK,KAAK;oBACtE,aAAa,CAAC,aAAa,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;oBAC3D,sCAAsC;oBACtC,IAAI,aAAa,CAAC,aAAa,CAAC,MAAM,KAAK,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;wBAC1E,oEAAoE;wBACpE,SAAS,CAAC,yBAAyB;oBACrC,CAAC;gBACH,CAAC;gBAED,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;oBACnC,QAAQ,GAAG,KAAK,CAAC;oBACjB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,MAAuB;QAChD,8DAA8D;QAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,4CAA4C;QAC5C,IAAI,OAAO,GAAG,MAAM,CAAC;QACrB,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC;YAC7B,sDAAsD;YACtD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAClD,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,aAAc,CAAC,MAAM;gBAC1C,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,aAAc,CAAC,UAAU,CACnD,CAAC;YAEF,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,uCAAuC;gBACvC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,8CAA8C;YAC9C,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;gBAChC,OAAO,YAAY,CAAC,EAAE,CAAC;YACzB,CAAC;YAED,OAAO,GAAG,YAAY,CAAC;QACzB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,UAAkB,EAClB,eAAuB,EACvB,UAAsB;QAEtB,6BAA6B;QAC7B,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QACxD,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAElC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,IAAI,SAAS,CAAC,UAAU,KAAK,UAAU;gBAAE,SAAS;YAElD,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,eAAe,CAAC;gBAC/C,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,eAAe,CAAC,CAAC;YACjE,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;gBACvC,OAAO,SAAS,CAAC,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,UAAkB;QACtC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACpD,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,0BAA0B;QAChC,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QAEzC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,IAAc,EAAW,EAAE;YAChE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;oBACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxB,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;4BAClC,OAAO,IAAI,CAAC;wBACd,CAAC;oBACH,CAAC;yBAAM,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrC,gBAAgB;wBAChB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;wBACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;wBACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB;wBACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACnB,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;YAED,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QAEF,+BAA+B;QAC/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAW,EAAE;YAC1C,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,qDAAqD;gBACrD,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,2BAA2B;gBAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;oBACxC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACf,CAAC;YACH,CAAC;YAED,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEtB,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,qEAAqE;QACrE,8CAA8C;QAC9C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,uBAAuB,CAC7B,aAAgC,EAChC,eAAyC;QAEzC,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE/C,sCAAsC;QACtC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;YAE5B,6CAA6C;YAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,kBAAkB,EAAE,CAAC;oBAC5D,kBAAkB,GAAG,QAAQ,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,8DAA8D;YAC9D,MAAM,WAAW,GAAG,kBAAkB,GAAG,CAAC,CAAC;YAC3C,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAEzC,qCAAqC;YACrC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YAC3B,CAAC;YACD,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACI,yBAAyB,CAC9B,OAA0B;QAE1B,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;QAE1D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,yCAAyC;YACzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxC,oDAAoD;gBACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC5B,CAAC;gBAED,UAAU,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC;oBAC1B,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,MAAM,CAAC,EAAE;oBACtB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,SAAS,EAAE,IAAI,CAAC,gCAAgC,CAAC,MAAM,EAAE,KAAK,CAAC;oBAC/D,QAAQ,EAAE,MAAM,CAAC,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACK,gCAAgC,CACtC,MAAuB,EACvB,YAAoB;QAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAElC,+BAA+B;QAC/B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEtD,sDAAsD;YACtD,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACjD,4BAA4B;gBAC5B,IAAI,UAAU,CAAC,UAAU,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;oBACpD,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;oBAClE,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;wBACjC,OAAO,KAAK,CAAC,IAAI,CAAC;oBACpB,CAAC;gBACH,CAAC;gBACD,mCAAmC;qBAC9B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;oBAClE,IAAI,iBAAiB,EAAE,CAAC;wBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,sBAAsB,CACrC,KAAK,CAAC,aAAa,EACnB,UAAU,EACV,iBAAiB,CAClB,CAAC;wBACF,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;4BACzB,OAAO,KAAK,CAAC,IAAI,CAAC;wBACpB,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACI,sBAAsB,CAC3B,OAA0B,EAC1B,mBAAqD;QAErD,+DAA+D;QAC/D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE/C,wEAAwE;QACxE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;YAE5B,6EAA6E;YAC7E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,kBAAkB,EAAE,CAAC;oBAC5D,kBAAkB,GAAG,QAAQ,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,8DAA8D;YAC9D,MAAM,WAAW,GAAG,kBAAkB,GAAG,CAAC,CAAC;YAC3C,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC3C,CAAC;QAED,yBAAyB;QACzB,MAAM,aAAa,GAAwB,EAAE,CAAC;QAC9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAE/C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAC5B,CAAC;YACD,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,uCAAuC;QACvC,iDAAiD;QACjD,mDAAmD;QACnD,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACI,wBAAwB,CAC7B,SAAsB,EACtB,mBAAqD;QAErD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,wCAAwC;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEpC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAChC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACpC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEtB,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAErD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,8BAA8B;gBAC9B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAEhC,sCAAsC;gBACtC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAptBD,4DAotBC","sourcesContent":["import { Metadata, EntityInfo } from '@memberjunction/core';\nimport { RecordData } from './sync-engine';\nimport { METADATA_KEYWORDS, isNonKeywordAtSymbol } from '../constants/metadata-keywords';\n\n/**\n * Represents a flattened record with its context and dependencies\n */\nexport interface FlattenedRecord {\n  record: RecordData;\n  entityName: string;\n  parentContext?: {\n    entityName: string;\n    record: RecordData;\n    recordIndex: number;\n  };\n  depth: number;\n  path: string; // Path to this record for debugging\n  dependencies: Set<string>; // Set of record IDs this record depends on\n  id: string; // Unique identifier for this record in the flattened list\n  originalIndex: number; // Original index in the source array\n}\n\n/**\n * Represents a reverse dependency relationship\n * (which records depend on a given record)\n */\nexport interface ReverseDependency {\n  recordId: string;           // The record being referenced\n  dependentId: string;        // The record that depends on it\n  entityName: string;         // Entity of the dependent\n  fieldName: string | null;   // Foreign key field name (if known)\n  filePath: string;           // Location of dependent record\n}\n\n/**\n * Result of dependency analysis\n */\nexport interface DependencyAnalysisResult {\n  sortedRecords: FlattenedRecord[];\n  circularDependencies: string[][];\n  dependencyGraph: Map<string, Set<string>>;\n  dependencyLevels?: FlattenedRecord[][]; // Records grouped by dependency level for parallel processing\n}\n\n/**\n * Analyzes and sorts records based on their dependencies\n */\nexport class RecordDependencyAnalyzer {\n  private metadata: Metadata;\n  private flattenedRecords: FlattenedRecord[] = [];\n  private recordIdMap: Map<string, FlattenedRecord> = new Map();\n  private entityInfoCache: Map<string, EntityInfo> = new Map();\n  private recordCounter: number = 0;\n\n  constructor() {\n    this.metadata = new Metadata();\n  }\n\n  /**\n   * Main entry point: analyzes all records in a file and returns them in dependency order\n   */\n  public async analyzeFileRecords(\n    records: RecordData[],\n    entityName: string\n  ): Promise<DependencyAnalysisResult> {\n    // Reset state\n    this.flattenedRecords = [];\n    this.recordIdMap.clear();\n    this.recordCounter = 0;\n\n    // Step 1: Flatten all records (including nested relatedEntities)\n    this.flattenRecords(records, entityName);\n\n    // Step 2: Analyze dependencies between all flattened records\n    this.analyzeDependencies();\n\n    // Step 3: Detect circular dependencies\n    const circularDeps = this.detectCircularDependencies();\n\n    // Step 4: Perform topological sort\n    const sortedRecords = this.topologicalSort();\n\n    // Step 5: Build dependency graph for debugging\n    const dependencyGraph = new Map<string, Set<string>>();\n    for (const record of this.flattenedRecords) {\n      dependencyGraph.set(record.id, record.dependencies);\n    }\n\n    // Step 6: Group records into dependency levels for parallel processing\n    const dependencyLevels = this.groupByDependencyLevels(sortedRecords, dependencyGraph);\n\n    return {\n      sortedRecords,\n      circularDependencies: circularDeps,\n      dependencyGraph,\n      dependencyLevels\n    };\n  }\n\n  /**\n   * Flattens all records including nested relatedEntities\n   */\n  private flattenRecords(\n    records: RecordData[],\n    entityName: string,\n    parentContext?: FlattenedRecord['parentContext'],\n    depth: number = 0,\n    pathPrefix: string = '',\n    parentRecordId?: string\n  ): void {\n    for (let i = 0; i < records.length; i++) {\n      const record = records[i];\n      const recordId = `${entityName}_${this.recordCounter++}`;\n      const path = pathPrefix ? `${pathPrefix}/${entityName}[${i}]` : `${entityName}[${i}]`;\n\n      // Validate that the record has a 'fields' property (required)\n      if (!record.fields) {\n        const hint = 'field' in record ? ' Did you mean \"fields\" instead of \"field\"?' : '';\n        throw new Error(\n          `Record at ${path} is missing required \"fields\" property.${hint} ` +\n          `Each record must have a \"fields\" object containing the entity field values.`\n        );\n      }\n\n      const flattenedRecord: FlattenedRecord = {\n        record,\n        entityName,\n        parentContext,\n        depth,\n        path,\n        dependencies: new Set(),\n        id: recordId,\n        originalIndex: i\n      };\n\n      // If this has a parent, add dependency on the parent\n      if (parentRecordId) {\n        flattenedRecord.dependencies.add(parentRecordId);\n      }\n\n      this.flattenedRecords.push(flattenedRecord);\n      this.recordIdMap.set(recordId, flattenedRecord);\n\n      // Recursively flatten related entities\n      if (record.relatedEntities) {\n        for (const [relatedEntityName, relatedRecords] of Object.entries(record.relatedEntities)) {\n          this.flattenRecords(\n            relatedRecords,\n            relatedEntityName,\n            {\n              entityName,\n              record,\n              recordIndex: i\n            },\n            depth + 1,\n            path,\n            recordId  // Pass current record ID as parent for children\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Analyzes dependencies between all flattened records\n   */\n  private analyzeDependencies(): void {\n    for (const record of this.flattenedRecords) {\n      // Get entity info for foreign key relationships\n      const entityInfo = this.getEntityInfo(record.entityName);\n      if (!entityInfo) continue;\n\n      // Analyze field dependencies\n      if (record.record.fields) {\n        for (const [fieldName, fieldValue] of Object.entries(record.record.fields)) {\n          if (typeof fieldValue === 'string') {\n            // Handle @lookup references\n            if (fieldValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n              const dependency = this.findLookupDependency(fieldValue, record);\n              if (dependency) {\n                record.dependencies.add(dependency);\n              }\n            }\n            // Handle @root references - these create dependencies on the root record\n            else if (fieldValue.startsWith(METADATA_KEYWORDS.ROOT)) {\n              const rootDependency = this.findRootDependency(record);\n              if (rootDependency) {\n                record.dependencies.add(rootDependency);\n              }\n            }\n            // @parent references don't create explicit dependencies in our flattened structure\n            // because parent is guaranteed to be processed before children due to the way\n            // we flatten records (parent always comes before its children)\n          }\n        }\n      }\n\n      // Check foreign key dependencies\n      this.analyzeForeignKeyDependencies(record, entityInfo);\n    }\n  }\n\n  /**\n   * Analyzes foreign key dependencies based on EntityInfo\n   */\n  private analyzeForeignKeyDependencies(record: FlattenedRecord, entityInfo: EntityInfo): void {\n    // Check all foreign key fields\n    for (const field of entityInfo.ForeignKeys) {\n      const fieldValue = record.record.fields?.[field.Name];\n      if (fieldValue && typeof fieldValue === 'string' && !fieldValue.startsWith('@')) {\n        // This is a direct foreign key value, find the referenced record\n        const relatedEntityInfo = this.getEntityInfo(field.RelatedEntity);\n        if (relatedEntityInfo) {\n          const dependency = this.findRecordByPrimaryKey(\n            field.RelatedEntity,\n            fieldValue,\n            relatedEntityInfo\n          );\n          if (dependency) {\n            record.dependencies.add(dependency);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Finds a record that matches a @lookup reference\n   */\n  private findLookupDependency(lookupValue: string, currentRecord: FlattenedRecord): string | null {\n    // Parse lookup format: @lookup:EntityName.Field=Value or @lookup:Field=Value\n    const lookupStr = lookupValue.substring(8); // Remove '@lookup:'\n    \n    // Handle the ?create syntax by removing it\n    const cleanLookup = lookupStr.split('?')[0];\n    \n    // Parse entity name if present\n    let targetEntity: string;\n    let criteria: string;\n    \n    if (cleanLookup.includes('.')) {\n      const parts = cleanLookup.split('.');\n      targetEntity = parts[0];\n      criteria = parts.slice(1).join('.');\n    } else {\n      // Same entity if not specified\n      targetEntity = currentRecord.entityName;\n      criteria = cleanLookup;\n    }\n\n    // Parse criteria (can be multiple with &)\n    const criteriaMap = new Map<string, string>();\n    for (const pair of criteria.split('&')) {\n      const [field, value] = pair.split('=');\n      if (field && value) {\n        let resolvedValue = value.trim();\n        \n        // Special handling for nested @lookup references in lookup criteria\n        // This creates a dependency on the looked-up record\n        if (resolvedValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n          const nestedDependency = this.findLookupDependency(resolvedValue, currentRecord);\n          if (nestedDependency) {\n            // Add this as a dependency of the current record\n            currentRecord.dependencies.add(nestedDependency);\n            // Continue processing - we can't resolve the actual value here\n            // but we've recorded the dependency\n          }\n        }\n        // Special handling for @root references in lookup criteria\n        else if (resolvedValue.startsWith(METADATA_KEYWORDS.ROOT)) {\n          // Add dependency on root record\n          const rootDep = this.findRootDependency(currentRecord);\n          if (rootDep) {\n            currentRecord.dependencies.add(rootDep);\n          }\n          // Note: We can't resolve the actual value here, but we've recorded the dependency\n        }\n        // Special handling for @parent references in lookup criteria\n        // If the value is @parent:field, we need to resolve it from the parent context\n        else if (resolvedValue.startsWith(METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {\n          const parentField = resolvedValue.substring(METADATA_KEYWORDS.PARENT.length);\n          \n          // Try to resolve from parent context\n          const parentValue = currentRecord.parentContext.record.fields?.[parentField] ||\n                             currentRecord.parentContext.record.primaryKey?.[parentField];\n          \n          if (parentValue && typeof parentValue === 'string') {\n            // Check if parent value is also a @parent reference (nested parent refs)\n            if (parentValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n              // Find the parent record to get its parent context\n              const parentRecord = this.flattenedRecords.find(r =>\n                r.record === currentRecord.parentContext!.record &&\n                r.entityName === currentRecord.parentContext!.entityName\n              );\n\n              if (parentRecord && parentRecord.parentContext) {\n                const grandParentField = parentValue.substring(METADATA_KEYWORDS.PARENT.length);\n                const grandParentValue = parentRecord.parentContext.record.fields?.[grandParentField] ||\n                                        parentRecord.parentContext.record.primaryKey?.[grandParentField];\n                if (grandParentValue && typeof grandParentValue === 'string' && !grandParentValue.startsWith('@')) {\n                  resolvedValue = grandParentValue;\n                }\n              }\n            } else if (!parentValue.startsWith('@')) {\n              resolvedValue = parentValue;\n            }\n          }\n        }\n        \n        criteriaMap.set(field.trim(), resolvedValue);\n      }\n    }\n\n    // Find matching record in our flattened list\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== targetEntity) continue;\n      if (candidate.id === currentRecord.id) continue; // Skip self\n\n      // Check if all criteria match\n      let allMatch = true;\n      for (const [field, value] of criteriaMap) {\n        let candidateValue = candidate.record.fields?.[field] || \n                             candidate.record.primaryKey?.[field];\n        let lookupValue = value;\n        \n        // Resolve candidate value if it's a @parent reference\n        if (typeof candidateValue === 'string' && candidateValue.startsWith(METADATA_KEYWORDS.PARENT) && candidate.parentContext) {\n          const parentField = candidateValue.substring(METADATA_KEYWORDS.PARENT.length);\n          const parentRecord = candidate.parentContext.record;\n          candidateValue = parentRecord.fields?.[parentField] || parentRecord.primaryKey?.[parentField];\n\n          // If the parent field is also a @parent reference, resolve it recursively\n          if (typeof candidateValue === 'string' && candidateValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n            // Find the candidate's parent in our flattened list\n            const candidateParent = this.flattenedRecords.find(r => \n              r.record === candidate.parentContext!.record && \n              r.entityName === candidate.parentContext!.entityName\n            );\n            if (candidateParent?.parentContext) {\n              const grandParentField = candidateValue.substring(8);\n              candidateValue = candidateParent.parentContext.record.fields?.[grandParentField] || \n                              candidateParent.parentContext.record.primaryKey?.[grandParentField];\n            }\n          }\n        }\n        \n        // Resolve lookup value if it contains @parent reference\n        if (typeof lookupValue === 'string' && lookupValue.includes(METADATA_KEYWORDS.PARENT)) {\n          // Handle cases like \"@parent:AgentID\" or embedded references\n          if (lookupValue.startsWith(METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {\n            const parentField = lookupValue.substring(METADATA_KEYWORDS.PARENT.length);\n            lookupValue = currentRecord.parentContext.record.fields?.[parentField] ||\n                         currentRecord.parentContext.record.primaryKey?.[parentField];\n\n            // If still a reference, try to resolve from the parent's parent\n            if (typeof lookupValue === 'string' && lookupValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n              const currentParent = this.flattenedRecords.find(r =>\n                r.record === currentRecord.parentContext!.record &&\n                r.entityName === currentRecord.parentContext!.entityName\n              );\n              if (currentParent?.parentContext) {\n                const grandParentField = lookupValue.substring(METADATA_KEYWORDS.PARENT.length);\n                lookupValue = currentParent.parentContext.record.fields?.[grandParentField] ||\n                             currentParent.parentContext.record.primaryKey?.[grandParentField];\n              }\n            }\n          }\n        }\n\n        // Special case: if both values are @parent references pointing to the same parent field,\n        // and they have the same parent context, they match\n        if (value.startsWith(METADATA_KEYWORDS.PARENT) && candidateValue === value && \n            currentRecord.parentContext && candidate.parentContext) {\n          // Check if they share the same parent\n          if (currentRecord.parentContext.record === candidate.parentContext.record) {\n            // Same parent, same reference - they will resolve to the same value\n            continue; // This criterion matches\n          }\n        }\n        \n        if (candidateValue !== lookupValue) {\n          allMatch = false;\n          break;\n        }\n      }\n\n      if (allMatch) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Finds the root record for a given record\n   */\n  private findRootDependency(record: FlattenedRecord): string | null {\n    // If this record has no parent, it IS the root, no dependency\n    if (!record.parentContext) {\n      return null;\n    }\n    \n    // Walk up the parent chain to find the root\n    let current = record;\n    while (current.parentContext) {\n      // Try to find the parent record in our flattened list\n      const parentRecord = this.flattenedRecords.find(r => \n        r.record === current.parentContext!.record && \n        r.entityName === current.parentContext!.entityName\n      );\n      \n      if (!parentRecord) {\n        // Parent not found, something is wrong\n        return null;\n      }\n      \n      // If this parent has no parent, it's the root\n      if (!parentRecord.parentContext) {\n        return parentRecord.id;\n      }\n      \n      current = parentRecord;\n    }\n    \n    return null;\n  }\n\n  /**\n   * Finds a record by its primary key value\n   */\n  private findRecordByPrimaryKey(\n    entityName: string,\n    primaryKeyValue: string,\n    entityInfo: EntityInfo\n  ): string | null {\n    // Get primary key field name\n    const primaryKeyField = entityInfo.PrimaryKeys[0]?.Name;\n    if (!primaryKeyField) return null;\n\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== entityName) continue;\n\n      const candidateValue = candidate.record.primaryKey?.[primaryKeyField] ||\n                            candidate.record.fields?.[primaryKeyField];\n      if (candidateValue === primaryKeyValue) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets EntityInfo from cache or metadata\n   */\n  private getEntityInfo(entityName: string): EntityInfo | null {\n    if (!this.entityInfoCache.has(entityName)) {\n      const info = this.metadata.EntityByName(entityName);\n      if (info) {\n        this.entityInfoCache.set(entityName, info);\n      }\n    }\n    return this.entityInfoCache.get(entityName) || null;\n  }\n\n  /**\n   * Detects circular dependencies in the dependency graph\n   */\n  private detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const detectCycle = (recordId: string, path: string[]): boolean => {\n      visited.add(recordId);\n      recursionStack.add(recordId);\n      path.push(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        for (const depId of record.dependencies) {\n          if (!visited.has(depId)) {\n            if (detectCycle(depId, [...path])) {\n              return true;\n            }\n          } else if (recursionStack.has(depId)) {\n            // Found a cycle\n            const cycleStart = path.indexOf(depId);\n            const cycle = path.slice(cycleStart);\n            cycle.push(depId); // Complete the cycle\n            cycles.push(cycle);\n            return true;\n          }\n        }\n      }\n\n      recursionStack.delete(recordId);\n      return false;\n    };\n\n    // Check all records for cycles\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        detectCycle(record.id, []);\n      }\n    }\n\n    return cycles;\n  }\n\n  /**\n   * Performs topological sort on the dependency graph\n   */\n  private topologicalSort(): FlattenedRecord[] {\n    const result: FlattenedRecord[] = [];\n    const visited = new Set<string>();\n    const tempStack = new Set<string>();\n\n    const visit = (recordId: string): boolean => {\n      if (tempStack.has(recordId)) {\n        // Circular dependency - we've already detected these\n        return false;\n      }\n\n      if (visited.has(recordId)) {\n        return true;\n      }\n\n      tempStack.add(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        // Visit dependencies first\n        for (const depId of record.dependencies) {\n          visit(depId);\n        }\n      }\n\n      tempStack.delete(recordId);\n      visited.add(recordId);\n      \n      if (record) {\n        result.push(record);\n      }\n\n      return true;\n    };\n\n    // Process all records, starting with those that have no dependencies\n    // First, process records with no dependencies\n    for (const record of this.flattenedRecords) {\n      if (record.dependencies.size === 0 && !visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    // Then process any remaining records (handles disconnected components)\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Groups sorted records into dependency levels for parallel processing\n   * Records in the same level have no dependencies on each other and can be processed in parallel\n   */\n  private groupByDependencyLevels(\n    sortedRecords: FlattenedRecord[],\n    dependencyGraph: Map<string, Set<string>>\n  ): FlattenedRecord[][] {\n    const levels: FlattenedRecord[][] = [];\n    const recordLevels = new Map<string, number>();\n    \n    // Calculate the level for each record\n    for (const record of sortedRecords) {\n      let maxDependencyLevel = -1;\n      \n      // Find the maximum level of all dependencies\n      for (const depId of record.dependencies) {\n        const depLevel = recordLevels.get(depId);\n        if (depLevel !== undefined && depLevel > maxDependencyLevel) {\n          maxDependencyLevel = depLevel;\n        }\n      }\n      \n      // This record's level is one more than its highest dependency\n      const recordLevel = maxDependencyLevel + 1;\n      recordLevels.set(record.id, recordLevel);\n      \n      // Add to the appropriate level array\n      if (!levels[recordLevel]) {\n        levels[recordLevel] = [];\n      }\n      levels[recordLevel].push(record);\n    }\n    \n    return levels;\n  }\n\n  /**\n   * Build reverse dependency map from forward dependencies\n   * Maps: record ID -> list of records that depend on it\n   *\n   * This is essential for deletion ordering - we need to know what depends on a record\n   * before we can safely delete it.\n   */\n  public buildReverseDependencyMap(\n    records: FlattenedRecord[]\n  ): Map<string, ReverseDependency[]> {\n    const reverseMap = new Map<string, ReverseDependency[]>();\n\n    for (const record of records) {\n      // For each dependency this record has...\n      for (const depId of record.dependencies) {\n        // Add this record as a dependent of that dependency\n        if (!reverseMap.has(depId)) {\n          reverseMap.set(depId, []);\n        }\n\n        reverseMap.get(depId)!.push({\n          recordId: depId,\n          dependentId: record.id,\n          entityName: record.entityName,\n          fieldName: this.findForeignKeyFieldForDependency(record, depId),\n          filePath: record.path\n        });\n      }\n    }\n\n    return reverseMap;\n  }\n\n  /**\n   * Find the foreign key field that creates a dependency\n   * Used for better error reporting\n   */\n  private findForeignKeyFieldForDependency(\n    record: FlattenedRecord,\n    dependencyId: string\n  ): string | null {\n    const entityInfo = this.getEntityInfo(record.entityName);\n    if (!entityInfo) return null;\n\n    const dependentRecord = this.recordIdMap.get(dependencyId);\n    if (!dependentRecord) return null;\n\n    // Check all foreign key fields\n    for (const field of entityInfo.ForeignKeys) {\n      const fieldValue = record.record.fields?.[field.Name];\n\n      // Check if this field references the dependent record\n      if (fieldValue && typeof fieldValue === 'string') {\n        // Handle @lookup references\n        if (fieldValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n          const resolvedDep = this.findLookupDependency(fieldValue, record);\n          if (resolvedDep === dependencyId) {\n            return field.Name;\n          }\n        }\n        // Handle direct foreign key values\n        else if (!fieldValue.startsWith('@')) {\n          const relatedEntityInfo = this.getEntityInfo(field.RelatedEntity);\n          if (relatedEntityInfo) {\n            const dep = this.findRecordByPrimaryKey(\n              field.RelatedEntity,\n              fieldValue,\n              relatedEntityInfo\n            );\n            if (dep === dependencyId) {\n              return field.Name;\n            }\n          }\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Perform reverse topological sort for deletion order\n   * Returns records grouped by dependency level, with leaf nodes (highest dependency level) first\n   *\n   * For deletions, we want to delete in reverse order of creation:\n   * - Records at highest forward dependency levels (leaf nodes) delete FIRST\n   * - Records at level 0 (root nodes with no dependencies) delete LAST\n   *\n   * This is simply the reverse of the forward topological sort used for creates.\n   */\n  public reverseTopologicalSort(\n    records: FlattenedRecord[],\n    reverseDependencies: Map<string, ReverseDependency[]>\n  ): FlattenedRecord[][] {\n    // Calculate forward dependency levels (same as creation order)\n    const recordLevels = new Map<string, number>();\n\n    // Calculate the level for each record based on its FORWARD dependencies\n    for (const record of records) {\n      let maxDependencyLevel = -1;\n\n      // Find the maximum level of all dependencies (things this record depends ON)\n      for (const depId of record.dependencies) {\n        const depLevel = recordLevels.get(depId);\n        if (depLevel !== undefined && depLevel > maxDependencyLevel) {\n          maxDependencyLevel = depLevel;\n        }\n      }\n\n      // This record's level is one more than its highest dependency\n      const recordLevel = maxDependencyLevel + 1;\n      recordLevels.set(record.id, recordLevel);\n    }\n\n    // Group records by level\n    const forwardLevels: FlattenedRecord[][] = [];\n    for (const record of records) {\n      const level = recordLevels.get(record.id) || 0;\n\n      if (!forwardLevels[level]) {\n        forwardLevels[level] = [];\n      }\n      forwardLevels[level].push(record);\n    }\n\n    // Reverse the array for deletion order\n    // Forward level 0 (roots) becomes last to delete\n    // Forward level N (leaves) becomes first to delete\n    return forwardLevels.reverse();\n  }\n\n  /**\n   * Find all transitive dependents of a set of records\n   * This is useful for finding all records that must be deleted when deleting a parent\n   *\n   * @param recordIds Set of record IDs to find dependents for\n   * @param reverseDependencies Reverse dependency map\n   * @returns Set of all record IDs that depend on the input records (transitively)\n   */\n  public findTransitiveDependents(\n    recordIds: Set<string>,\n    reverseDependencies: Map<string, ReverseDependency[]>\n  ): Set<string> {\n    const dependents = new Set<string>();\n    const visited = new Set<string>();\n\n    // BFS to find all transitive dependents\n    const queue = Array.from(recordIds);\n\n    while (queue.length > 0) {\n      const recordId = queue.shift()!;\n      if (visited.has(recordId)) continue;\n      visited.add(recordId);\n\n      const deps = reverseDependencies.get(recordId) || [];\n\n      for (const dep of deps) {\n        // Add dependent to result set\n        dependents.add(dep.dependentId);\n\n        // Queue for processing its dependents\n        queue.push(dep.dependentId);\n      }\n    }\n\n    return dependents;\n  }\n}"]}

package/dist/services/PushService.d.ts

@@ -45,6 +45,13 @@ export declare class PushService {
     private deferredFileWrites;
     private deferredRecords;
     constructor(syncEngine: SyncEngine, contextUser: UserInfo);
+    /**
+     * Determines whether to emit __mj_sync_notes based on config hierarchy.
+     * Entity config takes precedence over root config. Defaults to false.
+     * @param entityConfig - The entity-specific configuration (if available)
+     * @returns true if sync notes should be emitted, false otherwise
+     */
+    private shouldEmitSyncNotes;
     push(options: PushOptions, callbacks?: PushCallbacks): Promise<PushResult>;
     private processEntityDirectory;
     private processFlattenedRecord;

package/dist/services/PushService.js

@@ -26,13 +26,27 @@ class PushService {
     syncEngine;
     contextUser;
     warnings = [];
-    syncConfig;
+    syncConfig = null;
     deferredFileWrites = new Map();
     deferredRecords = [];
     constructor(syncEngine, contextUser) {
         this.syncEngine = syncEngine;
         this.contextUser = contextUser;
     }
+    /**
+     * Determines whether to emit __mj_sync_notes based on config hierarchy.
+     * Entity config takes precedence over root config. Defaults to false.
+     * @param entityConfig - The entity-specific configuration (if available)
+     * @returns true if sync notes should be emitted, false otherwise
+     */
+    shouldEmitSyncNotes(entityConfig) {
+        // Entity config takes precedence if explicitly set
+        if (entityConfig?.emitSyncNotes !== undefined) {
+            return entityConfig.emitSyncNotes;
+        }
+        // Fall back to root config, default to false
+        return this.syncConfig?.emitSyncNotes ?? false;
+    }
     async push(options, callbacks) {
         this.warnings = [];
         // Validate that include and exclude are not used together
@@ -80,7 +94,7 @@ class PushService {
                 if (provider && typeof provider.CreateSqlLogger === 'function') {
                     // Generate filename with timestamp
                     const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-                    const filename = this.syncConfig.sqlLogging?.formatAsMigration
+                    const filename = this.syncConfig?.sqlLogging?.formatAsMigration
                         ? `MetadataSync_Push_${timestamp}.sql`
                         : `push_${timestamp}.sql`;
                     // Use .sql-log-push directory in the config directory (where sync was initiated)
@@ -90,12 +104,12 @@ class PushService {
                     await fs_extra_1.default.ensureDir(path_1.default.dirname(filepath));
                     // Create the SQL logging session
                     sqlLoggingSession = await provider.CreateSqlLogger(filepath, {
-                        formatAsMigration: this.syncConfig.sqlLogging?.formatAsMigration || false,
+                        formatAsMigration: this.syncConfig?.sqlLogging?.formatAsMigration || false,
                         description: 'MetadataSync push operation',
                         statementTypes: "mutations",
                         prettyPrint: true,
-                        filterPatterns: this.syncConfig.sqlLogging?.filterPatterns,
-                        filterType: this.syncConfig.sqlLogging?.filterType,
+                        filterPatterns: this.syncConfig?.sqlLogging?.filterPatterns,
+                        filterType: this.syncConfig?.sqlLogging?.filterType,
                     });
                     if (options.verbose) {
                         callbacks?.onLog?.(`📝 SQL logging enabled: ${filepath}`);
@@ -933,21 +947,27 @@ class PushService {
         }
         // Restore original field values to preserve @ references
         record.fields = originalFields;
-        // Only update __mj_sync_notes if the record was actually dirty (changed)
-        // For unchanged records, preserve existing notes to maintain stability
-        if (isNew || isDirty) {
-            // Update __mj_sync_notes with resolution information
-            // This helps users understand how @lookup and @parent references were resolved
-            // Use type assertion through unknown to handle the dynamic property
-            const recordWithNotes = record;
-            if (resolutionCollector.notes.length > 0) {
-                recordWithNotes.__mj_sync_notes = resolutionCollector.notes;
-            }
-            else {
-                // Remove existing notes if no resolutions were tracked
-                delete recordWithNotes.__mj_sync_notes;
+        // Handle __mj_sync_notes based on emitSyncNotes config setting
+        // Use type assertion through unknown to handle the dynamic property
+        const recordWithNotes = record;
+        const emitNotes = this.shouldEmitSyncNotes(entityConfig);
+        if (emitNotes) {
+            // Only update __mj_sync_notes if the record was actually dirty (changed)
+            // For unchanged records, preserve existing notes to maintain stability
+            if (isNew || isDirty) {
+                if (resolutionCollector.notes.length > 0) {
+                    recordWithNotes.__mj_sync_notes = resolutionCollector.notes;
+                }
+                else {
+                    // Remove existing notes if no resolutions were tracked
+                    delete recordWithNotes.__mj_sync_notes;
+                }
             }
         }
+        else {
+            // emitSyncNotes is disabled - always remove existing notes
+            delete recordWithNotes.__mj_sync_notes;
+        }
         // Return appropriate status
         // If we had deferred lookups, return 'deferred' to indicate partial save
         // The record is saved but will be re-processed in Phase 2.5