@aquex/cmos-mcp 1.0.0

package/dist/tools/version-template.d.ts

@@ -0,0 +1,515 @@
+/**
+ * MCP Tool: version_template
+ *
+ * Exposes version management and migration functionality as MCP tools
+ * for use in Claude Desktop and other MCP-compatible environments.
+ *
+ * Implements SemVer support and migration capabilities from B3.4.
+ */
+import { VersionManagerOptions } from '../versioning/types';
+export interface CheckVersionCompatibilityParams {
+    /** Template ID to check */
+    templateId: string;
+    /** First version to compare */
+    version1: string;
+    /** Second version to compare */
+    version2: string;
+    /** Optional version manager options */
+    options?: VersionManagerOptions;
+}
+export interface CheckVersionCompatibilityResult {
+    success: boolean;
+    compatible: boolean;
+    reason?: string;
+    suggestedUpgrade?: {
+        from: string;
+        to: string;
+        migrationRequired: boolean;
+    };
+    message: string;
+}
+export declare function checkVersionCompatibility(params: CheckVersionCompatibilityParams): Promise<CheckVersionCompatibilityResult>;
+export declare const getVersionCompatibilityToolDefinition: {
+    readonly name: "get_version_compatibility";
+    readonly description: "Check if two template versions are compatible with each other. Returns compatibility status and suggested upgrade path if incompatible.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version to compare (SemVer format: X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version to compare (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "version1", "version2"];
+    };
+};
+export declare const checkVersionCompatibilityToolDefinitionDeprecated: {
+    readonly name: "check_version_compatibility";
+    readonly description: "[DEPRECATED] Use get_version_compatibility instead. Returns the same compatibility assessment.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version to compare (SemVer format: X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version to compare (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "version1", "version2"];
+    };
+};
+export interface FindMigrationPathParams {
+    /** Template ID */
+    templateId: string;
+    /** Source version */
+    fromVersion: string;
+    /** Target version */
+    toVersion: string;
+    /** Optional version manager options */
+    options?: VersionManagerOptions;
+}
+export interface FindMigrationPathResult {
+    success: boolean;
+    pathFound: boolean;
+    path?: {
+        from: string;
+        to: string;
+        steps: Array<{
+            id: string;
+            fromVersion: string;
+            toVersion: string;
+            description: string;
+            estimatedDuration?: number;
+            reversible: boolean;
+        }>;
+        reversible: boolean;
+        totalDuration: number;
+    };
+    message: string;
+}
+export declare function findMigrationPath(params: FindMigrationPathParams): Promise<FindMigrationPathResult>;
+export declare const getMigrationPathToolDefinition: {
+    readonly name: "get_migration_path";
+    readonly description: "Find a migration path from one template version to another. Returns the sequence of migration steps required.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly fromVersion: {
+                readonly type: "string";
+                readonly description: "Source version (SemVer format: X.Y.Z)";
+            };
+            readonly toVersion: {
+                readonly type: "string";
+                readonly description: "Target version (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "fromVersion", "toVersion"];
+    };
+};
+export declare const findMigrationPathToolDefinitionDeprecated: {
+    readonly name: "find_migration_path";
+    readonly description: "[DEPRECATED] Use get_migration_path instead. Produces the same ordered migration plan.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly fromVersion: {
+                readonly type: "string";
+                readonly description: "Source version (SemVer format: X.Y.Z)";
+            };
+            readonly toVersion: {
+                readonly type: "string";
+                readonly description: "Target version (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "fromVersion", "toVersion"];
+    };
+};
+export interface RegisterTemplateVersionParams {
+    /** Template ID */
+    templateId: string;
+    /** Version string (SemVer format) */
+    version: string;
+    /** Changelog for this version */
+    changelog?: string;
+    /** Compatible version range (e.g., '^1.0.0', '~1.2.0') */
+    compatibleWith?: string;
+    /** Release date (ISO 8601) */
+    releaseDate?: string;
+    /** Optional version manager options */
+    options?: VersionManagerOptions;
+}
+export interface RegisterTemplateVersionResult {
+    success: boolean;
+    version?: {
+        templateId: string;
+        version: string;
+        releaseDate: string;
+    };
+    message: string;
+}
+export declare function registerTemplateVersion(params: RegisterTemplateVersionParams): Promise<RegisterTemplateVersionResult>;
+export declare const createTemplateVersionToolDefinition: {
+    readonly name: "create_template_version";
+    readonly description: "Register a new template version in the version registry. Validates the version and adds it to the registry.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version: {
+                readonly type: "string";
+                readonly description: "Version string in SemVer format (X.Y.Z)";
+            };
+            readonly changelog: {
+                readonly type: "string";
+                readonly description: "Human-readable changelog entry for this version (optional)";
+            };
+            readonly compatibleWith: {
+                readonly type: "string";
+                readonly description: "Compatible version range (e.g., '^1.0.0' for compatible with 1.x, '~1.2.0' for 1.2.x) (optional)";
+            };
+            readonly releaseDate: {
+                readonly type: "string";
+                readonly description: "ISO 8601 release date (optional, defaults to now)";
+            };
+        };
+        readonly required: readonly ["templateId", "version"];
+    };
+};
+export declare const registerTemplateVersionToolDefinitionDeprecated: {
+    readonly name: "register_template_version";
+    readonly description: "[DEPRECATED] Use create_template_version instead. Registers the same version metadata and changelog information.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version: {
+                readonly type: "string";
+                readonly description: "Version string in SemVer format (X.Y.Z)";
+            };
+            readonly changelog: {
+                readonly type: "string";
+                readonly description: "Human-readable changelog entry for this version (optional)";
+            };
+            readonly compatibleWith: {
+                readonly type: "string";
+                readonly description: "Compatible version range (e.g., '^1.0.0' for compatible with 1.x, '~1.2.0' for 1.2.x) (optional)";
+            };
+            readonly releaseDate: {
+                readonly type: "string";
+                readonly description: "ISO 8601 release date (optional, defaults to now)";
+            };
+        };
+        readonly required: readonly ["templateId", "version"];
+    };
+};
+export interface GetLatestVersionParams {
+    /** Template ID */
+    templateId: string;
+    /** Include pre-release versions */
+    includePrerelease?: boolean;
+    /** Optional version manager options */
+    options?: VersionManagerOptions;
+}
+export interface GetLatestVersionResult {
+    success: boolean;
+    version?: {
+        templateId: string;
+        version: string;
+        releaseDate: string;
+        deprecated?: boolean;
+        deprecationMessage?: string;
+    };
+    message: string;
+}
+export declare function getLatestVersion(params: GetLatestVersionParams): Promise<GetLatestVersionResult>;
+export declare const getLatestVersionToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            templateId: {
+                type: string;
+                description: string;
+            };
+            includePrerelease: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface CompareVersionsParams {
+    /** First version */
+    version1: string;
+    /** Second version */
+    version2: string;
+}
+export interface CompareVersionsResult {
+    success: boolean;
+    comparison?: 'less_than' | 'equal' | 'greater_than';
+    message: string;
+}
+export declare function compareVersions(params: CompareVersionsParams): Promise<CompareVersionsResult>;
+export declare const getVersionComparisonToolDefinition: {
+    readonly name: "get_version_comparison";
+    readonly description: "Compare two semantic versions. Returns whether the first version is less than, equal to, or greater than the second.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version in SemVer format (X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version in SemVer format (X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["version1", "version2"];
+    };
+};
+export declare const compareVersionsToolDefinitionDeprecated: {
+    readonly name: "compare_versions";
+    readonly description: "[DEPRECATED] Use get_version_comparison instead. Provides the same ordering result.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version in SemVer format (X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version in SemVer format (X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["version1", "version2"];
+    };
+};
+export declare const versioningTools: readonly [{
+    readonly name: "get_version_compatibility";
+    readonly description: "Check if two template versions are compatible with each other. Returns compatibility status and suggested upgrade path if incompatible.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version to compare (SemVer format: X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version to compare (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "version1", "version2"];
+    };
+}, {
+    readonly name: "get_migration_path";
+    readonly description: "Find a migration path from one template version to another. Returns the sequence of migration steps required.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly fromVersion: {
+                readonly type: "string";
+                readonly description: "Source version (SemVer format: X.Y.Z)";
+            };
+            readonly toVersion: {
+                readonly type: "string";
+                readonly description: "Target version (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "fromVersion", "toVersion"];
+    };
+}, {
+    readonly name: "create_template_version";
+    readonly description: "Register a new template version in the version registry. Validates the version and adds it to the registry.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version: {
+                readonly type: "string";
+                readonly description: "Version string in SemVer format (X.Y.Z)";
+            };
+            readonly changelog: {
+                readonly type: "string";
+                readonly description: "Human-readable changelog entry for this version (optional)";
+            };
+            readonly compatibleWith: {
+                readonly type: "string";
+                readonly description: "Compatible version range (e.g., '^1.0.0' for compatible with 1.x, '~1.2.0' for 1.2.x) (optional)";
+            };
+            readonly releaseDate: {
+                readonly type: "string";
+                readonly description: "ISO 8601 release date (optional, defaults to now)";
+            };
+        };
+        readonly required: readonly ["templateId", "version"];
+    };
+}, {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            templateId: {
+                type: string;
+                description: string;
+            };
+            includePrerelease: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}, {
+    readonly name: "get_version_comparison";
+    readonly description: "Compare two semantic versions. Returns whether the first version is less than, equal to, or greater than the second.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version in SemVer format (X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version in SemVer format (X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["version1", "version2"];
+    };
+}];
+export declare const versioningToolsDeprecated: readonly [{
+    readonly name: "check_version_compatibility";
+    readonly description: "[DEPRECATED] Use get_version_compatibility instead. Returns the same compatibility assessment.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version to compare (SemVer format: X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version to compare (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "version1", "version2"];
+    };
+}, {
+    readonly name: "find_migration_path";
+    readonly description: "[DEPRECATED] Use get_migration_path instead. Produces the same ordered migration plan.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly fromVersion: {
+                readonly type: "string";
+                readonly description: "Source version (SemVer format: X.Y.Z)";
+            };
+            readonly toVersion: {
+                readonly type: "string";
+                readonly description: "Target version (SemVer format: X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["templateId", "fromVersion", "toVersion"];
+    };
+}, {
+    readonly name: "register_template_version";
+    readonly description: "[DEPRECATED] Use create_template_version instead. Registers the same version metadata and changelog information.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "The template identifier";
+            };
+            readonly version: {
+                readonly type: "string";
+                readonly description: "Version string in SemVer format (X.Y.Z)";
+            };
+            readonly changelog: {
+                readonly type: "string";
+                readonly description: "Human-readable changelog entry for this version (optional)";
+            };
+            readonly compatibleWith: {
+                readonly type: "string";
+                readonly description: "Compatible version range (e.g., '^1.0.0' for compatible with 1.x, '~1.2.0' for 1.2.x) (optional)";
+            };
+            readonly releaseDate: {
+                readonly type: "string";
+                readonly description: "ISO 8601 release date (optional, defaults to now)";
+            };
+        };
+        readonly required: readonly ["templateId", "version"];
+    };
+}, {
+    readonly name: "compare_versions";
+    readonly description: "[DEPRECATED] Use get_version_comparison instead. Provides the same ordering result.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly version1: {
+                readonly type: "string";
+                readonly description: "First version in SemVer format (X.Y.Z)";
+            };
+            readonly version2: {
+                readonly type: "string";
+                readonly description: "Second version in SemVer format (X.Y.Z)";
+            };
+        };
+        readonly required: readonly ["version1", "version2"];
+    };
+}];
+//# sourceMappingURL=version-template.d.ts.map

package/dist/tools/version-template.d.ts.map

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