@aquex/cmos-mcp 1.0.0

package/dist/versioning/migration-engine.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * Migration Engine - Template version migration and upgrade paths
+ * Handles transitioning between template versions (B3.4)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MigrationEngine = void 0;
+exports.createMigration = createMigration;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const types_1 = require("./types");
+const common_1 = require("../validation/common");
+const MAX_BACKUP_SIZE_BYTES = 2 * 1024 * 1024;
+/**
+ * Manages migration between template versions
+ */
+class MigrationEngine {
+    constructor(versionManager, options = {}) {
+        this.migrations = new Map(); // templateId -> migrations
+        this.versionManager = versionManager;
+        this.options = {
+            createBackups: options.createBackups ?? true,
+            autoMigrate: options.autoMigrate ?? false,
+            strict: options.strict ?? true,
+        };
+    }
+    /**
+     * Register a migration script
+     */
+    registerMigration(templateId, migration) {
+        const migrations = this.migrations.get(templateId) || [];
+        migrations.push(migration);
+        // Sort by from version (oldest to newest)
+        migrations.sort((a, b) => this.versionManager.compareVersions(a.fromVersion, b.fromVersion));
+        this.migrations.set(templateId, migrations);
+    }
+    /**
+     * Find a migration path from one version to another
+     */
+    findMigrationPath(templateId, fromVersion, toVersion) {
+        const migrations = this.migrations.get(templateId);
+        if (!migrations) {
+            return null;
+        }
+        // Use breadth-first search to find shortest migration path
+        const path = [];
+        let currentVersion = fromVersion;
+        const visited = new Set();
+        while (this.versionManager.compareVersions(currentVersion, toVersion) !== 0) {
+            const versionKey = this.versionManager.versionToString(currentVersion);
+            if (visited.has(versionKey)) {
+                // Circular dependency detected
+                return null;
+            }
+            visited.add(versionKey);
+            // Find migration from current version
+            const nextMigration = migrations.find((m) => this.versionManager.compareVersions(m.fromVersion, currentVersion) === 0);
+            if (!nextMigration) {
+                // No migration found from this version
+                return null;
+            }
+            path.push(nextMigration);
+            currentVersion = nextMigration.toVersion;
+            // Check if we've reached the target version
+            if (this.versionManager.compareVersions(currentVersion, toVersion) === 0) {
+                break;
+            }
+            // Check if we've overshot the target (shouldn't happen with proper migrations)
+            if (this.versionManager.compareVersions(currentVersion, toVersion) > 0) {
+                return null;
+            }
+        }
+        // Calculate total duration and reversibility
+        const totalDuration = path.reduce((sum, migration) => sum + (migration.estimatedDuration || 0), 0);
+        const reversible = path.every((migration) => migration.reversible);
+        return {
+            from: fromVersion,
+            to: toVersion,
+            steps: path,
+            reversible,
+            totalDuration,
+        };
+    }
+    /**
+     * Execute a migration path
+     */
+    async migrate(templateId, template, migrationPath, backupDir) {
+        const startTime = Date.now();
+        const errors = [];
+        const warnings = [];
+        let currentTemplate = template;
+        let backupPath;
+        try {
+            // Create backup if enabled
+            if (this.options.createBackups && backupDir) {
+                backupPath = await this.createBackup(templateId, template, backupDir);
+            }
+            // Execute each migration step
+            for (let i = 0; i < migrationPath.steps.length; i++) {
+                const migration = migrationPath.steps[i];
+                const stepStart = Date.now();
+                try {
+                    const result = await migration.migrate(currentTemplate);
+                    if (!result.success) {
+                        errors.push(`Migration step ${i + 1} (${migration.id}) failed: ${result.errors?.join(', ')}`);
+                        if (this.options.strict) {
+                            throw new types_1.MigrationError(`Migration failed at step ${i + 1}: ${migration.id}`, {
+                                step: i + 1,
+                                migration: migration.id,
+                                errors: result.errors,
+                            });
+                        }
+                    }
+                    if (result.warnings) {
+                        warnings.push(...result.warnings);
+                    }
+                    currentTemplate = result.migratedTemplate || currentTemplate;
+                    const stepDuration = Date.now() - stepStart;
+                    console.error(`[INFO] Migration step ${i + 1}/${migrationPath.steps.length} completed in ${stepDuration}ms`);
+                }
+                catch (error) {
+                    const errorMsg = `Migration step ${i + 1} (${migration.id}) threw error: ${error instanceof Error ? error.message : String(error)}`;
+                    errors.push(errorMsg);
+                    if (this.options.strict) {
+                        throw new types_1.MigrationError(errorMsg, {
+                            step: i + 1,
+                            migration: migration.id,
+                            error,
+                        });
+                    }
+                }
+            }
+            const executionTime = Date.now() - startTime;
+            const warningList = warnings.length > 0 ? warnings : undefined;
+            if (errors.length === 0) {
+                return {
+                    success: true,
+                    migratedTemplate: currentTemplate,
+                    warnings: warningList,
+                    executionTime,
+                    backupPath,
+                };
+            }
+            return {
+                success: false,
+                migratedTemplate: currentTemplate,
+                errors,
+                warnings: warningList,
+                executionTime,
+                backupPath,
+            };
+        }
+        catch (error) {
+            if (error instanceof types_1.MigrationError) {
+                throw error;
+            }
+            throw new types_1.MigrationError(`Migration failed: ${error instanceof Error ? error.message : String(error)}`, { error, backupPath });
+        }
+    }
+    /**
+     * Rollback a migration using backup
+     */
+    async rollback(templateId, backupPath) {
+        try {
+            const backupContent = await fs.readFile(backupPath, 'utf-8');
+            const template = (0, common_1.jsonContent)(backupContent, {
+                maxSize: MAX_BACKUP_SIZE_BYTES,
+            });
+            return {
+                success: true,
+                template,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Rollback failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Create a backup of the template before migration
+     */
+    async createBackup(templateId, template, backupDir) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupFileName = `${templateId}_${timestamp}_backup.json`;
+        const backupPath = path.join(backupDir, backupFileName);
+        // Ensure backup directory exists
+        await fs.mkdir(backupDir, { recursive: true });
+        // Write backup
+        await fs.writeFile(backupPath, JSON.stringify(template, null, 2), 'utf-8');
+        return backupPath;
+    }
+    /**
+     * Get all available migrations for a template
+     */
+    getMigrations(templateId) {
+        return this.migrations.get(templateId) || [];
+    }
+    /**
+     * Check if a migration path exists between two versions
+     */
+    canMigrate(templateId, fromVersion, toVersion) {
+        const path = this.findMigrationPath(templateId, fromVersion, toVersion);
+        return path !== null;
+    }
+    /**
+     * Validate a migration script
+     */
+    validateMigration(migration) {
+        const errors = [];
+        // Check that versions are different
+        if (this.versionManager.compareVersions(migration.fromVersion, migration.toVersion) === 0) {
+            errors.push('Migration fromVersion and toVersion must be different');
+        }
+        // Check that toVersion is greater than fromVersion (no downgrades)
+        if (this.versionManager.compareVersions(migration.fromVersion, migration.toVersion) > 0) {
+            errors.push('Migration toVersion must be greater than fromVersion (no downgrades)');
+        }
+        // Check that migration function exists
+        if (typeof migration.migrate !== 'function') {
+            errors.push('Migration must have a migrate function');
+        }
+        // Check rollback if reversible
+        if (migration.reversible && typeof migration.rollback !== 'function') {
+            errors.push('Reversible migrations must have a rollback function');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Auto-migrate a template to the latest version
+     */
+    async autoMigrate(templateId, template, currentVersion, backupDir) {
+        // Get latest version
+        const latestVersion = this.versionManager.getLatestVersion(templateId);
+        if (!latestVersion) {
+            throw new types_1.MigrationError(`No versions registered for template: ${templateId}`);
+        }
+        // Check if already at latest version
+        if (this.versionManager.compareVersions(currentVersion, latestVersion.version) === 0) {
+            return {
+                success: true,
+                migratedTemplate: template,
+                executionTime: 0,
+                warnings: ['Template is already at the latest version'],
+            };
+        }
+        // Find migration path
+        const path = this.findMigrationPath(templateId, currentVersion, latestVersion.version);
+        if (!path) {
+            throw new types_1.MigrationError(`No migration path found from ${this.versionManager.versionToString(currentVersion)} to ${this.versionManager.versionToString(latestVersion.version)}`);
+        }
+        // Execute migration
+        return this.migrate(templateId, template, path, backupDir);
+    }
+    /**
+     * Get migration statistics
+     */
+    getStatistics(templateId) {
+        const migrations = this.getMigrations(templateId);
+        const totalMigrations = migrations.length;
+        const reversibleCount = migrations.filter((m) => m.reversible).length;
+        const totalDuration = migrations.reduce((sum, m) => sum + (m.estimatedDuration || 0), 0);
+        const averageDuration = totalMigrations > 0 ? totalDuration / totalMigrations : 0;
+        const versionCoverage = migrations.map((m) => ({
+            from: this.versionManager.versionToString(m.fromVersion),
+            to: this.versionManager.versionToString(m.toVersion),
+        }));
+        return {
+            totalMigrations,
+            reversibleCount,
+            averageDuration,
+            versionCoverage,
+        };
+    }
+    /**
+     * Clear all registered migrations
+     */
+    clearMigrations() {
+        this.migrations.clear();
+    }
+}
+exports.MigrationEngine = MigrationEngine;
+/**
+ * Helper to create a simple migration script
+ */
+function createMigration(id, fromVersion, toVersion, description, migrateFn, options = {}) {
+    return {
+        id,
+        fromVersion,
+        toVersion,
+        description,
+        migrate: async (template) => {
+            const startTime = Date.now();
+            try {
+                const migratedTemplate = await migrateFn(template);
+                return {
+                    success: true,
+                    migratedTemplate,
+                    executionTime: Date.now() - startTime,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    errors: [error instanceof Error ? error.message : String(error)],
+                    executionTime: Date.now() - startTime,
+                };
+            }
+        },
+        rollback: options.rollbackFn,
+        estimatedDuration: options.estimatedDuration,
+        reversible: options.rollbackFn !== undefined,
+    };
+}
+//# sourceMappingURL=migration-engine.js.map

package/dist/versioning/migration-engine.js.map

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

package/dist/versioning/types.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Type definitions for the Template Versioning system.
+ * Implements SemVer support and migration capabilities for mission B3.4.
+ */
+/**
+ * Semantic version components (X.Y.Z format)
+ */
+export interface SemanticVersion {
+    /** Major version - incremented for breaking changes */
+    major: number;
+    /** Minor version - incremented for backward-compatible features */
+    minor: number;
+    /** Patch version - incremented for backward-compatible bug fixes */
+    patch: number;
+    /** Optional pre-release identifier (e.g., 'alpha', 'beta', 'rc.1') */
+    prerelease?: string;
+    /** Optional build metadata */
+    buildMetadata?: string;
+}
+/**
+ * Version comparison result
+ */
+export declare enum VersionComparison {
+    LESS_THAN = -1,
+    EQUAL = 0,
+    GREATER_THAN = 1
+}
+/**
+ * SemVer range specification for compatibility checks
+ */
+export interface VersionRange {
+    /** Minimum version (inclusive) */
+    min?: SemanticVersion;
+    /** Maximum version (exclusive) */
+    max?: SemanticVersion;
+    /** Exact version match (overrides min/max) */
+    exact?: SemanticVersion;
+    /** Range expression (e.g., '^1.2.0', '~1.2.0', '>=1.0.0 <2.0.0') */
+    expression?: string;
+}
+/**
+ * Template version metadata
+ */
+export interface TemplateVersion {
+    /** The template identifier */
+    templateId: string;
+    /** Semantic version of this template */
+    version: SemanticVersion;
+    /** Human-readable changelog entry for this version */
+    changelog?: string;
+    /** Compatible versions (range specification) */
+    compatibleWith?: VersionRange;
+    /** Required dependency versions */
+    dependencies?: {
+        [templateId: string]: VersionRange;
+    };
+    /** Migration script path (if upgrading from previous version) */
+    migrationFrom?: {
+        [sourceVersion: string]: string;
+    };
+    /** ISO 8601 timestamp of when this version was released */
+    releaseDate: string;
+    /** Deprecation notice if this version is deprecated */
+    deprecated?: {
+        message: string;
+        replacedBy?: string;
+    };
+}
+/**
+ * Version compatibility check result
+ */
+export interface CompatibilityCheckResult {
+    /** Whether versions are compatible */
+    compatible: boolean;
+    /** Detailed reason if not compatible */
+    reason?: string;
+    /** Suggested upgrade path if incompatible */
+    suggestedUpgrade?: {
+        from: string;
+        to: string;
+        migrationRequired: boolean;
+    };
+}
+export type TemplateData = Record<string, unknown>;
+/**
+ * Migration script metadata
+ */
+export interface MigrationScript {
+    /** Unique identifier for this migration */
+    id: string;
+    /** Source version (what it migrates from) */
+    fromVersion: SemanticVersion;
+    /** Target version (what it migrates to) */
+    toVersion: SemanticVersion;
+    /** Description of what this migration does */
+    description: string;
+    /** Migration function */
+    migrate: (template: TemplateData) => Promise<MigrationResult>;
+    /** Optional rollback function */
+    rollback?: (template: TemplateData) => Promise<TemplateData>;
+    /** Estimated time to complete (in seconds) */
+    estimatedDuration?: number;
+    /** Whether this migration is reversible */
+    reversible: boolean;
+}
+/**
+ * Shared result fields for migration operations
+ */
+interface MigrationResultBase {
+    /** Warnings (non-fatal issues) */
+    warnings?: string[];
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** Backup path (for rollback) */
+    backupPath?: string;
+}
+/**
+ * Successful migration result
+ */
+export interface SuccessfulMigrationResult extends MigrationResultBase {
+    /** Whether migration succeeded */
+    success: true;
+    /** The migrated template (always present when success === true) */
+    migratedTemplate: TemplateData;
+}
+/**
+ * Failed migration result
+ */
+export interface FailedMigrationResult extends MigrationResultBase {
+    /** Whether migration succeeded */
+    success: false;
+    /** Errors encountered during migration */
+    errors: string[];
+    /** Partial template payload if the migration produced one before failing */
+    migratedTemplate?: TemplateData;
+}
+/**
+ * Result of a migration operation
+ */
+export type MigrationResult = SuccessfulMigrationResult | FailedMigrationResult;
+/**
+ * Narrow a migration result to the successful variant
+ */
+export declare function isSuccessfulMigrationResult(result: MigrationResult): result is SuccessfulMigrationResult;
+/**
+ * Migration path from one version to another
+ */
+export interface MigrationPath {
+    /** Source version */
+    from: SemanticVersion;
+    /** Target version */
+    to: SemanticVersion;
+    /** Ordered list of migration steps */
+    steps: MigrationScript[];
+    /** Whether all migrations in path are reversible */
+    reversible: boolean;
+    /** Total estimated duration (sum of all steps) */
+    totalDuration: number;
+}
+/**
+ * Version registry entry
+ */
+export interface VersionRegistryEntry {
+    /** Template identifier */
+    templateId: string;
+    /** All available versions for this template */
+    versions: TemplateVersion[];
+    /** The latest stable version */
+    latestStable: SemanticVersion;
+    /** The latest version (including pre-releases) */
+    latest: SemanticVersion;
+}
+/**
+ * Version conflict in a template pack combination
+ */
+export interface VersionConflict {
+    /** Template identifier with conflict */
+    templateId: string;
+    /** Conflicting version requirements */
+    conflicts: Array<{
+        requiredBy: string;
+        versionRange: VersionRange;
+    }>;
+    /** Suggested resolution */
+    resolution?: {
+        version: string;
+        reason: string;
+    };
+}
+/**
+ * Result of a version resolution operation (for pack combinations)
+ */
+export interface VersionResolutionResult {
+    /** Whether resolution was successful */
+    success: boolean;
+    /** Resolved versions for each template */
+    resolvedVersions?: {
+        [templateId: string]: SemanticVersion;
+    };
+    /** Any conflicts that couldn't be resolved */
+    conflicts?: VersionConflict[];
+    /** Warnings about version choices */
+    warnings?: string[];
+}
+/**
+ * Options for version manager operations
+ */
+export interface VersionManagerOptions {
+    /** Whether to allow pre-release versions */
+    allowPrerelease?: boolean;
+    /** Whether to automatically migrate when loading templates */
+    autoMigrate?: boolean;
+    /** Strict mode (fail on warnings) */
+    strict?: boolean;
+    /** Whether to create backups before migrations */
+    createBackups?: boolean;
+}
+/**
+ * Error types for versioning operations
+ */
+export declare class VersionError extends Error {
+    code?: string | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code?: string | undefined, details?: Record<string, unknown> | undefined);
+}
+export declare class IncompatibleVersionError extends VersionError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class MigrationError extends VersionError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class InvalidVersionError extends VersionError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/versioning/types.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Type definitions for the Template Versioning system.
+ * Implements SemVer support and migration capabilities for mission B3.4.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidVersionError = exports.MigrationError = exports.IncompatibleVersionError = exports.VersionError = exports.VersionComparison = void 0;
+exports.isSuccessfulMigrationResult = isSuccessfulMigrationResult;
+/**
+ * Version comparison result
+ */
+var VersionComparison;
+(function (VersionComparison) {
+    VersionComparison[VersionComparison["LESS_THAN"] = -1] = "LESS_THAN";
+    VersionComparison[VersionComparison["EQUAL"] = 0] = "EQUAL";
+    VersionComparison[VersionComparison["GREATER_THAN"] = 1] = "GREATER_THAN";
+})(VersionComparison || (exports.VersionComparison = VersionComparison = {}));
+/**
+ * Narrow a migration result to the successful variant
+ */
+function isSuccessfulMigrationResult(result) {
+    return result.success;
+}
+/**
+ * Error types for versioning operations
+ */
+class VersionError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'VersionError';
+    }
+}
+exports.VersionError = VersionError;
+class IncompatibleVersionError extends VersionError {
+    constructor(message, details) {
+        super(message, 'INCOMPATIBLE_VERSION', details);
+        this.name = 'IncompatibleVersionError';
+    }
+}
+exports.IncompatibleVersionError = IncompatibleVersionError;
+class MigrationError extends VersionError {
+    constructor(message, details) {
+        super(message, 'MIGRATION_FAILED', details);
+        this.name = 'MigrationError';
+    }
+}
+exports.MigrationError = MigrationError;
+class InvalidVersionError extends VersionError {
+    constructor(message, details) {
+        super(message, 'INVALID_VERSION', details);
+        this.name = 'InvalidVersionError';
+    }
+}
+exports.InvalidVersionError = InvalidVersionError;
+//# sourceMappingURL=types.js.map

package/dist/versioning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/versioning/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAoLH,kEAIC;AAlKD;;GAEG;AACH,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,oEAAc,CAAA;IACd,2DAAS,CAAA;IACT,yEAAgB,CAAA;AAClB,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B;AAoJD;;GAEG;AACH,SAAgB,2BAA2B,CACzC,MAAuB;IAEvB,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AA+FD;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YACE,OAAe,EACR,IAAa,EACb,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAS;QACb,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AATD,oCASC;AAED,MAAa,wBAAyB,SAAQ,YAAY;IACxD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AALD,4DAKC;AAED,MAAa,cAAe,SAAQ,YAAY;IAC9C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}