@specverse/engines 4.1.0

package/dist/registry/formatters/error-formatter.js

@@ -0,0 +1,290 @@
+/**
+ * Error Formatter
+ *
+ * Formats validation issues for beautiful console output.
+ * Provides colored, contextualized error messages with suggestions.
+ *
+ * @module registry/formatters/error-formatter
+ * @version 2.0.0
+ */
+/**
+ * ANSI color codes for terminal output
+ */
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    // Severity colors
+    error: '\x1b[31m', // Red
+    warning: '\x1b[33m', // Yellow
+    info: '\x1b[36m', // Cyan
+    success: '\x1b[32m', // Green
+    // Element colors
+    title: '\x1b[1m\x1b[37m', // Bold White
+    file: '\x1b[35m', // Magenta
+    code: '\x1b[36m', // Cyan
+    suggestion: '\x1b[2m\x1b[37m' // Dim White
+};
+/**
+ * Error Formatter
+ *
+ * Formats validation issues for console output.
+ */
+export class ErrorFormatter {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            colors: options.colors ?? true,
+            showSuggestions: options.showSuggestions ?? true,
+            showFix: options.showFix ?? true,
+            showLearnMore: options.showLearnMore ?? true,
+            compact: options.compact ?? false
+        };
+    }
+    /**
+     * Format a complete validation report
+     *
+     * @param report - Validation report to format
+     * @returns Formatted string ready for console output
+     */
+    formatReport(report) {
+        const lines = [];
+        // Header
+        lines.push(this.formatHeader(report));
+        lines.push('');
+        // Summary
+        if (!this.options.compact) {
+            lines.push(this.formatSummary(report));
+            lines.push('');
+        }
+        // Issues
+        if (report.result.errors.length > 0) {
+            lines.push(this.color(colors.bold, '━━━ Errors ━━━'));
+            lines.push('');
+            report.result.errors.forEach(error => {
+                lines.push(this.formatIssue(error));
+                lines.push('');
+            });
+        }
+        if (report.result.warnings.length > 0 && !this.options.compact) {
+            lines.push(this.color(colors.bold, '━━━ Warnings ━━━'));
+            lines.push('');
+            report.result.warnings.forEach(warning => {
+                lines.push(this.formatIssue(warning));
+                lines.push('');
+            });
+        }
+        if (report.result.info.length > 0 && !this.options.compact) {
+            lines.push(this.color(colors.bold, '━━━ Info ━━━'));
+            lines.push('');
+            report.result.info.forEach(info => {
+                lines.push(this.formatIssue(info));
+                lines.push('');
+            });
+        }
+        // Footer
+        lines.push(this.formatFooter(report));
+        return lines.join('\n');
+    }
+    /**
+     * Format validation result
+     *
+     * @param result - Validation result to format
+     * @returns Formatted string
+     */
+    formatResult(result) {
+        const lines = [];
+        // Errors
+        if (result.errors.length > 0) {
+            lines.push(this.color(colors.bold, '━━━ Errors ━━━'));
+            lines.push('');
+            result.errors.forEach(error => {
+                lines.push(this.formatIssue(error));
+                lines.push('');
+            });
+        }
+        // Warnings
+        if (result.warnings.length > 0) {
+            lines.push(this.color(colors.bold, '━━━ Warnings ━━━'));
+            lines.push('');
+            result.warnings.forEach(warning => {
+                lines.push(this.formatIssue(warning));
+                lines.push('');
+            });
+        }
+        // Info
+        if (result.info.length > 0) {
+            lines.push(this.color(colors.bold, '━━━ Info ━━━'));
+            lines.push('');
+            result.info.forEach(info => {
+                lines.push(this.formatIssue(info));
+                lines.push('');
+            });
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format a single validation issue
+     *
+     * @param issue - Issue to format
+     * @returns Formatted string
+     */
+    formatIssue(issue) {
+        const lines = [];
+        // Icon and title
+        const icon = this.getIcon(issue.severity);
+        const severityColor = this.getSeverityColor(issue.severity);
+        lines.push(`${this.color(severityColor, icon)} ` +
+            `${this.color(colors.title, issue.title)} ` +
+            `${this.color(colors.dim, `[${issue.code}]`)}`);
+        // File location
+        if (issue.file) {
+            const location = issue.line > 0
+                ? `${issue.file}:${issue.line}:${issue.column}`
+                : issue.file;
+            lines.push(`  ${this.color(colors.file, location)}`);
+        }
+        // Message
+        lines.push(`  ${issue.message}`);
+        // Suggestions
+        if (this.options.showSuggestions && issue.suggestions && issue.suggestions.length > 0) {
+            lines.push('');
+            lines.push(this.color(colors.dim, '  Suggestions:'));
+            issue.suggestions.forEach(suggestion => {
+                lines.push(`  ${this.color(colors.suggestion, '• ' + suggestion)}`);
+            });
+        }
+        // Fix command
+        if (this.options.showFix && issue.fix) {
+            lines.push('');
+            lines.push(this.color(colors.dim, '  Fix:'));
+            lines.push(`  ${this.color(colors.code, '$ ' + issue.fix)}`);
+        }
+        // Learn more
+        if (this.options.showLearnMore && issue.learnMoreUrl) {
+            lines.push('');
+            lines.push(`  ${this.color(colors.dim, 'Learn more:')} ${this.color(colors.info, issue.learnMoreUrl)}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format header
+     *
+     * @param report - Validation report
+     * @returns Formatted header
+     */
+    formatHeader(report) {
+        const lines = [];
+        if (report.result.valid) {
+            lines.push(this.color(colors.success, '✓ Validation Passed'));
+        }
+        else {
+            lines.push(this.color(colors.error, '✗ Validation Failed'));
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format summary
+     *
+     * @param report - Validation report
+     * @returns Formatted summary
+     */
+    formatSummary(report) {
+        const lines = [];
+        const { summary } = report;
+        lines.push(this.color(colors.bold, 'Summary:'));
+        // Validations
+        if (summary.validationsPassed.length > 0) {
+            lines.push(`  ${this.color(colors.success, '✓')} Passed: ${summary.validationsPassed.join(', ')}`);
+        }
+        if (summary.validationsFailed.length > 0) {
+            lines.push(`  ${this.color(colors.error, '✗')} Failed: ${summary.validationsFailed.join(', ')}`);
+        }
+        // Issue counts
+        lines.push('');
+        lines.push(this.color(colors.bold, 'Issues:'));
+        if (summary.errorCount > 0) {
+            lines.push(`  ${this.color(colors.error, '✗')} Errors: ${summary.errorCount}`);
+        }
+        if (summary.warningCount > 0) {
+            lines.push(`  ${this.color(colors.warning, '⚠')} Warnings: ${summary.warningCount}`);
+        }
+        if (summary.infoCount > 0) {
+            lines.push(`  ${this.color(colors.info, 'ℹ')} Info: ${summary.infoCount}`);
+        }
+        if (summary.totalIssues === 0) {
+            lines.push(`  ${this.color(colors.success, 'No issues found')}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format footer
+     *
+     * @param report - Validation report
+     * @returns Formatted footer
+     */
+    formatFooter(report) {
+        const lines = [];
+        if (report.result.valid) {
+            lines.push(this.color(colors.success, '✓ All validations passed successfully'));
+        }
+        else {
+            lines.push(this.color(colors.error, `✗ Validation failed with ${report.summary.errorCount} error(s)`));
+            if (!this.options.compact) {
+                lines.push('');
+                lines.push(this.color(colors.dim, 'Run with --help for more information'));
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get icon for severity
+     *
+     * @param severity - Issue severity
+     * @returns Icon character
+     */
+    getIcon(severity) {
+        switch (severity) {
+            case 'error':
+                return '✗';
+            case 'warning':
+                return '⚠';
+            case 'info':
+                return 'ℹ';
+            default:
+                return '•';
+        }
+    }
+    /**
+     * Get color for severity
+     *
+     * @param severity - Issue severity
+     * @returns ANSI color code
+     */
+    getSeverityColor(severity) {
+        switch (severity) {
+            case 'error':
+                return colors.error;
+            case 'warning':
+                return colors.warning;
+            case 'info':
+                return colors.info;
+            default:
+                return colors.reset;
+        }
+    }
+    /**
+     * Apply color to text
+     *
+     * @param colorCode - ANSI color code
+     * @param text - Text to color
+     * @returns Colored text (or plain text if colors disabled)
+     */
+    color(colorCode, text) {
+        if (!this.options.colors) {
+            return text;
+        }
+        return `${colorCode}${text}${colors.reset}`;
+    }
+}
+//# sourceMappingURL=error-formatter.js.map

package/dist/registry/formatters/error-formatter.js.map

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

package/dist/registry/formatters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Registry Formatters
+ *
+ * @module registry/formatters
+ */
+export { ErrorFormatter } from './error-formatter.js';
+export type { ErrorFormatterOptions } from './error-formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/registry/formatters/index.js

@@ -0,0 +1,7 @@
+/**
+ * Registry Formatters
+ *
+ * @module registry/formatters
+ */
+export { ErrorFormatter } from './error-formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @specverse/engine-registry
+ *
+ * Registry client for the SpecVerse community library platform.
+ * Provides caching, offline support, manifest validation, and
+ * installation validation for the spec registry.
+ */
+export { RegistryClient } from './client/registry-client.js';
+export { CacheManager } from './cache/cache-manager.js';
+export { OfflineHandler } from './offline/offline-handler.js';
+export { Validator } from './validators/validator.js';
+export { ManifestValidator } from './validators/manifest-validator.js';
+export { InstallationValidator } from './validators/installation-validator.js';
+export { ErrorFormatter } from './formatters/error-formatter.js';
+export { manifestConfigToSpecVerseManifest, validateFactoryReferences } from './utils/manifest-adapter.js';
+export type * from './types/index.js';
+export type * from './types/registry.js';
+export type * from './types/validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,OAAO,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAG3G,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,uBAAuB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,22 @@
+/**
+ * @specverse/engine-registry
+ *
+ * Registry client for the SpecVerse community library platform.
+ * Provides caching, offline support, manifest validation, and
+ * installation validation for the spec registry.
+ */
+// Client
+export { RegistryClient } from './client/registry-client.js';
+// Cache
+export { CacheManager } from './cache/cache-manager.js';
+// Offline
+export { OfflineHandler } from './offline/offline-handler.js';
+// Validators
+export { Validator } from './validators/validator.js';
+export { ManifestValidator } from './validators/manifest-validator.js';
+export { InstallationValidator } from './validators/installation-validator.js';
+// Formatters
+export { ErrorFormatter } from './formatters/error-formatter.js';
+// Utils
+export { manifestConfigToSpecVerseManifest, validateFactoryReferences } from './utils/manifest-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,QAAQ;AACR,OAAO,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/registry/offline/offline-handler.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Registry Offline Handler
+ *
+ * Implements cache-first strategy with graceful fallback for offline scenarios.
+ * Wraps RegistryClient and CacheManager to provide unified online/offline access.
+ *
+ * @module registry/offline/offline-handler
+ * @version 2.0.0
+ */
+import type { RegistryResponse, RegistryFactoryMetadata, SearchResponse, CapabilitiesResponse, ValidationIssue } from '../types/index.js';
+/**
+ * Offline handler configuration
+ */
+export interface OfflineHandlerConfig {
+    /** Registry client configuration */
+    registryClient?: {
+        endpoint?: string;
+        timeout?: number;
+        retries?: number;
+    };
+    /** Cache manager configuration */
+    cache?: {
+        cacheDir?: string;
+        ttl?: number;
+        enabled?: boolean;
+    };
+    /** Offline mode - only use cache, never network */
+    offlineMode?: boolean;
+    /** Allow stale cache as fallback (default: true) */
+    allowStaleCache?: boolean;
+}
+/**
+ * Fetch result with metadata
+ */
+export interface FetchResult {
+    /** Registry response data */
+    data: RegistryResponse;
+    /** Data source */
+    source: 'network' | 'cache-fresh' | 'cache-stale';
+    /** Validation issues (warnings about cache staleness, etc.) */
+    issues: ValidationIssue[];
+}
+/**
+ * Registry Offline Handler
+ *
+ * Provides unified access to registry metadata with offline-first strategy:
+ * 1. Try to fetch from network
+ * 2. If network fails, use fresh cache
+ * 3. If no fresh cache, use stale cache as fallback (with warning)
+ * 4. If no cache at all, throw error
+ */
+export declare class OfflineHandler {
+    private client;
+    private cache;
+    private config;
+    constructor(config?: OfflineHandlerConfig);
+    /**
+     * Fetch all factories with offline-first strategy
+     *
+     * @returns Fetch result with data, source, and issues
+     */
+    fetchFactories(): Promise<FetchResult>;
+    /**
+     * Get specific factory by name
+     *
+     * @param name - Factory name
+     * @returns Factory metadata or null if not found
+     */
+    getFactory(name: string): Promise<RegistryFactoryMetadata | null>;
+    /**
+     * Search factories
+     *
+     * Note: Search functionality requires network access.
+     * Falls back to local filtering of cached data when offline.
+     *
+     * @param query - Search query
+     * @returns Search results
+     */
+    search(query: string): Promise<SearchResponse>;
+    /**
+     * Get all capabilities
+     *
+     * @returns Capabilities response
+     */
+    getCapabilities(): Promise<CapabilitiesResponse>;
+    /**
+     * Check if registry is accessible
+     *
+     * @returns True if network access is available
+     */
+    checkHealth(): Promise<boolean>;
+    /**
+     * Clear cache
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Get cache status
+     *
+     * @returns Cache status information
+     */
+    getCacheStatus(): Promise<{
+        exists: boolean;
+        valid: boolean;
+        age?: number;
+        timeToExpiration?: number;
+        createdAt?: string;
+        expiresAt?: string;
+    }>;
+    /**
+     * Get registry client endpoint
+     *
+     * @returns Registry endpoint URL
+     */
+    getEndpoint(): string;
+    /**
+     * Get cache file path
+     *
+     * @returns Absolute path to cache file
+     */
+    getCacheFile(): string;
+    /**
+     * Enable offline mode
+     */
+    enableOfflineMode(): void;
+    /**
+     * Disable offline mode
+     */
+    disableOfflineMode(): void;
+    /**
+     * Check if offline mode is enabled
+     *
+     * @returns True if offline mode is enabled
+     */
+    isOfflineMode(): boolean;
+}
+/**
+ * Offline error
+ *
+ * Thrown when registry data is unavailable both from network and cache.
+ */
+export declare class OfflineError extends Error {
+    code: string;
+    issues: ValidationIssue[];
+    constructor(message: string, code: string, issues: ValidationIssue[]);
+    /**
+     * Get user-friendly error message
+     */
+    getUserMessage(): string;
+}
+//# sourceMappingURL=offline-handler.d.ts.map

package/dist/registry/offline/offline-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-handler.d.ts","sourceRoot":"","sources":["../../../src/registry/offline/offline-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAO3B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,cAAc,CAAC,EAAE;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IAEvB,kBAAkB;IAClB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;IAElD,+DAA+D;IAC/D,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,GAAE,oBAAyB;IAY7C;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAoH5C;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IASvE;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkCpD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAkCtD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAQrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAuBF;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;;OAIG;IACH,aAAa,IAAI,OAAO;CAGzB;AAED;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,eAAe,EAAE;gBAFhC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EAAE;IAUlC;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}