claude-flow-novice 2.15.3 → 2.15.4

package/dist/lib/idempotent-write.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/idempotent-write.ts"],"sourcesContent":["/**\r\n * Idempotent Write Utility\r\n *\r\n * Provides content-based deduplication for metrics logging using SHA256 hashing.\r\n * Part of Task 2.3: Unified Metrics and Execution Logging\r\n *\r\n * Features:\r\n * - Content-based idempotency keys (prevents duplicate metrics)\r\n * - TTL-based cleanup (24-hour retention)\r\n * - Atomic write tracking across databases\r\n */\r\n\r\nimport * as crypto from 'crypto';\r\nimport { IDatabaseAdapter, OperationResult } from './database-service/types.js';\r\nimport { createLogger } from './logging.js';\r\n\r\nconst logger = createLogger('idempotent-write');\r\n\r\n/**\r\n * Execution metrics interface (must match ExecutionMetrics in metrics-logger.ts)\r\n */\r\nexport interface ExecutionMetrics {\r\n  id?: string;\r\n  timestamp: Date;\r\n  agent_id: string;\r\n  skill_id?: string;\r\n  task_id: string;\r\n  duration_ms: number;\r\n  tokens_used: number;\r\n  cost_usd: number;\r\n  status: 'success' | 'failure' | 'timeout' | 'cancelled';\r\n  error_message?: string;\r\n  metadata?: Record<string, any>;\r\n}\r\n\r\n/**\r\n * Idempotency key record\r\n */\r\nexport interface IdempotencyKey {\r\n  key: string;\r\n  metrics_id?: string;\r\n  written_at: Date;\r\n  expires_at: Date;\r\n}\r\n\r\n/**\r\n * Default TTL for idempotency keys (24 hours)\r\n */\r\nconst DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;\r\n\r\n/**\r\n * Create idempotency key from execution metrics\r\n *\r\n * Key is based on: agent_id + task_id + timestamp + duration_ms\r\n * This combination ensures uniqueness while allowing retries to be detected\r\n *\r\n * @param metrics - Execution metrics to create key from\r\n * @returns SHA256 hash as idempotency key\r\n */\r\nexport function createIdempotentKey(metrics: ExecutionMetrics): string {\r\n  // Normalize timestamp to ISO string for consistent hashing\r\n  const timestampStr = metrics.timestamp instanceof Date\r\n    ? metrics.timestamp.toISOString()\r\n    : new Date(metrics.timestamp).toISOString();\r\n\r\n  // Build content string for hashing\r\n  const content = [\r\n    metrics.agent_id,\r\n    metrics.task_id,\r\n    timestampStr,\r\n    metrics.duration_ms.toString(),\r\n    metrics.status,\r\n  ].join(':');\r\n\r\n  // Generate SHA256 hash\r\n  const hash = crypto.createHash('sha256').update(content).digest('hex');\r\n\r\n  logger.debug('Created idempotency key', {\r\n    agent_id: metrics.agent_id,\r\n    task_id: metrics.task_id,\r\n    key: hash.substring(0, 16) + '...', // Log truncated key\r\n  });\r\n\r\n  return hash;\r\n}\r\n\r\n/**\r\n * Check if metrics have already been written\r\n *\r\n * @param key - Idempotency key to check\r\n * @param db - Database adapter\r\n * @returns True if already written, false otherwise\r\n */\r\nexport async function hasBeenWritten(\r\n  key: string,\r\n  db: IDatabaseAdapter\r\n): Promise<boolean> {\r\n  try {\r\n    // Query idempotency_keys table\r\n    const result = await db.get<IdempotencyKey>(`idempotency_keys:${key}`);\r\n\r\n    if (!result) {\r\n      logger.debug('Idempotency key not found', { key: key.substring(0, 16) + '...' });\r\n      return false;\r\n    }\r\n\r\n    // Check if key has expired\r\n    const expiresAt = new Date(result.expires_at);\r\n    const now = new Date();\r\n\r\n    if (expiresAt < now) {\r\n      logger.debug('Idempotency key expired', {\r\n        key: key.substring(0, 16) + '...',\r\n        expired_at: expiresAt.toISOString(),\r\n      });\r\n      return false;\r\n    }\r\n\r\n    logger.debug('Idempotency key found', {\r\n      key: key.substring(0, 16) + '...',\r\n      written_at: result.written_at,\r\n    });\r\n\r\n    return true;\r\n  } catch (error) {\r\n    logger.error('Failed to check idempotency key', {\r\n      key: key.substring(0, 16) + '...',\r\n      error: error instanceof Error ? error.message : String(error),\r\n    });\r\n\r\n    // On error, assume not written to allow retry\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Mark metrics as written\r\n *\r\n * @param key - Idempotency key\r\n * @param db - Database adapter\r\n * @param metricsId - Optional metrics ID to link\r\n * @param ttlMs - Time-to-live in milliseconds (default: 24 hours)\r\n */\r\nexport async function markWritten(\r\n  key: string,\r\n  db: IDatabaseAdapter,\r\n  metricsId?: string,\r\n  ttlMs: number = DEFAULT_TTL_MS\r\n): Promise<void> {\r\n  try {\r\n    const now = new Date();\r\n    const expiresAt = new Date(now.getTime() + ttlMs);\r\n\r\n    const idempotencyRecord: IdempotencyKey = {\r\n      key,\r\n      metrics_id: metricsId,\r\n      written_at: now,\r\n      expires_at: expiresAt,\r\n    };\r\n\r\n    // Insert into idempotency_keys table\r\n    await db.insert('idempotency_keys', idempotencyRecord);\r\n\r\n    logger.debug('Marked idempotency key as written', {\r\n      key: key.substring(0, 16) + '...',\r\n      metrics_id: metricsId,\r\n      expires_at: expiresAt.toISOString(),\r\n    });\r\n  } catch (error) {\r\n    logger.error('Failed to mark idempotency key', {\r\n      key: key.substring(0, 16) + '...',\r\n      error: error instanceof Error ? error.message : String(error),\r\n    });\r\n\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Batch check for written metrics\r\n *\r\n * @param keys - Array of idempotency keys\r\n * @param db - Database adapter\r\n * @returns Map of key -> boolean (written status)\r\n */\r\nexport async function batchCheckWritten(\r\n  keys: string[],\r\n  db: IDatabaseAdapter\r\n): Promise<Map<string, boolean>> {\r\n  const results = new Map<string, boolean>();\r\n\r\n  try {\r\n    // Check all keys in parallel\r\n    const checks = keys.map(async (key) => {\r\n      const written = await hasBeenWritten(key, db);\r\n      return { key, written };\r\n    });\r\n\r\n    const checkResults = await Promise.all(checks);\r\n\r\n    // Build result map\r\n    checkResults.forEach(({ key, written }) => {\r\n      results.set(key, written);\r\n    });\r\n\r\n    logger.debug('Batch idempotency check complete', {\r\n      total_keys: keys.length,\r\n      already_written: Array.from(results.values()).filter(v => v).length,\r\n    });\r\n\r\n    return results;\r\n  } catch (error) {\r\n    logger.error('Failed to batch check idempotency keys', {\r\n      total_keys: keys.length,\r\n      error: error instanceof Error ? error.message : String(error),\r\n    });\r\n\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Batch mark metrics as written\r\n *\r\n * @param entries - Array of { key, metricsId? } entries\r\n * @param db - Database adapter\r\n * @param ttlMs - Time-to-live in milliseconds (default: 24 hours)\r\n */\r\nexport async function batchMarkWritten(\r\n  entries: Array<{ key: string; metricsId?: string }>,\r\n  db: IDatabaseAdapter,\r\n  ttlMs: number = DEFAULT_TTL_MS\r\n): Promise<void> {\r\n  try {\r\n    const now = new Date();\r\n    const expiresAt = new Date(now.getTime() + ttlMs);\r\n\r\n    const records: IdempotencyKey[] = entries.map(({ key, metricsId }) => ({\r\n      key,\r\n      metrics_id: metricsId,\r\n      written_at: now,\r\n      expires_at: expiresAt,\r\n    }));\r\n\r\n    // Batch insert\r\n    await db.insertMany('idempotency_keys', records);\r\n\r\n    logger.debug('Batch marked idempotency keys as written', {\r\n      total_keys: entries.length,\r\n      expires_at: expiresAt.toISOString(),\r\n    });\r\n  } catch (error) {\r\n    logger.error('Failed to batch mark idempotency keys', {\r\n      total_keys: entries.length,\r\n      error: error instanceof Error ? error.message : String(error),\r\n    });\r\n\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Cleanup expired idempotency keys\r\n *\r\n * @param db - Database adapter\r\n * @returns Number of keys deleted\r\n */\r\nexport async function cleanupExpiredKeys(db: IDatabaseAdapter): Promise<number> {\r\n  try {\r\n    const now = new Date();\r\n\r\n    // Query for expired keys\r\n    const expiredKeys = await db.query<IdempotencyKey>('idempotency_keys', [\r\n      {\r\n        field: 'expires_at' as keyof IdempotencyKey,\r\n        operator: 'lt',\r\n        value: now,\r\n      },\r\n    ]);\r\n\r\n    // Delete expired keys\r\n    let deletedCount = 0;\r\n    for (const key of expiredKeys) {\r\n      await db.delete('idempotency_keys', key.key);\r\n      deletedCount++;\r\n    }\r\n\r\n    logger.info('Cleaned up expired idempotency keys', {\r\n      deleted_count: deletedCount,\r\n    });\r\n\r\n    return deletedCount;\r\n  } catch (error) {\r\n    logger.error('Failed to cleanup expired idempotency keys', {\r\n      error: error instanceof Error ? error.message : String(error),\r\n    });\r\n\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Validate cost accuracy (within $0.001 precision)\r\n *\r\n * @param cost - Cost value to validate\r\n * @returns True if cost is accurate to $0.001\r\n */\r\nexport function validateCostAccuracy(cost: number): boolean {\r\n  const rounded = parseFloat(cost.toFixed(3));\r\n  return Math.abs(cost - rounded) < 0.0001;\r\n}\r\n\r\n/**\r\n * Round cost to $0.001 precision\r\n *\r\n * Uses standard \"round half up\" behavior for consistent rounding.\r\n *\r\n * @param cost - Cost value to round\r\n * @returns Cost rounded to 3 decimal places\r\n */\r\nexport function roundCost(cost: number): number {\r\n  // Use Math.round for proper \"round half up\" behavior\r\n  // Multiply by 1000, round, then divide by 1000 for $0.001 precision\r\n  return Math.round(cost * 1000) / 1000;\r\n}\r\n"],"names":["crypto","createLogger","logger","DEFAULT_TTL_MS","createIdempotentKey","metrics","timestampStr","timestamp","Date","toISOString","content","agent_id","task_id","duration_ms","toString","status","join","hash","createHash","update","digest","debug","key","substring","hasBeenWritten","db","result","get","expiresAt","expires_at","now","expired_at","written_at","error","Error","message","String","markWritten","metricsId","ttlMs","getTime","idempotencyRecord","metrics_id","insert","batchCheckWritten","keys","results","Map","checks","map","written","checkResults","Promise","all","forEach","set","total_keys","length","already_written","Array","from","values","filter","v","batchMarkWritten","entries","records","insertMany","cleanupExpiredKeys","expiredKeys","query","field","operator","value","deletedCount","delete","info","deleted_count","validateCostAccuracy","cost","rounded","parseFloat","toFixed","Math","abs","roundCost","round"],"mappings":"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"}

package/dist/lib/integration-schema-validator.js

@@ -0,0 +1,522 @@
+/**
+ * Integration Schema Validator
+ *
+ * Task: P2-3.2 - JSON Schema Validation Enforcement
+ * Enforces JSON Schema validation at all 47 integration points
+ *
+ * Features:
+ * - Automatic validation at data boundaries
+ * - Schema registry with versioning
+ * - Migration support between schema versions
+ * - Performance: <50ms validation, <100ms schema loading
+ * - Comprehensive error reporting with StandardError
+ *
+ * @module integration-schema-validator
+ */ import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { StandardError, ErrorCode } from './errors.js';
+import { getGlobalLogger } from './logging.js';
+import fs from 'fs/promises';
+import path from 'path';
+const logger = getGlobalLogger();
+// ============================================================================
+// Integration Categories (6 categories, 47 points total)
+// ============================================================================
+const INTEGRATION_CATEGORIES = [
+    'database-handoffs',
+    'file-operations',
+    'cfn-loop-communication',
+    'phase4-workflow',
+    'api-layer',
+    'data-format-transformations'
+];
+// ============================================================================
+// IntegrationSchemaValidator Class
+// ============================================================================
+export class IntegrationSchemaValidator {
+    config;
+    ajv;
+    schemaCache;
+    migrations;
+    initialized = false;
+    constructor(config){
+        this.config = {
+            schemaPath: config.schemaPath,
+            enableCache: config.enableCache ?? true,
+            strictMode: config.strictMode ?? true,
+            maxCacheSize: config.maxCacheSize ?? 1000,
+            schemaExtension: config.schemaExtension ?? '.schema.json'
+        };
+        // Initialize Ajv with formats support
+        this.ajv = new Ajv({
+            allErrors: true,
+            strict: this.config.strictMode,
+            validateFormats: true,
+            verbose: true
+        });
+        addFormats(this.ajv); // Add format validators (date-time, email, uri, etc.)
+        this.schemaCache = new Map();
+        this.migrations = {};
+        logger.debug('IntegrationSchemaValidator initialized', {
+            schemaPath: this.config.schemaPath,
+            enableCache: this.config.enableCache,
+            strictMode: this.config.strictMode
+        });
+    }
+    /**
+   * Initialize validator by loading all schemas
+   */ async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            // Verify schema directory exists
+            await fs.access(this.config.schemaPath);
+            // Load all schemas from directory
+            const categories = await this.loadSchemaDirectory();
+            logger.info('Schema validator initialized', {
+                categories: categories.length,
+                schemasLoaded: this.schemaCache.size
+            });
+            this.initialized = true;
+        } catch (error) {
+            logger.error('Failed to initialize schema validator', error, {
+                schemaPath: this.config.schemaPath
+            });
+            throw new StandardError(ErrorCode.CONFIGURATION_ERROR, `Failed to initialize schema validator: ${error.message}`, {
+                schemaPath: this.config.schemaPath
+            }, error);
+        }
+    }
+    /**
+   * Shutdown validator and clear caches
+   */ async shutdown() {
+        this.schemaCache.clear();
+        this.migrations = {};
+        this.initialized = false;
+        logger.debug('Schema validator shutdown complete');
+    }
+    /**
+   * Validate data against a schema
+   *
+   * @param data - Data to validate
+   * @param schemaId - Schema identifier (e.g., "database-handoffs/pattern-deployment")
+   * @param version - Schema version (defaults to latest)
+   * @throws StandardError with VALIDATION_FAILED code if validation fails
+   */ async validate(data, schemaId, version) {
+        this.ensureInitialized();
+        const startTime = Date.now();
+        try {
+            // Get schema validator
+            const schema = await this.getSchema(schemaId, version);
+            // Perform validation
+            const valid = schema.validator(data);
+            if (!valid) {
+                const errors = this.formatErrors(schema.validator.errors || []);
+                logger.warn('Schema validation failed', {
+                    schemaId,
+                    version: schema.version,
+                    errorCount: errors.length,
+                    duration: Date.now() - startTime
+                });
+                throw new StandardError(ErrorCode.VALIDATION_FAILED, `Schema validation failed for ${schemaId}@${schema.version}`, {
+                    schemaId,
+                    version: schema.version,
+                    errors,
+                    suggestions: this.generateSuggestions(errors, data)
+                });
+            }
+            logger.debug('Schema validation succeeded', {
+                schemaId,
+                version: schema.version,
+                duration: Date.now() - startTime
+            });
+        } catch (error) {
+            if (error instanceof StandardError) {
+                throw error;
+            }
+            throw new StandardError(ErrorCode.VALIDATION_FAILED, `Validation error: ${error.message}`, {
+                schemaId,
+                version
+            }, error);
+        }
+    }
+    /**
+   * Validate batch of records
+   */ async validateBatch(records, schemaId, version, options = {}) {
+        this.ensureInitialized();
+        const result = {
+            valid: true,
+            totalRecords: records.length,
+            validRecords: 0,
+            invalidRecords: 0,
+            errors: []
+        };
+        for(let i = 0; i < records.length; i++){
+            try {
+                await this.validate(records[i], schemaId, version);
+                result.validRecords++;
+            } catch (error) {
+                result.invalidRecords++;
+                result.valid = false;
+                if (error instanceof StandardError) {
+                    result.errors.push({
+                        index: i,
+                        errors: error.context?.errors || []
+                    });
+                }
+                if (options.failFast) {
+                    break;
+                }
+            }
+        }
+        logger.info('Batch validation completed', {
+            schemaId,
+            version,
+            total: result.totalRecords,
+            valid: result.validRecords,
+            invalid: result.invalidRecords
+        });
+        return result;
+    }
+    /**
+   * Migrate data from one schema version to another
+   */ async migrate(data, schemaId, fromVersion, toVersion) {
+        this.ensureInitialized();
+        const transition = `${fromVersion}->${toVersion}`;
+        const migrationFn = this.migrations[schemaId]?.[transition];
+        if (!migrationFn) {
+            // Check if migration is needed (same version)
+            if (fromVersion === toVersion) {
+                return data;
+            }
+            // No migration function registered
+            throw new StandardError(ErrorCode.CONFIGURATION_ERROR, `No migration available for ${schemaId} from ${fromVersion} to ${toVersion}`, {
+                schemaId,
+                fromVersion,
+                toVersion,
+                transition
+            });
+        }
+        try {
+            const migrated = await migrationFn(data, fromVersion, toVersion);
+            logger.info('Schema migration completed', {
+                schemaId,
+                fromVersion,
+                toVersion
+            });
+            return migrated;
+        } catch (error) {
+            throw new StandardError(ErrorCode.VALIDATION_FAILED, `Migration failed: ${error.message}`, {
+                schemaId,
+                fromVersion,
+                toVersion
+            }, error);
+        }
+    }
+    /**
+   * Register a migration function
+   */ registerMigration(schemaId, fromVersion, toVersion, migrationFn) {
+        const transition = `${fromVersion}->${toVersion}`;
+        if (!this.migrations[schemaId]) {
+            this.migrations[schemaId] = {};
+        }
+        this.migrations[schemaId][transition] = migrationFn;
+        logger.debug('Migration registered', {
+            schemaId,
+            transition
+        });
+    }
+    /**
+   * Get schema metadata
+   */ async getSchema(schemaId, version) {
+        const cacheKey = `${schemaId}@${version || 'latest'}`;
+        // Check cache
+        if (this.config.enableCache && this.schemaCache.has(cacheKey)) {
+            return this.schemaCache.get(cacheKey);
+        }
+        // Load schema from file
+        const schema = await this.loadSchema(schemaId, version);
+        // Cache schema
+        if (this.config.enableCache) {
+            this.schemaCache.set(cacheKey, schema);
+            // Enforce cache size limit
+            if (this.schemaCache.size > this.config.maxCacheSize) {
+                const firstKey = this.schemaCache.keys().next().value;
+                this.schemaCache.delete(firstKey);
+            }
+        }
+        return schema;
+    }
+    /**
+   * Check if schema exists
+   */ async hasSchema(schemaId, version) {
+        try {
+            await this.getSchema(schemaId, version);
+            return true;
+        } catch  {
+            return false;
+        }
+    }
+    /**
+   * List all available schemas
+   */ async listSchemas(category) {
+        this.ensureInitialized();
+        const schemas = Array.from(this.schemaCache.keys()).map((key)=>key.split('@')[0]) // Remove version
+        .filter((id, index, self)=>self.indexOf(id) === index); // Unique
+        if (category) {
+            return schemas.filter((id)=>id.startsWith(`${category}/`));
+        }
+        return schemas;
+    }
+    /**
+   * Get all available versions for a schema
+   */ async getVersions(schemaId) {
+        const versions = Array.from(this.schemaCache.keys()).filter((key)=>key.startsWith(`${schemaId}@`)).map((key)=>key.split('@')[1]).filter((v)=>v !== 'latest');
+        // Also check filesystem for versions not yet cached
+        const schemaDir = path.join(this.config.schemaPath, schemaId);
+        try {
+            const files = await fs.readdir(schemaDir);
+            const fileVersions = files.filter((f)=>f.endsWith(this.config.schemaExtension)).map((f)=>{
+                const match = f.match(/v([\d.]+)/);
+                return match ? match[1] : null;
+            }).filter((v)=>v !== null);
+            // Merge and deduplicate
+            const allVersions = [
+                ...new Set([
+                    ...versions,
+                    ...fileVersions
+                ])
+            ];
+            return allVersions.sort();
+        } catch  {
+            return versions;
+        }
+    }
+    /**
+   * Get integration categories
+   */ async getCategories() {
+        return [
+            ...INTEGRATION_CATEGORIES
+        ];
+    }
+    /**
+   * Get validator configuration
+   */ getConfig() {
+        return {
+            ...this.config
+        };
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new StandardError(ErrorCode.CONFIGURATION_ERROR, 'Schema validator not initialized. Call initialize() first.', {
+                initialized: this.initialized
+            });
+        }
+    }
+    async loadSchemaDirectory() {
+        const loadedCategories = [];
+        for (const category of INTEGRATION_CATEGORIES){
+            const categoryPath = path.join(this.config.schemaPath, category);
+            try {
+                await fs.access(categoryPath);
+                await this.loadCategorySchemas(category);
+                loadedCategories.push(category);
+            } catch (error) {
+                logger.warn(`Category directory not found: ${category}`, {
+                    categoryPath
+                });
+            }
+        }
+        return loadedCategories;
+    }
+    async loadCategorySchemas(category) {
+        const categoryPath = path.join(this.config.schemaPath, category);
+        try {
+            const entries = await fs.readdir(categoryPath, {
+                withFileTypes: true
+            });
+            for (const entry of entries){
+                if (entry.isDirectory()) {
+                    // Schema subdirectory (e.g., pattern-deployment/)
+                    const schemaName = entry.name;
+                    const schemaId = `${category}/${schemaName}`;
+                    await this.loadSchemaVersions(schemaId, path.join(categoryPath, schemaName));
+                } else if (entry.isFile() && entry.name.endsWith(this.config.schemaExtension)) {
+                    // Direct schema file
+                    const schemaName = entry.name.replace(this.config.schemaExtension, '');
+                    const schemaId = `${category}/${schemaName}`;
+                    await this.loadSchemaFile(schemaId, path.join(categoryPath, entry.name), '1.0.0');
+                }
+            }
+        } catch (error) {
+            logger.error(`Failed to load schemas for category: ${category}`, error, {
+                categoryPath
+            });
+        }
+    }
+    async loadSchemaVersions(schemaId, schemaDir) {
+        try {
+            const files = await fs.readdir(schemaDir);
+            for (const file of files){
+                if (file.endsWith(this.config.schemaExtension)) {
+                    const versionMatch = file.match(/v([\d.]+)/);
+                    const version = versionMatch ? versionMatch[1] : '1.0.0';
+                    const filePath = path.join(schemaDir, file);
+                    await this.loadSchemaFile(schemaId, filePath, version);
+                }
+            }
+        } catch (error) {
+            logger.error(`Failed to load schema versions: ${schemaId}`, error, {
+                schemaDir
+            });
+        }
+    }
+    async loadSchemaFile(schemaId, filePath, version) {
+        try {
+            // Check if already loaded in cache
+            const cacheKey = `${schemaId}@${version}`;
+            if (this.schemaCache.has(cacheKey)) {
+                logger.debug('Schema already cached', {
+                    schemaId,
+                    version
+                });
+                return;
+            }
+            const content = await fs.readFile(filePath, 'utf-8');
+            const schema = JSON.parse(content);
+            // Check if schema with this $id already exists in Ajv
+            const schemaKey = schema.$id || `${schemaId}/${version}`;
+            if (this.ajv.getSchema(schemaKey)) {
+                logger.debug('Schema already compiled in Ajv', {
+                    schemaId,
+                    version,
+                    schemaKey
+                });
+                // Use existing compiled schema
+                const validator = this.ajv.getSchema(schemaKey);
+                const category = schemaId.split('/')[0];
+                const metadata = {
+                    id: schemaId,
+                    version,
+                    category,
+                    description: schema.description,
+                    validator
+                };
+                this.schemaCache.set(cacheKey, metadata);
+                return;
+            }
+            // Compile schema with Ajv
+            const validator = this.ajv.compile(schema);
+            // Extract category from schemaId
+            const category = schemaId.split('/')[0];
+            const metadata = {
+                id: schemaId,
+                version,
+                category,
+                description: schema.description,
+                validator
+            };
+            // Cache with version
+            this.schemaCache.set(cacheKey, metadata);
+            logger.debug('Schema loaded', {
+                schemaId,
+                version,
+                filePath
+            });
+        } catch (error) {
+            logger.error(`Failed to load schema file: ${filePath}`, error, {
+                schemaId,
+                version
+            });
+            throw error;
+        }
+    }
+    async loadSchema(schemaId, version) {
+        const category = schemaId.split('/')[0];
+        const schemaName = schemaId.split('/').slice(1).join('/');
+        // Determine file path
+        const categoryPath = path.join(this.config.schemaPath, category);
+        const schemaPath = path.join(categoryPath, schemaName);
+        // Try versioned schema directory
+        try {
+            const versionedFile = version ? `v${version}${this.config.schemaExtension}` : `v1.0.0${this.config.schemaExtension}`;
+            const filePath = path.join(schemaPath, versionedFile);
+            await fs.access(filePath);
+            const actualVersion = version || '1.0.0';
+            await this.loadSchemaFile(schemaId, filePath, actualVersion);
+            return this.schemaCache.get(`${schemaId}@${actualVersion}`);
+        } catch  {
+            // Try direct schema file
+            const directFile = path.join(categoryPath, `${schemaName}${this.config.schemaExtension}`);
+            try {
+                await fs.access(directFile);
+                const actualVersion = version || '1.0.0';
+                await this.loadSchemaFile(schemaId, directFile, actualVersion);
+                return this.schemaCache.get(`${schemaId}@${actualVersion}`);
+            } catch (error) {
+                throw new StandardError(ErrorCode.FILE_NOT_FOUND, `Schema not found: ${schemaId}${version ? `@${version}` : ''}`, {
+                    schemaId,
+                    version,
+                    searchPaths: [
+                        schemaPath,
+                        directFile
+                    ]
+                }, error);
+            }
+        }
+    }
+    formatErrors(errors) {
+        return errors.map((error)=>({
+                path: error.instancePath || error.schemaPath,
+                message: error.message || 'Validation failed',
+                keyword: error.keyword,
+                params: error.params
+            }));
+    }
+    generateSuggestions(errors, data) {
+        const suggestions = [];
+        for (const error of errors){
+            if (error.keyword === 'required' && error.params?.missingProperty) {
+                const missing = error.params.missingProperty;
+                suggestions.push(missing);
+                // Check for typos in data keys
+                const dataKeys = Object.keys(data);
+                const similar = dataKeys.filter((key)=>this.levenshteinDistance(key, missing) <= 2);
+                if (similar.length > 0) {
+                    suggestions.push(`Did you mean: ${similar.join(', ')}?`);
+                }
+            }
+        }
+        return [
+            ...new Set(suggestions)
+        ]; // Deduplicate
+    }
+    levenshteinDistance(a, b) {
+        const matrix = [];
+        for(let i = 0; i <= b.length; i++){
+            matrix[i] = [
+                i
+            ];
+        }
+        for(let j = 0; j <= a.length; j++){
+            matrix[0][j] = j;
+        }
+        for(let i = 1; i <= b.length; i++){
+            for(let j = 1; j <= a.length; j++){
+                if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                } else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1 // deletion
+                    );
+                }
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+}
+
+//# sourceMappingURL=integration-schema-validator.js.map

package/dist/lib/integration-schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/integration-schema-validator.ts"],"sourcesContent":["/**\r\n * Integration Schema Validator\r\n *\r\n * Task: P2-3.2 - JSON Schema Validation Enforcement\r\n * Enforces JSON Schema validation at all 47 integration points\r\n *\r\n * Features:\r\n * - Automatic validation at data boundaries\r\n * - Schema registry with versioning\r\n * - Migration support between schema versions\r\n * - Performance: <50ms validation, <100ms schema loading\r\n * - Comprehensive error reporting with StandardError\r\n *\r\n * @module integration-schema-validator\r\n */\r\n\r\nimport Ajv, { ValidateFunction, ErrorObject } from 'ajv';\r\nimport addFormats from 'ajv-formats';\r\nimport { StandardError, ErrorCode, createValidationError } from './errors.js';\r\nimport { getGlobalLogger } from './logging.js';\r\nimport fs from 'fs/promises';\r\nimport path from 'path';\r\n\r\nconst logger = getGlobalLogger();\r\n\r\n// ============================================================================\r\n// Type Definitions\r\n// ============================================================================\r\n\r\nexport interface SchemaValidatorConfig {\r\n  /**\r\n   * Path to directory containing JSON schemas\r\n   */\r\n  schemaPath: string;\r\n\r\n  /**\r\n   * Enable schema caching for performance\r\n   * @default true\r\n   */\r\n  enableCache?: boolean;\r\n\r\n  /**\r\n   * Strict mode - fail on additional properties\r\n   * @default true\r\n   */\r\n  strictMode?: boolean;\r\n\r\n  /**\r\n   * Maximum cache size (number of schemas)\r\n   * @default 1000\r\n   */\r\n  maxCacheSize?: number;\r\n\r\n  /**\r\n   * Schema file extension\r\n   * @default '.schema.json'\r\n   */\r\n  schemaExtension?: string;\r\n}\r\n\r\nexport interface ValidationResult {\r\n  valid: boolean;\r\n  errors?: ValidationError[];\r\n  warnings?: string[];\r\n}\r\n\r\nexport interface ValidationError {\r\n  path: string;\r\n  message: string;\r\n  keyword?: string;\r\n  params?: Record<string, any>;\r\n}\r\n\r\nexport interface BatchValidationResult {\r\n  valid: boolean;\r\n  totalRecords: number;\r\n  validRecords: number;\r\n  invalidRecords: number;\r\n  errors: Array<{\r\n    index: number;\r\n    errors: ValidationError[];\r\n  }>;\r\n}\r\n\r\nexport interface BatchValidationOptions {\r\n  /**\r\n   * Stop validation on first error\r\n   * @default false\r\n   */\r\n  failFast?: boolean;\r\n\r\n  /**\r\n   * Include valid records in result\r\n   * @default false\r\n   */\r\n  includeValidRecords?: boolean;\r\n}\r\n\r\nexport type MigrationFunction = (data: any, fromVersion: string, toVersion: string) => Promise<any>;\r\n\r\ninterface SchemaMetadata {\r\n  id: string;\r\n  version: string;\r\n  category: string;\r\n  description?: string;\r\n  validator: ValidateFunction;\r\n}\r\n\r\ninterface MigrationRegistry {\r\n  [schemaId: string]: {\r\n    [transition: string]: MigrationFunction; // \"1.0.0->2.0.0\"\r\n  };\r\n}\r\n\r\n// ============================================================================\r\n// Integration Categories (6 categories, 47 points total)\r\n// ============================================================================\r\n\r\nconst INTEGRATION_CATEGORIES = [\r\n  'database-handoffs',       // 9 points\r\n  'file-operations',         // 11 points\r\n  'cfn-loop-communication',  // 8 points\r\n  'phase4-workflow',         // 7 points\r\n  'api-layer',               // 7 points\r\n  'data-format-transformations', // 5 points\r\n] as const;\r\n\r\nexport type IntegrationCategory = typeof INTEGRATION_CATEGORIES[number];\r\n\r\n// ============================================================================\r\n// IntegrationSchemaValidator Class\r\n// ============================================================================\r\n\r\nexport class IntegrationSchemaValidator {\r\n  private config: Required<SchemaValidatorConfig>;\r\n  private ajv: Ajv;\r\n  private schemaCache: Map<string, SchemaMetadata>;\r\n  private migrations: MigrationRegistry;\r\n  private initialized: boolean = false;\r\n\r\n  constructor(config: SchemaValidatorConfig) {\r\n    this.config = {\r\n      schemaPath: config.schemaPath,\r\n      enableCache: config.enableCache ?? true,\r\n      strictMode: config.strictMode ?? true,\r\n      maxCacheSize: config.maxCacheSize ?? 1000,\r\n      schemaExtension: config.schemaExtension ?? '.schema.json',\r\n    };\r\n\r\n    // Initialize Ajv with formats support\r\n    this.ajv = new Ajv({\r\n      allErrors: true, // Report all errors, not just first\r\n      strict: this.config.strictMode,\r\n      validateFormats: true,\r\n      verbose: true, // Include schema and data in error messages\r\n    });\r\n\r\n    addFormats(this.ajv); // Add format validators (date-time, email, uri, etc.)\r\n\r\n    this.schemaCache = new Map();\r\n    this.migrations = {};\r\n\r\n    logger.debug('IntegrationSchemaValidator initialized', {\r\n      schemaPath: this.config.schemaPath,\r\n      enableCache: this.config.enableCache,\r\n      strictMode: this.config.strictMode,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Initialize validator by loading all schemas\r\n   */\r\n  async initialize(): Promise<void> {\r\n    if (this.initialized) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      // Verify schema directory exists\r\n      await fs.access(this.config.schemaPath);\r\n\r\n      // Load all schemas from directory\r\n      const categories = await this.loadSchemaDirectory();\r\n\r\n      logger.info('Schema validator initialized', {\r\n        categories: categories.length,\r\n        schemasLoaded: this.schemaCache.size,\r\n      });\r\n\r\n      this.initialized = true;\r\n    } catch (error) {\r\n      logger.error('Failed to initialize schema validator', error as Error, {\r\n        schemaPath: this.config.schemaPath,\r\n      });\r\n\r\n      throw new StandardError(\r\n        ErrorCode.CONFIGURATION_ERROR,\r\n        `Failed to initialize schema validator: ${(error as Error).message}`,\r\n        { schemaPath: this.config.schemaPath },\r\n        error as Error\r\n      );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown validator and clear caches\r\n   */\r\n  async shutdown(): Promise<void> {\r\n    this.schemaCache.clear();\r\n    this.migrations = {};\r\n    this.initialized = false;\r\n\r\n    logger.debug('Schema validator shutdown complete');\r\n  }\r\n\r\n  /**\r\n   * Validate data against a schema\r\n   *\r\n   * @param data - Data to validate\r\n   * @param schemaId - Schema identifier (e.g., \"database-handoffs/pattern-deployment\")\r\n   * @param version - Schema version (defaults to latest)\r\n   * @throws StandardError with VALIDATION_FAILED code if validation fails\r\n   */\r\n  async validate(data: any, schemaId: string, version?: string): Promise<void> {\r\n    this.ensureInitialized();\r\n\r\n    const startTime = Date.now();\r\n\r\n    try {\r\n      // Get schema validator\r\n      const schema = await this.getSchema(schemaId, version);\r\n\r\n      // Perform validation\r\n      const valid = schema.validator(data);\r\n\r\n      if (!valid) {\r\n        const errors = this.formatErrors(schema.validator.errors || []);\r\n\r\n        logger.warn('Schema validation failed', {\r\n          schemaId,\r\n          version: schema.version,\r\n          errorCount: errors.length,\r\n          duration: Date.now() - startTime,\r\n        });\r\n\r\n        throw new StandardError(\r\n          ErrorCode.VALIDATION_FAILED,\r\n          `Schema validation failed for ${schemaId}@${schema.version}`,\r\n          {\r\n            schemaId,\r\n            version: schema.version,\r\n            errors,\r\n            suggestions: this.generateSuggestions(errors, data),\r\n          }\r\n        );\r\n      }\r\n\r\n      logger.debug('Schema validation succeeded', {\r\n        schemaId,\r\n        version: schema.version,\r\n        duration: Date.now() - startTime,\r\n      });\r\n    } catch (error) {\r\n      if (error instanceof StandardError) {\r\n        throw error;\r\n      }\r\n\r\n      throw new StandardError(\r\n        ErrorCode.VALIDATION_FAILED,\r\n        `Validation error: ${(error as Error).message}`,\r\n        { schemaId, version },\r\n        error as Error\r\n      );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Validate batch of records\r\n   */\r\n  async validateBatch(\r\n    records: any[],\r\n    schemaId: string,\r\n    version?: string,\r\n    options: BatchValidationOptions = {}\r\n  ): Promise<BatchValidationResult> {\r\n    this.ensureInitialized();\r\n\r\n    const result: BatchValidationResult = {\r\n      valid: true,\r\n      totalRecords: records.length,\r\n      validRecords: 0,\r\n      invalidRecords: 0,\r\n      errors: [],\r\n    };\r\n\r\n    for (let i = 0; i < records.length; i++) {\r\n      try {\r\n        await this.validate(records[i], schemaId, version);\r\n        result.validRecords++;\r\n      } catch (error) {\r\n        result.invalidRecords++;\r\n        result.valid = false;\r\n\r\n        if (error instanceof StandardError) {\r\n          result.errors.push({\r\n            index: i,\r\n            errors: error.context?.errors || [],\r\n          });\r\n        }\r\n\r\n        if (options.failFast) {\r\n          break;\r\n        }\r\n      }\r\n    }\r\n\r\n    logger.info('Batch validation completed', {\r\n      schemaId,\r\n      version,\r\n      total: result.totalRecords,\r\n      valid: result.validRecords,\r\n      invalid: result.invalidRecords,\r\n    });\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Migrate data from one schema version to another\r\n   */\r\n  async migrate(\r\n    data: any,\r\n    schemaId: string,\r\n    fromVersion: string,\r\n    toVersion: string\r\n  ): Promise<any> {\r\n    this.ensureInitialized();\r\n\r\n    const transition = `${fromVersion}->${toVersion}`;\r\n    const migrationFn = this.migrations[schemaId]?.[transition];\r\n\r\n    if (!migrationFn) {\r\n      // Check if migration is needed (same version)\r\n      if (fromVersion === toVersion) {\r\n        return data;\r\n      }\r\n\r\n      // No migration function registered\r\n      throw new StandardError(\r\n        ErrorCode.CONFIGURATION_ERROR,\r\n        `No migration available for ${schemaId} from ${fromVersion} to ${toVersion}`,\r\n        { schemaId, fromVersion, toVersion, transition }\r\n      );\r\n    }\r\n\r\n    try {\r\n      const migrated = await migrationFn(data, fromVersion, toVersion);\r\n\r\n      logger.info('Schema migration completed', {\r\n        schemaId,\r\n        fromVersion,\r\n        toVersion,\r\n      });\r\n\r\n      return migrated;\r\n    } catch (error) {\r\n      throw new StandardError(\r\n        ErrorCode.VALIDATION_FAILED,\r\n        `Migration failed: ${(error as Error).message}`,\r\n        { schemaId, fromVersion, toVersion },\r\n        error as Error\r\n      );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Register a migration function\r\n   */\r\n  registerMigration(\r\n    schemaId: string,\r\n    fromVersion: string,\r\n    toVersion: string,\r\n    migrationFn: MigrationFunction\r\n  ): void {\r\n    const transition = `${fromVersion}->${toVersion}`;\r\n\r\n    if (!this.migrations[schemaId]) {\r\n      this.migrations[schemaId] = {};\r\n    }\r\n\r\n    this.migrations[schemaId][transition] = migrationFn;\r\n\r\n    logger.debug('Migration registered', { schemaId, transition });\r\n  }\r\n\r\n  /**\r\n   * Get schema metadata\r\n   */\r\n  async getSchema(schemaId: string, version?: string): Promise<SchemaMetadata> {\r\n    const cacheKey = `${schemaId}@${version || 'latest'}`;\r\n\r\n    // Check cache\r\n    if (this.config.enableCache && this.schemaCache.has(cacheKey)) {\r\n      return this.schemaCache.get(cacheKey)!;\r\n    }\r\n\r\n    // Load schema from file\r\n    const schema = await this.loadSchema(schemaId, version);\r\n\r\n    // Cache schema\r\n    if (this.config.enableCache) {\r\n      this.schemaCache.set(cacheKey, schema);\r\n\r\n      // Enforce cache size limit\r\n      if (this.schemaCache.size > this.config.maxCacheSize) {\r\n        const firstKey = this.schemaCache.keys().next().value;\r\n        this.schemaCache.delete(firstKey);\r\n      }\r\n    }\r\n\r\n    return schema;\r\n  }\r\n\r\n  /**\r\n   * Check if schema exists\r\n   */\r\n  async hasSchema(schemaId: string, version?: string): Promise<boolean> {\r\n    try {\r\n      await this.getSchema(schemaId, version);\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * List all available schemas\r\n   */\r\n  async listSchemas(category?: IntegrationCategory): Promise<string[]> {\r\n    this.ensureInitialized();\r\n\r\n    const schemas = Array.from(this.schemaCache.keys())\r\n      .map((key) => key.split('@')[0]) // Remove version\r\n      .filter((id, index, self) => self.indexOf(id) === index); // Unique\r\n\r\n    if (category) {\r\n      return schemas.filter((id) => id.startsWith(`${category}/`));\r\n    }\r\n\r\n    return schemas;\r\n  }\r\n\r\n  /**\r\n   * Get all available versions for a schema\r\n   */\r\n  async getVersions(schemaId: string): Promise<string[]> {\r\n    const versions = Array.from(this.schemaCache.keys())\r\n      .filter((key) => key.startsWith(`${schemaId}@`))\r\n      .map((key) => key.split('@')[1])\r\n      .filter((v) => v !== 'latest');\r\n\r\n    // Also check filesystem for versions not yet cached\r\n    const schemaDir = path.join(this.config.schemaPath, schemaId);\r\n\r\n    try {\r\n      const files = await fs.readdir(schemaDir);\r\n      const fileVersions = files\r\n        .filter((f) => f.endsWith(this.config.schemaExtension))\r\n        .map((f) => {\r\n          const match = f.match(/v([\\d.]+)/);\r\n          return match ? match[1] : null;\r\n        })\r\n        .filter((v): v is string => v !== null);\r\n\r\n      // Merge and deduplicate\r\n      const allVersions = [...new Set([...versions, ...fileVersions])];\r\n      return allVersions.sort();\r\n    } catch {\r\n      return versions;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get integration categories\r\n   */\r\n  async getCategories(): Promise<IntegrationCategory[]> {\r\n    return [...INTEGRATION_CATEGORIES];\r\n  }\r\n\r\n  /**\r\n   * Get validator configuration\r\n   */\r\n  getConfig(): Required<SchemaValidatorConfig> {\r\n    return { ...this.config };\r\n  }\r\n\r\n  // ============================================================================\r\n  // Private Methods\r\n  // ============================================================================\r\n\r\n  private ensureInitialized(): void {\r\n    if (!this.initialized) {\r\n      throw new StandardError(\r\n        ErrorCode.CONFIGURATION_ERROR,\r\n        'Schema validator not initialized. Call initialize() first.',\r\n        { initialized: this.initialized }\r\n      );\r\n    }\r\n  }\r\n\r\n  private async loadSchemaDirectory(): Promise<IntegrationCategory[]> {\r\n    const loadedCategories: IntegrationCategory[] = [];\r\n\r\n    for (const category of INTEGRATION_CATEGORIES) {\r\n      const categoryPath = path.join(this.config.schemaPath, category);\r\n\r\n      try {\r\n        await fs.access(categoryPath);\r\n        await this.loadCategorySchemas(category);\r\n        loadedCategories.push(category);\r\n      } catch (error) {\r\n        logger.warn(`Category directory not found: ${category}`, {\r\n          categoryPath,\r\n        });\r\n      }\r\n    }\r\n\r\n    return loadedCategories;\r\n  }\r\n\r\n  private async loadCategorySchemas(category: IntegrationCategory): Promise<void> {\r\n    const categoryPath = path.join(this.config.schemaPath, category);\r\n\r\n    try {\r\n      const entries = await fs.readdir(categoryPath, { withFileTypes: true });\r\n\r\n      for (const entry of entries) {\r\n        if (entry.isDirectory()) {\r\n          // Schema subdirectory (e.g., pattern-deployment/)\r\n          const schemaName = entry.name;\r\n          const schemaId = `${category}/${schemaName}`;\r\n          await this.loadSchemaVersions(schemaId, path.join(categoryPath, schemaName));\r\n        } else if (entry.isFile() && entry.name.endsWith(this.config.schemaExtension)) {\r\n          // Direct schema file\r\n          const schemaName = entry.name.replace(this.config.schemaExtension, '');\r\n          const schemaId = `${category}/${schemaName}`;\r\n          await this.loadSchemaFile(schemaId, path.join(categoryPath, entry.name), '1.0.0');\r\n        }\r\n      }\r\n    } catch (error) {\r\n      logger.error(`Failed to load schemas for category: ${category}`, error as Error, {\r\n        categoryPath,\r\n      });\r\n    }\r\n  }\r\n\r\n  private async loadSchemaVersions(schemaId: string, schemaDir: string): Promise<void> {\r\n    try {\r\n      const files = await fs.readdir(schemaDir);\r\n\r\n      for (const file of files) {\r\n        if (file.endsWith(this.config.schemaExtension)) {\r\n          const versionMatch = file.match(/v([\\d.]+)/);\r\n          const version = versionMatch ? versionMatch[1] : '1.0.0';\r\n          const filePath = path.join(schemaDir, file);\r\n\r\n          await this.loadSchemaFile(schemaId, filePath, version);\r\n        }\r\n      }\r\n    } catch (error) {\r\n      logger.error(`Failed to load schema versions: ${schemaId}`, error as Error, {\r\n        schemaDir,\r\n      });\r\n    }\r\n  }\r\n\r\n  private async loadSchemaFile(\r\n    schemaId: string,\r\n    filePath: string,\r\n    version: string\r\n  ): Promise<void> {\r\n    try {\r\n      // Check if already loaded in cache\r\n      const cacheKey = `${schemaId}@${version}`;\r\n      if (this.schemaCache.has(cacheKey)) {\r\n        logger.debug('Schema already cached', { schemaId, version });\r\n        return;\r\n      }\r\n\r\n      const content = await fs.readFile(filePath, 'utf-8');\r\n      const schema = JSON.parse(content);\r\n\r\n      // Check if schema with this $id already exists in Ajv\r\n      const schemaKey = schema.$id || `${schemaId}/${version}`;\r\n      if (this.ajv.getSchema(schemaKey)) {\r\n        logger.debug('Schema already compiled in Ajv', { schemaId, version, schemaKey });\r\n        // Use existing compiled schema\r\n        const validator = this.ajv.getSchema(schemaKey)!;\r\n\r\n        const category = schemaId.split('/')[0] as IntegrationCategory;\r\n        const metadata: SchemaMetadata = {\r\n          id: schemaId,\r\n          version,\r\n          category,\r\n          description: schema.description,\r\n          validator,\r\n        };\r\n\r\n        this.schemaCache.set(cacheKey, metadata);\r\n        return;\r\n      }\r\n\r\n      // Compile schema with Ajv\r\n      const validator = this.ajv.compile(schema);\r\n\r\n      // Extract category from schemaId\r\n      const category = schemaId.split('/')[0] as IntegrationCategory;\r\n\r\n      const metadata: SchemaMetadata = {\r\n        id: schemaId,\r\n        version,\r\n        category,\r\n        description: schema.description,\r\n        validator,\r\n      };\r\n\r\n      // Cache with version\r\n      this.schemaCache.set(cacheKey, metadata);\r\n\r\n      logger.debug('Schema loaded', { schemaId, version, filePath });\r\n    } catch (error) {\r\n      logger.error(`Failed to load schema file: ${filePath}`, error as Error, {\r\n        schemaId,\r\n        version,\r\n      });\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  private async loadSchema(schemaId: string, version?: string): Promise<SchemaMetadata> {\r\n    const category = schemaId.split('/')[0] as IntegrationCategory;\r\n    const schemaName = schemaId.split('/').slice(1).join('/');\r\n\r\n    // Determine file path\r\n    const categoryPath = path.join(this.config.schemaPath, category);\r\n    const schemaPath = path.join(categoryPath, schemaName);\r\n\r\n    // Try versioned schema directory\r\n    try {\r\n      const versionedFile = version\r\n        ? `v${version}${this.config.schemaExtension}`\r\n        : `v1.0.0${this.config.schemaExtension}`;\r\n\r\n      const filePath = path.join(schemaPath, versionedFile);\r\n      await fs.access(filePath);\r\n\r\n      const actualVersion = version || '1.0.0';\r\n      await this.loadSchemaFile(schemaId, filePath, actualVersion);\r\n\r\n      return this.schemaCache.get(`${schemaId}@${actualVersion}`)!;\r\n    } catch {\r\n      // Try direct schema file\r\n      const directFile = path.join(categoryPath, `${schemaName}${this.config.schemaExtension}`);\r\n\r\n      try {\r\n        await fs.access(directFile);\r\n\r\n        const actualVersion = version || '1.0.0';\r\n        await this.loadSchemaFile(schemaId, directFile, actualVersion);\r\n\r\n        return this.schemaCache.get(`${schemaId}@${actualVersion}`)!;\r\n      } catch (error) {\r\n        throw new StandardError(\r\n          ErrorCode.FILE_NOT_FOUND,\r\n          `Schema not found: ${schemaId}${version ? `@${version}` : ''}`,\r\n          { schemaId, version, searchPaths: [schemaPath, directFile] },\r\n          error as Error\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  private formatErrors(errors: ErrorObject[]): ValidationError[] {\r\n    return errors.map((error) => ({\r\n      path: error.instancePath || error.schemaPath,\r\n      message: error.message || 'Validation failed',\r\n      keyword: error.keyword,\r\n      params: error.params,\r\n    }));\r\n  }\r\n\r\n  private generateSuggestions(errors: ValidationError[], data: any): string[] {\r\n    const suggestions: string[] = [];\r\n\r\n    for (const error of errors) {\r\n      if (error.keyword === 'required' && error.params?.missingProperty) {\r\n        const missing = error.params.missingProperty;\r\n        suggestions.push(missing);\r\n\r\n        // Check for typos in data keys\r\n        const dataKeys = Object.keys(data);\r\n        const similar = dataKeys.filter(\r\n          (key) => this.levenshteinDistance(key, missing) <= 2\r\n        );\r\n\r\n        if (similar.length > 0) {\r\n          suggestions.push(`Did you mean: ${similar.join(', ')}?`);\r\n        }\r\n      }\r\n    }\r\n\r\n    return [...new Set(suggestions)]; // Deduplicate\r\n  }\r\n\r\n  private levenshteinDistance(a: string, b: string): number {\r\n    const matrix: number[][] = [];\r\n\r\n    for (let i = 0; i <= b.length; i++) {\r\n      matrix[i] = [i];\r\n    }\r\n\r\n    for (let j = 0; j <= a.length; j++) {\r\n      matrix[0][j] = j;\r\n    }\r\n\r\n    for (let i = 1; i <= b.length; i++) {\r\n      for (let j = 1; j <= a.length; j++) {\r\n        if (b.charAt(i - 1) === a.charAt(j - 1)) {\r\n          matrix[i][j] = matrix[i - 1][j - 1];\r\n        } else {\r\n          matrix[i][j] = Math.min(\r\n            matrix[i - 1][j - 1] + 1, // substitution\r\n            matrix[i][j - 1] + 1, // insertion\r\n            matrix[i - 1][j] + 1 // deletion\r\n          );\r\n        }\r\n      }\r\n    }\r\n\r\n    return matrix[b.length][a.length];\r\n  }\r\n}\r\n"],"names":["Ajv","addFormats","StandardError","ErrorCode","getGlobalLogger","fs","path","logger","INTEGRATION_CATEGORIES","IntegrationSchemaValidator","config","ajv","schemaCache","migrations","initialized","schemaPath","enableCache","strictMode","maxCacheSize","schemaExtension","allErrors","strict","validateFormats","verbose","Map","debug","initialize","access","categories","loadSchemaDirectory","info","length","schemasLoaded","size","error","CONFIGURATION_ERROR","message","shutdown","clear","validate","data","schemaId","version","ensureInitialized","startTime","Date","now","schema","getSchema","valid","validator","errors","formatErrors","warn","errorCount","duration","VALIDATION_FAILED","suggestions","generateSuggestions","validateBatch","records","options","result","totalRecords","validRecords","invalidRecords","i","push","index","context","failFast","total","invalid","migrate","fromVersion","toVersion","transition","migrationFn","migrated","registerMigration","cacheKey","has","get","loadSchema","set","firstKey","keys","next","value","delete","hasSchema","listSchemas","category","schemas","Array","from","map","key","split","filter","id","self","indexOf","startsWith","getVersions","versions","v","schemaDir","join","files","readdir","fileVersions","f","endsWith","match","allVersions","Set","sort","getCategories","getConfig","loadedCategories","categoryPath","loadCategorySchemas","entries","withFileTypes","entry","isDirectory","schemaName","name","loadSchemaVersions","isFile","replace","loadSchemaFile","file","versionMatch","filePath","content","readFile","JSON","parse","schemaKey","$id","metadata","description","compile","slice","versionedFile","actualVersion","directFile","FILE_NOT_FOUND","searchPaths","instancePath","keyword","params","missingProperty","missing","dataKeys","Object","similar","levenshteinDistance","a","b","matrix","j","charAt","Math","min"],"mappings":"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"}