@specverse/engines 4.1.0

package/dist/registry/validators/installation-validator.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Installation Validator
+ *
+ * Validates that instance factory npm packages are installed locally
+ * and that the factory files exist at the specified locations.
+ *
+ * @module registry/validators/installation-validator
+ * @version 2.0.0
+ */
+import type { ValidationResult, RegistryFactoryMetadata } from '../types/index.js';
+import type { SpecVerseManifest } from './manifest-validator.js';
+/**
+ * Installation validation options
+ */
+export interface InstallationValidationOptions {
+    /** Auto-install missing packages (not implemented yet) */
+    autoInstall?: boolean;
+    /** Project root directory (default: process.cwd()) */
+    projectRoot?: string;
+    /** File path for error reporting */
+    filePath?: string;
+}
+/**
+ * Package installation info
+ */
+export interface PackageInfo {
+    /** Package name */
+    name: string;
+    /** Is package installed? */
+    installed: boolean;
+    /** Installed version (if available) */
+    version?: string;
+    /** Package.json path */
+    packageJsonPath?: string;
+}
+/**
+ * Installation Validator
+ *
+ * Validates that required npm packages are installed locally.
+ */
+export declare class InstallationValidator {
+    /**
+     * Validate installation
+     *
+     * @param manifest - Manifest to validate
+     * @param registryFactories - Factory metadata from registry
+     * @param options - Validation options
+     * @returns Validation result
+     */
+    validate(manifest: SpecVerseManifest, registryFactories: Map<string, RegistryFactoryMetadata>, options?: InstallationValidationOptions): Promise<ValidationResult>;
+    /**
+     * Check if a package is installed
+     *
+     * @param packageName - Package name
+     * @param projectRoot - Project root directory
+     * @returns Package info
+     */
+    private checkPackageInstallation;
+    /**
+     * Check if a file exists
+     *
+     * @param filePath - File path to check
+     * @returns True if file exists
+     */
+    private checkFileExists;
+    /**
+     * Get package info for a specific package
+     *
+     * @param packageName - Package name
+     * @param projectRoot - Project root directory
+     * @returns Package info
+     */
+    getPackageInfo(packageName: string, projectRoot?: string): Promise<PackageInfo>;
+}
+//# sourceMappingURL=installation-validator.d.ts.map

package/dist/registry/validators/installation-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-validator.d.ts","sourceRoot":"","sources":["../../../src/registry/validators/installation-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAEhB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,SAAS,EAAE,OAAO,CAAC;IAEnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;IACG,QAAQ,CACZ,QAAQ,EAAE,iBAAiB,EAC3B,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EACvD,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,gBAAgB,CAAC;IA2H5B;;;;;;OAMG;YACW,wBAAwB;IAiCtC;;;;;OAKG;YACW,eAAe;IAS7B;;;;;;OAMG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAGtF"}

package/dist/registry/validators/installation-validator.js

@@ -0,0 +1,142 @@
+/**
+ * Installation Validator
+ *
+ * Validates that instance factory npm packages are installed locally
+ * and that the factory files exist at the specified locations.
+ *
+ * @module registry/validators/installation-validator
+ * @version 2.0.0
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { createIssue, withFix, withSuggestions, ErrorCodes } from '../types/index.js';
+/**
+ * Installation Validator
+ *
+ * Validates that required npm packages are installed locally.
+ */
+export class InstallationValidator {
+    /**
+     * Validate installation
+     *
+     * @param manifest - Manifest to validate
+     * @param registryFactories - Factory metadata from registry
+     * @param options - Validation options
+     * @returns Validation result
+     */
+    async validate(manifest, registryFactories, options = {}) {
+        const errors = [];
+        const warnings = [];
+        const info = [];
+        const projectRoot = options.projectRoot || process.cwd();
+        const filePath = options.filePath || 'manifests/implementation.yaml';
+        // Check each instance factory
+        for (const instanceFactory of manifest.instanceFactories) {
+            const registryFactory = registryFactories.get(instanceFactory.name);
+            if (!registryFactory) {
+                // Factory not in registry - skip (already reported by manifest validator)
+                continue;
+            }
+            // Only check npm packages
+            if (registryFactory.source.type !== 'npm') {
+                info.push(createIssue('REALIZE-004', 'info', 'installation', 'Non-npm source', `Skipping installation check for "${instanceFactory.name}" (source type: ${registryFactory.source.type})`, filePath));
+                continue;
+            }
+            const packageName = registryFactory.source.package;
+            const requiredVersion = registryFactory.source.version;
+            // Check if package is installed
+            const packageInfo = await this.checkPackageInstallation(packageName, projectRoot);
+            if (!packageInfo.installed) {
+                const installCmd = `npm install ${packageName}${requiredVersion ? '@' + requiredVersion : ''}`;
+                errors.push(withFix(withSuggestions(createIssue(ErrorCodes.PACKAGE_NOT_INSTALLED, 'error', 'installation', 'Package not installed', `The npm package "${packageName}" is required by "${instanceFactory.name}" but is not installed.`, filePath), [
+                    `Run: ${installCmd}`,
+                    'Or install all dependencies: npm install'
+                ]), installCmd));
+                continue;
+            }
+            // Package is installed - check version
+            if (requiredVersion && packageInfo.version) {
+                if (packageInfo.version !== requiredVersion) {
+                    warnings.push(withFix(createIssue(ErrorCodes.VERSION_MISMATCH, 'warning', 'installation', 'Version mismatch', `Package "${packageName}" version mismatch: installed=${packageInfo.version}, required=${requiredVersion}`, filePath), `npm install ${packageName}@${requiredVersion}`));
+                }
+            }
+            // Check if factory file exists
+            const entrypoint = registryFactory.source.entrypoint || 'factory.yaml';
+            const factoryPath = join(projectRoot, 'node_modules', packageName, entrypoint);
+            const factoryExists = await this.checkFileExists(factoryPath);
+            if (!factoryExists) {
+                errors.push(withSuggestions(createIssue(ErrorCodes.FACTORY_FILE_NOT_FOUND, 'error', 'installation', 'Factory file not found', `The factory file "${entrypoint}" was not found in package "${packageName}" at expected location: ${factoryPath}`, filePath), [
+                    'The package may be corrupted',
+                    `Try: npm install ${packageName}@${requiredVersion || 'latest'} --force`,
+                    'Check that the package contains the factory file'
+                ]));
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            info
+        };
+    }
+    /**
+     * Check if a package is installed
+     *
+     * @param packageName - Package name
+     * @param projectRoot - Project root directory
+     * @returns Package info
+     */
+    async checkPackageInstallation(packageName, projectRoot) {
+        const packageJsonPath = join(projectRoot, 'node_modules', packageName, 'package.json');
+        try {
+            const packageJsonContent = await fs.readFile(packageJsonPath, 'utf8');
+            const packageJson = JSON.parse(packageJsonContent);
+            return {
+                name: packageName,
+                installed: true,
+                version: packageJson.version,
+                packageJsonPath
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // Package not installed
+                return {
+                    name: packageName,
+                    installed: false
+                };
+            }
+            // Other error (permission, invalid JSON, etc.) - treat as not installed
+            return {
+                name: packageName,
+                installed: false
+            };
+        }
+    }
+    /**
+     * Check if a file exists
+     *
+     * @param filePath - File path to check
+     * @returns True if file exists
+     */
+    async checkFileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get package info for a specific package
+     *
+     * @param packageName - Package name
+     * @param projectRoot - Project root directory
+     * @returns Package info
+     */
+    async getPackageInfo(packageName, projectRoot) {
+        return this.checkPackageInstallation(packageName, projectRoot || process.cwd());
+    }
+}
+//# sourceMappingURL=installation-validator.js.map

package/dist/registry/validators/installation-validator.js.map

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

package/dist/registry/validators/manifest-validator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Manifest Validator
+ *
+ * Validates SpecVerse manifests against registry metadata.
+ * Checks that all instance factories referenced in the manifest exist
+ * in the registry and validates capability mappings.
+ *
+ * @module registry/validators/manifest-validator
+ * @version 2.0.0
+ */
+import { OfflineHandler } from '../offline/offline-handler.js';
+import type { ValidationResult } from '../types/index.js';
+/**
+ * Manifest to validate
+ */
+export interface SpecVerseManifest {
+    /** Spec version */
+    specVersion: string;
+    /** Instance factories used */
+    instanceFactories: Array<{
+        name: string;
+        source: string;
+    }>;
+    /** Capability mappings */
+    capabilityMappings?: Array<{
+        capability: string;
+        instanceFactory: string;
+    }>;
+}
+/**
+ * Manifest validation options
+ */
+export interface ManifestValidationOptions {
+    /** Treat warnings as errors */
+    strict?: boolean;
+    /** Skip deprecated factory checks */
+    skipDeprecated?: boolean;
+    /** Offline mode - only use cache */
+    offline?: boolean;
+    /** File path for error reporting */
+    filePath?: string;
+}
+/**
+ * Manifest Validator
+ *
+ * Validates manifests against registry metadata.
+ */
+export declare class ManifestValidator {
+    private offlineHandler;
+    constructor(offlineHandler?: OfflineHandler);
+    /**
+     * Validate manifest
+     *
+     * @param manifest - Manifest to validate
+     * @param options - Validation options
+     * @returns Validation result with errors, warnings, and info
+     */
+    validate(manifest: SpecVerseManifest, options?: ManifestValidationOptions): Promise<ValidationResult>;
+    /**
+     * Find similar factory names using Levenshtein distance
+     *
+     * @param target - Target name
+     * @param candidates - Candidate names
+     * @returns Top 5 similar names
+     */
+    private findSimilarFactories;
+    /**
+     * Calculate Levenshtein distance between two strings
+     *
+     * @param a - First string
+     * @param b - Second string
+     * @returns Edit distance
+     */
+    private levenshteinDistance;
+    /**
+     * Get offline handler
+     *
+     * @returns Offline handler instance
+     */
+    getOfflineHandler(): OfflineHandler;
+}
+//# sourceMappingURL=manifest-validator.d.ts.map

package/dist/registry/validators/manifest-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-validator.d.ts","sourceRoot":"","sources":["../../../src/registry/validators/manifest-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAU3B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,KAAK,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAAiB;gBAE3B,cAAc,CAAC,EAAE,cAAc;IAI3C;;;;;;OAMG;IACG,QAAQ,CACZ,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,gBAAgB,CAAC;IA4N5B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;;OAIG;IACH,iBAAiB,IAAI,cAAc;CAGpC"}

package/dist/registry/validators/manifest-validator.js

@@ -0,0 +1,213 @@
+/**
+ * Manifest Validator
+ *
+ * Validates SpecVerse manifests against registry metadata.
+ * Checks that all instance factories referenced in the manifest exist
+ * in the registry and validates capability mappings.
+ *
+ * @module registry/validators/manifest-validator
+ * @version 2.0.0
+ */
+import { OfflineHandler } from '../offline/offline-handler.js';
+import { createIssue, withSuggestions, withLearnMore, ErrorCodes, LearnMoreUrls } from '../types/index.js';
+/**
+ * Manifest Validator
+ *
+ * Validates manifests against registry metadata.
+ */
+export class ManifestValidator {
+    offlineHandler;
+    constructor(offlineHandler) {
+        this.offlineHandler = offlineHandler || new OfflineHandler();
+    }
+    /**
+     * Validate manifest
+     *
+     * @param manifest - Manifest to validate
+     * @param options - Validation options
+     * @returns Validation result with errors, warnings, and info
+     */
+    async validate(manifest, options = {}) {
+        const errors = [];
+        const warnings = [];
+        const info = [];
+        const filePath = options.filePath || 'manifests/implementation.yaml';
+        // Enable offline mode if requested
+        if (options.offline) {
+            this.offlineHandler.enableOfflineMode();
+        }
+        try {
+            // Fetch registry metadata
+            const registryResult = await this.offlineHandler.fetchFactories();
+            // Add any registry fetch warnings
+            warnings.push(...registryResult.issues);
+            // Build factory lookup map
+            const factoryMap = new Map();
+            for (const factory of registryResult.data.results) {
+                factoryMap.set(factory.name, factory);
+            }
+            // Validate instance factories
+            for (const instanceFactory of manifest.instanceFactories) {
+                const registryFactory = factoryMap.get(instanceFactory.name);
+                if (!registryFactory) {
+                    // Factory not found in registry
+                    const similar = this.findSimilarFactories(instanceFactory.name, Array.from(factoryMap.keys()));
+                    const issue = createIssue(ErrorCodes.FACTORY_NOT_FOUND, 'error', 'manifest', 'Instance factory not found', `The instance factory "${instanceFactory.name}" was not found in the registry.`, filePath);
+                    if (similar.length > 0) {
+                        errors.push(withLearnMore(withSuggestions(issue, [
+                            `Did you mean "${similar[0]}"?`,
+                            ...similar.slice(1, 3).map(name => `Or try: "${name}"`),
+                            'Run "specverse lib search <query>" to find factories'
+                        ]), LearnMoreUrls.REGISTRY));
+                    }
+                    else {
+                        errors.push(withLearnMore(withSuggestions(issue, [
+                            'Check the factory name spelling',
+                            'Run "specverse lib list" to see available factories',
+                            'The factory may not be published yet'
+                        ]), LearnMoreUrls.REGISTRY));
+                    }
+                    continue;
+                }
+                // Check if deprecated
+                if (!options.skipDeprecated && registryFactory.deprecated) {
+                    const issue = createIssue(ErrorCodes.FACTORY_DEPRECATED, options.strict ? 'error' : 'warning', 'manifest', 'Instance factory is deprecated', `The instance factory "${instanceFactory.name}" is deprecated${registryFactory.deprecationReason ? ': ' + registryFactory.deprecationReason : ''}`, filePath);
+                    const suggestions = [];
+                    if (registryFactory.replacedBy) {
+                        suggestions.push(`Use "${registryFactory.replacedBy}" instead`);
+                    }
+                    if (registryFactory.alternatives && registryFactory.alternatives.length > 0) {
+                        suggestions.push(`Alternatives: ${registryFactory.alternatives.slice(0, 3).join(', ')}`);
+                    }
+                    suggestions.push('Update your manifest to use a supported factory');
+                    const deprecatedIssue = withLearnMore(withSuggestions(issue, suggestions), LearnMoreUrls.MIGRATION);
+                    if (options.strict) {
+                        errors.push(deprecatedIssue);
+                    }
+                    else {
+                        warnings.push(deprecatedIssue);
+                    }
+                }
+            }
+            // Validate capability mappings
+            if (manifest.capabilityMappings) {
+                for (const mapping of manifest.capabilityMappings) {
+                    const factory = factoryMap.get(mapping.instanceFactory);
+                    if (!factory) {
+                        // Factory not found (already reported above, skip duplicate)
+                        continue;
+                    }
+                    // Check if factory provides the capability
+                    if (!factory.capabilities.includes(mapping.capability)) {
+                        const issue = createIssue(ErrorCodes.INVALID_CAPABILITY_MAPPING, 'error', 'manifest', 'Invalid capability mapping', `The instance factory "${mapping.instanceFactory}" does not provide capability "${mapping.capability}". ` +
+                            `Available capabilities: ${factory.capabilities.join(', ')}`, filePath);
+                        // Find factories that DO provide this capability
+                        const providingFactories = registryResult.data.results
+                            .filter(f => f.capabilities.includes(mapping.capability))
+                            .map(f => f.name)
+                            .slice(0, 5);
+                        if (providingFactories.length > 0) {
+                            errors.push(withSuggestions(issue, [
+                                `Use one of these factories instead: ${providingFactories.join(', ')}`,
+                                `Or remove the capability mapping for "${mapping.capability}"`
+                            ]));
+                        }
+                        else {
+                            errors.push(withSuggestions(issue, [
+                                `No factories provide capability "${mapping.capability}"`,
+                                'Check the capability name spelling',
+                                'The capability may not be supported yet'
+                            ]));
+                        }
+                    }
+                }
+            }
+            // Check for unused factories (info)
+            const usedFactoryNames = new Set((manifest.capabilityMappings || []).map(m => m.instanceFactory));
+            for (const instanceFactory of manifest.instanceFactories) {
+                if (!usedFactoryNames.has(instanceFactory.name)) {
+                    info.push(createIssue('MANIFEST-003', 'info', 'manifest', 'Unused instance factory', `The instance factory "${instanceFactory.name}" is declared but not mapped to any capability.`, filePath));
+                }
+            }
+        }
+        catch (error) {
+            // Handle offline errors
+            if (error.name === 'OfflineError') {
+                errors.push(withLearnMore(withSuggestions(createIssue(ErrorCodes.NETWORK_ERROR, 'error', 'manifest', 'Registry unavailable', 'Cannot validate manifest: registry is unavailable and no cache exists.', filePath), [
+                    'Check your internet connection',
+                    'Run with network access to populate cache',
+                    'Use --offline flag with existing cache'
+                ]), LearnMoreUrls.REGISTRY));
+            }
+            else {
+                // Unexpected error
+                errors.push(createIssue('MANIFEST-999', 'error', 'manifest', 'Validation error', `Unexpected error during validation: ${error.message}`, filePath));
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            info
+        };
+    }
+    /**
+     * Find similar factory names using Levenshtein distance
+     *
+     * @param target - Target name
+     * @param candidates - Candidate names
+     * @returns Top 5 similar names
+     */
+    findSimilarFactories(target, candidates) {
+        const scored = candidates.map(candidate => ({
+            name: candidate,
+            distance: this.levenshteinDistance(target.toLowerCase(), candidate.toLowerCase())
+        }));
+        // Sort by distance (lower is better)
+        scored.sort((a, b) => a.distance - b.distance);
+        // Return top 5 with distance <= 5
+        return scored
+            .filter(s => s.distance <= 5)
+            .slice(0, 5)
+            .map(s => s.name);
+    }
+    /**
+     * Calculate Levenshtein distance between two strings
+     *
+     * @param a - First string
+     * @param b - Second string
+     * @returns Edit distance
+     */
+    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, // substitution
+                    matrix[i][j - 1] + 1, // insertion
+                    matrix[i - 1][j] + 1 // deletion
+                    );
+                }
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+    /**
+     * Get offline handler
+     *
+     * @returns Offline handler instance
+     */
+    getOfflineHandler() {
+        return this.offlineHandler;
+    }
+}
+//# sourceMappingURL=manifest-validator.js.map

package/dist/registry/validators/manifest-validator.js.map

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

package/dist/registry/validators/validator.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Main Validator
+ *
+ * Orchestrates manifest and installation validation.
+ * Provides a unified interface for validating SpecVerse projects.
+ *
+ * @module registry/validators/validator
+ * @version 2.0.0
+ */
+import { ManifestValidator } from './manifest-validator.js';
+import { InstallationValidator } from './installation-validator.js';
+import { OfflineHandler } from '../offline/offline-handler.js';
+import type { SpecVerseManifest } from './manifest-validator.js';
+import type { ValidationResult, ManifestValidationOptions, InstallationValidationOptions } from '../types/index.js';
+/**
+ * Complete validation options
+ */
+export interface ValidatorOptions {
+    /** Manifest validation options */
+    manifest?: ManifestValidationOptions;
+    /** Installation validation options */
+    installation?: InstallationValidationOptions;
+    /** Skip manifest validation */
+    skipManifest?: boolean;
+    /** Skip installation validation */
+    skipInstallation?: boolean;
+    /** Offline mode - only use cache */
+    offline?: boolean;
+}
+/**
+ * Validation report
+ */
+export interface ValidationReport {
+    /** Overall validation result */
+    result: ValidationResult;
+    /** Manifest validation result (if run) */
+    manifestResult?: ValidationResult;
+    /** Installation validation result (if run) */
+    installationResult?: ValidationResult;
+    /** Summary statistics */
+    summary: {
+        totalIssues: number;
+        errorCount: number;
+        warningCount: number;
+        infoCount: number;
+        validationsPassed: string[];
+        validationsFailed: string[];
+    };
+}
+/**
+ * Main Validator
+ *
+ * Orchestrates all validation stages.
+ */
+export declare class Validator {
+    private manifestValidator;
+    private installationValidator;
+    private offlineHandler;
+    constructor(offlineHandler?: OfflineHandler);
+    /**
+     * Validate a manifest file
+     *
+     * Runs both manifest and installation validation unless skipped.
+     *
+     * @param manifest - Manifest to validate
+     * @param options - Validation options
+     * @returns Validation report
+     */
+    validate(manifest: SpecVerseManifest, options?: ValidatorOptions): Promise<ValidationReport>;
+    /**
+     * Validate manifest only (skip installation check)
+     *
+     * @param manifest - Manifest to validate
+     * @param options - Manifest validation options
+     * @returns Validation report
+     */
+    validateManifestOnly(manifest: SpecVerseManifest, options?: ManifestValidationOptions): Promise<ValidationReport>;
+    /**
+     * Validate installation only (skip manifest check)
+     *
+     * @param manifest - Manifest to validate
+     * @param options - Installation validation options
+     * @returns Validation report
+     */
+    validateInstallationOnly(manifest: SpecVerseManifest, options?: InstallationValidationOptions): Promise<ValidationReport>;
+    /**
+     * Get offline handler
+     *
+     * @returns Offline handler instance
+     */
+    getOfflineHandler(): OfflineHandler;
+    /**
+     * Get manifest validator
+     *
+     * @returns Manifest validator instance
+     */
+    getManifestValidator(): ManifestValidator;
+    /**
+     * Get installation validator
+     *
+     * @returns Installation validator instance
+     */
+    getInstallationValidator(): InstallationValidator;
+    /**
+     * Enable offline mode
+     */
+    enableOfflineMode(): void;
+    /**
+     * Disable offline mode
+     */
+    disableOfflineMode(): void;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/registry/validators/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/registry/validators/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAEhB,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAErC,sCAAsC;IACtC,YAAY,CAAC,EAAE,6BAA6B,CAAC;IAE7C,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IAEzB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAElC,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;IAEtC,yBAAyB;IACzB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,cAAc,CAAiB;gBAE3B,cAAc,CAAC,EAAE,cAAc;IAM3C;;;;;;;;OAQG;IACG,QAAQ,CACZ,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IAkF5B;;;;;;OAMG;IACG,oBAAoB,CACxB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;;;;OAMG;IACG,wBAAwB,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;;OAIG;IACH,iBAAiB,IAAI,cAAc;IAInC;;;;OAIG;IACH,oBAAoB,IAAI,iBAAiB;IAIzC;;;;OAIG;IACH,wBAAwB,IAAI,qBAAqB;IAIjD;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,kBAAkB,IAAI,IAAI;CAG3B"}