@specverse/engine-registry 4.0.2 → 4.0.4

package/dist/types/validation.d.ts

@@ -1,197 +0,0 @@
-/**
- * Validation Type Definitions
- *
- * Types for manifest validation and error reporting.
- *
- * @module registry/types/validation
- * @version 2.0.0
- */
-import type { RegistryResponse } from './registry.js';
-/**
- * Validation severity levels
- */
-export type ValidationSeverity = 'error' | 'warning' | 'info';
-/**
- * Validation stage
- */
-export type ValidationStage = 'manifest' | 'installation';
-/**
- * Validation issue/error
- *
- * Represents a single validation problem found during manifest or installation validation.
- */
-export interface ValidationIssue {
-    /** Error code (e.g., "MANIFEST-001") */
-    code: string;
-    /** Severity level */
-    severity: ValidationSeverity;
-    /** Validation stage where this issue was found */
-    stage: ValidationStage;
-    /** Short title for the issue */
-    title: string;
-    /** Detailed message explaining the issue */
-    message: string;
-    /** File where the issue was found */
-    file: string;
-    /** Line number in the file (0 if unknown) */
-    line: number;
-    /** Column number in the file (0 if unknown) */
-    column: number;
-    /** Code snippet showing the problematic section (optional) */
-    snippet?: string;
-    /** Suggestions for fixing the issue */
-    suggestions?: string[];
-    /** Auto-fix command (e.g., "npm install @specverse/factories-prisma@3.3.0") */
-    fix?: string;
-    /** URL to learn more about this issue */
-    learnMoreUrl?: string;
-}
-/**
- * Validation result
- *
- * Complete result of running validation on a manifest.
- */
-export interface ValidationResult {
-    /** True if validation passed (no errors) */
-    valid: boolean;
-    /** List of errors found */
-    errors: ValidationIssue[];
-    /** List of warnings found */
-    warnings: ValidationIssue[];
-    /** List of informational messages */
-    info: ValidationIssue[];
-}
-/**
- * Validation rule interface
- *
- * All validation rules must implement this interface.
- */
-export interface ValidationRule {
-    /** Unique error code for this rule */
-    code: string;
-    /** Human-readable name for this rule */
-    name: string;
-    /** Default severity for issues from this rule */
-    severity: ValidationSeverity;
-    /** Stage where this rule runs */
-    stage: ValidationStage;
-    /**
-     * Validate manifest against registry metadata
-     *
-     * @param manifest - The manifest to validate
-     * @param registry - Registry metadata to validate against
-     * @returns Array of validation issues found
-     */
-    validate(manifest: any, registry: RegistryResponse): ValidationIssue[];
-}
-/**
- * Manifest validation options
- */
-export interface ManifestValidationOptions {
-    /** Treat warnings as errors */
-    strict?: boolean;
-    /** Skip deprecated factory checks */
-    skipDeprecated?: boolean;
-    /** File path for error reporting */
-    filePath?: string;
-}
-/**
- * Installation validation options
- */
-export interface InstallationValidationOptions {
-    /** Auto-install missing packages */
-    autoInstall?: boolean;
-    /** Check git sources (requires git command) */
-    checkGit?: boolean;
-    /** Check URL sources (requires network) */
-    checkUrl?: boolean;
-}
-/**
- * Combined validation options
- */
-export interface ValidationOptions extends ManifestValidationOptions, InstallationValidationOptions {
-    /** Run manifest validation (Stage 2) */
-    checkManifest?: boolean;
-    /** Run installation validation (Stage 3) */
-    checkInstalled?: boolean;
-    /** Use offline mode (cached registry metadata) */
-    offline?: boolean;
-}
-/**
- * Type guard to check if issue is an error
- */
-export declare function isError(issue: ValidationIssue): boolean;
-/**
- * Type guard to check if issue is a warning
- */
-export declare function isWarning(issue: ValidationIssue): boolean;
-/**
- * Type guard to check if issue is info
- */
-export declare function isInfo(issue: ValidationIssue): boolean;
-/**
- * Helper to filter issues by severity
- */
-export declare function filterBySeverity(issues: ValidationIssue[], severity: ValidationSeverity): ValidationIssue[];
-/**
- * Helper to filter issues by stage
- */
-export declare function filterByStage(issues: ValidationIssue[], stage: ValidationStage): ValidationIssue[];
-/**
- * Helper to check if validation result has errors
- */
-export declare function hasErrors(result: ValidationResult): boolean;
-/**
- * Helper to check if validation result has warnings
- */
-export declare function hasWarnings(result: ValidationResult): boolean;
-/**
- * Helper to get total issue count
- */
-export declare function getTotalIssues(result: ValidationResult): number;
-/**
- * Helper to merge multiple validation results
- */
-export declare function mergeResults(...results: ValidationResult[]): ValidationResult;
-/**
- * Helper to create a validation issue
- */
-export declare function createIssue(code: string, severity: ValidationSeverity, stage: ValidationStage, title: string, message: string, file?: string, line?: number, column?: number): ValidationIssue;
-/**
- * Helper to add suggestions to an issue
- */
-export declare function withSuggestions(issue: ValidationIssue, suggestions: string[]): ValidationIssue;
-/**
- * Helper to add fix command to an issue
- */
-export declare function withFix(issue: ValidationIssue, fix: string): ValidationIssue;
-/**
- * Helper to add learn more URL to an issue
- */
-export declare function withLearnMore(issue: ValidationIssue, url: string): ValidationIssue;
-/**
- * Error code constants
- */
-export declare const ErrorCodes: {
-    readonly FACTORY_NOT_FOUND: "MANIFEST-001";
-    readonly FACTORY_DEPRECATED: "MANIFEST-002";
-    readonly INVALID_CAPABILITY_MAPPING: "MANIFEST-004";
-    readonly NETWORK_ERROR: "MANIFEST-005";
-    readonly STALE_CACHE: "MANIFEST-006";
-    readonly PACKAGE_NOT_INSTALLED: "REALIZE-001";
-    readonly FACTORY_FILE_NOT_FOUND: "REALIZE-002";
-    readonly VERSION_MISMATCH: "REALIZE-003";
-};
-/**
- * Type for error codes
- */
-export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
-/**
- * Learn more URLs
- */
-export declare const LearnMoreUrls: {
-    readonly REGISTRY: "https://registry.specverse.com/factories";
-    readonly MIGRATION: "https://docs.specverse.com/migration";
-    readonly CAPABILITIES: "https://docs.specverse.com/capabilities";
-};
-//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

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

package/dist/types/validation.js

@@ -1,140 +0,0 @@
-/**
- * Validation Type Definitions
- *
- * Types for manifest validation and error reporting.
- *
- * @module registry/types/validation
- * @version 2.0.0
- */
-/**
- * Type guard to check if issue is an error
- */
-export function isError(issue) {
-    return issue.severity === 'error';
-}
-/**
- * Type guard to check if issue is a warning
- */
-export function isWarning(issue) {
-    return issue.severity === 'warning';
-}
-/**
- * Type guard to check if issue is info
- */
-export function isInfo(issue) {
-    return issue.severity === 'info';
-}
-/**
- * Helper to filter issues by severity
- */
-export function filterBySeverity(issues, severity) {
-    return issues.filter(issue => issue.severity === severity);
-}
-/**
- * Helper to filter issues by stage
- */
-export function filterByStage(issues, stage) {
-    return issues.filter(issue => issue.stage === stage);
-}
-/**
- * Helper to check if validation result has errors
- */
-export function hasErrors(result) {
-    return result.errors.length > 0;
-}
-/**
- * Helper to check if validation result has warnings
- */
-export function hasWarnings(result) {
-    return result.warnings.length > 0;
-}
-/**
- * Helper to get total issue count
- */
-export function getTotalIssues(result) {
-    return result.errors.length + result.warnings.length + result.info.length;
-}
-/**
- * Helper to merge multiple validation results
- */
-export function mergeResults(...results) {
-    const merged = {
-        valid: true,
-        errors: [],
-        warnings: [],
-        info: []
-    };
-    for (const result of results) {
-        merged.errors.push(...result.errors);
-        merged.warnings.push(...result.warnings);
-        merged.info.push(...result.info);
-    }
-    merged.valid = merged.errors.length === 0;
-    return merged;
-}
-/**
- * Helper to create a validation issue
- */
-export function createIssue(code, severity, stage, title, message, file = 'manifests/implementation.yaml', line = 0, column = 0) {
-    return {
-        code,
-        severity,
-        stage,
-        title,
-        message,
-        file,
-        line,
-        column
-    };
-}
-/**
- * Helper to add suggestions to an issue
- */
-export function withSuggestions(issue, suggestions) {
-    return {
-        ...issue,
-        suggestions
-    };
-}
-/**
- * Helper to add fix command to an issue
- */
-export function withFix(issue, fix) {
-    return {
-        ...issue,
-        fix
-    };
-}
-/**
- * Helper to add learn more URL to an issue
- */
-export function withLearnMore(issue, url) {
-    return {
-        ...issue,
-        learnMoreUrl: url
-    };
-}
-/**
- * Error code constants
- */
-export const ErrorCodes = {
-    // Stage 2: Manifest validation
-    FACTORY_NOT_FOUND: 'MANIFEST-001',
-    FACTORY_DEPRECATED: 'MANIFEST-002',
-    INVALID_CAPABILITY_MAPPING: 'MANIFEST-004',
-    NETWORK_ERROR: 'MANIFEST-005',
-    STALE_CACHE: 'MANIFEST-006',
-    // Stage 3: Installation validation
-    PACKAGE_NOT_INSTALLED: 'REALIZE-001',
-    FACTORY_FILE_NOT_FOUND: 'REALIZE-002',
-    VERSION_MISMATCH: 'REALIZE-003'
-};
-/**
- * Learn more URLs
- */
-export const LearnMoreUrls = {
-    REGISTRY: 'https://registry.specverse.com/factories',
-    MIGRATION: 'https://docs.specverse.com/migration',
-    CAPABILITIES: 'https://docs.specverse.com/capabilities'
-};
-//# sourceMappingURL=validation.js.map

package/dist/types/validation.js.map

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

package/dist/utils/manifest-adapter.d.ts

@@ -1,42 +0,0 @@
-/**
- * Manifest Adapter
- *
- * Bridges between ManifestConfig (realize format) and SpecVerseManifest (validation format).
- * Converts the unified manifest format to the structure expected by validators.
- *
- * @module registry/utils/manifest-adapter
- * @version 1.0.0
- */
-import type { SpecVerseManifest } from '../validators/manifest-validator.js';
-import type { ManifestConfig } from '@specverse/engine-realize';
-/**
- * Convert ManifestConfig to SpecVerseManifest
- *
- * Extracts instance factories and capability mappings from the unified format.
- * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
- *
- * @param manifestConfig - Full manifest configuration
- * @returns SpecVerseManifest suitable for validation
- */
-export declare function manifestConfigToSpecVerseManifest(manifestConfig: ManifestConfig): SpecVerseManifest;
-/**
- * Validate that capability mappings reference declared factories
- *
- * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
- *
- * @param manifest - Manifest configuration to validate
- * @returns Validation errors (empty if valid)
- */
-export declare function validateFactoryReferences(manifest: ManifestConfig): string[];
-/**
- * Get all factory names from manifest
- *
- * Extracts factory names from instanceFactories, overrides, capabilityMappings, and instanceMappings.
- * Supports both v3.6 and v3.3 formats.
- * Useful for determining what needs to be declared.
- *
- * @param manifest - Manifest configuration
- * @returns Set of factory names
- */
-export declare function getReferencedFactoryNames(manifest: ManifestConfig): Set<string>;
-//# sourceMappingURL=manifest-adapter.d.ts.map

package/dist/utils/manifest-adapter.js

@@ -1,182 +0,0 @@
-/**
- * Manifest Adapter
- *
- * Bridges between ManifestConfig (realize format) and SpecVerseManifest (validation format).
- * Converts the unified manifest format to the structure expected by validators.
- *
- * @module registry/utils/manifest-adapter
- * @version 1.0.0
- */
-import { getEffectiveMappings } from '@specverse/engine-realize';
-/**
- * Convert ManifestConfig to SpecVerseManifest
- *
- * Extracts instance factories and capability mappings from the unified format.
- * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
- *
- * @param manifestConfig - Full manifest configuration
- * @returns SpecVerseManifest suitable for validation
- */
-export function manifestConfigToSpecVerseManifest(manifestConfig) {
-    // Extract instance factories if present
-    const instanceFactories = [];
-    if (manifestConfig.instanceFactories) {
-        for (const factory of manifestConfig.instanceFactories) {
-            // Convert source metadata to string format for validation
-            const sourceString = getSourceString(factory);
-            instanceFactories.push({
-                name: factory.name,
-                source: sourceString
-            });
-        }
-    }
-    // Get effective mappings (auto-migrates v3.3 to v3.6 if needed)
-    const { defaults, overrides, system } = getEffectiveMappings(manifestConfig);
-    // Build capability mappings from effective mappings
-    const capabilityMappings = [];
-    // If using v3.6 format, convert overrides with capability targets
-    if (system === 'v3.6' && overrides) {
-        for (const override of overrides) {
-            // Only include capability targets (not instance names)
-            if (isCapabilityTarget(override.target)) {
-                capabilityMappings.push({
-                    capability: override.target,
-                    instanceFactory: override.factory
-                });
-            }
-        }
-    }
-    // If using v3.3 format, use original legacy mappings (not migrated)
-    if (system === 'v3.3' && manifestConfig.capabilityMappings) {
-        capabilityMappings.push(...manifestConfig.capabilityMappings.map(mapping => ({
-            capability: mapping.capability,
-            instanceFactory: mapping.instanceFactory
-        })));
-    }
-    return {
-        specVersion: manifestConfig.specVersion,
-        instanceFactories,
-        capabilityMappings
-    };
-}
-/**
- * Determine if a target is a capability pattern
- *
- * Capability patterns contain dots (e.g., "storage.database")
- * Instance names typically don't (e.g., "primary-db")
- *
- * @param target - Target string to check
- * @returns True if target looks like a capability
- */
-function isCapabilityTarget(target) {
-    return /^[a-z]+\.[a-z]+(\.[a-z]+)*$/.test(target);
-}
-/**
- * Get source string from factory declaration
- *
- * Converts structured source metadata to a string representation.
- *
- * @param factory - Instance factory declaration
- * @returns Source string (e.g., "@specverse/factories-prisma")
- */
-function getSourceString(factory) {
-    const { source } = factory;
-    switch (source.type) {
-        case 'npm':
-            return source.package || '';
-        case 'git':
-            return source.url || '';
-        case 'url':
-            return source.url || '';
-        default:
-            return '';
-    }
-}
-/**
- * Validate that capability mappings reference declared factories
- *
- * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
- *
- * @param manifest - Manifest configuration to validate
- * @returns Validation errors (empty if valid)
- */
-export function validateFactoryReferences(manifest) {
-    const errors = [];
-    if (!manifest.instanceFactories || manifest.instanceFactories.length === 0) {
-        // If no instance factories declared, skip validation
-        // (backward compatibility with old manifests)
-        return errors;
-    }
-    // Build map of declared factory names
-    const declaredFactories = new Set(manifest.instanceFactories.map(f => f.name));
-    // Check v3.6 overrides
-    if (manifest.overrides) {
-        for (const override of manifest.overrides) {
-            if (!declaredFactories.has(override.factory)) {
-                errors.push(`Override references undeclared factory: "${override.factory}" for target "${override.target}". ` +
-                    `Add it to instanceFactories section.`);
-            }
-        }
-    }
-    // Check v3.3 capability mappings
-    if (manifest.capabilityMappings) {
-        for (const mapping of manifest.capabilityMappings) {
-            if (!declaredFactories.has(mapping.instanceFactory)) {
-                errors.push(`Capability mapping references undeclared factory: "${mapping.instanceFactory}". ` +
-                    `Add it to instanceFactories section.`);
-            }
-        }
-    }
-    // Check v3.3 instance mappings
-    if (manifest.instanceMappings) {
-        for (const mapping of manifest.instanceMappings) {
-            const factoryName = mapping.instanceFactory;
-            if (factoryName && !declaredFactories.has(factoryName)) {
-                errors.push(`Instance mapping references undeclared factory: "${factoryName}". ` +
-                    `Add it to instanceFactories section.`);
-            }
-        }
-    }
-    return errors;
-}
-/**
- * Get all factory names from manifest
- *
- * Extracts factory names from instanceFactories, overrides, capabilityMappings, and instanceMappings.
- * Supports both v3.6 and v3.3 formats.
- * Useful for determining what needs to be declared.
- *
- * @param manifest - Manifest configuration
- * @returns Set of factory names
- */
-export function getReferencedFactoryNames(manifest) {
-    const names = new Set();
-    // From instance factories
-    if (manifest.instanceFactories) {
-        for (const factory of manifest.instanceFactories) {
-            names.add(factory.name);
-        }
-    }
-    // From v3.6 overrides
-    if (manifest.overrides) {
-        for (const override of manifest.overrides) {
-            names.add(override.factory);
-        }
-    }
-    // From v3.3 capability mappings
-    if (manifest.capabilityMappings) {
-        for (const mapping of manifest.capabilityMappings) {
-            names.add(mapping.instanceFactory);
-        }
-    }
-    // From v3.3 instance mappings
-    if (manifest.instanceMappings) {
-        for (const mapping of manifest.instanceMappings) {
-            if (mapping.instanceFactory) {
-                names.add(mapping.instanceFactory);
-            }
-        }
-    }
-    return names;
-}
-//# sourceMappingURL=manifest-adapter.js.map

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

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

package/dist/validators/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Registry Validators
- *
- * @module registry/validators
- */
-export { Validator } from './validator.js';
-export { ManifestValidator } from './manifest-validator.js';
-export { InstallationValidator } from './installation-validator.js';
-export type { ValidatorOptions, ValidationReport } from './validator.js';
-export type { SpecVerseManifest, ManifestValidationOptions } from './manifest-validator.js';
-export type { InstallationValidationOptions, PackageInfo } from './installation-validator.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,YAAY,EAAE,6BAA6B,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/validators/index.js

@@ -1,9 +0,0 @@
-/**
- * Registry Validators
- *
- * @module registry/validators
- */
-export { Validator } from './validator.js';
-export { ManifestValidator } from './manifest-validator.js';
-export { InstallationValidator } from './installation-validator.js';
-//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}