@specverse/engine-realize 3.5.3

package/dist/utils/manifest-loader.js

@@ -0,0 +1,168 @@
+/**
+ * Manifest Loader Utility
+ *
+ * Loads and validates SpecVerse manifest files.
+ * Provides default manifests for testing and development.
+ */
+import { readFileSync, existsSync } from 'fs';
+import { parse as parseYaml } from 'yaml';
+import { resolve } from 'path';
+/**
+ * Load manifest from file
+ */
+export function loadManifest(manifestPath) {
+    if (!manifestPath) {
+        throw new Error('Manifest path is required');
+    }
+    const fullPath = resolve(manifestPath);
+    if (!existsSync(fullPath)) {
+        throw new Error(`Manifest file not found: ${fullPath}`);
+    }
+    try {
+        const yamlContent = readFileSync(fullPath, 'utf8');
+        const parsed = parseYaml(yamlContent);
+        // Handle unified container format (manifests: { ManifestName: { ... } })
+        if (parsed.manifests && typeof parsed.manifests === 'object') {
+            const manifestKeys = Object.keys(parsed.manifests);
+            if (manifestKeys.length === 0) {
+                throw new Error('Manifests container is empty');
+            }
+            // Use first manifest
+            const manifestName = manifestKeys[0];
+            const manifest = parsed.manifests[manifestName];
+            // Add metadata
+            manifest._manifestName = manifestName;
+            manifest._manifestPath = fullPath;
+            return manifest;
+        }
+        // Handle direct manifest format (legacy or simplified)
+        if (parsed.specVersion) {
+            return parsed;
+        }
+        throw new Error('Invalid manifest format: missing "manifests" container or "specVersion"');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Manifest file not found: ${fullPath}`);
+        }
+        throw new Error(`Failed to load manifest: ${error.message}`);
+    }
+}
+/**
+ * Get manifest configuration value by path
+ */
+export function getManifestValue(manifest, path, defaultValue) {
+    if (!manifest || !path) {
+        return defaultValue;
+    }
+    const parts = path.split('.');
+    let current = manifest;
+    for (const part of parts) {
+        if (current && typeof current === 'object' && part in current) {
+            current = current[part];
+        }
+        else {
+            return defaultValue;
+        }
+    }
+    return current;
+}
+/**
+ * Validate manifest structure (v3.3 only - no backward compatibility)
+ */
+export function validateManifest(manifest) {
+    const errors = [];
+    if (!manifest) {
+        errors.push('Manifest is null or undefined');
+        return { valid: false, errors };
+    }
+    // Required fields
+    if (!manifest.specVersion) {
+        errors.push('Missing required field: specVersion');
+    }
+    else if (!manifest.specVersion.match(/^\d+\.\d+/)) {
+        errors.push(`Invalid specVersion format: ${manifest.specVersion}. Expected semver (e.g., 3.5.0).`);
+    }
+    if (!manifest.name) {
+        errors.push('Missing required field: name');
+    }
+    if (!manifest.version) {
+        errors.push('Missing required field: version');
+    }
+    // v3.3 required: deployment reference
+    if (!manifest.deployment) {
+        errors.push('Missing required field: deployment (must reference a deployment specification)');
+    }
+    else {
+        if (!manifest.deployment.deploymentSource) {
+            errors.push('deployment.deploymentSource is required');
+        }
+        if (!manifest.deployment.deploymentName) {
+            errors.push('deployment.deploymentName is required');
+        }
+    }
+    // v3.3 required: at least one mapping strategy
+    const hasMappings = manifest.defaultMappings ||
+        (manifest.capabilityMappings && manifest.capabilityMappings.length > 0) ||
+        (manifest.instanceMappings && manifest.instanceMappings.length > 0);
+    if (!hasMappings) {
+        errors.push('At least one mapping strategy is required: defaultMappings, capabilityMappings, or instanceMappings');
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+/**
+ * Merge manifests (v3.3 composition)
+ */
+export function mergeManifests(baseManifest, overrideManifest) {
+    if (!baseManifest)
+        return overrideManifest || null;
+    if (!overrideManifest)
+        return baseManifest;
+    // v3.3 merge: arrays override completely, objects merge
+    return {
+        ...baseManifest,
+        ...overrideManifest,
+        // Deployment reference: override completely
+        deployment: overrideManifest.deployment || baseManifest.deployment,
+        // Default mappings: merge objects
+        defaultMappings: {
+            ...(baseManifest.defaultMappings || {}),
+            ...(overrideManifest.defaultMappings || {})
+        },
+        // Capability mappings: override array completely
+        capabilityMappings: overrideManifest.capabilityMappings || baseManifest.capabilityMappings,
+        // Instance mappings: override array completely
+        instanceMappings: overrideManifest.instanceMappings || baseManifest.instanceMappings,
+        // Configuration: merge objects
+        configuration: {
+            ...(baseManifest.configuration || {}),
+            ...(overrideManifest.configuration || {})
+        }
+    };
+}
+/**
+ * Get manifest summary for debugging
+ */
+export function getManifestSummary(manifest) {
+    const strategies = [];
+    if (manifest.defaultMappings) {
+        const count = Object.keys(manifest.defaultMappings).length;
+        strategies.push(`defaultMappings (${count} categories)`);
+    }
+    if (manifest.capabilityMappings && manifest.capabilityMappings.length > 0) {
+        strategies.push(`capabilityMappings (${manifest.capabilityMappings.length} patterns)`);
+    }
+    if (manifest.instanceMappings && manifest.instanceMappings.length > 0) {
+        strategies.push(`instanceMappings (${manifest.instanceMappings.length} instances)`);
+    }
+    return {
+        name: manifest.name,
+        version: manifest.version,
+        deployment: `${manifest.deployment?.deploymentName || 'unknown'} from ${manifest.deployment?.deploymentSource || 'unknown'}`,
+        mappingStrategies: strategies
+    };
+}
+//# sourceMappingURL=manifest-loader.js.map

package/dist/utils/manifest-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.js","sourceRoot":"","sources":["../../src/utils/manifest-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAmG/B;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAQ,CAAC;QAE7C,yEAAyE;QACzE,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAClD,CAAC;YAED,qBAAqB;YACrB,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAEhD,eAAe;YACf,QAAQ,CAAC,aAAa,GAAG,YAAY,CAAC;YACtC,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC;YAElC,OAAO,QAA0B,CAAC;QACpC,CAAC;QAED,uDAAuD;QACvD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,MAAwB,CAAC;QAClC,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAE7F,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA2C,EAC3C,IAAY,EACZ,YAAkB;IAElB,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAQ,QAAQ,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;YAC9D,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA2C;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,CAAC,WAAW,kCAAkC,CAAC,CAAC;IACrG,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAChG,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,eAAe;QACxB,CAAC,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;QACvE,CAAC,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAExF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,qGAAqG,CAAC,CAAC;IACrH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,YAA+C,EAC/C,gBAAmD;IAEnD,IAAI,CAAC,YAAY;QAAE,OAAO,gBAAgB,IAAI,IAAI,CAAC;IACnD,IAAI,CAAC,gBAAgB;QAAE,OAAO,YAAY,CAAC;IAE3C,wDAAwD;IACxD,OAAO;QACL,GAAG,YAAY;QACf,GAAG,gBAAgB;QACnB,4CAA4C;QAC5C,UAAU,EAAE,gBAAgB,CAAC,UAAU,IAAI,YAAY,CAAC,UAAU;QAClE,kCAAkC;QAClC,eAAe,EAAE;YACf,GAAG,CAAC,YAAY,CAAC,eAAe,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,gBAAgB,CAAC,eAAe,IAAI,EAAE,CAAC;SAC5C;QACD,iDAAiD;QACjD,kBAAkB,EAAE,gBAAgB,CAAC,kBAAkB,IAAI,YAAY,CAAC,kBAAkB;QAC1F,+CAA+C;QAC/C,gBAAgB,EAAE,gBAAgB,CAAC,gBAAgB,IAAI,YAAY,CAAC,gBAAgB;QACpF,+BAA+B;QAC/B,aAAa,EAAE;YACb,GAAG,CAAC,YAAY,CAAC,aAAa,IAAI,EAAE,CAAC;YACrC,GAAG,CAAC,gBAAgB,CAAC,aAAa,IAAI,EAAE,CAAC;SAC1C;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IAOzD,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;QAC3D,UAAU,CAAC,IAAI,CAAC,oBAAoB,KAAK,cAAc,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1E,UAAU,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,kBAAkB,CAAC,MAAM,YAAY,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,UAAU,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,gBAAgB,CAAC,MAAM,aAAa,CAAC,CAAC;IACtF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,UAAU,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,cAAc,IAAI,SAAS,SAAS,QAAQ,CAAC,UAAU,EAAE,gBAAgB,IAAI,SAAS,EAAE;QAC5H,iBAAiB,EAAE,UAAU;KAC9B,CAAC;AACJ,CAAC"}

package/dist/utils/mapping-migration.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Mapping Migration Utilities
+ *
+ * Converts legacy three-level mapping system (v3.3) to new two-level system (v3.6).
+ * Provides backward compatibility while encouraging migration to the simpler format.
+ *
+ * @module realize/utils/mapping-migration
+ * @version 3.6.0
+ */
+import type { ManifestConfig } from './manifest-loader.js';
+import type { DefaultMappingsV2, OverrideMapping } from '../types/unified-mappings.js';
+/**
+ * Convert legacy three-level mappings to new two-level system
+ *
+ * Migrates:
+ * - defaultMappings (v3.3) → defaults (v3.6)
+ * - capabilityMappings (v3.3) → overrides (v3.6)
+ * - instanceMappings (v3.3) → overrides (v3.6) with configuration
+ *
+ * @param manifest - Manifest with legacy mappings
+ * @returns Manifest with new two-level mappings
+ */
+export declare function migrateToTwoLevelSystem(manifest: ManifestConfig): ManifestConfig;
+/**
+ * Detect which mapping system is in use
+ *
+ * @param manifest - Manifest to analyze
+ * @returns Mapping system version
+ */
+export declare function detectMappingSystem(manifest: ManifestConfig): 'v3.6' | 'v3.3' | 'none';
+/**
+ * Get effective mappings using the appropriate system
+ *
+ * Automatically migrates if using legacy system.
+ *
+ * @param manifest - Manifest configuration
+ * @returns Defaults and overrides (migrated if necessary)
+ */
+export declare function getEffectiveMappings(manifest: ManifestConfig): {
+    defaults?: DefaultMappingsV2;
+    overrides?: OverrideMapping[];
+    system: 'v3.6' | 'v3.3' | 'none';
+};
+/**
+ * Validate that manifest uses consistent mapping system
+ *
+ * Warns if mixing v3.3 and v3.6 systems.
+ *
+ * @param manifest - Manifest to validate
+ * @returns Validation warnings
+ */
+export declare function validateMappingConsistency(manifest: ManifestConfig): string[];
+//# sourceMappingURL=mapping-migration.d.ts.map

package/dist/utils/mapping-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-migration.d.ts","sourceRoot":"","sources":["../../src/utils/mapping-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAOtC;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAwChF;AAkED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAsBtF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG;IAC9D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAClC,CAyBA;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAmB7E"}

package/dist/utils/mapping-migration.js

@@ -0,0 +1,194 @@
+/**
+ * Mapping Migration Utilities
+ *
+ * Converts legacy three-level mapping system (v3.3) to new two-level system (v3.6).
+ * Provides backward compatibility while encouraging migration to the simpler format.
+ *
+ * @module realize/utils/mapping-migration
+ * @version 3.6.0
+ */
+/**
+ * Convert legacy three-level mappings to new two-level system
+ *
+ * Migrates:
+ * - defaultMappings (v3.3) → defaults (v3.6)
+ * - capabilityMappings (v3.3) → overrides (v3.6)
+ * - instanceMappings (v3.3) → overrides (v3.6) with configuration
+ *
+ * @param manifest - Manifest with legacy mappings
+ * @returns Manifest with new two-level mappings
+ */
+export function migrateToTwoLevelSystem(manifest) {
+    // If already using new system, return as-is
+    if (manifest.defaults || manifest.overrides) {
+        return manifest;
+    }
+    // If no legacy mappings, return as-is
+    if (!manifest.defaultMappings && !manifest.capabilityMappings && !manifest.instanceMappings) {
+        return manifest;
+    }
+    const migrated = {
+        ...manifest,
+        defaults: undefined,
+        overrides: []
+    };
+    // Step 1: Convert defaultMappings → defaults
+    if (manifest.defaultMappings) {
+        migrated.defaults = convertDefaultMappings(manifest.defaultMappings);
+    }
+    // Step 2: Convert capabilityMappings → overrides
+    if (manifest.capabilityMappings) {
+        const capabilityOverrides = convertCapabilityMappings(manifest.capabilityMappings);
+        migrated.overrides.push(...capabilityOverrides);
+    }
+    // Step 3: Convert instanceMappings → overrides (with configuration)
+    if (manifest.instanceMappings) {
+        const instanceOverrides = convertInstanceMappings(manifest.instanceMappings);
+        migrated.overrides.push(...instanceOverrides);
+    }
+    // Remove empty overrides array
+    if (migrated.overrides && migrated.overrides.length === 0) {
+        delete migrated.overrides;
+    }
+    return migrated;
+}
+/**
+ * Convert v3.3 DefaultMappings to v3.6 DefaultMappingsV2
+ *
+ * Maps v3.3 architectural layer names to v3.6 technology category names.
+ *
+ * v3.3 uses: controller, service, view, storage, security, infrastructure, monitoring, communication
+ * v3.6 uses: api, orm, cache, queue, auth, email, storage, search, logging, monitoring
+ *
+ * @param legacy - Legacy default mappings
+ * @returns New default mappings
+ */
+function convertDefaultMappings(legacy) {
+    const converted = {};
+    // Map v3.3 architectural layers to v3.6 technology categories
+    if (legacy.controller)
+        converted.api = legacy.controller; // controller → api (REST endpoints)
+    if (legacy.service)
+        converted.orm = legacy.service; // service → orm (often uses DB)
+    if (legacy.storage)
+        converted.storage = legacy.storage; // storage → storage (direct mapping)
+    if (legacy.security)
+        converted.auth = legacy.security; // security → auth
+    if (legacy.monitoring)
+        converted.monitoring = legacy.monitoring; // monitoring → monitoring (direct)
+    if (legacy.communication)
+        converted.email = legacy.communication; // communication → email
+    if (legacy.infrastructure) {
+        // Infrastructure can map to cache or queue depending on context
+        // For now, map to cache as a reasonable default
+        converted.cache = legacy.infrastructure;
+    }
+    // Note: v3.3 'view' doesn't have a direct v3.6 equivalent
+    // View is typically UI layer, not part of backend mappings
+    return converted;
+}
+/**
+ * Convert v3.3 CapabilityMappings to v3.6 OverrideMappings
+ *
+ * @param legacy - Legacy capability mappings
+ * @returns Override mappings
+ */
+function convertCapabilityMappings(legacy) {
+    return legacy.map(mapping => ({
+        target: mapping.capability,
+        factory: mapping.instanceFactory,
+        version: mapping.version,
+        configuration: mapping.configuration,
+        namespace: mapping.namespace
+    }));
+}
+/**
+ * Convert v3.3 InstanceMappings to v3.6 OverrideMappings
+ *
+ * @param legacy - Legacy instance mappings
+ * @returns Override mappings with configuration
+ */
+function convertInstanceMappings(legacy) {
+    return legacy.map(mapping => ({
+        target: mapping.instanceName, // Instance name as target
+        factory: mapping.instanceFactory,
+        version: mapping.version,
+        configuration: mapping.configuration
+    }));
+}
+/**
+ * Detect which mapping system is in use
+ *
+ * @param manifest - Manifest to analyze
+ * @returns Mapping system version
+ */
+export function detectMappingSystem(manifest) {
+    const hasNewSystem = !!(manifest.defaults || manifest.overrides);
+    const hasLegacySystem = !!(manifest.defaultMappings ||
+        manifest.capabilityMappings ||
+        manifest.instanceMappings);
+    if (hasNewSystem && hasLegacySystem) {
+        // Both systems present - prefer new one
+        return 'v3.6';
+    }
+    if (hasNewSystem) {
+        return 'v3.6';
+    }
+    if (hasLegacySystem) {
+        return 'v3.3';
+    }
+    return 'none';
+}
+/**
+ * Get effective mappings using the appropriate system
+ *
+ * Automatically migrates if using legacy system.
+ *
+ * @param manifest - Manifest configuration
+ * @returns Defaults and overrides (migrated if necessary)
+ */
+export function getEffectiveMappings(manifest) {
+    const system = detectMappingSystem(manifest);
+    if (system === 'v3.6') {
+        return {
+            defaults: manifest.defaults,
+            overrides: manifest.overrides,
+            system: 'v3.6'
+        };
+    }
+    if (system === 'v3.3') {
+        const migrated = migrateToTwoLevelSystem(manifest);
+        return {
+            defaults: migrated.defaults,
+            overrides: migrated.overrides,
+            system: 'v3.3'
+        };
+    }
+    return {
+        defaults: undefined,
+        overrides: undefined,
+        system: 'none'
+    };
+}
+/**
+ * Validate that manifest uses consistent mapping system
+ *
+ * Warns if mixing v3.3 and v3.6 systems.
+ *
+ * @param manifest - Manifest to validate
+ * @returns Validation warnings
+ */
+export function validateMappingConsistency(manifest) {
+    const warnings = [];
+    const hasNewSystem = !!(manifest.defaults || manifest.overrides);
+    const hasLegacySystem = !!(manifest.defaultMappings ||
+        manifest.capabilityMappings ||
+        manifest.instanceMappings);
+    if (hasNewSystem && hasLegacySystem) {
+        warnings.push('Manifest contains both v3.6 (defaults/overrides) and v3.3 (defaultMappings/capabilityMappings/instanceMappings) mapping systems. ' +
+            'Using v3.6 system and ignoring v3.3 mappings. ' +
+            'Remove legacy mappings to avoid confusion.');
+    }
+    return warnings;
+}
+//# sourceMappingURL=mapping-migration.js.map

package/dist/utils/mapping-migration.js.map

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