@specverse/engines 4.1.0

package/dist/realize/library/loader.js

@@ -0,0 +1,159 @@
+/**
+ * Instance Factory Loader
+ *
+ * Loads instance factory definitions from YAML files
+ * and validates them against the JSON Schema.
+ */
+import { readFile } from 'fs/promises';
+import { glob } from 'glob';
+import path from 'path';
+import yaml from 'yaml';
+import AjvModule from 'ajv';
+import addFormatsModule from 'ajv-formats';
+const Ajv = AjvModule.default || AjvModule;
+const addFormats = addFormatsModule.default || addFormatsModule;
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Load JSON Schema for validation
+let instanceFactorySchema;
+async function loadSchema() {
+    if (!instanceFactorySchema) {
+        // Load schema from engine-entities (single source of truth)
+        // Falls back to local copy if engine-entities not available
+        let schemaPath;
+        try {
+            const { createRequire } = await import('module');
+            const require = createRequire(import.meta.url);
+            const entitiesPkg = path.dirname(require.resolve('@specverse/entities/package.json'));
+            schemaPath = path.join(entitiesPkg, 'schema', 'SPECVERSE-SCHEMA.json');
+        }
+        catch {
+            // Fallback to local copy (for standalone usage)
+            schemaPath = path.join(__dirname, '../../schema/SPECVERSE-SCHEMA.json');
+        }
+        const schemaContent = await readFile(schemaPath, 'utf-8');
+        const fullSchema = JSON.parse(schemaContent);
+        instanceFactorySchema = fullSchema.$defs?.InstanceFactoryDefinition;
+        if (!instanceFactorySchema) {
+            throw new Error('InstanceFactoryDefinition not found in SPECVERSE-SCHEMA.json');
+        }
+    }
+    return instanceFactorySchema;
+}
+/**
+ * Load a single instance factory from a YAML file
+ */
+export async function loadInstanceFactory(filePath, options = {}) {
+    const validate = options.validate !== false;
+    // Read and parse YAML
+    const content = await readFile(filePath, 'utf-8');
+    const parsed = yaml.parse(content);
+    // Validate against schema if requested
+    if (validate) {
+        const schema = await loadSchema();
+        // Skip validation if no schema available (schema was consolidated)
+        if (schema) {
+            const ajv = new Ajv({ allErrors: true, strict: false });
+            addFormats(ajv); // Add support for format validators like "uri"
+            const validateFn = ajv.compile(schema);
+            if (!validateFn(parsed)) {
+                const errors = validateFn.errors?.map((err) => {
+                    const path = err.instancePath || '/';
+                    return `${path}: ${err.message}`;
+                }) || ['Unknown validation error'];
+                throw new Error(`Instance factory validation failed for ${filePath}:\n` +
+                    errors.map((e) => `  - ${e}`).join('\n'));
+            }
+        }
+    }
+    const warnings = [];
+    // Check for optional but recommended fields
+    if (!parsed.description) {
+        warnings.push('Missing recommended field: description');
+    }
+    if (!parsed.metadata?.author) {
+        warnings.push('Missing recommended metadata: author');
+    }
+    return {
+        type: parsed,
+        filePath,
+        warnings: warnings.length > 0 ? warnings : undefined
+    };
+}
+/**
+ * Load all instance factories from a directory
+ */
+export async function loadInstanceFactories(options) {
+    const { baseDir, pattern = '**/*.yaml', validate = true, ignoreInvalid = false } = options;
+    const types = [];
+    const errors = [];
+    // Find all YAML files matching the pattern
+    const files = await glob(pattern, {
+        cwd: baseDir,
+        absolute: true,
+        nodir: true
+    });
+    // Load each file
+    for (const filePath of files) {
+        try {
+            const result = await loadInstanceFactory(filePath, { validate });
+            types.push(result);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (ignoreInvalid) {
+                errors.push({
+                    filePath,
+                    errors: [errorMessage]
+                });
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    return { types, errors };
+}
+/**
+ * Load instance factories from multiple directories
+ *
+ * Directories are searched in order, with earlier directories
+ * taking precedence for duplicate type names.
+ */
+export async function loadFromMultipleSources(sources, options = {}) {
+    const allTypes = [];
+    const allErrors = [];
+    const seenTypes = new Set();
+    for (const source of sources) {
+        const result = await loadInstanceFactories({
+            baseDir: source.path,
+            pattern: source.pattern,
+            validate: options.validate,
+            ignoreInvalid: options.ignoreInvalid
+        });
+        // Filter out duplicate types (first source wins)
+        for (const loadResult of result.types) {
+            const typeName = loadResult.type.name;
+            if (!seenTypes.has(typeName)) {
+                seenTypes.add(typeName);
+                allTypes.push(loadResult);
+            }
+            else {
+                // Add warning about duplicate
+                const existing = allTypes.find(t => t.type.name === typeName);
+                if (existing) {
+                    existing.warnings = existing.warnings || [];
+                    existing.warnings.push(`Duplicate type "${typeName}" found in ${loadResult.filePath} (ignored)`);
+                }
+            }
+        }
+        allErrors.push(...result.errors);
+    }
+    return {
+        types: allTypes,
+        errors: allErrors
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/realize/library/loader.js.map

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

package/dist/realize/library/resolver.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Instance Factory Resolver
+ *
+ * Resolves deployment capabilities to instance factories
+ * using manifest configuration and capability mappings.
+ */
+import { InstanceFactoryLibrary } from './library.js';
+import type { CapabilityMapping, InstanceMapping, DefaultMappings, ResolvedImplementation } from '../types/index.js';
+/**
+ * Resolver configuration (v3.3 hybrid mapping only)
+ */
+export interface ResolverConfig {
+    /** v3.3 Hybrid Mapping System */
+    defaultMappings?: DefaultMappings;
+    capabilityMappings?: CapabilityMapping[];
+    instanceMappings?: InstanceMapping[];
+    /** Global configuration overrides */
+    globalConfiguration?: Record<string, any>;
+}
+/**
+ * Resolution context for a deployment instance
+ */
+export interface ResolutionContext {
+    /** Deployment instance being resolved */
+    instance: any;
+    /** Component name */
+    componentName?: string;
+    /** Environment name */
+    environment?: string;
+    /** Additional context properties */
+    [key: string]: any;
+}
+/**
+ * Resolution error
+ */
+export declare class ResolutionError extends Error {
+    capability: string;
+    instance?: any;
+    constructor(message: string, capability: string, instance?: any);
+}
+/**
+ * Resolver for mapping capabilities to instance factories
+ */
+export declare class InstanceFactoryResolver {
+    private library;
+    private validator;
+    private config;
+    constructor(library: InstanceFactoryLibrary, config?: ResolverConfig);
+    /**
+     * Resolve a single capability to an instance factory (v3.3 hybrid mapping)
+     *
+     * Resolution priority:
+     * 1. Instance-specific mapping (instanceMappings) - highest priority
+     * 2. Capability-based mapping (capabilityMappings) - medium priority
+     * 3. Default category mapping (defaultMappings) - lowest priority
+     */
+    resolveCapability(capability: string, context?: ResolutionContext): ResolvedImplementation;
+    /**
+     * Resolve all capabilities for a deployment instance
+     */
+    resolveForInstance(instance: any, context?: ResolutionContext): ResolvedImplementation[];
+    /**
+     * Resolve all capabilities for a deployment
+     */
+    resolveForDeployment(deployment: any, context?: Omit<ResolutionContext, 'instance'>): Map<string, ResolvedImplementation[]>;
+    /**
+     * Find capability mapping that matches the given capability
+     *
+     * Supports wildcard patterns (e.g., "api.*" matches "api.rest", "api.graphql")
+     */
+    private findCapabilityMapping;
+    /**
+     * Extract capabilities from a deployment instance
+     */
+    private getInstanceCapabilities;
+    /**
+     * Apply template overrides to an instance factory
+     */
+    private applyTemplateOverrides;
+    /**
+     * Infer instance category from capability pattern (v3.3)
+     *
+     * Used as fallback when instance doesn't have explicit category
+     */
+    private inferCategoryFromCapability;
+    /**
+     * Get configuration summary for debugging
+     */
+    getConfigSummary(): {
+        capabilityMappings: number;
+        instanceMappings: number;
+        defaultMappings: number;
+    };
+}
+/**
+ * Create a resolver from manifest data (v3.3 hybrid mapping only)
+ */
+export declare function createResolver(library: InstanceFactoryLibrary, manifest: {
+    defaultMappings?: DefaultMappings;
+    capabilityMappings?: CapabilityMapping[];
+    instanceMappings?: InstanceMapping[];
+    configuration?: Record<string, any>;
+}): InstanceFactoryResolver;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/realize/library/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/realize/library/resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAEV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IAErC,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,EAAE,GAAG,CAAC;IAEd,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,UAAU,EAAE,MAAM;IAClB,QAAQ,CAAC,EAAE,GAAG;gBAFrB,OAAO,EAAE,MAAM,EACR,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,GAAG;CAKxB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,MAAM,CAAiB;gBAEnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,GAAE,cAAmB;IAMxE;;;;;;;OAOG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,sBAAsB;IA+FzB;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,sBAAsB,EAAE;IAuDxF;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAkB3H;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAwCnC;;OAEG;IACH,gBAAgB,IAAI;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB;CAOF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE;IACR,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC,GACA,uBAAuB,CAOzB"}

package/dist/realize/library/resolver.js

@@ -0,0 +1,299 @@
+/**
+ * Instance Factory Resolver
+ *
+ * Resolves deployment capabilities to instance factories
+ * using manifest configuration and capability mappings.
+ */
+import path from 'path';
+import { InstanceFactoryValidator } from './validator.js';
+/**
+ * Resolution error
+ */
+export class ResolutionError extends Error {
+    capability;
+    instance;
+    constructor(message, capability, instance) {
+        super(message);
+        this.capability = capability;
+        this.instance = instance;
+        this.name = 'ResolutionError';
+    }
+}
+/**
+ * Resolver for mapping capabilities to instance factories
+ */
+export class InstanceFactoryResolver {
+    library;
+    validator;
+    config;
+    constructor(library, config = {}) {
+        this.library = library;
+        this.validator = new InstanceFactoryValidator();
+        this.config = config;
+    }
+    /**
+     * Resolve a single capability to an instance factory (v3.3 hybrid mapping)
+     *
+     * Resolution priority:
+     * 1. Instance-specific mapping (instanceMappings) - highest priority
+     * 2. Capability-based mapping (capabilityMappings) - medium priority
+     * 3. Default category mapping (defaultMappings) - lowest priority
+     */
+    resolveCapability(capability, context) {
+        let factoryName;
+        let mappingConfig;
+        let mappingVersion;
+        // PRIORITY 1: Check for instance-specific mapping
+        if (context?.instance?.name && this.config.instanceMappings) {
+            const instanceMapping = this.config.instanceMappings.find(m => m.instanceName === context.instance.name);
+            if (instanceMapping) {
+                factoryName = instanceMapping.instanceFactory;
+                mappingConfig = instanceMapping.configuration;
+                mappingVersion = instanceMapping.version;
+            }
+        }
+        // PRIORITY 2: Check for capability-based mapping
+        if (!factoryName) {
+            const capabilityMapping = this.findCapabilityMapping(capability);
+            if (capabilityMapping) {
+                factoryName = capabilityMapping.instanceFactory;
+                mappingConfig = capabilityMapping.configuration;
+                mappingVersion = capabilityMapping.version;
+            }
+        }
+        // PRIORITY 3: Check for default category mapping
+        if (!factoryName && context?.instance && this.config.defaultMappings) {
+            const instanceCategory = context.instance.category || this.inferCategoryFromCapability(capability);
+            if (instanceCategory) {
+                factoryName = this.config.defaultMappings[instanceCategory];
+            }
+        }
+        // If still no factory found, throw error
+        if (!factoryName) {
+            throw new ResolutionError(`No instance factory mapping found for capability "${capability}".\n` +
+                `  Instance: ${context?.instance?.name || 'unknown'}\n` +
+                `  Tried: instanceMappings, capabilityMappings, defaultMappings`, capability, context?.instance);
+        }
+        // Resolve instance factory by name
+        const loadResult = this.library.resolveWithMetadata(factoryName);
+        if (!loadResult) {
+            throw new ResolutionError(`Instance factory "${factoryName}" not found in library`, capability, context?.instance);
+        }
+        const factory = loadResult.type;
+        // Get package root (3 levels up from libs/instance-factories/backend)
+        const basePath = path.resolve(path.dirname(loadResult.filePath), '../../..');
+        // Merge configuration in order of precedence:
+        // 1. Instance factory defaults
+        // 2. Global configuration
+        // 3. Mapping configuration overrides
+        const configuration = {
+            ...(factory.configuration || {}),
+            ...(this.config.globalConfiguration || {}),
+            ...(mappingConfig || {})
+        };
+        // Validate the resolved implementation
+        const validationResult = this.validator.validateComplete(factory, {
+            specverseVersion: process.env.SPECVERSE_VERSION || '4.0.0'
+        });
+        if (!validationResult.compatible) {
+            throw new ResolutionError(`Instance factory "${factory.name}" validation failed:\n` +
+                (validationResult.errors || []).map(e => `  - ${e}`).join('\n'), capability, context?.instance);
+        }
+        return {
+            capability,
+            instanceFactory: factory,
+            instance: context?.instance,
+            configuration,
+            basePath
+        };
+    }
+    /**
+     * Resolve all capabilities for a deployment instance
+     */
+    resolveForInstance(instance, context) {
+        const resolved = [];
+        // Get capabilities from instance
+        const capabilities = this.getInstanceCapabilities(instance);
+        // Resolve each capability
+        for (const capability of capabilities) {
+            try {
+                const resolution = this.resolveCapability(capability, {
+                    ...context,
+                    instance
+                });
+                resolved.push(resolution);
+            }
+            catch (error) {
+                // Re-throw with additional context
+                if (error instanceof ResolutionError) {
+                    throw error;
+                }
+                throw new ResolutionError(`Failed to resolve capability "${capability}": ${error instanceof Error ? error.message : String(error)}`, capability, instance);
+            }
+        }
+        // Validate dependencies between resolved implementations
+        const depResult = this.validator.validateDependencies(resolved);
+        if (!depResult.satisfied) {
+            const errors = [];
+            if (depResult.missing) {
+                errors.push(...depResult.missing);
+            }
+            if (depResult.conflicts) {
+                for (const conflict of depResult.conflicts) {
+                    errors.push(`Conflict for capability "${conflict.capability}": ` +
+                        `required by "${conflict.required}", available in "${conflict.available}"`);
+                }
+            }
+            throw new ResolutionError(`Dependency validation failed:\n${errors.map(e => `  - ${e}`).join('\n')}`, 'multiple', instance);
+        }
+        return resolved;
+    }
+    /**
+     * Resolve all capabilities for a deployment
+     */
+    resolveForDeployment(deployment, context) {
+        const resolvedByInstance = new Map();
+        // Get all instances from deployment
+        const instances = deployment.instances || {};
+        for (const [instanceName, instance] of Object.entries(instances)) {
+            const resolved = this.resolveForInstance(instance, {
+                ...context,
+                instance
+            });
+            resolvedByInstance.set(instanceName, resolved);
+        }
+        return resolvedByInstance;
+    }
+    /**
+     * Find capability mapping that matches the given capability
+     *
+     * Supports wildcard patterns (e.g., "api.*" matches "api.rest", "api.graphql")
+     */
+    findCapabilityMapping(capability) {
+        if (!this.config.capabilityMappings) {
+            return undefined;
+        }
+        // First try exact match
+        for (const mapping of this.config.capabilityMappings) {
+            if (mapping.capability === capability) {
+                return mapping;
+            }
+        }
+        // Then try wildcard match
+        for (const mapping of this.config.capabilityMappings) {
+            if (mapping.capability.includes('*')) {
+                const pattern = mapping.capability.replace(/\*/g, '.*');
+                if (new RegExp(`^${pattern}$`).test(capability)) {
+                    return mapping;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract capabilities from a deployment instance
+     */
+    getInstanceCapabilities(instance) {
+        const capabilities = [];
+        // From "advertises" field
+        if (instance.advertises) {
+            if (Array.isArray(instance.advertises)) {
+                capabilities.push(...instance.advertises);
+            }
+            else if (typeof instance.advertises === 'string') {
+                capabilities.push(instance.advertises);
+            }
+        }
+        // From "capabilities" field (alternative format)
+        if (instance.capabilities) {
+            if (Array.isArray(instance.capabilities)) {
+                capabilities.push(...instance.capabilities);
+            }
+            else if (typeof instance.capabilities === 'string') {
+                capabilities.push(instance.capabilities);
+            }
+        }
+        return [...new Set(capabilities)]; // Remove duplicates
+    }
+    /**
+     * Apply template overrides to an instance factory
+     */
+    applyTemplateOverrides(factory, overrides) {
+        const newCodeTemplates = { ...factory.codeTemplates };
+        for (const [templateName, templatePath] of Object.entries(overrides)) {
+            if (newCodeTemplates[templateName]) {
+                newCodeTemplates[templateName] = {
+                    ...newCodeTemplates[templateName],
+                    template: templatePath
+                };
+            }
+        }
+        return {
+            ...factory,
+            codeTemplates: newCodeTemplates
+        };
+    }
+    /**
+     * Infer instance category from capability pattern (v3.3)
+     *
+     * Used as fallback when instance doesn't have explicit category
+     */
+    inferCategoryFromCapability(capability) {
+        const capabilityToCategoryMap = {
+            'api.rest': 'controller',
+            'api.graphql': 'controller',
+            'api.websocket': 'controller',
+            'service': 'service',
+            'validation': 'service',
+            'sdk': 'view',
+            'ui': 'view',
+            'frontend': 'view',
+            'storage': 'storage',
+            'database': 'storage',
+            'cache': 'storage',
+            'auth': 'security',
+            'security': 'security',
+            'infrastructure': 'infrastructure',
+            'docker': 'infrastructure',
+            'kubernetes': 'infrastructure',
+            'monitoring': 'monitoring',
+            'logging': 'monitoring',
+            'messaging': 'communication',
+            'queue': 'communication',
+            'pubsub': 'communication'
+        };
+        // Try exact match
+        if (capabilityToCategoryMap[capability]) {
+            return capabilityToCategoryMap[capability];
+        }
+        // Try prefix match
+        for (const [capPrefix, category] of Object.entries(capabilityToCategoryMap)) {
+            if (capability.startsWith(capPrefix + '.')) {
+                return category;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get configuration summary for debugging
+     */
+    getConfigSummary() {
+        return {
+            capabilityMappings: this.config.capabilityMappings?.length || 0,
+            instanceMappings: this.config.instanceMappings?.length || 0,
+            defaultMappings: Object.keys(this.config.defaultMappings || {}).length
+        };
+    }
+}
+/**
+ * Create a resolver from manifest data (v3.3 hybrid mapping only)
+ */
+export function createResolver(library, manifest) {
+    return new InstanceFactoryResolver(library, {
+        defaultMappings: manifest.defaultMappings,
+        capabilityMappings: manifest.capabilityMappings,
+        instanceMappings: manifest.instanceMappings,
+        globalConfiguration: manifest.configuration
+    });
+}
+//# sourceMappingURL=resolver.js.map

package/dist/realize/library/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/realize/library/resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAuC1D;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG/B;IACA;IAHT,YACE,OAAe,EACR,UAAkB,EAClB,QAAc;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAQ;QAClB,aAAQ,GAAR,QAAQ,CAAM;QAGrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,OAAO,CAAyB;IAChC,SAAS,CAA2B;IACpC,MAAM,CAAiB;IAE/B,YAAY,OAA+B,EAAE,SAAyB,EAAE;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAwB,EAAE,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CACf,UAAkB,EAClB,OAA2B;QAE3B,IAAI,WAA+B,CAAC;QACpC,IAAI,aAA8C,CAAC;QACnD,IAAI,cAAkC,CAAC;QAEvC,kDAAkD;QAClD,IAAI,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CACvD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,CAC9C,CAAC;YAEF,IAAI,eAAe,EAAE,CAAC;gBACpB,WAAW,GAAG,eAAe,CAAC,eAAe,CAAC;gBAC9C,aAAa,GAAG,eAAe,CAAC,aAAa,CAAC;gBAC9C,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;YACjE,IAAI,iBAAiB,EAAE,CAAC;gBACtB,WAAW,GAAG,iBAAiB,CAAC,eAAe,CAAC;gBAChD,aAAa,GAAG,iBAAiB,CAAC,aAAa,CAAC;gBAChD,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,WAAW,IAAI,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACrE,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC;YACnG,IAAI,gBAAgB,EAAE,CAAC;gBACrB,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,gBAAyC,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,eAAe,CACvB,qDAAqD,UAAU,MAAM;gBACrE,eAAe,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,SAAS,IAAI;gBACvD,gEAAgE,EAChE,UAAU,EACV,OAAO,EAAE,QAAQ,CAClB,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CACvB,qBAAqB,WAAW,wBAAwB,EACxD,UAAU,EACV,OAAO,EAAE,QAAQ,CAClB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC;QAChC,sEAAsE;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;QAE7E,8CAA8C;QAC9C,+BAA+B;QAC/B,0BAA0B;QAC1B,qCAAqC;QACrC,MAAM,aAAa,GAAG;YACpB,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC;YAC1C,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;SACzB,CAAC;QAEF,uCAAuC;QACvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE;YAChE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO;SAC3D,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,eAAe,CACvB,qBAAqB,OAAO,CAAC,IAAI,wBAAwB;gBACzD,CAAC,gBAAgB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAC/D,UAAU,EACV,OAAO,EAAE,QAAQ,CAClB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU;YACV,eAAe,EAAE,OAAO;YACxB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,aAAa;YACb,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAa,EAAE,OAA2B;QAC3D,MAAM,QAAQ,GAA6B,EAAE,CAAC;QAE9C,iCAAiC;QACjC,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAE5D,0BAA0B;QAC1B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE;oBACpD,GAAG,OAAO;oBACV,QAAQ;iBACT,CAAC,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,mCAAmC;gBACnC,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;oBACrC,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,eAAe,CACvB,iCAAiC,UAAU,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACzG,UAAU,EACV,QAAQ,CACT,CAAC;YACJ,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAa,EAAE,CAAC;YAE5B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YAED,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBAC3C,MAAM,CAAC,IAAI,CACT,4BAA4B,QAAQ,CAAC,UAAU,KAAK;wBACpD,gBAAgB,QAAQ,CAAC,QAAQ,oBAAoB,QAAQ,CAAC,SAAS,GAAG,CAC3E,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,IAAI,eAAe,CACvB,kCAAkC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC1E,UAAU,EACV,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,UAAe,EAAE,OAA6C;QACjF,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAoC,CAAC;QAEvE,oCAAoC;QACpC,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC;QAE7C,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE;gBACjD,GAAG,OAAO;gBACV,QAAQ;aACT,CAAC,CAAC;YAEH,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACK,qBAAqB,CAAC,UAAkB;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,wBAAwB;QACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACrD,IAAI,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACrD,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACxD,IAAI,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBAChD,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,QAAa;QAC3C,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,0BAA0B;QAC1B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvC,YAAY,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;iBAAM,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzC,YAAY,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACrD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,oBAAoB;IACzD,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,OAAwB,EACxB,SAAiC;QAEjC,MAAM,gBAAgB,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAEtD,KAAK,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrE,IAAI,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,gBAAgB,CAAC,YAAY,CAAC,GAAG;oBAC/B,GAAG,gBAAgB,CAAC,YAAY,CAAC;oBACjC,QAAQ,EAAE,YAAY;iBACvB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,GAAG,OAAO;YACV,aAAa,EAAE,gBAAgB;SAChC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,2BAA2B,CAAC,UAAkB;QACpD,MAAM,uBAAuB,GAA2B;YACtD,UAAU,EAAE,YAAY;YACxB,aAAa,EAAE,YAAY;YAC3B,eAAe,EAAE,YAAY;YAC7B,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,SAAS;YACvB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,UAAU;YACtB,gBAAgB,EAAE,gBAAgB;YAClC,QAAQ,EAAE,gBAAgB;YAC1B,YAAY,EAAE,gBAAgB;YAC9B,YAAY,EAAE,YAAY;YAC1B,SAAS,EAAE,YAAY;YACvB,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,eAAe;SAC1B,CAAC;QAEF,kBAAkB;QAClB,IAAI,uBAAuB,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC5E,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC3C,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,gBAAgB;QAKd,OAAO;YACL,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,IAAI,CAAC;YAC/D,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;YAC3D,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,MAAM;SACvE,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA+B,EAC/B,QAKC;IAED,OAAO,IAAI,uBAAuB,CAAC,OAAO,EAAE;QAC1C,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;QAC/C,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,mBAAmB,EAAE,QAAQ,CAAC,aAAa;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/realize/library/validator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Instance Factory Validator
+ *
+ * Validates instance factory compatibility and requirements.
+ */
+import type { InstanceFactory, ResolvedImplementation } from '../types/index.js';
+/**
+ * Compatibility validation result
+ */
+export interface CompatibilityResult {
+    /** Whether the instance factory is compatible */
+    compatible: boolean;
+    /** Error messages if incompatible */
+    errors?: string[];
+    /** Warning messages */
+    warnings?: string[];
+}
+/**
+ * Dependency resolution result
+ */
+export interface DependencyResolutionResult {
+    /** Whether all dependencies are satisfied */
+    satisfied: boolean;
+    /** Missing dependencies */
+    missing?: string[];
+    /** Version conflicts */
+    conflicts?: Array<{
+        capability: string;
+        required: string;
+        available?: string;
+    }>;
+}
+/**
+ * Validator for instance factory compatibility
+ */
+export declare class InstanceFactoryValidator {
+    /**
+     * Validate instance factory against SpecVerse version
+     */
+    validateCompatibility(factory: InstanceFactory, options?: {
+        specverseVersion?: string;
+        nodeVersion?: string;
+    }): CompatibilityResult;
+    /**
+     * Validate that all required capabilities are provided
+     */
+    validateCapabilities(factory: InstanceFactory, availableCapabilities: string[]): CompatibilityResult;
+    /**
+     * Validate dependencies between resolved implementations
+     */
+    validateDependencies(resolved: ResolvedImplementation[]): DependencyResolutionResult;
+    /**
+     * Validate that an instance factory can extend another
+     */
+    validateExtension(child: InstanceFactory, parent: InstanceFactory): CompatibilityResult;
+    /**
+     * Validate complete instance factory
+     */
+    validateComplete(factory: InstanceFactory, options?: {
+        specverseVersion?: string;
+        nodeVersion?: string;
+        availableCapabilities?: string[];
+    }): CompatibilityResult;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/realize/library/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/realize/library/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IAEpB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IAEnB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC;;OAEG;IACH,qBAAqB,CACnB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACjB,GACL,mBAAmB;IA2EtB;;OAEG;IACH,oBAAoB,CAClB,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,MAAM,EAAE,GAC9B,mBAAmB;IAuCtB;;OAEG;IACH,oBAAoB,CAClB,QAAQ,EAAE,sBAAsB,EAAE,GACjC,0BAA0B;IAyD7B;;OAEG;IACH,iBAAiB,CACf,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,eAAe,GACtB,mBAAmB;IAmCtB;;OAEG;IACH,gBAAgB,CACd,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC7B,GACL,mBAAmB;CAsBvB"}